Custom Attributes

Use the Parameter Editor to assign custom attributes to objects, modifiers, materials, and animation tracks. A custom attribute is an additional, abstract parameter; abstract in the sense that it does not directly extend the functionality of the object by default. It affects an object only after wire parameters, reaction controllers, or expression controllers are set up to connect the custom attribute to another parameter in the scene. You can also use custom attributes to store job-specific notes and data.

Standard menu: Animation menu > Parameter Editor
Enhanced menu: Animation menu > Attributes > Parameter Editor
Keyboard > +1

Custom attributes behave like other object parameters in several ways:

They are saved and loaded in the scene file along with the object.
They can be animated and keyframed.
They are displayed in Track View along with the base parameters.

Each custom attribute parameter can be one of a number of different data types, including integers, floating numbers, Booleans, arrays, nodes, colors, and texture maps. Parameters added to an object or modifier appear on a Custom Attributes rollout on the Modify panel. For each custom attribute parameter you create, you can specify the name, layout, value range, default value, and UI type: spinner or slider for floats and integers, checkbox for Booleans, etc.

As you customize an attribute, the result is displayed on the Testing Attribute rollout at the bottom of the dialog.

Note: If an object with custom attributes is placed in a container, those attributes are retained in the inherited container. The inheritor of the container can unlock attribute values and edit them locally, but any locally added attributes to the same definition will be lost upon updating the container.

Custom Attributes Special Features

The Custom Attributes feature offers an array of workflow-enhancing functionality, including:

the ability to add custom attributes to specific animation tracks.
the ability to edit existing custom attributes.
13 available data types.
a variety of available UI options, such as ComboBox and ListBox for the Array data type.
the ability to position UI elements precisely with X and Y Offset controls.
the ability to preserve custom attributes when collapsing the stack.
A special Attribute Holder Modifier that lets you collect attributes from different entities and access them in one place on the Modify panel.

Procedures

To add a parameter to an object:

Select the object.
Choose Animation menu Parameter Editor. If using the Enhanced menu system, you'll find Parameter Editor on the Attributes panel of the Animation menu.
The Parameter Editor opens.
Change settings as desired.
Click Add.
The parameter is added to the level specified in the Add To Type list. If an object has no custom attributes, Parameter Editor first adds a Custom Attributes entry to the current Add To Type level, and then adds the parameter to the Custom Attributes entry. If an object has more than one Custom Attributes entry as a result of collapsing its stack, the parameter is added to the first Custom Attributes entry.

If a custom attribute parameter is assigned to an object or modifier, you can see and edit its value on the Modify panel after adding it by activating the entity to which the attribute is assigned. If the custom attribute is assigned to a material, it's available for that material in the Material Editor, on the Custom Attributes rollout. To access a parameter that's assigned to an animation track, open Track View, highlight the track's Custom Attributes entry, and then right-click and choose View Attribute Dialog.

To edit a parameter or custom attribute:

Select the object.
Open Parameter Editor.
From the Add To Type drop-down list, choose the type of parameter to edit, and then click Edit/Delete.
The Edit Attributes/Parameters dialog opens.

Note: If you chose Add To Type Picked Track, the Track View Pick dialog might open first to prompt you to choose the animation track whose attribute to edit.
In the Edit Attributes/Parameters dialog, highlight the parameter to edit.
Its settings appear in the Parameter Editor.
Change the settings in the Parameter editor, and then click Accept Parameter changes.
With multiple parameters or custom attributes, to change the ordering, click the entity to move, and then use the up and down arrow buttons to move the entity in the list. Moving a Custom Attributes entry also moves its parameters.
Note: You cannot rename a Custom Attributes entry.
When finished editing, click Apply Changes, and then exit the dialog by clicking the Close or Cancel button.

To delete a custom attribute or parameter:

Select the object.
Open the Parameter Editor.
From the Add To Type drop-down list, choose the type of parameter to delete, and then click Edit/Delete.
The Edit Attributes/Parameters dialog opens.

