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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Blend Cvs in between input surface and result from stitch. A value of 0.0 returns the input surfaceDefault:1.0
caching (cch) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
cascade (c) bool ../../../_images/create.gif
 

Cascade the created stitch node. (Only if the surface has a stitch history)Default is ‘false’.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
cvIthIndex (ci) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The ith boundary cv index on the input surfaceDefault:-1
cvJthIndex (cj) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The jth boundary cv index on the input surfaceDefault:-1
equalWeight (ewt) bool ../../../_images/create.gif
 

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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Fix Boundary Cvs while Solving for any G1 constraints.Default:falseAdvanced flags
keepG0Continuity (kg0) bool ../../../_images/create.gif
 
Stitch together the points with positional continuity.Default is ‘true’.
keepG1Continuity (kg1) bool ../../../_images/create.gif
 
Stitch together the points with tangent continuity.Default is ‘false’.
name (n) unicode ../../../_images/create.gif
 

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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information.Note:For advanced users only.Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node
parameterU (u) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The U parameter value on surface for a point constraint.Default:-10000
parameterV (v) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The V parameter value on surface for a point constraintDefault:-10000
positionalContinuity (pc) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Toggle on(off) G0 continuous at edge corresponding to multi index.Default:true
replaceOriginal (rpo) bool ../../../_images/create.gif
 
Create “in place” (i.e., replace)
stepCount (sc) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Step count for the number of discretizations.Default:20
tangentialContinuity (tc) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Toggle on(off) G1 continuity across edge corresponding to multi index.Default:false
togglePointNormals (tpn) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Toggle on(off) normal point constraints on the surface.Default:false
togglePointPosition (tpp) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Toggle on(off) position point constraints on the surface.Default:true
toggleTolerance (tt) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Toggle on(off) so as to use Tolerance or specified steps for discretization.Default:false
tolerance (tol) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Tolerance to use while discretizing the edgeDefault:0.1

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 )

Previous topic

pymel.core.modeling.stitchSurface

Next topic

pymel.core.modeling.subdAutoProjection

Core

Core Modules

Other Modules

This Page