pymel.core.modeling.stitchSurfacePoints¶

stitchSurfacePoints(*args, **kwargs)¶

The stitchSurfacePoints command aligns two or more surface points along the boundaries together to a single point. In the process, a node to average the points is created. The points are averaged together in a weighted fashion. The points may be control vertices along the boundaries. If the points are CVs then they are stitched together only with positional continuity. Note: No two points can lie on the same surface.

Flags:

Long Name / Short Name		Argument Types	Properties
bias / b		float
	Blend CVs in between input surface and result from stitch. A value of 0.0 returns the input surface. Default:1.0
caching / cch		bool
	Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
cascade / c		bool
	Cascade the created stitch node. (Only if the surface has a stitch history) Default is ‘false’.
constructionHistory / ch		bool
	Turn the construction history on or off.
cvIthIndex / ci		int
	The ith boundary CV index on the input surface. Default:-1
cvJthIndex / cj		int
	The jth boundary CV index on the input surface. Default:-1
equalWeight / ewt		bool
	Assign equal weights to all the points being stitched together. Default is ‘true’. If false, the first point is assigned a weight of 1.0 and the rest are assigned 0.0.
fixBoundary / fb		bool
	Fix Boundary CVs while solving for any G1 constraints. Default:false
frozen / fzn		bool
keepG0Continuity / kg0		bool
	Stitch together the points with positional continuity. Default is ‘true’.
keepG1Continuity / kg1		bool
	Stitch together the points with tangent continuity. Default is ‘false’.
name / n		unicode
	Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.
nodeState / nds		int
	Modifies the node state. See the node documentation for more information. Note:For advanced users only. Flag can have multiple arguments, passed either as a tuple or a list.
object / o		bool
	Create the result, or just the dependency node.
parameterU / u		float
	The U parameter value on surface for a point constraint. Default:-10000
parameterV / v		float
	The V parameter value on surface for a point constraint. Default:-10000
positionalContinuity / pc		bool
	Toggle on (off) G0 continuity at edge corresponding to multi index. Default:true
replaceOriginal / rpo		bool
	Create in place(i.e., replace). Advanced flags
stepCount / sc		int
	Step count for the number of discretizations. Default:20
tangentialContinuity / tc		bool
	Toggle on (off) G1 continuity across edge corresponding to multi index. Default:false
togglePointNormals / tpn		bool
	Toggle on (off) normal point constraints on the surface. Default:false
togglePointPosition / tpp		bool
	Toggle on (off) position point constraints on the surface. Default:true
toggleTolerance / tt		bool
	Toggle on (off) so as to use Tolerance or specified steps for discretization. Default:false
tolerance / tol		float
	Tolerance to use while discretizing the edge. Default:0.1 Common flags

Derived from mel command maya.cmds.stitchSurfacePoints

Example:

import pymel.core as pm

# stitch together four corner control vertices to the average of the four corners.
pm.stitchSurfacePoints( 'nurbsPlane2.cv[0][0]', 'nurbsPlane1.cv[3][0]', 'nurbsPlane4.cv[0][3]', 'nurbsPlane3.cv[3][3]', ewt=True )

# stitch together two edit points to the edit point nurbsPlane2.ep[0][0].
pm.stitchSurfacePoints( 'nurbsPlane2.ep[0][0]', 'nurbsPlane1.ep[1][0]', ewt=False )