In this section we give a short explanation of concepts commonly used in the CmSym API.
Table of Content
- Sym graph
- Shared node
- Local bound
- Local node coordinates
- Node coordinates
- Anchor node
- Anchor coordinates
A sym graph refers to a graph created by one ore more SymNode(s).
A node that has multiple parents.
A sequence of “.” separated node ids forming a way down the sym graph. For instance, in “a.b.c” node “a” is the parent of node “b” and the grand parent of node “c”.
The descendants of a node refer to all nodes below that node. In other words it refers to the node’s children, grandchildren, great grandchildren etc.
The ascendants of a node refer to all nodes above that node. In other words it refers to the node’s parents, grandparents, great grandparents etc.
Refers to SymMesh, SymShape and primitive components.
Refers to SymBox, SymCylinder, SymCone and SymSphere.
The bound of a node before the (potential) transform of the node has been applied. The local bound of a node includes the bound its descendants.
The bound of the node after the (potential) transform of the node has been applied. The bound of a node includes the bound of its descendants.
Local node coordinates
Local node coordinates or just local coordinates refers to coordinates defined in the coordinate system for a node before the transform on the node has been applied.
Refers to coordinates defined in the coordinate system for a node after the transform on the node has been applied.
The first node in the node sequence defined by a SymHandle.
Refers to node coordinates for the anchor node of a handle.
The further away an object is from the view point the smaller it gets on screen making it harder to perceive details. This is something rendering applications can take advantage of in order to boost performance. This is generally achieved by switching between differently detailed representations of the same object. The different representations can be referred to as LODs (level of detail). The CmSym API uses a component called SymReps to define LODs and in what context they should be rendered.
Stands for external reference and refers to a file that is referred from a sym graph or from another file.
Dex, data exchange format, is a graphics file format API developed at Configura. One of the major benefits with Dex based file is that it allow us to read small parts of data at a time, opposed to reading a complete file at once. CmSym files is built on top of Dex meaning that all data in a CmSym file is streamed using the Dex API.