revolve

Show frames

Go to: Related nodes. Attributes.

Given an input curve (inputCurve) this node creates a revolved surface about a specified axis of revolution (defined by the attributes "axis" and "pivot"). The sweep is defined by "startSweep" and "endSweep". The degree of the resulting surface is defined by the attribute "degree". The end sweep cannot be more than 360 degrees. You can control the number of spans or "sections" in the surface either explicitly, using the "sections" attribute, or indirectly, using the "useTolerance" and "tolerance" attributes. If tolerance is used, then the result surface has as many spans as needed to stay within the specified tolerance.

Related nodes

extrude, makeNurbsSquare, loft

Attributes (36)

autoCorrectNormal, axis, axisChoice, axisX, axisY, axisZ, bridge, bridgeCurve, compAnchor, compAnchorX, compAnchorY, compAnchorZ, compAxis, compAxisChoice, compAxisX, compAxisY, compAxisZ, compPivot, compPivotX, compPivotY, compPivotZ, computePivotAndAxis, degree, endSweep, inputCurve, outputSurface, pivot, pivotX, pivotY, pivotZ, radius, radiusAnchor, sections, startSweep, tolerance, useTolerance

Long name (short name)	Type	Default	Flags
autoCorrectNormal (acn)	bool	false
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.
axis (ax)	double3
Revolve axis
axisX (axx) distance (double) 1cm X of the axis
axisY (axy) distance (double) 0cm Y of the axis
axisZ (axz) distance (double) 0cm Z of the axis
axisChoice (aco)	enum	0
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).
bridge (br)	bool	false
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.
bridgeCurve (bc)	nurbsCurve	NULL
If we have a partial revolve, this curve can be used to bridge the surface into a pie shaped one.
compAnchor (cn)	double3
Computed anchor if computePivotAndAxis attribute was set to non-zero. This is the point from which the computed pivot is radius distance away.
compAnchorX (cnx) distance (double) 0.0cm X of the computed anchor.
compAnchorY (cny) distance (double) 0.0cm Y of the computed anchor.
compAnchorZ (cnz) distance (double) 0.0cm Z of the computed anchor.
compAxis (ca)	double3
Computed axis if computePivotAndAxis attribute was set to non-zero.
compAxisX (cax) double 0.0 X of the computed axis if computePivotAndAxis attribute was set.
compAxisY (cay) double 0.0 Y of the computed axis if computePivotAndAxis attribute was set.
compAxisZ (caz) double 0.0 Z of the computed axis if computePivotAndAxis attribute was set.
compAxisChoice (cac)	enum	0
Computed axis choice, either matching non-zero axis choice or computed from the curve.
compPivot (cp)	double3
Computed pivot if computePivotAndAxis attribute was set to non-zero.
compPivotX (cpx) distance (double) 0.0cm X of the computed pivot.
compPivotY (cpy) distance (double) 0.0cm Y of the computed pivot.
compPivotZ (cpz) distance (double) 0.0cm Z of the computed pivot.
computePivotAndAxis (cpa)	enum	0
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.
degree (d)	enum	3
The degree of the resulting surface.
endSweep (esw)	angle (double)	6.2831853
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.
inputCurve (ic)	nurbsCurve	NULL
The input curve.
outputSurface (os)	nurbsSurface	NULL
Output surface
pivot (p)	double3
Revolve pivot point
pivotX (px) distance (double) 0cm X of the pivot
pivotY (py) distance (double) 0cm Y of the pivot
pivotZ (pz) distance (double) 0cm Z of the pivot
radius (r)	distance (double)	1cm
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.
radiusAnchor (ra)	double	-1
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.
sections (s)	integer	8
Number of sections of the resulting surface (if tolerance is not used).
startSweep (ssw)	angle (double)	0.0deg
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.
tolerance (tol)	distance (double)	0.01cm
Tolerance to build to (if useTolerance attribute is set)
useTolerance (ut)	bool	false
Use the tolerance, or the number of sections to control the sections.