AddAnimationLayer

Introduced

6.0

Description

Creates a new animation layer above the current animation layer and makes it the current animation layer for the specified objects.

Scripting Syntax

AddAnimationLayer( [InputObjs], [Name], [MakeCurrent] )

Parameters

Parameter

Type

Description

InputObjs

String

List of objects.

Default Value: Currently selected objects

Name

String

Name for the new layer.

MakeCurrent

Boolean

Make the new layer the current animation layer

Default Value: True

Examples

VBScript Example

' 
' In this example, an FCurve is created on the XPos param
' of the sphere. Then, two keys are created (at frame 1,
' XPos = -2; at frame 30, XPos = 5). A layer is then added
' to adjust the end frame position. (frame 30, XPos = 8)
'

NewScene
CreatePrim "Sphere", "NurbsSurface", "MySphere"
' Add a posx fcurve
AddFCurve "MySphere.kine.local.posx"

' Add two keys, at frame 1 and 30
SaveKey "MySphere.kine.local.posx", 1, -2 
SaveKey "MySphere.kine.local.posx", 30, 5 

' Create a new animation layer and make it current
AddAnimationLayer

' Add two layer keys, at frame 1 and 30
SaveKey "MySphere.kine.local.posx", 1, 0 
SaveKey "MySphere.kine.local.posx", 30, 3 

' Set back to layer 0
SetCurrentAnimationLayer ,0

' Play the animation
PlayForwardsFromStart

See Also

SetCurrentAnimationLayer

GetCurrentAnimationLayer

GetNumberOfAnimationLayers

DeleteAnimationLayer

DuplicateAnimationLayer

RemoveAnimation

RemoveAllAnimation

SaveKey

RemoveKey

PrevKey

FirstKey

LastKey

Parameter.AddFCurve

 

 

 



Autodesk Softimage v7.5