Revolve

Revolve planar faces in 3D.

Syntax

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

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

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

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

Description

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

Use model.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.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-90: 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.
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.

When unite is on, the input objects are united with the corresponding revolved objects, after which the input objects are removed. When revolving from work plane objects, this has the same effect as deleting the input objects. When unite is off, the revolved objects remain separate from the input objects and the input objects are kept.

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

Compatibility

Additional properties:

Table 3-91: 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).

Example

Create torus about the y-axis:

Code for use with Java

Model model = ModelUtil.create("Model1");

GeomSequence g = model.geom().create("geom1",3);

g.create("wp1","WorkPlane");

g.feature("wp1").geom().create("c1", "Circle");

g.feature("wp1").geom().feature("c1").set("pos", "2 0");

g.run("wp1");

g.create("r1","Revolve");

g.run();

Code for use with MATLAB

model = ModelUtil.create('Model1');

g = model.geom.create('geom1',3);

g.create('wp1','WorkPlane');

g.feature('wp1').geom.create('c1', 'Circle');

g.feature('wp1').geom.feature('c1').set('pos', '2 0');

g.run('wp1');

g.create('r1','Revolve');

g.run;

See Also

 Extrude, WorkPlane