Murl Engine Lua Addon API  Version 1.0 beta
Murl.Graph.IResetTransform

The IResetTransform graph node interface.

Nodes implementing this interface can be used to reset the position and/or rotation component of the currently active combined transform on the transform stack. This can be useful if e.g. a camera is attached to a moving object, but should always look in a specific direction regardless of the object's actual orientation. In such a case, an IResetTransform node can be inserted below the object and above the camera, with calling SetAffectTranslationEnabled(false) to retain the object's position, and SetAffectRotationEnabled(true) to reset its rotation to the identity 3x3 matrix.

Note, that like all other transform nodes, the effect is limited to this node's children; all siblings of this node are not affected.


Table members

Methods


GetNodeInterface()

Get the constant Graph::INode interface. This method returns a constant pointer to the node's Graph::INode interface, to be able to query common node properties such as active state, visibility or ID.

Murl.Graph.INode GetNodeInterface()

Returns
Murl.Graph.INode The constant Graph::INode interface, or null if not available

SetAffectRotationEnabled(enabled)

Enable/disable resetting of the current world rotation.

Boolean SetAffectRotationEnabled(Boolean enabled)

Parameters
enabledIf true, the rotation part of the current world transform is reset to the 3x3 identity matrix.
Returns
Boolean true if successful.

IsAffectRotationEnabled()

Check if resetting of the current world rotation is enabled.

Boolean IsAffectRotationEnabled()

Returns
Boolean true if enabled.

SetAffectTranslationEnabled(enabled)

Enable/disable resetting of the current world translation.

Boolean SetAffectTranslationEnabled(Boolean enabled)

Parameters
enabledIf true, the translation part of the current world transform is reset to the zero position vector.
Returns
Boolean true if successful.

IsAffectTranslationEnabled()

Check if resetting of the current world translation is enabled.

Boolean IsAffectTranslationEnabled()

Returns
Boolean true if enabled.

SetAffectDepthOrderEnabled(enabled)

Enable/disable resetting of the current depth order.

Boolean SetAffectDepthOrderEnabled(Boolean enabled)

Parameters
enabledIf true, the depth order is reset to zero.
Returns
Boolean true if successful.

IsAffectDepthOrderEnabled()

Check if resetting of the current depth order is enabled.

Boolean IsAffectDepthOrderEnabled()

Returns
Boolean true if enabled.