Interface: AnimLayerManager

new.gif NEW in 3ds Max 9: This Interface exposes the Animation Layer Manager to MAXScript.

Properties:

.filterActiveOnly : bool : Read|Write

Get/Set the state of the Filter Active Only option.

.justUpToActive : bool : Read|Write

Get/Set the state of the Just Up To Active option.

Methods:

showAnimLayersManagerToolbar show

Show/hide the Animation Layers Manager toolbar. When the argument is true, the toolbar will be displayed. When the argument is false, the toolbar will be hidden.

For Example:

AnimLayerManager.showAnimLayersManagerToolbar true --show the toolbar

AnimLayerManager.showAnimLayersManagerToolbar false --hide the toolbar

?

enableLayersDlg <&node array>nodes

nodes is In and Out parameter

Shows the Enable Anim Layers dialog for the specified objects.

enableLayers <&node array>nodes pos: rot: scale: ik: object: customAtt: mod: mat: other:

nodes is In and Out parameter

pos default value: true

rot default value: true

scale default value: true

ik default value: false

object default value: false

customAtt default value: false

mod default value: false

mat default value: false

other default value: false

Enables the Animation Layers for the specified objects without user interaction via the Enable Anim Layers dialog. The optional keyword parameters can be used to enable or disable animation layers for the given track types.

canEnableLayer anim client subNum

Returns true if the Animation Layer can be enabled for the specified object and track, false otherwise.

enableLayer anim client subNum

Enables the Animation Layer for the specified object and track. Returns true on success, false on failure.

getLayerCount()

Returns the number of layers.

getNodesLayers <&node array>nodes

nodes is In and Out parameter

Returns an array of indices representing the layers used by the specified nodes.

setLayerActive listIndex

listIndex Validated by Validator function

Sets the indexed layer as the current layer.

setLayerActiveNodes listIndex <&node array>nodes

listIndex Validated by Validator function

nodes is In and Out parameter

Sets the active nodes for the indexed layer to the by-reference array of nodes.

getActiveLayersNodes <&node array>nodes

nodes is In and Out parameter

Writes the active layers nodes into the by-reference array of nodes. Returns an array of layer indices.

getNodesActiveLayer <&node array>nodes

nodes is In and Out parameter

Returns the nodes using the active layer into the by-reference array of nodes.

addLayer <&TSTR>name <&node array>nodes useActiveControllerType

name is In and Out parameter

nodes is In and Out parameter

Adds a layer with the given name to the nodes specified by the second argument. The third argument controls whether to use the active controller type.

addLayerDlg <&node array>nodes

nodes is In and Out parameter

Opens the Add Layer dialog.

deleteLayer listIndex

listIndex Validated by Validator function

Deletes the indexed Animation Layer.

deleteLayerNodes listIndex <&node array>nodes

listIndex Validated by Validator function

nodes is In and Out parameter

Deletes the indexed Animation Layer from the specified scene nodes.

copyLayerNodes listIndex <&node array>nodes

listIndex Validated by Validator function

nodes is In and Out parameter

Copies the indexed Animation Layer from the specified scene nodes.

pasteLayerNodes listIndex <&node array>nodes

listIndex Validated by Validator function

nodes is In and Out parameter

Pastes the copied Animation Layer into the specified scene nodes at the indexed position.

getLayerName listIndex

listIndex Validated by Validator function

Returns the name of the indexed Animation Layer.

setLayerName listIndex name

listIndex Validated by Validator function

Sets the name of the indexed Animation Layer to the given string.

getLayerWeight listIndex

listIndex Validated by Validator function

Returns the weight of the indexed Animation Layer.

setLayerWeight listIndex

listIndex Validated by Validator function

Sets the weight of the indexed Animation Layer to the given value.

getLayerMute listIndex

listIndex Validated by Validator function

Returns the Mute state of the indexed Animation Layer as a boolean value.

setLayerMute listIndex mute

listIndex Validated by Validator function

Sets the Mute state of the indexed Animation Layer to the given boolean value.

getLayerOutputMute listIndex

listIndex Validated by Validator function

Returns the Output Mute state of the indexed Animation Layer as a boolean value.

setLayerOutputMute listIndex mute

listIndex Validated by Validator function

Sets the Output Mute state of the indexed Animation Layer to the given boolean value.

collapseLayerNodes listIndex <&node array>nodes

listIndex Validated by Validator function

nodes is In and Out parameter

Collapses the indexed Animation Layer of the given scene nodes.

disableLayerNodes <&node array>nodes

nodes is In and Out parameter

Disables the Animation Layers of the given scene nodes.

animLayerPropertiesDlg()

Opens the Layer Properties dialog.

SetCollapseControllerType controllerType

controllerType enums: {#Bezier|#Linear|#Default}

Sets the Controller Type to collapse to. Corresponds to the radio buttons in the Layer Properties dialog.

GetCollapseControllerType()

GetCollapseControllerType enums: {#Bezier|#Linear|#Default

Returns the Controller Type to collapse to. Corresponds to the radio buttons in the Layer Properties dialog.

SetCollapsePerFrame keyable

Sets whether to collapse to keys only when possible (false) or to keys per frame (true). Note that this value is the inverse of the checkbox' state in the Layer Properties dialog.

GetCollapsePerFrame()

Returns whether to collapse to keys only when possible (false) or to keys per frame (true). Note that this value is the inverse of the checkbox' state in the Layer Properties dialog.

SetCollapsePerFrameActiveRange activeRange

Sets whether to collapse the active range (true) or the user-defined range (false). Corresponds to the radio buttons in the Layer Properties dialog > Per Frame Collapse Range.

GetCollapsePerFrameActiveRange()

Get whether to collapse the active range (true) or the user-defined range (false). Corresponds to the radio buttons in the Layer Properties dialog > Per Frame Collapse Range.

SetCollapseRange range

Sets the Collapse Range to the given interval value. Corresponds to the value spinners in the Layer Properties dialog > Per Frame Collapse Range.

GetCollapseRange()

Returns the Collapse Range interval value. Corresponds to the value spinners in the Layer Properties dialog > Per Frame Collapse Range.