Note: If you chose Add To Type Picked Track, the Track View Pick dialog might open first to prompt you to choose the animation track from which to delete the attribute.
In the Edit Attributes/Parameters dialog, highlight the parameter to delete, and then click Delete Parameter. Alternatively, to delete all parameters under the same Custom Attributes heading as the highlighted parameter, click Delete All Parameters.
To delete one or more custom attributes instead, click a Custom Attributes heading, and then click Delete Attribute or Delete All Attributes. Multiple attributes can result from collapsing an object's stack with Preserve Custom Attributes on. For example, one set of custom attributes might be applied to an object and a second set of attributes assigned to one of its modifiers. Collapsing such an object results in two sets of custom attributes.
Click Apply Changes, and then close the dialog by clicking its Close box or the Cancel button.

Interface

The Parameter Editor takes the form of a dialog with three rollouts: The first rollout sets general options for the attribute; the central rollout sets options for the current parameter type; and the third lets you preview the attribute user interface (UI).

Attribute rollout

Add to Type group

Add to Type list: Choose whether the custom attribute is assigned to the selected object, its active modifier (as highlighted in the modifier stack), its material, or a picked track. Also use this drop-down list to choose the attribute type to delete or edit.
If the text “Pick Explicit Track” appears in the box below the drop-down list before you choose Picked Track, the Track View Pick dialog appears showing the Track View hierarchy. Expand the hierarchy as necessary, click the track to add the attribute to, and then click OK.

Note: If you choose Selected Object's Current Modifier and multiple modifiers are highlighted in the stack when you click Add, Parameter Editor applies the custom attribute to the first modifier you highlighted and removes the highlighting from the other modifiers.
Pick Explicit Track: Click this button to open a Track View hierarchy window from which to choose an animation track. Navigate the hierarchy to find the desired track, highlight the track, and then click OK. The controller information for the track then appears in the text box to the right of the button, and the Parameter Editor will then use this track for adding or editing custom attributes and parameters.

Add/Edit/Delete group

Add: Applies the custom attribute parameter to the current object, modifier, material, or track, depending on the current choice in the Add To Type list.
If a custom attribute parameter is assigned to an object or modifier, you can see and edit its value on the Modify panel after adding it by activating the entity to which the attribute is assigned. If the custom attribute is assigned to a material, it's available for that material in the Material Editor. To access a parameter that's assigned to an animation track, open Track View, highlight the track's Custom Attributes entry, and then right-click and choose View Attribute Dialog.
Edit/Delete: Opens the Edit Attributes/Parameters dialog.
This dialog displays a list of all of the custom attribute parameters assigned to the current object at the current level. Dialog behavior is described in these two procedures: To edit a parameter or custom attribute and To delete a custom attribute or parameter.

Parameter Type group

Parameter Type

Use the drop-down list to choose the data type for the current parameter. The following list includes links to the sections describing the UI settings for each parameter's data type:

Angle: Spinner or Slider
Array
Boolean: CheckBox or CheckButton
Color
Float: Spinner or Slider
fRGBA
Integer: Spinner or Slider
Material
Node
Percent: Spinner or Slider
String
TextureMap
WorldUnits: Spinner or Slider

UI Type group

UI Type

Selects the type of UI element that controls the parameter.

The UI types available depend on which parameter type you specify. For example, float and integer values are controlled by spinners or sliders, and Boolean values by checkboxes or check buttons. Array values are always controlled by drop-down lists, node values by pick buttons, color values by color pickers, and texture map values by map buttons.

Full descriptions of each UI Options rollout follow, and the list of parameter types, above, includes links to the respective UI Options rollout descriptions.

Name

The name of the parameter. Parameter Editor gives the parameter the default name Param#, with # being a number. Change the name by editing this field.

Angle/Float/Integer/Percent/WorldUnits UI Options rollout for spinners

These are the options for a standard spinner control that sets either a whole-number (integer) value or a real-number (angle, float, percent, World units) value.