# Entity Reference

Creates and accesses references to other PRC entities.

> 2.0

Entity type is `kA3DTypeMiscEntityReference`.

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 Entitiesand Referenceable Topological Entities.

Returns

> `A3D_SUCCESS`on success, or an error code on failure

Topics

- Reference on Topology/Tessellation
- Referenceable Non-Topological Entities
- Referenceable Topological Entities
- Reference on coordinate system subcomponent

Structures

- `A3DMiscEntityReferenceData`

Functions

- `A3DMiscEntityReferenceGet()`
- `A3DMiscEntityReferenceCreate()`
- `A3DMiscEntityReferenceSet()`

Conversation saved
HOOPSY BETA

### Hello! I'm HOOPSY

Your multilingual generative AI assistant for documentation. Ask me anything about HOOPS Exchange in your own language, or choose a sample question below to start a conversation:

What is HOOPS Exchange?
What are the latest release notes for HOOPS Exchange?
How do I start evaluating HOOPS Exchange?
How do I write my first sample application?
How can I get assistance?

HOOPSY may store conversations according to OpenAI's policy. Responses may not always be accurate.

HOOPSY is thinking...