Adobe ATMOSPHERE User Manual page 338

326
APPENDIX E
Note that within a Viewpoint scene, the 'Z' coordinate is reversed for position. Therefore, if a Viewpoint scene
contains multiple instances, moving those instances relative to each other will require using an inverted Z value as
compared to the normal Atmosphere coordinate system.
Properties
type
Returns the string 'ViewpointObject' for this object.
if (object.type == 'ViewpointObject') { ... }
position
The object position as an array of three values [ X, Y, Z ].
viewpointObject.position = [ 5, 2, 12 ];
orientation
The object orientation in radians as a Rotation object.
viewpointObject.orientation = Rotation('X', 1.2);
transform
The object transform representing the combined position and orientation values.
// Set by creating a Transform explicitly
viewpointObject.transform = Transform([8.0, 8.0, -20.0],
// Set equal to another Transform
viewpointObject.transform = anchorPoint1.Transform;
worldSpacePosition
The worldSpacePosition of the object as a Vector.
// set the worldSpacePosition of the object to a known anchor
myObject.worldSpacePosition = myAnchor3.worldSpacePosition;
worldSpaceOrientation
The worldSpaceOrientation of the object (as a Rotation).
// set the worldSpaceOrientation of the object to a known anchor
myObject.worldSpaceOrientation = myAnchor3.worldSpaceOrientation;
worldSpaceTransform
The worldSpaceTransform is the combined worldSpacePosition and worldSpaceOrientation of the object.
// set the worldSpaceTransform of the object to a known anchor
myObject.worldSpaceTransform = myAnchor3.worldSpaceTransform;
Rotation('XYZ', 1.57, 1.57, 1.57));