BallSelection, BoxSelection, CylinderSelection, Disk Selection

Create selections of geometric entities or objects that (partly) lie inside a ball, box, cylinder, or disk.

Syntax

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

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

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

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

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

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

Description

The following general properties are available:


Property	Value	Default	Description
angletol	double	5	Angle tolerance for continuity evaluation.
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.
condition	intersects \| inside \| somevertex \| allvertices	intersects	Condition for inclusion of an entity.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
entitydim	-1 \| 0 \| 1 \| 2 \| 3	space dimension	Dimension of entities to select. -1 means Object.
groupcontang	on \| off	off	Continuous tangent mode.
input	String[]	{}	Tags of input selections, only used when inputent is selections.
inputent	all \| selections	all	Select among all entities or entities defined by the input property.
selkeep	on \| off	on	Keep the selection within the geometry sequence.
selshow	on \| off	on	Show selection in physics, materials, and so on; in part instances; or in 3D from a plane geometry.
contributeto	String	none	Tag of cumulative selection to contribute to.

For BallSelection, you define the ball using the following properties (using the geometry sequence’s length unit):


Property	Value	Default	Description
posx	double	0	Center of ball, first coordinate.
posy	double	0	Center of ball, second coordinate.
posz	double	0	Center of ball, third coordinate.
r	double	0	Radius of ball.

For BoxSelection, you define the box using the following properties (using the geometry sequence’s length unit):


Property	Value	Default	Description
xmax	double	inf	Maximum x-coordinate of box.
xmin	double	-inf	Minimum x-coordinate of box.
ymax	double	inf	Maximum y-coordinate of box.
ymin	double	-inf	Minimum y-coordinate of box.
zmax	double	inf	Maximum z-coordinate of box.
zmin	double	-inf	Minimum z-coordinate of box.

For CylinderSelection, you define the cylinder using the following properties (using the geometry sequence’s length unit):


Property	Value	Default	Description
angle1	double	0	Start angle.
angle2	double	360	End angle (default: 360 degrees; that is, a full cylinder).
axis	double[]	{0,0,0}	Direction of cylinder axis. Vector has length 3 if axistype is cartesian and length 2 is axistype is spherical. Not used if axistype is x, y, or z.
axistype	x \| y \| z \| cartesian \| spherical	z	Type of axis or coordinate system used for axis. The value is synchronized with axis.
bottom	double	-inf	Coordinate of bottom face in local coordinate system.
pos	double[]	{0,0,0}	Base point.
r	double (nonnegative)	0	Outer radius.
rin	double (nonnegative)	0	Inner radius.
top	double	inf	Coordinate of top face in local coordinate system.

For DiskSelection, you define the disk using the following properties (using the geometry sequence’s length unit):


Property	Value	Default	Description
angle1	double	0	Start angle.
angle2	double	360	End angle (default: 360 degrees; that is, a full disk).
posx	double	0	Center of disk, first coordinate.
posy	double	0	Center of disk, second coordinate.
r	double (nonnegative)	0	Outer radius.
rin	double (nonnegative)	0	Inner radius.

You select the input entities or objects to select among using the properties entitydim, inputent, and input. For a boundary or edge selection in 2D or 3D, you can force the selection to select whole groups of entities by setting the property groupcontang to on. Each group consists of adjacent entities that meet at an angle less than angletol.

The output entities/objects are determined by the property condition:

•

intersects: All entities/objects that intersect the ball/box/cylinder are included.

•

inside: All entities/objects that are completely inside the ball/box/cylinder are included.

•

somevertex: All entities/objects that have at least one adjacent vertex inside the ball/box/cylinder are included.

•

allvertices: All entities/objects that have all adjacent vertices inside the ball/box/cylinder are included.

For intersects and inside, the rendering mesh is used for the calculation. You can set the resolution of the rendering mesh using

ModelUtil.setPreference("graphics.rendering.detail",<detail>);

where <detail> is coarse, normal, fine, or wireframe.