float_list : floatController point3_list : point3Controller position_list : positionController rotation_list : rotationController scale_list : scaleController
Value > MAXWrapper > Controllers > List Controllers |
The List controller combines multiple controllers into a single effect. It is a compound controller with tools for managing the order in which its internal controllers are calculated. Controllers are evaluated in a top to bottom order; the controller at the top of the list is evaluated first. The contribution of the single sub-controllers can be weighted allowing for animation mixing.
When you assign a List controller to a parameter, the current controller is moved one level below the List controller; it becomes the first controller in the list. A second parameter is added below the List controller and is named Available. This is an empty placeholder for the next controller you add to the list.
An array of the weight values of the sub-controllers.
Controls the averaging of the Weights.
The . available property has a controller property, which contains a "phantom" controller. To add a controller to a list controller, assign the controller to the available.controller property. The following script shows an example of creating and adding controllers to a list controller.
The property list for a list controller also contains the sub-controllers in the list controller (if any). The type of these controllers depends on the type of the list controller. For example, a float_list can contain any number of bezier_float controllers.
This property contains the number of items that appear in the List controllers list box.
Gets/Sets the index of the currently active item.
This method returns the number of items that appear in the List controllers list box.
This method allows you to set the indexed item in the list active, so its parameters appear in the motion panel and any input is directed to the indexed sub controller.
<index>listIndex: The index of the item to set as the active item.
This method returns the index of the currently active item.
This method allows you to delete the indexed sub controller from the list.
<index>listIndex: The index of the item to delete from the list.
This method allows you to cut the index sub controller from the list and stores it in the buffer to paste later.
<index>listIndex: The index of the item you wish to cut.
This method allows you to paste the sub-controller from the buffer into the indexed slot in the list.
<index>listIndex:The index of the slot to paste into.
This method returns the class name of the indexed sub-controller if a user defined name does not exist.
<index>listIndex:The index of the item for which to get the name.
This method allows you to set the name of an indexed item.
<index>listIndex :The index of the item.
<string>name:The name to set it to.
See also Class IlistControl in the SDK Help file accompanying this product.
The following methods were available in 3ds Max prior to version 4. They are still supported for backwards compatibility, but their functionality is covered by the new methods described above.
Returns the name of the indexed subcontroller in the list controller.
Sets the name of the indexed subcontroller in the list controller. If the string is a null string (""), the default controller name is used.
Returns the index of the active subcontroller in the list controller.
Sets the indexed subcontroller in the list controller as the active controller.