Go to: Synopsis. Return value. Flags. Python examples.
stitchSurface(
[surfaceIsoparm] [surfaceIsoparm]
, [bias=float], [caching=boolean], [cascade=boolean], [constructionHistory=boolean], [cvIthIndex=int], [cvJthIndex=int], [fixBoundary=boolean], [keepG0Continuity=boolean], [keepG1Continuity=boolean], [name=string], [nodeState=int], [numberOfSamples=int], [object=boolean], [parameterU=float], [parameterV=float], [positionalContinuity=boolean], [replaceOriginal=boolean], [stepCount=int], [tangentialContinuity=boolean], [togglePointNormals=boolean], [togglePointPosition=boolean], [toggleTolerance=boolean], [tolerance=linear], [weight0=float], [weight1=float])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
stitchSurface is undoable, queryable, and editable.
The stitchSurface command aligns two surfaces together to be
G(0) and/or G(1) continuous by ajusting only the Control Vertices
of the surfaces. The two surfaces can be stitched by specifying
the two isoparm boundary edges that are to stitched together. The
edge to which the two surfaces are stitched together is obtained
by doing a weighted average of the two edges. The weights for the
two edges is specified using the flags -wt0, -wt1 respectively.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
bias, caching, cascade, constructionHistory, cvIthIndex, cvJthIndex, fixBoundary, keepG0Continuity, keepG1Continuity, name, nodeState, numberOfSamples, object, parameterU, parameterV, positionalContinuity, replaceOriginal, stepCount, tangentialContinuity, togglePointNormals, togglePointPosition, toggleTolerance, tolerance, weight0, weight1
| 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
|
|
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
|
|
fixBoundary(fb)
|
boolean
|
|
|
Fix Boundary CVs while solving for any G1 constraints.
Default: false
|
|
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)
|
boolean
|
|
|
Toggle on (off) G0 continuity at edge corresponding to multi index.
Default: true
|
|
stepCount(sc)
|
int
|
|
|
Step count for the number of discretizations.
Default: 20
|
|
tangentialContinuity(tc)
|
boolean
|
|
|
Toggle on (off) G1 continuity across edge corresponding to multi index.
Default: false
|
|
togglePointNormals(tpn)
|
boolean
|
|
|
Toggle on (off) normal point constraints on the surface.
Default: false
|
|
togglePointPosition(tpp)
|
boolean
|
|
|
Toggle on (off) position point constraints on the surface.
Default: true
|
|
toggleTolerance(tt)
|
boolean
|
|
|
Toggle on (off) so as to use Tolerance or specified steps for discretization.
Default: false
|
|
tolerance(tol)
|
linear
|
|
|
Tolerance to use while discretizing the edge.
Default: 0.1
|
|
| Common flags |
cascade(c)
|
boolean
|
|
|
Cascade the created stitch node. (Only if the surface has a stitch
history)
Default is 'false'.
|
|
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off.
|
|
keepG0Continuity(kg0)
|
boolean
|
|
|
Stitch together with positional continuity.
Default is 'true'.
|
|
keepG1Continuity(kg1)
|
boolean
|
|
|
Stitch together with tangent continuity.
Default is 'false'.
|
|
name(n)
|
string
|
|
|
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.
|
|
numberOfSamples(ns)
|
int
|
|
|
The number of samples on the edge.
Default is 20.
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node.
|
|
replaceOriginal(rpo)
|
boolean
|
|
|
Create "in place" (i.e., replace).
|
|
weight0(wt0)
|
float
|
|
|
The weighting factor for the first edge.
Default is 0.5.
|
|
weight1(wt1)
|
float
|
|
|
The weighting factor for the second edge.
Default is 0.5.
|
|
| Advanced flags |
caching(cch)
|
boolean
|
|
|
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
|
|
nodeState(nds)
|
int
|
|
|
Modifies the node state. See the node documentation for more information.
Note: For advanced users only.
|
|
|
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.
|
import maya.cmds as cmds
# Stitch the two surfaces along the two specified surface isoparam with C0 continuity.
# Since wt0 = 0.0, both the surfaces are stitched to surface2.vn[0] really.
cmds.stitchSurface( 'surface1.vn[1.0]', 'surface2.vn[0.0]', kg0=False, kg1=True, cascade=False, ns=100, wt0=0.0, wt1=1.0 )