Compose, Union, Intersection, Difference

Compose objects using a Boolean set formula.

Syntax

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

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

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

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

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>,operationName) to combine geometric objects in different ways.

Use model.geom(<tag>).feature(<ftag>).selection(property) to select the objects to combine. The default selection is empty.

The following properties are available:

Table 3-34: Valid Properties for the Compose and Boolean Operations

Property	Value	Default	Description
absrepairtol	double	model.geom(<tag>).absRepairTol()	Absolute repair tolerance.
formula	String		Set formula (only for Compose feature).
input	Selection		Objects to compose.
input2	Selection		Objects to subtract (only for Difference feature).
intbnd	on | off	on	Keep interior boundaries.
keep	on | off	off	Keep input objects.
repairtol	double	model.geom(<tag>).repairTol()	Relative repair tolerance, relative to size of union of inputs.
repairtoltype	auto | relative | absolute	model.geom(<tag>).repairTolType()	Repair tolerance type: automatic, relative, or absolute.
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, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. 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.

The following Boolean operation is performed:

•	For Compose, the input objects are combined using the set formula in the property formula. The operators +, *, and - correspond to the set operations union, intersection, and difference, respectively. The precedence of the operators + and - are the same. * has higher precedence.

•	For Union, the objects in input are united.

•	For Intersection, the objects in input are intersected.

•	For Difference, the objects in input2 are subtracted from the union of the objects in input to form a set difference.

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

Compatibility

The following properties are also supported, see the Delete feature:

Table 3-35: Valid Property/Value Pairs

Property	Value	Default	Description
edge	all | none	none	Delete isolated edges on a face (3D). Delete interior edges and edges not adjacent to a domain (2D; alias for indbnd).
face	all | none	none	Delete interior faces (3D; alias for intbnd).
point	all | none	none	Delete isolated vertices (points) on a face (3D) or in a domain (2D).

The property out is no longer available.

See Also

 ConvertToSolid, ConvertToSurface, ConvertToCurve, ConvertToPoint, Finalize, Partition