pymel.core.animation.pairBlend

pairBlend(*args, **kwargs)

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.

Flags:

Long Name / Short Name Argument Types Properties
attribute / at unicode ../../../_images/create.gif
  The name of the attribute(s) which the blend will drive. This flag is required when creating the blend.
input1 / i1 bool ../../../_images/query.gif
  Returns a string array of the node(s) connected to input 1.
input2 / i2 bool ../../../_images/query.gif
  Returns a string array of the node(s) connected to input 2.
node / nd unicode ../../../_images/create.gif
  The name of the node which the blend will drive. This flag is required when creating the blend. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.pairBlend

Example:

import pymel.core as pm

# Create a pairBlend node and connect sphere1's tx and ty to the pairBlend's input1
pm.nurbsSphere(n='sphere1')
pm.pairBlend( nd='sphere1', at=['tx','ty'] )
# Query the nodes connected to input1.
#
inputs = pm.pairBlend('pairBlend1' ,query=True, input1=True)