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:

<void>showAnimLayersManagerToolbar <bool>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

 

<integer>enableLayersDlg <&node array>nodes

nodes is In and Out parameter

Shows the Enable Anim Layers dialog for the specified objects.

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

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.

<boolean>canEnableLayer <maxObject>anim <maxObject>client <index>subNum

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

<boolean>enableLayer <maxObject>anim <maxObject>client <index>subNum

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

<index>getLayerCount()

Returns the number of layers.

<index array>getNodesLayers <&node array>nodes

nodes is In and Out parameter

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

<void>setLayerActive <index>listIndex

listIndex Validated by Validator function

Sets the indexed layer as the current layer.

<void>setLayerActiveNodes <index>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.

<index array>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.

<void>getNodesActiveLayer <&node array>nodes

nodes is In and Out parameter

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

<void>addLayer <&TSTR>name <&node array>nodes <bool>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.

<void>addLayerDlg <&node array>nodes

nodes is In and Out parameter

Opens the Add Layer dialog.

<void>deleteLayer <index>listIndex

listIndex Validated by Validator function

Deletes the indexed Animation Layer.

<void>deleteLayerNodes <index>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.

<void>copyLayerNodes <index>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.

<void>pasteLayerNodes <index>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.

<TSTR by value>getLayerName <index>listIndex

listIndex Validated by Validator function

Returns the name of the indexed Animation Layer.

<void>setLayerName <index>listIndex <TSTR by value>name

listIndex Validated by Validator function

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

<float>getLayerWeight <index>listIndex <time>atTime

listIndex Validated by Validator function

Returns the weight of the indexed Animation Layer.

<void>setLayerWeight <index>listIndex <time>atTime <float>weight

listIndex Validated by Validator function

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

<bool>getLayerMute <index>listIndex

listIndex Validated by Validator function

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

<void>setLayerMute <index>listIndex <bool>mute

listIndex Validated by Validator function

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

<bool>getLayerOutputMute <index>listIndex

listIndex Validated by Validator function

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

<void>setLayerOutputMute <index>listIndex <bool>mute

listIndex Validated by Validator function

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

<void>collapseLayerNodes <index>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.

<void>disableLayerNodes <&node array>nodes

nodes is In and Out parameter

Disables the Animation Layers of the given scene nodes.

<void>animLayerPropertiesDlg()

Opens the Layer Properties dialog.

<void>SetCollapseControllerType <enum>controllerType

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

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

<enum>GetCollapseControllerType()

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

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

<void>SetCollapsePerFrame <bool>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.

<bool>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.

<void>SetCollapsePerFrameActiveRange <bool>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.

<bool>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.

<void>SetCollapseRange <interval>range

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

<interval>GetCollapseRange()

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