SaveKeyOnPath
v1.0
Adds a key on the path that constrains the given object.
A path ( an interpolated nurbs curve ) is created if one does not
already exist. Then a path constraint is applied between the given
objects and the new curve.
If a path constraint already exists, a position is added onto the
existing curve and a key is added on the path percentage property (
ObjectName.kine.PathCns.Percentage ) of the constraint at the given
time.
SaveKeyOnPath( [InputObj], [Time], [X], [Y], [Z], [Locked] ); |
| Parameter | Type | Description |
|---|---|---|
| InputObj | String | List of objects.
Default Value: Current selection |
| Time | Real Number | Frame at which the object is at new position on the curve
Default Value: Current frame |
| X | Real Number | X Position ( Global ) where the path will pass by
Default Value: current position |
| Y | Real Number | Y Position ( Global ) where the path will pass by
Default Value: current position |
| Z | Real Number | Z Position ( Global ) where the path will pass by
Default Value: current position |
| Locked | Boolean | True to position the key at an absolute length along the curve.
False to position the key a relative percentage along the curve.
Default Value: False |
set a = sigetprim("null", "a")
SaveKeyOnPath "a", 1, -3.093, 0.000, -0.773
SaveKeyOnPath "a", 25, 0.080, 0.000, -3.841, True
SaveKeyOnPath "a", 50 ,0.162, 3.680, -0.368
'As a result, the object "a" will be constrained and animated on a path with three positions.
'The object will pass through those points at the given time. Animation key are added to the path
'percentage paramater of the path constraint.
|