3D Lingo Dictionary > E-K > getWorldTransform()

 

getWorldTransform()

Syntax

member(whichCastmember).node(whichNode).getWorldTransform()
member(whichCastmember).node(whichNode).getWorldTransform().position
member(whichCastmember).node(whichNode).getWorldTransform().rotation
member(whichCastmember).node(whichNode).getWorldTransform().scale

Description

3D command; returns the world-relative transform of the model, group, camera, or light represented by node.

The transform property of a node is calculated relative to the transform of the node's parent, and is therefore parent-relative. The getWorldTransform() command calculates the node's transform relative to the origin of the 3D world, and is therefore world-relative.

Use member(whichCastmember).node(whichNode).getWorldTransform().position to find the position property of the node's world-relative transform. You can also use worldPosition as a shortcut for getWorldTransform().position.

Use member(whichCastmember).node(whichNode).getWorldTransform().rotation to find the rotation property of the node's world-relative transform.

Use member(whichCastmember).node(whichNode).getWorldTransform().scale to find the scale property of the node's world-relative transform.

These properties can be tested but not set.

Example

This statement shows the world-relative transform of the model named Box, followed by its position and rotation properties.

put member("3d world").model("Box").getworldTransform()
-- transform(1.000000,0.000000,0.000000,0.000000, 0.000000,1.000000,0.000000,0.000000, 0.000000,0.000000,1.000000,0.000000, -94.144844,119.012825,0.000000,1.000000)
put member("3d world").model("Box"). getworldTransform().position
-- vector(-94.1448, 119.0128, 0.0000)
put member("3d world").model("Box"). getworldTransform().rotation
--vector(0.0000, 0.0000, 0.0000)

See also

worldPosition, transform (property)