pymel.core.animation.pairBlend

static animation.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. Flag can have multiple arguments, passed either as a tuple or a list.

node (nd) unicode ../../../_images/create.gif
 
The name of the node which the blend will drive. This flag is required when creating the blend.

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)

Previous topic

pymel.core.animation.orientConstraint

Next topic

pymel.core.animation.parentConstraint

Core

Core Modules

Other Modules

This Page