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

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')