pymel.core.modeling.polyBlendColor — PyMEL 1.0.7 documentation

pymel.core.modeling.polyBlendColor

polyBlendColor(*args, **kwargs)

Takes two color sets and blends them together into a third specified color set.

Flags:

Long Name / Short Name Argument Types Properties
baseColorName / bcn unicode  
   
blendFunc / bfn int  
   
blendWeightA / bwa float  
   
blendWeightB / bwb float  
   
blendWeightC / bwc float  
   
blendWeightD / bwd float  
   
caching / cch bool ../../../_images/create.gif ../../../_images/edit.gif
 
Toggle caching for all attributes so that no recomputation is needed
constructionHistory / ch bool ../../../_images/create.gif ../../../_images/query.gif
 

Turn the construction history on or off (where applicable). If construction history is on then the corresponding node will be inserted into the history chain for the mesh. If construction history is off then the operation will be performed directly on the object. Note:If the object already has construction history then this flag is ignored and the node will always be inserted into the history chain.

dstColorName / dst unicode  
   
frozen / fzn bool  
   
name / n unicode ../../../_images/create.gif
 
Give a name to the resulting node.
nodeState / nds int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Defines how to evaluate the node. 0: Normal1: PassThrough2: Blocking3: Internally disabled. Will return to Normal state when enabled4: Internally disabled. Will return to PassThrough state when enabled5: Internally disabled. Will return to Blocking state when enabledFlag can have multiple arguments, passed either as a tuple or a list.

srcColorName / src unicode  
   

Derived from mel command maya.cmds.polyBlendColor

Example:

import pymel.core as pm

# This example creates two poly color sets for pPlane1.
# Apply red and green to the vertices of pPlane1 using two separate color sets, then blend their colors to the second color set
# After that, delete the first color set

# Create a poly plane pPlane1
pm.polyPlane(w=10, h=10, sx=10, sy=10, n='pPlane1')

# Create colorSet1, set to use RGBA channels
pm.polyColorSet(create=True, clamped=0, rpt='RGBA', colorSet='colorSet1')
# Apply red color to the vertices of pPlane1
pm.polyColorPerVertex(r=1, g=0, b=0, a=1, cdo=True)

# Create colorSet2, set to use RGBA channels
pm.polyColorSet(create=True, clamped=0, rpt='RGBA', colorSet='colorSet2')
# Apply green color to the vertices of pPlane1
pm.polyColorPerVertex(r=0, g=1, b=0, a=1, cdo=True)

# Blend the two color sets to colorSet2, set to use ColorChannel blend style, set all the blend weights to 0.5
pm.polyBlendColor(bcn='colorSet1', src='colorSet2', dst='colorSet2', bfn=6, bwa=0.5, bwb=0.5, bwc=0.5, bwd=0.5)
# Delete colorSet1
pm.polyColorSet(delete=True, colorSet='colorSet1')