v1.0

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

VBScript Example

'

' 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

RemoveAllCns RemoveCns SIApplyCns