v1.0
animation constraint
Constrains an object so that it follows the path of a curve.
This is the scripting equivalent of choosing Animate > Create
> Path > Set Path for an object. A picking session is started
if no constraining curve is specified.
You can also set the path percentage, which controls the location
of the constrained object over the length of the curve. At zero
percent the object is at the beginning of the curve, and at 100% it
is at 100% of the length of the curve. By default the constrained
object is animated to travel the entire path between the given
start and end frames.
ApplyPath( [InputObjs], [Path], [StartFrame], [EndFrame], [NbKeys], [Linear], [Tangent] ); |
| Parameter | Type | Description |
|---|---|---|
| InputObjs | String | List of objects to put on a
path.
Default Value: Selected objects |
| Path | String | Curve to use as the path
Default Value: User is prompted to pick a curve |
| StartFrame | Double | Start frame for path animation
Default Value: 0 |
| EndFrame | Double | End frame for path animation
Default Value: 0 |
| NbKeys | Long | Number of keys to set on the timing curve
Default Value: 2 |
| Linear | Boolean | True for a linear fcurve, False for a spline fcurve.
Default Value: False |
| Tangent | Boolean | True to set a tangency constraint on the object.
Default Value: False |
'
' Applies a circular path to two cubes.
' One cube travels tangent to the path the other does not.
' The cubes travel in opposite directions.
'
dim oCircle,oCube1,oCube2
'
' Setup: create the circle and cubes
'
set oCircle = CreatePrim("Circle", "NurbsCurve")
oCircle.radius = 3
Rotate oCircle, -90, 0, 0, siRelative, siAdd, siObj, siXYZ
set oCube1 = CreatePrim("Cube", "MeshSurface")
set oCube2 = CreatePrim("Cube", "MeshSurface")
oCube1.length = 1
Scale oCube1, 2.5, 0.3, 0.3, siRelative, siLocal, siObj, siXYZ
oCube2.length = 1
Scale oCube2, 2.5, 0.3, 0.3, siRelative, siLocal, siObj, siXYZ
'
' Apply the paths to the cubes.
' Make oCube2 travel tangent to the path.
' By swapping the start and end frames, oCube2 will travel in the opposite direction.
'
ApplyPath oCube1, oCircle, 1, 100, 2, False, False
ApplyPath oCube2, oCircle, 100, 1, 2, False, True
'
' Display the path constraint relation in the top
' view of viewport A
'
SetValue "Views.ViewA.TopCamera.camvis.*constraint*", True
'
' Play the animation
'
PlayForwardsFromStart
|