Extrude

Extrude planar faces into 3D objects.

Syntax

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

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>,"Extrude") to extrude objects from a work plane or planar faces in the 3D geometry.

Use model.geom(<tag>).feature(<ftag>).selection("input") to select the work plane objects to extrude. 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 extrude. Faces are extruded when the workplane property is none; otherwise work plane objects are extruded.

The following properties are available:

Table 3-52: Valid Property/Value Pairs

Property	Values	Default	Description
crossfaces	on | off	on	Keep cross-sectional faces.
displ	double[nd][2]	{{0,0}}	Displacement (parallel to work plane) of extrusion top (of each layer) in local coordinate system.
distance	double | double[nd]	1	Extrusion distance(s), that is, local z-coordinate for the top (of each layer).
extrudefrom	workplane | faces		Extrude work plane objects or planar faces in 3D.
input	Selection	all objects	Objects to extrude.
intputface	Selection		Faces to extrude.
polres	double	50	Polygon resolution of edges.
reverse	on | off	off	Reverse the extrude direction.
scale	double[nd][2]	{{1,1}}	Scale of extrusion top (of each layer).
twist	double | double[nd]	0	Twist angle (of each layer).
unite	on | off	on	Unite extruded objects with input objects.
workplane	String		Work plane to extrude.
selresult	on | off	off	Create selections of all resulting objects.
selresultshow	all | obj | dom | bnd | edg | pnt | off	dom	Show selections, if selresult is on, 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 planar input is extruded in nd layers defined by a local coordinate system. By default, nd=1. The property distance is the extrusion distance (of each layer) in the z-axis direction of the local system. The properties displ, scale, and twist define the translation displacements, scale factors and rotation of the top (of each layer) with respect to the bottom of the extruded object. The last array dimension in the properties displ, scale, and twist can be omitted if the same value is desired for all layers.

When extruding work plane objects, the local system is defined as the local system of the work plane. When extruding 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 set to on, the input objects are united with the corresponding extruded objects, after which the input objects are removed. When extruding from work plane object, this has the same effect as deleting the input objects. When unite is set to off, the extruded 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

The cubic interpolated extrusion is no longer supported.

The following property is also supported:

Table 3-53: Valid Property/Value Pairs

Property	Values	Default	Description
face	all | none	all	Cross-sectional faces to delete, alias for crossfaces
keep	on | off	off	Alias for unite property with opposite value

Example

Creation of a cylinder of height 1.3:

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.run("wp1");

g.create("e1","Extrude");

g.feature("e1").set("distance",1.3);

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.run('wp1');

g.create('e1','Extrude');

g.feature('e1').set('distance',1.3);

g.run;

See Also

 Revolve, WorkPlane