ExposeTm : Helper

ExposeTm - Superclass:Helper;super-superclass:node - classID:#(-2071764533, -1858289533)

This Helper object can be used to extract position and rotation data from any scene nodes to be used as input for scripted controllers, wire controllers etc. It simplifies significantly the creation of custom animation rigs.

Constructor:

exposeTM...      
ExposeTransform ... 

Properties:

Display

<ExposeTm>.size: world units   

Get/Set the size of the helper in world units.

<ExposeTm>.centermarker(Center_Marker) : boolean 

When set to true, displays a small X marker at the center of the helper.

<ExposeTm>.axistripod(Axis_Tripod) : boolean 

When set to true, displays a tripod axis indicating the position and orientation of the helper. The axis remains visible when the helper is no longer selected.

<ExposeTm>.cross: boolean 

When set to true, displays an axis-aligned cross.

<ExposeTm>.box: boolean 

When set to true, displays a small box at the center of the helper.

<ExposeTm>.constantscreensize (Constant_Screen_Size) : boolean 

When set to true, keeps the size of the helper constant, regardless of how much you zoom in or out.

<ExposeTm>.drawontop (Draw_On_Top) : boolean 

When set to true, the helper object draws lines with the Z buffer turned off (which usually causes it to appear in front of other objects).

<ExposeTm>.displayExposedVals (Display_Exposed) : boolean 

When set to true, the exposed values will be displayed.

Exposed Nodes

<ExposeTm>.exposeNode (Expose_Node) : node 

Get/Set the node whose Transformations should be exposed.

<ExposeTm>.localReferenceNode (Local_Reference_Node) : node 

Get/Set the local reference node to be used for relative values calculation.

<ExposeTm>.useParent (Use_Parent_Ref) : boolean 

When set to true, the parent node of the *.exposeNode* will be used as the reference node. If there is no parent node, the World is the parent of the . *exposeNode* .

When set to false, the explicitly specified *.localReferenceNode* will be used as the reference node.

Rotation Options

<ExposeTm>.eulerXOrder (Euler_X_Order) : integer 
<ExposeTm>.eulerYOrder (Euler_Y_Order) : integer 
<ExposeTm>.eulerZOrder (Euler_Z_Order) : integer 
<ExposeTm>.stripNUScale (Strip_Non_Uniform_Scale) : boolean 

When set to true, non-uniform scale values will be stripped from the transformation matrix before the values are calculated. When set to false, non-uniform scaling will affect the exposed values.

Local and World Euler Rotation

<ExposeTm>.localEuler (Local_Euler_Rotation) : point3 

Returns the local rotation as Point3 Euler Angles value.

<ExposeTm>.localEulerX (Local_Euler_X) : angle 

Returns the local Euler X rotation value.

<ExposeTm>.localEulerY (Local_Euler_Y) : angle 

Returns the local Euler Y rotation value.

<ExposeTm>.localEulerZ (Local_Euler_Z) : angle 

Returns the local Euler Z rotation value.

<ExposeTm>.worldEuler (World_Euler_Rotation) : point3 

Returns the world rotation as Point3 Euler Angles value.

<ExposeTm>.worldEulerX (World_Euler_X) : angle 

Returns the world Euler X rotation value.

<ExposeTm>.worldEulerY (World_Euler_Y) : angle 

Returns the world Euler Y rotation value.

<ExposeTm>.worldEulerZ (World_Euler_Z) : angle 

Returns the world Euler Z rotation value.

Local and World Position

<ExposeTm>.localPosition (Local_Position) : point3 

Returns the local position as Point3 value.

<ExposeTm>.localPositionX (Local_Position_X) : world units 

Returns the X component of the local position.

<ExposeTm>.localpositionY (Local_Position_Y) : world units 

Returns the Y component of the local position.

<ExposeTm>.localPositionZ (Local_Position_Z) : world units 

Returns the Z component of the local position.

<ExposeTm>.worldPosition (World_Position) : point3 

Returns the world position as Point3 value.

<ExposeTm>.worldPositionX (World_Position_X) : world units 

Returns the X component of the world position.

<ExposeTm>.worldPositionY (World_Position_Y) : world units 

Returns the Y component of the world position.

<ExposeTm>.worldPositionZ (World_Position_Z) : world units 

Returns the Z component of the world position.

Bounding Box

<ExposeTm>.worldBoundingBoxSize (World_Bounding_Box_Size) : point3 

Returns the size of the world-oriented bounding box as a Point3 value.

<ExposeTm>.worldBoundingBoxWidth (World_Bounding_Box_Width) : float 

Returns the X component of the size of the world-oriented bounding box.

<ExposeTm>.worldBoundingBoxLength (World_Bounding_Box_Length) : float 

Returns the Y component of the size of the world-oriented bounding box.

<ExposeTm>.worldBoundingBoxHeight (World_Bounding_Box_Height) : float 

Returns the Z component of the size of the world-oriented bounding box.

Timing

<ExposeTm>.timeOffset (Time_Offset) : time 

Get/Set the time offset value. When the *.useTimeOff set* property is set to true, the values returned by the ExposeTM Helper will be calculated at a time which is offset from the current time by the *.timeOffset* value.

<ExposeTm>.useTimeOffset (Use_Time_Offset) : boolean 

Enable/Disable the use of the *.timeOffset* value.

Distance and Angle

<ExposeTm>.distance: float 

Returns the distance to the Reference node.If the reference node is set to Parent and there is no parent, this effectively returns the distance to the World origin.

<ExposeTm>.angle: angle 

Returns the angle.