PostLibrary Object

Derived from: CAMLibrary Object
Defined in namespace "adsk::cam" and the header file is <Cam/Post/PostLibrary.h>

Description

The PostLibrary provides access to post configurations. Using this object you can import post configurations and get existing post configurations using either a URL or query to find specific post configurations.

Methods

Name Description
childAssetURLs

Get all assets under given URL.

childFolderURLs

Get all library folders under given URL.

childPostConfigurations

Get all posts by the given parent folder URL. Returns null, if the URL does not exist.

classType

Static function that all classes support that returns the type of the class as a string. The returned string matches the string returned by the objectType property. For example if you have a reference to an object and you want to check if it's a SketchLine you can use myObject.objectType == fusion.SketchLine.classType().

createFolder

Create a new folder in the library. Create the folder under given parent URL with given folder name. Add counting suffix, in case a folder with given name already exists. Throw an error if given URL does not point to a valid folder or the URL is read-only. Also throws an error if given folder name is empty.

createQuery

Creates a new PostConfigurationQuery that is used to query the library for post configurations matching the query.

deleteAsset

Delete asset by URL from the library. Throw an error if given URL does not point to a valid asset or the URL is read-only.

deleteFolder

Delete folder by URL from the library. Any content of the folder will also be deleted. Throw an error if given URL does not point to a valid folder or the URL is read-only.

displayName

Get the localized display name for a given URL. The URL must point to a folder.

doesPathExist

Checks if the given URL points to an existing folder or asset in the library.

importPostConfiguration

Import a given post configuration at a specific location. The post configuration will be stored in the library. Throws an error, if the given URL is read-only.

postConfigurationAtURL

Get a specific post configuration by the given URL. Returns null, if the URL does not exist.

urlByLocation

Get the URL for a given LibraryLocations.

Properties

Name Description
assetTypeName Get the name of the asset type which can be accessed by the library.
isValid Indicates if this object is still valid, i.e. hasn't been deleted or some other action done to invalidate the reference.
objectType This property is supported by all objects in the API and returns a string that contains the full name (namespace::objecttype) describing the type of the object.

It's often useful to use this in combination with the classType method to see if an object is a certain type. For example: if obj.objectType == adsk.core.Point3D.classType():

Accessed From

CAMLibraryManager.postLibrary

Samples

Name Description
Manufacturing Workflow API Sample

Manufacturing Workflow API Sample. This sample script starts by creating a simple component, which is then used to describe a milling workflow. It creates a setup and a few operations, picks tools from a Fusion sample tool library using loops and queries, and post-processes the operations using an NC program.

Post Toolpaths API Sample

Demonstrates posting toolpaths in the active document using an NC program: import a post configuration from the post library, choose which setups or operations to include, set NC program and post parameters, and run NCProgram.postProcess.

Before running: Run from Scripts and Add-Ins with a design that contains at least one CAM setup with toolpaths. The script prompts for what to post (all setups, first setup, or first operation) and optionally opens the NC file when complete. It may offer to switch to the MANUFACTURE workspace.

Turning Workflow API Sample

Turning Workflow API Sample. This sample script starts by opening a simple component, which is then used to describe a basic turning workflow. It creates a setup and a few operations, picks tools from a Fusion sample tool library using loops and queries, and post-processes the operations using an NC program.

Version

Introduced in version April 2023