pymel.core.effects.arrayMapper

arrayMapper(*args, **kwargs)

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.

Flags:

Long name (short name)		Argument Types	Properties
destAttr (da)		unicode
	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)		unicode
	Specifies the upstream attribute to connect to the mapper’s uCoordPP attribute. If the flag is omitted, no input connection is made.
inputV (iv)		unicode
	Specifies the upstream attribute to connect to the mapper’s vCoordPP attribute. If the flag is omitted, no input connection is made.
mapTo (mt)		unicode
	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. Flag can have multiple arguments, passed either as a tuple or a list.
target (t)		unicode
	Specifies the target object to be connected to.
type (ty)		unicode
	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.

Derived from mel command maya.cmds.arrayMapper

Example:

import pymel.core as pm

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