Skip to main content

Interface: ElementLocation

Extended element location data that supports both Euler angles and quaternions

Properties

dimensions?

optional dimensions: Vector3


position?

optional position: Nullable<Vector3>

3D position of the product in the scene.

This property defines where the product is located in 3D space, specified as X, Y, and Z coordinates. For free-moving products, this position can be directly set. For connected products, the position may be determined by their connections.

A null value indicates the product uses automatic positioning based on its connections to other products.


quaternion?

optional quaternion: Nullable<Quaternion>

Precise 3D rotation of the product represented as a quaternion.

This property defines the product's orientation using quaternion representation (x, y, z, w components), which provides more accurate and gimbal-lock-free rotation compared to Euler angles (rotation property). This precision is especially important for complex multi-axis connections between products.

Quaternions ensure rotation fidelity is maintained when saving and loading configurations, particularly for products positioned using advanced snapping methods. When present, this value takes precedence over the rotation property during scene restoration.

A null value indicates the product uses either Euler-based rotation or automatic rotation derived from its connections to other products.


rotation?

optional rotation: Nullable<Vector3>

3D rotation of the product in the scene.

This property defines how the product is rotated in 3D space, specified as rotation angles around the X, Y, and Z axes. Proper rotation ensures products face the right direction and align correctly with other components.

A null value indicates the product uses automatic rotation based on its connections to other products.