Entity Reference

Parent module: Miscellaneous Module

group a3d_entity_reference

Creates and accesses references to other PRC entities.

Entity type is kA3DTypeMiscEntityReference.

Version

2.0

An A3DMiscEntityReference references an entity containing structure data, representation items, topology data, markup data or scene display data. All of these entities can be referenced from other entities. For example, the A3DAsmProductOccurrence entity (Product Occurrence) can include an A3DMiscEntityReference entity that references another product occurrence. In another example, an A3DAsmFilter entity (Filter Module) can include an entity filter for which multiple A3DMiscEntityReference entities specify the entities to be inclusively or exclusively filtered.

The A3DMiscEntityReference can supply modifiers that affect the referenced entity nominal definition. All entity references can include a coordinate system, which is applied to the referenced item. Topology entity references can also include global index items, such as color and texture.

To create references for non-topological entities listed in Referenceable Non-Topological Entities, perform these steps:

  1. Create an A3DMiscEntityReferenceData structure that references the non-topological entity.

  2. Set the coordinate system transformation in the A3DMiscEntityReferenceData structure as needed.

  3. Create an A3DMiscEntityReference that references the A3DMiscEntityReferenceData structure.

To create references for topological entities listed in Referenceable Topological Entities, perform these steps:

  1. Create an A3DMiscReferenceOnTopologyData structure that references the topological entity.

  2. Set global index items in the A3DMiscReferenceOnTopologyData structure as needed.

  3. Create an A3DMiscReferenceOnTopology entity, providing the A3DMiscReferenceOnTopologyData structure.

  4. Create an A3DMiscEntityReferenceData structure that references the A3DMiscReferenceOnTopology entity.

  5. Set the coordinate system transformation in the A3DMiscEntityReferenceData structure as needed.

  6. Create an A3DMiscEntityReference that references the A3DMiscEntityReferenceData structure.

See the referenceable types in the modules Referenceable Non-Topological Entities and Referenceable Topological Entities.

Sub-modules

Reference on Topology/Tessellation

Creates and accesses entities that reference topology entities and that specify globally-defined attributes.

Referenceable Non-Topological Entities

Listing of the non-topological entities that can be referenced from the A3DMiscEntityReference .

Referenceable Topological Entities

Listing of the topological entities that can be referenced from the A3DMiscReferenceOnTopology entity.

Reference on coordinate system subcomponent

Creates and accesses entities that reference coordinate system subcomponent.

Data Structures

A3DMiscEntityReferenceData

Structure that identifies the referenced entity and that provides a new coordinate system.

Functions

A3DMiscEntityReferenceGet()

Populates the A3DMiscEntityReferenceData structure.

A3DMiscEntityReferenceCreate()

Creates an A3DMiscEntityReference from an A3DMiscEntityReferenceData structure.

A3DMiscEntityReferenceSet()

Function to set the entity reference from A3DMiscEntityReferenceData structure in a previously created object.