Go to: Synopsis. Flags. Return value. Python examples.
closeSurface(
[surface] or [surfaceIsoparm]
, [blendBias=float], [blendKnotInsertion=boolean], [constructionHistory=boolean], [curveOnSurface=boolean], [direction=int], [name=string], [object=boolean], [parameter=float], [polygon=int], [preserveShape=int], [range=boolean], [rebuild=boolean], [replaceOriginal=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
closeSurface is undoable, queryable, and editable.
The closeSurface command closes a surface in the U, V, or both
directions, making it periodic. The close direction is controlled
by the direction flag. If a surface is not specified in the
command, then the first selected surface will be used.
The pathname to the newly closed surface and the name of the
resulting dependency node are returned.
This command also handles selected surface isoparms. For example, if
an isoparm is specified, surface1.u[0.33], then the surface will
be closed in V, regardless of the direction flag.
blendBias, blendKnotInsertion, constructionHistory, curveOnSurface, direction, name, object, parameter, polygon, preserveShape, range, rebuild, replaceOriginal
| Long name (short name) |
[argument types] |
Properties |
preserveShape(ps)
|
int
|
 
|
|
0 - without preserving the shape
1 - preserve shape
2 - blend
Default: 1
In query mode, this flag needs a value.
|
|
blendBias(bb)
|
float
|
|
|
Skew the result toward the first or the second surface depending on the blend value being smaller or larger than 0.5.
Default: 0.5
In query mode, this flag needs a value.
|
|
blendKnotInsertion(bki)
|
boolean
|
|
|
If set to true, insert a knot in one of the original surfaces (relative position given by the parameter attribute below) in order to produce a slightly different effect.
Default: false
In query mode, this flag needs a value.
|
|
parameter(p)
|
float
|
|
|
The parameter value for the positioning of the newly inserted knot.
Default: 0.1
In query mode, this flag needs a value.
|
|
direction(d)
|
int
|
|
|
The direction in which to close:
0 - U,
1 - V,
2 - Both U and V
Default: 0
In query mode, this flag needs a value.
|
|
name(n)
|
string
|
|
|
Name the resulting object
|
|
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off (not available in all commands)
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node (not available in all commands)
|
|
replaceOriginal(rpo)
|
boolean
|
|
|
Create "in place" (i.e., replace) (not available in all commands)
|
|
curveOnSurface(cos)
|
boolean
|
|
|
If possible, create 2D curve as a result (not available in all commands)
|
|
polygon(po)
|
int
|
|
|
The value of this argument controls the type of the object
created by this operation (not available in all commands)
- 0: nurbs surface
- 1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)
- 2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)
- 3: Bezier surface
- 4: subdivision surface solid (use nurbsToSubdivPref to set the
parameters for the conversion)
|
|
range(rn)
|
boolean
|
|
|
Force a curve range on complete input curve (not available in all commands)
|
|
rebuild(rb)
|
boolean
|
|
|
Rebuild the input curve(s) before using them in the operation. Use nurbsCurveRebuildPref to set the parameters for the conversion. (not available in all commands)
|
|
|
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.
|
[string[]] (object name and node name)
import maya.cmds as cmds
cmds.closeSurface( 'surface1', ch=True, d=0, ps=True )
# Closes surface1 in the U direction with history and by preserving shape.
# The name of the closed surface, and the name of the newly created
# dependency node are returned.
cmds.closeSurface( 'surface1', ch=True, d=2, ps=False )
# Closes surface1 in both U and V directions, with history. Closing
# the surface will not preserve the shape of the surface.
cmds.closeSurface( 'surface1.u[0.66]', ch= True )
# Closes surface1 in the V direction, with history. The direction is
# implied from the specified isoparm.
Return to Autodesk Index