DeleteAnimationLayer

Introduced

v6.0

Description

Deletes specified animation layer.

Note: A value of 0 for the layer will be ignored because the base animation cannot be removed with this command.

Scripting Syntax

DeleteAnimationLayer( [InputObjs], [Layer] );

Parameters

Parameter Type Description
InputObjs String List of objects.

Default Value: Currently selected objects

Layer Long Animation layer to remove. Only layers greater than 0 can be removed.

Default Value: Current animation layer (-1)

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

' and removed.

'

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 

' Delete animation layer

DeleteAnimationLayer

' Play the animation

PlayForwardsFromStart

See Also

SetCurrentAnimationLayer GetCurrentAnimationLayer GetNumberOfAnimationLayers AddAnimationLayer RemoveAnimation RemoveAllAnimation SaveKey RemoveKey PrevKey FirstKey LastKey Parameter.AddFCurve