Boolean Functions

Functions
int	mdlElmdscr_unionShapes (MSElementDescrH edPP, MSElementDescrH obsoleteEdPP, MSElementDescrP shape1, MSElementDescrP shape2, double tol)
	Constructs a single complex shape or series of complex shapes that enclose the area represented by the union of the two input elements. More...
int	mdlElmdscr_intersectShapes (MSElementDescrH edPP, MSElementDescrH obsoleteEdPP, MSElementDescrP shape1, MSElementDescrP shape2, double tol)
	Constructs a single complex shape or series of complex shapes that enclose the area represented by the intersection of the two input elements. More...
int	mdlElmdscr_differenceShapes (MSElementDescrH edPP, MSElementDescrH obsoleteEdPP, MSElementDescrP minuend, MSElementDescrP subtrahend, double tol)
	Constructs a single complex shape or series of complex shapes that enclose the area represented by the difference between the two input elements. More...

Detailed Description

Function Documentation

int mdlElmdscr_differenceShapes	(	MSElementDescrH	edPP,
		MSElementDescrH	obsoleteEdPP,
		MSElementDescrP	minuend,
		MSElementDescrP	subtrahend,
		double	tol
	)

Constructs a

single complex shape or series of complex shapes that enclose the area represented by the difference between the two input elements.

Input elements must be coplanar, closed elements (shapes, ellipses, complex shapes). The difference area is represented by one or more complex shapes with disjoint enclosing shapes returned as an element descriptor chain in *insideEdPP and islands within the enclosing regions returned in *obsoleteEdPP.

Parameters

[out]	edPP	output descriptor
[out]	obsoleteEdPP	in 4.0 this was outputEdPP
[in]	minuend	minuend
[in]	subtrahend	subtrahend (subtracted from minuend)
[in]	tol	represents the maximum allowable error when calculating intersections between curved elements. A small tolerance will result in high accuracy at the expense of increased processing time.

Returns

Returns SUCCESS if the difference is constructed successfully. Possible error values include MDLERR_NONCOPLANARSHAPES meaning the input shapes are not coplanar.
MDLERR_NULLSOLUTION meaning the difference area is empty.
MDLERR_UNBOUNDEDSOLUTION meaning the difference area is unbounded.

See also

mdlElmdscr_intersectShapes mdlElmdscr_unionShapes

Remarks

Required Library: mdlbltin.lib

int mdlElmdscr_intersectShapes	(	MSElementDescrH	edPP,
		MSElementDescrH	obsoleteEdPP,
		MSElementDescrP	shape1,
		MSElementDescrP	shape2,
		double	tol
	)

Constructs a single

complex shape or series of complex shapes that enclose the area represented by the intersection of the two input elements.

Input elements must be coplanar, closed elements (shapes, ellipses, complex shapes). The intersection area is represented by one or more complex shapes with disjoint enclosing shapes returned as an element descriptor chain in *insideEdPP and islands within the enclosing regions returned as an element descriptor chain in *obsoleteEdPP.

Parameters

[out]	edPP	output descriptor
[out]	obsoleteEdPP	in 4.0 this was outputEdPP
[in]	shape1	first shape
[in]	shape2	second shape
[in]	tol	represents the maximum allowable error when calculating intersections between curved elements. A small tolerance will result in high accuracy at the expense of increased processing time.

Returns

mdlElmdscr_intersectShapes returns SUCCESS if the intersection is constructed successfully. Possible error values include MDLERR_NONCOPLANARSHAPES meaning the input shapes are not coplanar.
MDLERR_NULLSOLUTION meaning the input elements are disjoint and therefore have no intersection.

See also

mdlElmdscr_unionShapes mdlElmdscr_differenceShapes

Remarks

Required Library: mdlbltin.lib

int mdlElmdscr_unionShapes	(	MSElementDescrH	edPP,
		MSElementDescrH	obsoleteEdPP,
		MSElementDescrP	shape1,
		MSElementDescrP	shape2,
		double	tol
	)

Constructs a single complex shape or

series of complex shapes that enclose the area represented by the union of the two input elements.

Input elements must be coplanar, closed elements (shapes, ellipses, complex shapes). The union area is represented by one or more complex shapes with disjoint enclosing shapes returned as an element descriptor chain in *insideEdPP and islands within the enclosing regions returned as an element descriptor chain in *obsoleteEdPP.

Parameters

[out]	edPP	output descriptor
[out]	obsoleteEdPP	in 4.0 this was outputEdPP
[in]	shape1	first shape
[in]	shape2	second shape
[in]	tol	represents the maximum allowable error when calculating intersections between curved elements. A small tolerance will result in high accuracy at the expense of increased processing time.

Returns

Returns SUCCESS if the union is constructed successfully. Possible error values include MDLERR_NONCOPLANARSHAPES if the input shapes are not coplanar.

See also

mdlElmdscr_intersectShapes mdlElmdscr_differenceShapes

Remarks

Required Library: mdlbltin.lib