Go to: Synopsis. Return value. Flags. Python examples.
rebuildSurface(
surface [surface]
, [caching=boolean], [constructionHistory=boolean], [degreeU=int], [degreeV=int], [direction=int], [endKnots=int], [fitRebuild=int], [keepControlPoints=boolean], [keepCorners=boolean], [keepRange=int], [name=string], [nodeState=int], [object=boolean], [polygon=int], [rebuildType=int], [replaceOriginal=boolean], [spansU=int], [spansV=int], [tolerance=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
rebuildSurface is undoable, queryable, and editable.
This command rebuilds a surface by modifying its parameterization.
In some cases the shape of the surface may also change. The
rebuildType (-rt) attribute determines how the surface is rebuilt.
The optional second surface can be used to specify a reference
parameterization.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
caching, constructionHistory, degreeU, degreeV, direction, endKnots, fitRebuild, keepControlPoints, keepCorners, keepRange, name, nodeState, object, polygon, rebuildType, replaceOriginal, spansU, spansV, tolerance
| Long name (short name) |
Argument types |
Properties |
|
degreeU(du)
|
int
|
  
|
|
The degree of the resulting surface in the u direction
0 - maintain current,
1 - linear,
2 - quadratic,
3 - cubic,
5 - quintic,
7 - heptic
Default: 3
|
|
degreeV(dv)
|
int
|
|
|
The degree of the resulting surface in the v direction
0 - maintain current,
1 - linear,
2 - quadratic,
3 - cubic,
5 - quintic,
7 - heptic
Default: 3
|
|
direction(dir)
|
int
|
|
|
The direction in which to rebuild:
0 - U,
1 - V,
2 - Both U and V
Default: 2
|
|
endKnots(end)
|
int
|
|
|
End conditions for the surface
0 - uniform end knots,
1 - multiple end knots,
Default: 0
|
|
fitRebuild(fr)
|
int
|
|
|
Specify the type of rebuild method to be used:
0 - Convert Classic, the default and original convert method.
1 - Fit using the least squares fit method.
2 - Convert Match, alternate matching convert method.
3 - Convert Grid, uses a grid-based fit algorithm.
Default: 0
|
|
keepControlPoints(kcp)
|
boolean
|
|
|
Use the control points of the input surface.
This forces uniform parameterization unless rebuildType is 2 (match knots)
Default: false
|
|
keepCorners(kc)
|
boolean
|
|
|
The corners of the resulting surface will not change from the corners of the input surface.
Default: true
|
|
keepRange(kr)
|
int
|
|
|
Determine the parameterization for the resulting surface.
0 - reparameterize the resulting surface from 0 to 1;
1 - keep the original surface parameterization;
2 - reparameterize the result from 0 to number of spans
Default: 1
|
|
rebuildType(rt)
|
int
|
|
|
The rebuild type:
0 - uniform,
1 - reduce spans,
2 - match knots,
3 - remove multiple knots,
4 - force non rational
5 - rebuild ends
6 - trim convert (uniform)
7 - into Bezier mesh
Default: 0
|
|
spansU(su)
|
int
|
|
|
The number of spans in the u direction in resulting surface. Used only when rebuildType is 0 - uniform. If 0, keep the same number of spans as the original surface.
Default: 4
|
|
spansV(sv)
|
int
|
|
|
The number of spans in the v direction in resulting surface. Used only when rebuildType is 0 - uniform. If 0, keep the same number of spans as the original surface.
Default: 4
|
|
tolerance(tol)
|
linear
|
|
|
The tolerance with which to rebuild
Default: 0.01
|
|
| Common flags |
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off.
|
|
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.
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node.
|
|
polygon(po)
|
int
|
|
|
The value of this argument controls the type of the object
created by this operation
- 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)
|
|
replaceOriginal(rpo)
|
boolean
|
|
|
Create "in place" (i.e., replace).
|
|
| 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
# rebuild the surface using uniform parameterization
# The rebuilt surface will have 5 spans in u and
# 10 spans in v
cmds.rebuildSurface( rt=0, dir=2, su=5, sv=10 )
# rebuild the surface by removing its redundant spans
cmds.rebuildSurface( rt=1 )
# rebuild the surface by matching the u parameterization
# of another surface. surface1 is the surface to rebuild
# surface2 is the reference surface
cmds.rebuildSurface( 'surface1', 'surface2', rt=2, dir=0 )
# rebuild the surface by removing all multiple interior knots
cmds.rebuildSurface( rt=3 )
# rebuild the surface using uniform parameterization
cmds.rebuildSurface( rt=4 )