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
image1 (i1)		unicode
image2 (i2)		unicode
image3 (i3)		unicode
	Contexts support up to three icons that represent 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. Flag can have multiple arguments, passed either as a tuple or a list.
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

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