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 Return the active nodes in the tool caching / cch bool constructionHistory / ch bool exists / ex bool Returns true or false depending upon whether the specified object exists. Other flags are ignored. firstFacet / ff int frozen / fzn bool image1 / i1 unicode First of three possible icons representing the tool associated with the context. image2 / i2 unicode Second of three possible icons representing the tool associated with the context. image3 / i3 unicode Third of three possible icons representing the tool associated with the context. immediate / im bool Acts on the object not the tool defaults mergeMode / mm int The merge mode. (at first facet : 0, in between : 1, at last facet : 2) Default is in between. name / n unicode If this is a tool command, name the tool appropriately. nodeState / nds int previous / pv bool Reset to previously stored values reset / rs bool Reset to default values secondFacet / sf int toolNode / tnq bool 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')