Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

arrayMapper([destAttr=string], [inputU=string], [inputV=string], [mapTo=string], [target=string], [type=string])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

arrayMapper is undoable, NOT queryable, and NOT editable.

Create an arrayMapper node and connect it to a target object. If the -type flag is used, then this command also creates an external node used for computing the output values. If the input attribute does not already exist, it will be created. The output attribute must exists. If a flag is omitted, the selection list will be used to supply the needed objects. If none are found, that action is omitted.

Return value

string[]Names of created arrayMapper nodes.

Flags

destAttr, inputU, inputV, mapTo, target, type
Long name (short name) Argument types Properties
destAttr(da) string create
Specifies the attribute which will be the downstream connection for the output data from the mapper node. The attribute type will be used to determine which output attribute to use: float array gets outValuePP, vector array gets outColorPP. If the flag is omitted, no output connection is made.
inputU(iu) string create
Specifies the upstream attribute to connect to the mapper's uCoordPP attribute. If the flag is omitted, no input connection is made.
inputV(iv) string create
Specifies the upstream attribute to connect to the mapper's vCoordPP attribute. If the flag is omitted, no input connection is made.
mapTo(mt) string create
Specifies an existing node to be used to compute the output values. This node must be of the appropriate type. Currently, only ramp nodes may be used.
target(t) string createmultiuse
Specifies the target object to be connected to.
type(ty) string create
Specifies the node type to create which will be used to compute the output values. Currently, only ramp is valid. If the flag is omitted, no connection is made and the external node is not created.
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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

cmds.arrayMapper( target='particle1', destAttr='rgbPP', inputV='ageNormalized', type='ramp' )