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 |
positionalContinuity(pc) |
boolean |
    |
|
Toggle on(off) G0 continuous at edge corresponding to multi
index.
Default: true |
|
tangentialContinuity(tc) |
boolean |
|
|
Toggle on(off) G1 continuity across edge corresponding to multi
index.
Default: false |
|
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 |
|
stepCount(sc) |
int |
|
|
Step count for the number of discretizations.
Default: 20 |
|
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 |
|
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 |
|
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 |
|
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 |
|
fixBoundary(fb) |
boolean |
|
|
Fix Boundary Cvs while Solving for any G1 constraints.
Default: false |
|
| 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. |
|
| Common flags |
name(n) |
string |
|
|
Name the resulting object |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off |
|
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. |
|
numberOfSamples(ns) |
int |
|
|
The number of samples on the edge.
Default is 20. |
|
keepG0Continuity(kg0) |
boolean |
|
|
Stitch together with positional continuity.
Default is 'true'. |
|
keepG1Continuity(kg1) |
boolean |
|
|
Stitch together with tangent continuity.
Default is 'false'. |
|
cascade(c) |
boolean |
|
|
Cascade the created stitch node. (Only if the surface has a
stitch history)
Default is 'false'. |
|
| 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 )