Introduced
1.0
Description
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.
Scripting Syntax
SaveKeyOnPath( [InputObj], [Time], [X], [Y], [Z], [Locked] )
Parameters
|
Parameter |
Type |
Description |
|
InputObj |
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 |
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 |
Examples
VBScript Example
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.Autodesk Softimage v7.5