Block

Create a right-angled solid or surface block in 3D.

Syntax

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

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

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

Description

Use model.geom(<tag>).create(<ftag>,"Block") to create a block. The following properties are available:

Table 3-28: Valid Property/Value Pairs

Property	Value	Default	Description
axis	double[]	{0,0,1}	Direction of the edge on the local z-axis. Vector has length 3 if axistype is cartesian, and length 2 if axistype is spherical.
axistype	x | y | z | cartesian | spherical	z	Coordinate system used for axis. The value is synchronized with axis.
base	corner | center	corner	Positions the object either centered about pos or with one corner in pos.
layer	double[]		Thicknesses of layers.
layertop	on | off	off	Apply layers on top.
layerbottom	on | off	on	Apply layers on bottom.
layerleft	on | off	off	Apply layers to the left.
layerright	on | off	off	Apply layers to the right.
layerfront	on | off	off	Apply layers on front.
layerback	on | off	off	Apply layers on back.
size	double[]	{1,1,1}	Edge lengths.
pos	double[]	{0,0,0}	Position of the object.
rot	double	0	Rotational angle about axis.
type	solid | surface	solid	Object type.
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.

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

Compatibility

model.geom(<tag>).create(<ftag>,"block2") constructs a solid block.

model.geom(<tag>).create(<ftag>,"block3") constructs a surface block.

The following properties are also available:

Table 3-29: Valid Property/Value Pairs

Property	Value	Default	Description
ax2	double[]	{0,0}	Alias for axis when axistype is spherical.
ax3	double[]	{0,0,1}	Alias for axis when axistype is cartesian.
lx, ly, lz	double	1	Alias for size.
x, y, z	double	0	Alias for pos.

The property const is no longer available.

Example

The following commands create a solid and surface block, where the position is defined in the two alternative ways.

Code for use with Java

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

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

g.create("b1","Block");

g.feature("b1").set("size","1 2.1 0.5");

g.feature("b1").set("base","center");

g.feature("b1").set("pos","1 0 1");

g.feature("b1").set("axis","1 0 0");

g.feature("b1").set("rot",30);

double[] a = g.feature("b1").getDoubleArray("pos");

g.create("b2","Block");

g.feature("b2").set("type","surface");

g.feature("b2").set("size","1 2.1 0.5");

g.feature("b2").set("pos",a);

String b = g.feature("b2").getString("pos");

Code for use with MATLAB

model = ModelUtil.create('Model1');

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

g.create('b1','Block');

g.feature('b1').set('size','1 2.1 0.5');

g.feature('b1').set('base','center');

g.feature('b1').set('pos','1 0 1');

g.feature('b1').set('axis','1 0 0');

g.feature('b1').set('rot',30);

a = g.feature('b1').getDoubleArray('pos');

g.create('b2','Block');

g.feature('b2').set('type','surface');

g.feature('b2').set('size','1 2.1 0.5');

g.feature('b2').set('pos',a);

b = g.feature('b2').getString('pos');

See Also

Hexahedron