3D Lingo Dictionary > L-N > lockTranslation

 

lockTranslation

Syntax

member(whichCastmember).model(whichModel).bonesPlayer.lockTranslation
member(whichCastmember).model(whichModel).keyframePlayer.lockTranslation

Description

3D #bonesPlayer and #keyframePlayer modifier property; prevents displacement from the specified plane(s) except by the absolute translation of the motion data. Any additional translation introduced either manually or through cumulative error is removed. The possible values of #none, #x, #y, #z, #xy, #yz, #xz, and #all control which of the three translational components are controlled for each frame. When a lock on an axis is turned on, the current displacement along that axis is stored and used thereafter as the fixed displacement to which the animation is relative. This displacement can be reset by deactivating that axis lock, moving the object, and reactivating that axis lock.

In other words, it defines the axis of translation to ignore when playing back a motion. To keep a model locked to a ground plane with the top pointing along the Z axis, set lockTranslation to #z. The default value for this property is #none.

Example

This statement sets the lockTranslation property of the model named Walker to #z.

member("ParkScene").model("Walker").bonesPlayer.lockTranslation = #z

See also

immovable