pymel.core.context.polyMergeFacetCtx — PyMEL 1.0.7 documentation

pymel.core.context.polyMergeFacetCtx

polyMergeFacetCtx(*args, **kwargs)

Create a new context to merge facets on polygonal objects In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name Argument Types Properties
activeNodes / anq bool ../../../_images/query.gif
 
Return the active nodes in the tool
caching / cch bool  
   
constructionHistory / ch bool  
   
exists / ex bool ../../../_images/create.gif
 
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
firstFacet / ff int  
   
frozen / fzn bool  
   
image1 / i1 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
First of three possible icons representing the tool associated with the context.
image2 / i2 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Second of three possible icons representing the tool associated with the context.
image3 / i3 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Third of three possible icons representing the tool associated with the context.
immediate / im bool ../../../_images/edit.gif
 
Acts on the object not the tool defaults
mergeMode / mm int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

The merge mode. (at first facet : 0, in between : 1, at last facet : 2) Default is in between. Flag can have multiple arguments, passed either as a tuple or a list.

name / n unicode ../../../_images/create.gif
 
If this is a tool command, name the tool appropriately.
nodeState / nds int  
   
previous / pv bool ../../../_images/edit.gif
 
Reset to previously stored values
reset / rs bool ../../../_images/edit.gif
 
Reset to default values
secondFacet / sf int  
   
toolNode / tnq bool ../../../_images/query.gif
 
Return the node used for tool defaults

Derived from mel command maya.cmds.polyMergeFacetCtx

Example:

import pymel.core as pm

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

# Create a new poly merge facet context, set the merge mode to merging the second face to the first face, then switch to it
pm.polyMergeFacetCtx('polyMergeFacetCtx1', mm=0)
pm.setToolTo('polyMergeFacetCtx1')