Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
pairBlend([attribute=string], [input1=boolean], [input2=boolean], [node=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
pairBlend is undoable, queryable, and editable.
The pairBlend node allows a weighted combinations of 2 inputs to be blended together. It is created automatically when keying or constraining an attribute which is already connected.
Alternatively, the pairBlend command can be used to connect a pairBlend node to connected attributes of a node. The previously existing connections are rewired to input1 of the pairBlend node. Additional connections can then be made manually to input2 of the pairBlend node.
The pairBlend command can also be used to query the inputs to an existing pairBlend node.
| string | name of pairBlend node |
In query mode, return type is based on queried flag.
blend, animation, constraints
orientConstraint, parentConstraint, pointConstraint, setKeyframe
attribute, input1, input2, node
| Long name (short name) |
Argument types |
Properties |
node(nd)
|
string
|
|
|
The name of the node which the blend will drive. This flag is required when creating the blend.
|
|
attribute(at)
|
string
|
|
|
The name of the attribute(s) which the blend will drive. This flag is required when creating the blend.
|
|
input1(i1)
|
boolean
|
|
|
Returns a string array of the node(s) connected to input 1.
|
|
input2(i2)
|
boolean
|
|
|
Returns a string array of the node(s) connected to input 2.
|
|
|
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.
|
import maya.cmds as cmds
# Create a pairBlend node and connect sphere1's tx and ty to the pairBlend's input1
cmds.nurbsSphere(n='sphere1')
cmds.pairBlend( nd='sphere1', at=['tx','ty'] )
# Query the nodes connected to input1.
#
inputs = cmds.pairBlend('pairBlend1' ,query=True, input1=True)