PMIImportedDimensions.itemsByEntities Method

Parent Object: PMIImportedDimensions

PreviewThis functionality is provided as a preview of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the Fusion API and Scripts forum.

Because this is a preview of future functionality, there is the possibility that it will change, which will possibly break any existing programs that use this functionality. Because of that, you should never deliver any programs that use any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.


Defined in namespace "adsk::fusion" and the header file is <Fusion/PMI/PMIImportedDimensions.h>

Description

Gets all the PMIImportedDimension from the collection that are associated with the specified geometric entities and optionally match the specified PMI types.

This is useful for finding PMIImportedDimension that reference specific geometric features.

Syntax

"pMIImportedDimensions_var" is a variable referencing a PMIImportedDimensions object.
# Uses no optional arguments.
returnValue = pMIImportedDimensions_var.itemsByEntities(entities)

# Uses optional arguments.
returnValue = pMIImportedDimensions_var.itemsByEntities(entities, types)
"pMIImportedDimensions_var" is a variable referencing a PMIImportedDimensions object.

#include <Fusion/PMI/PMIImportedDimensions.h>

// Uses no optional arguments.
returnValue = pMIImportedDimensions_var->itemsByEntities(entities);

// Uses optional arguments.
returnValue = pMIImportedDimensions_var->itemsByEntities(entities, types);

Return Value

Type Description
PMIImportedDimension[] Returns an array of PMIImportedDimension objects that are associated with the specified entities and match the type filter (if provided) or an empty array if no matching PMI were found.

Parameters

Name Type Description
entities Base[] An array of core.Base objects that represent the geometric entities to search for associated PMI. These can be BRepFace, BRepEdge or BRepVertex objects. The function will return the PMIImportedDimension that references any of these entities in their geometric associations.

For example, a Diameter Dimension PMI associated with a cylindrical face.
types integer[] An optional array of PMITypes that filters the results to include only PMI that matches the type presented in the specified types. If an empty array or null is passed, all the PMIImportedDimension associated with the specified geometric entities will be returned, regardless of type.

This is an optional argument whose default value is null.

Version

Introduced in version April 2026