Revolve

Revolve planar faces in 3D.

Syntax

model.component(<ctag>).geom(<tag>).create(<ftag>,"Revolve");

model.component(<ctag>).geom(<tag>).feature(<ftag>).selection(property);

model.component(<ctag>).geom(<tag>).feature(<ftag>).set(property,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getType(property);

Description

Use model.component(<ctag>).geom(<tag>).create(<ftag>,"Revolve") to revolve objects from a work plane.

Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("input") to select the work plane objects to revolve. The default selection is all available objects from the last preceding work plane.

Use model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("inputface") to select the faces to revolve. Faces are revolved when the workplane property is none; otherwise, work plane objects are revolved.

The following properties are available:

Table 3-93: Valid Property/Value Pairs
Property	Values	Default	Description
angle1	double	0	Start revolution angle.
angle2	double	0	End revolution angle.
angtype	specang \| full	specang	Type of specification.
axis	double[2]	{0,1}	Direction of axis of revolution (in local coordinate system).
axis3	double[3]	{0,1,0}	Direction of axis of revolution (in 3D coordinate system).
axistype	2d \| 3d	2d	Type of revolution axis.
color	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
input	Selection	all objects	Objects to revolve.
intputface	Selection		Faces to revolve.
origfaces	on \| off	on	Keep original faces.
polres	double	50	Polygon resolution of edges.
pos	double[2]	{0,0}	A point on the axis of revolution (in work plane’s coordinate system).
pos3	double[3]	{0,0,0}	A point on the axis of revolution (in 3D coordinate system).
revolvefrom	workplane \| faces		Revolve work plane objects or faces from 3D objects.
unite	on \| off	on	Unite revolved objects with input objects.
workplane	String		Work plane to revolve or none to revolve faces.
selresult	on \| off	off	Create selections of all resulting objects.
selresultshow	all \| obj \| dom \| bnd \| edg \| pnt \| off	dom	Show selections of resulting objects in physics, materials, and so on, or in part instances. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
contributeto	String	none	Tag of cumulative selection to contribute to.

Each 2D object in input or planar face in inputface is revolved about the revolution axis. The range of angles is given by the properties angle1 and angle2. If axistype is 2d, the revolution axis is defined in a local coordinate system. The revolution axis goes through pos with direction axis. If axistype is 3d, the revolution axis is defined in the 3D coordinate system. The revolution axis goes through pos3 with direction axis3.

When revolving work plane objects, the local system is defined as the local system of the work plane. When revolving faces, the local system is defined by the face with the smallest face number in the object that comes first in the geometry sequence. The local z-axis is parallel to the face normal and located at the center of the face. The local x-axis is defined by the tangent direction corresponding to the first parameter in the surface representation for the face.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

Compatibility

Additional properties:

Table 3-94: Valid Property/Value Pairs
Property	Values	Default	Description
angles	double \| double[2]	2*pi	Alias for angle1 and angle2.
keep	on \| off	off	Alias for unite property with opposite value.
revaxis	double[2][2]	{{0,0}, { 0,1}}	Alias for pos (first column) and axis (second column).