Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.

Synopsis

aliasAttr [-remove]

aliasAttr is undoable, queryable, and editable.

Allows aliases (alternate names) to be defined for any attribute of a specified node. When an attribute is aliased, the alias will be used by the system to display information about the attribute. The user may, however, freely use either the alias or the original name of the attribute. Only a single alias can be specified for an attribute so setting an alias on an already-aliased attribute destroys the old alias.

Return value

string[] in query mode.

In query mode, return type is based on queried flag.

Keywords

dg, dependency, graph, alias, attribute, name

Related

addAttr, attributeInfo, connectAttr, deleteAttr, disconnectAttr, getAttr, getClassification, nodeType, objExists, objectType, renameAttr, setAttr

Flags

remove
Long name (short name) Argument types Properties
-remove(-rm) create
Specifies that aliases listed should be removed (otherwise new aliases are added).

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

createNode blendShape -n blender;
//
// Define intuitive names for the weights of a blendShape.
// The blendShape command does this automatically to allow you
// to refer to the weight corresponding to a target shape by the name
// of that shape.
//
aliasAttr smile blender.w[0] frown blender.w[1];
// Result: 2 //
//
// List all the attribute aliases for the node blendShape1
//
aliasAttr -q blender;
// Result: smile weight[0] frown weight[1] //
//
// Allow the X rotation on a joint to be called its "roll"
//
createNode joint -n elbow;
aliasAttr roll elbow.rx;
// Result: 1 //
aliasAttr tuck elbow.ry;
// Result: 1 //
//
// Remove the roll alias defined above.
//
aliasAttr -rm elbow.roll;
//
// Remove the tuck alias defined above.
//
aliasAttr -rm elbow.ry;