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`