Go to: Synopsis. Flags. Return value. Related. Python examples.

Synopsis

polyMergeEdge([constructionHistory=boolean], [firstEdge=int], [mergeMode=int], [name=string], [secondEdge=int])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polyMergeEdge is undoable, queryable, and editable.

Sews two border edges together.
The new edge is located either on the first, last, or between both selected edges, depending on the mode.

Both edges must belong to the same object, and orientations must match (i.e. normals on corresponding faces must point in the same direction).
Edge flags are mandatory.

Flags

constructionHistory, firstEdge, mergeMode, name, secondEdge
Long name (short name) [argument types] Properties
mergeMode(mm) int createqueryedit
This flag specifies how to merge, merge mode : at first edge : 0, in between : 1, at last edge : 2.
C: Default is in between.

In query mode, this flag needs a value.
firstEdge(fe) int createqueryedit
The number of the first edge to merge.

In query mode, this flag needs a value.
secondEdge(se) int createqueryedit
The number of the second edge to merge.

In query mode, this flag needs a value.
name(n) string create
Name the resulting object.
constructionHistory(ch) boolean createquery
Turn the construction history on or off (where applicable).

In query mode, this flag needs a value.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Return value


string The node name.

Related

polyCloseBorder, polyCollapseEdge, polyCollapseFacet, polyDelEdge, polyDelFacet, polyDelVertex, polyMergeFacet, polyMergeVertex, polyQuad, polyReduce, polySewEdge

Python examples

import maya.cmds as cmds

cmds.polyPlane( sx=3, sy=3, n='plg1' )
cmds.move( -2, 0, 0, 'plg1' )
cmds.delete( 'plg1.f[3:5]' )
cmds.polyPlane( sx=3, sy=3, n='plg2' )
cmds.delete( 'plg2.f[3:5]' )
cmds.polyPlane( sx=3, sy=3, n='plg3' )
cmds.move( 2, 0, 0, 'plg3' )
cmds.delete( 'plg3.f[3:5]' )

#<I>first</I>
cmds.polyMergeEdge( 'plg1', mm=0, fe=8, se=12 )

#<I>between</I>
cmds.polyMergeEdge( 'plg2', mm=1, fe=8, se=12 )

#<I>last</I>
cmds.polyMergeEdge( 'plg3', mm=2, fe=8, se=12 )