MaterialLibraries.itemById Method

Parent Object: MaterialLibraries
Defined in namespace "adsk::core" and the header file is <Core/Materials/MaterialLibraries.h>

Description

Returns the Material Library at the specified ID.

Syntax

"materialLibraries_var" is a variable referencing a MaterialLibraries object.
returnValue = materialLibraries_var.itemById(id)
"materialLibraries_var" is a variable referencing a MaterialLibraries object.

#include <Core/Materials/MaterialLibraries.h>

returnValue = materialLibraries_var->itemById(id);

Return Value

Type Description
MaterialLibrary Returns the specified material library or null if there's no match on the ID.

Parameters

Name Type Description
id string The ID of the library to return.

Samples

Name Description
Avoid Machine Surface Settings API Sample

This sample script demonstrates how to use Machine/Avoid/Gouge/Fixture functionality.

The script starts by opening a sample model from the CAM Samples folder via its URN. The model comprises a curved surface with a through slot, a countersunk hole and a raised, circular and filleted upstand from the surface. The model is supported by two rectangular blocks, themselves mounted on a fixture plate. A setup is included with a single operation running a 3-axis diagonal raster over the model, supports and fixture. The operation machines the fixture, the supporting blocks, the upper surface of the upstand and the area within the slot and hole, something we would like to avoid.

The script duplicates the original operation and then proceeds to create a series of MachineAvoidGroups. These are labelled as either Machine in the case of 2 cap surfaces for the slot and hole, Fixture for the fixture plate, Gouge for the supporting blocks and Avoid for the top face of the upstand. Additionally, both AxialOffset and RadialOffset can be specified for the Machine, Avoid and Fixture passes.

Create Engravings Selection Sets API Sample

This sample script demonstrates how to find and machine engravings in the Z+ direction using pocket recognition.

The script will first open an example model via its URN. Using pocket recognition, it will identify pockets that may be engravings based on their dimensions.

We assume here that an engraving pocket is:

  • Made with a flat bottom face and no fillet.
  • A closed pocket.
  • Have a Z height less than 2 mm

We demonstrate creating selection sets in both design and manufacture workspaces and use one of the selection sets as an operation geometry selection input to generate an engraving operation.

The engraving toolpath can be seen by expanding the setup and selecting the operation.

Version

Introduced in version August 2014