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

Synopsis

makeSingleSurface( surface , [chordHeight=linear], [chordHeightRatio=float], [constructionHistory=boolean], [delta=linear], [edgeSwap=boolean], [format=int], [fractionalTolerance=float], [matchNormalDir=boolean], [minEdgeLength=linear], [name=string], [normalizeTrimmedUVRange=boolean], [object=boolean], [polygonCount=int], [polygonType=int], [stitchTolerance=float], [uNumber=int], [uType=int], [useChordHeight=boolean], [useChordHeightRatio=boolean], [vNumber=int], [vType=int])

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

makeSingleSurface is undoable, queryable, and editable.

This command performs a stitch and tessellate operation.

Return value

string[]Object name and node name.

In query mode, return type is based on queried flag.

Flags

chordHeight, chordHeightRatio, constructionHistory, delta, edgeSwap, format, fractionalTolerance, matchNormalDir, minEdgeLength, name, normalizeTrimmedUVRange, object, polygonCount, polygonType, stitchTolerance, uNumber, uType, useChordHeight, useChordHeightRatio, vNumber, vType
Long name (short name) Argument types Properties
chordHeight(cht) linear queryedit
Chord height is the absolute distance in OBJECT space which the center of a polygon edge can deviate from the actual center of the surface span. Only used if Format is General and if useChordHeight is true.
Default: 0.1
chordHeightRatio(chr) float queryedit
Chord height ratio is the ratio of the chord length of a surface span to the chord height. (This is a length to height ratio). 0 is a very loose fit. 1 is a very tight fit. (See also description of chord height.) Always used if Format is Standard Fit. Otherwise, only used if Format is General and useChordHeightRatio is true.
Default: 0.9
constructionHistory(ch) boolean create
Turn the construction history on or off.
delta(d) linear queryedit
3D delta. Only used if Format is Standard Fit.
Default: 0.1
edgeSwap(es) boolean queryedit
Edge swap. This attribute enables an algorithm which determines the optimal method with which to tessellate a quadrilateral into triangles. Only used if Format is General.
Default: false
format(f) int queryedit
Format: 0 - Triangle Count, 1 - Standard Fit, 2 - General, 3 - CVs
Default: 1
fractionalTolerance(ft) float queryedit
Fractional tolerance. Only used if Format is Standard Fit.
Default: 0.01
matchNormalDir(mnd) boolean queryedit
Only used when the format is CVs. Order the cvs so that the normal matches the direction of the original surface if set to true.
Default: false
minEdgeLength(mel) linear queryedit
Minimal edge length. Only used if Format is Standard Fit.
Default: 0.001
name(n) string create
Name the resulting object.
normalizeTrimmedUVRange(ntr) boolean queryedit
This attribute is only applicable when a trimmed NURBS surface is used as the input surface. When true, the UV texture coordinates on the trimmed input surface are normalized and applied to the output surface as they are for the untrimmed version of the input surface. (The texture coordinates on the entire untrimmed surface are mapped to the entire output surface.) When false, the UV texture coordinates on the trimmed input surface are applied to the output surface as they are for the trimmed input surface. (Only the texture coordinates visible on the trimmed input surface are mapped to the output surface.)
Default: true
object(o) boolean create
Create the result, or just the dependency node.
polygonCount(pc) int queryedit
The number of polygons to produce. Only used if Format is Triangle Count.
Default: 200
polygonType(pt) int queryedit
Polygon type: 0 - Triangles, 1 - Quads
Default: 0
stitchTolerance(st) float edit
Stitch tolerance.
Default: 0.1
uNumber(un) int queryedit
Initial number of isoparms in U. Used in conjunction with the uType attribute. Only used if Format is General.
Default: 3
uType(ut) int queryedit
Initial U type tessellation criteria (3 types). Type 0 - Per surface # of isoparms in 3D. This type places a specific number of iso-parametric subdivision lines across the surface, equally spaced in 3D space. Type 1 - Per surface # of isoparms. This type places a specific number of iso-parametric subdivision lines across the surface, equally spaced in parameter space. Type 2 - Per span # of isoparms. This type places a specific number of iso-parametric subdivision lines across each surface span, equally spaced in parameter space. (This is the closest option to the Alias Studio tessellation parameters.) This attribute is only used if Format is General.
Default: 3
useChordHeight(uch) boolean queryedit
True means use chord height. Only used if Format is General.
Default: false
useChordHeightRatio(ucr) boolean queryedit
True means use chord height ratio.
Default: true
vNumber(vn) int queryedit
Initial number of isoparms in V. Used in conjunction with the vType attribute. Only used if Format is General.
Default: 3
vType(vt) int queryedit
Initial V type tessellation criteria (3 types). See description for the uType attribute. Only used if Format is General.
Default: 3

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.

Python examples

import maya.cmds as cmds

# To make a single poly surface from a bunch of surfaces
cmds.makeSingleSurface( 'nurbsPlane1', 'nurbsPlane2', 'nurbsPlane3' )