pymel.core.modeling.rebuildSurface

rebuildSurface(*args, **kwargs)

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.

Flags:
Long name (short name) Argument Types Properties
caching (cch) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
degreeU (du) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The degree of the resulting surface in the u direction 0 - maintain current, 1 - linear, 2 - quadratic, 3 - cubic, 5 - quintic, 7 - hepticDefault:3
degreeV (dv) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The degree of the resulting surface in the v direction 0 - maintain current, 1 - linear, 2 - quadratic, 3 - cubic, 5 - quintic, 7 - hepticDefault:3
direction (dir) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The direction in which to rebuild: 0 - U, 1 - V, 2 - Both U and VDefault:2
endKnots (end) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
End conditions for the surface 0 - uniform end knots, 1 - multiple end knots,Default:0
fitRebuild (fr) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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:0Advanced flags

keepControlPoints (kcp) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Use the control points of the input surface. This forces uniform parameterization unless rebuildType is 2 (match knots)Default:false
keepCorners (kc) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The corners of the resulting surface will not change from the corners of the input surface.Default:true
keepRange (kr) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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 spansDefault:1

name (n) unicode ../../../_images/create.gif
 

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.

noChanges (nc) bool  
   
nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information.Note:For advanced users only.Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node
polygon (po) int ../../../_images/create.gif
 

The value of this argument controls the type of the object created by this operation 0: nurbs surface1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)3: Bezier surface4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

rebuildType (rt) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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 meshDefault:0

replaceOriginal (rpo) bool ../../../_images/create.gif
 
Create “in place” (i.e., replace)
spansU (su) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The tolerance with which to rebuildDefault:0.01

Derived from mel command maya.cmds.rebuildSurface

Example:

import pymel.core as pm

# rebuild the surface using uniform parameterization
# The rebuilt surface will have 5 spans in u and
# 10 spans in v
pm.rebuildSurface( rt=0, dir=2, su=5, sv=10 )

# rebuild the surface by removing its redundant spans
pm.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
pm.rebuildSurface( 'surface1', 'surface2', rt=2, dir=0 )

# rebuild the surface by removing all multiple interior knots
pm.rebuildSurface( rt=3 )

# rebuild the surface using uniform parameterization
pm.rebuildSurface( rt=4 )

Previous topic

pymel.core.modeling.rebuildCurve

Next topic

pymel.core.modeling.refineSubdivSelectionList

Core

Core Modules

Other Modules

This Page