Go to: Synopsis. Return value. Flags. Python examples.
revolve( curve , [autoCorrectNormal=boolean],
[axis=[linear, linear, linear]],
[axisChoice=int], [axisX=linear], [axisY=linear], [axisZ=linear], [bridge=boolean], [caching=boolean], [computePivotAndAxis=int],
[constructionHistory=boolean],
[degree=int], [endSweep=angle], [name=string], [nodeState=int], [object=boolean], [pivot=[linear, linear, linear]], [pivotX=linear], [pivotY=linear], [pivotZ=linear], [polygon=int], [radius=linear], [radiusAnchor=float], [range=boolean], [rebuild=boolean], [sections=int], [startSweep=angle], [tolerance=linear], [useLocalPivot=boolean], [useTolerance=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
revolve is undoable, queryable, and editable.
This command creates a revolved surface by revolving the given
profile curve about an axis. The profile curve can be a curve,
curve-on-surface, surface isoparm, or trim edge.
| string[] |
Object name and node name |
In query mode, return type is based on queried flag.
autoCorrectNormal, axis, axisChoice,
axisX, axisY,
axisZ, bridge,
caching, computePivotAndAxis, constructionHistory, degree, endSweep,
name, nodeState, object,
pivot, pivotX,
pivotY, pivotZ,
polygon, radius, radiusAnchor, range, rebuild,
sections, startSweep, tolerance, useLocalPivot, useTolerance
| Long name (short name) |
Argument types |
Properties |
startSweep(ssw) |
angle |
   |
|
The value for the start sweep angle, in the current units. This
must be no more than the maximum, 360 degrees, or 2 Pi
radians.
Default: 0 |
|
endSweep(esw) |
angle |
|
|
The value for the end sweep angle, in the current units. This
must be no more than the maximum, 360 degrees, or 2 Pi
radians.
Default: 6.2831853 |
|
useTolerance(ut) |
boolean |
|
|
Use the tolerance, or the number of sections to control the
sections.
Default: false |
|
degree(d) |
int |
|
|
The degree of the resulting surface.
Default: 3 |
|
sections(s) |
int |
|
|
Number of sections of the resulting surface (if tolerance is
not used).
Default: 8 |
|
tolerance(tol) |
linear |
|
|
Tolerance to build to (if useTolerance attribute is set)
Default: 0.01 |
|
axis(ax) |
[linear, linear, linear] |
|
|
|
axisX(axx) |
linear |
|
|
|
axisY(axy) |
linear |
|
|
|
axisZ(axz) |
linear |
|
|
|
pivot(p) |
[linear, linear, linear] |
|
|
|
pivotX(px) |
linear |
|
|
X of the pivot
Default: 0 |
|
pivotY(py) |
linear |
|
|
Y of the pivot
Default: 0 |
|
pivotZ(pz) |
linear |
|
|
Z of the pivot
Default: 0 |
|
autoCorrectNormal(acn) |
boolean |
|
|
If this is set to true we will attempt to reverse the direction
of the axis in case it is necessary to do so for the surface
normals to end up pointing to the outside of the object.
Default: false |
|
computePivotAndAxis(cpa) |
int |
|
|
If this is set to 2, we will compute the axis, use the curve
position and radius to compute the pivot for the revolve
internally. The value of the pivot and axis attributes are ignored.
If this is set to 1, we will take the supplied axis, but compute
the pivot. If this is set to 0, we will take both the supplied axis
and pivot.
Default: 0 |
|
radius(r) |
linear |
|
|
The pivot point will be this distance away from the bounding
box of the curve, if computedPivot is set to true. The value of the
pivot attribute is ignored.
Default: 1 |
|
radiusAnchor(ra) |
float |
|
|
The position on the curve for the anchor point so that we can
compute the pivot using the radius value. If in 0 - 1 range, its on
the curve, normalized parameter range. If < 0 or > 1, its
computed based on the bounding box.
Default: -1 |
|
axisChoice(aco) |
int |
|
|
Only used for computed axis/pivot case. As we are computing the
axis for a planar curve, we have two choices for the major axis
based axis. We will choose the axis corresponding to the longer
dimension of the object (0), or explicitly choose one or the other
(choices 1 and 2).
Default: 0 |
|
bridge(br) |
boolean |
|
|
If true, we will close a partial revolve to get a pie shaped
surface. The surface will be closed, but not periodic the way it is
in the full revolve case.
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 |
|
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)
|
|
range(rn) |
boolean |
|
|
Force a curve range on complete input curve |
|
rebuild(rb) |
boolean |
|
|
Rebuild the input curve(s) before using them in the operation.
Use nurbsCurveRebuildPref to set the parameters for the
conversion. |
|
useLocalPivot(ulp) |
boolean |
|
|
If true, then the pivot of the profile curve is used as the
start point of the axis of revolution. |
|
| 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
# To revolve a curve about the X axis at the origin. The profile curve is
# revolved by 360 degrees by default.
cmds.revolve( 'curve1', ax=(1, 0, 0), p=(0, 0, 0) )
# To revolve a curve about the Y axis at 1,0,1:
cmds.revolve( 'curve1', ax=(0, 1, 0), p=(1, 0, 1) )