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]edPPoutput descriptor
[out]obsoleteEdPPin 4.0 this was outputEdPP
[in]minuendminuend
[in]subtrahendsubtrahend (subtracted from minuend)
[in]tolrepresents 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]edPPoutput descriptor
[out]obsoleteEdPPin 4.0 this was outputEdPP
[in]shape1first shape
[in]shape2second shape
[in]tolrepresents 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]edPPoutput descriptor
[out]obsoleteEdPPin 4.0 this was outputEdPP
[in]shape1first shape
[in]shape2second shape
[in]tolrepresents 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

Copyright © 2017 Bentley Systems, Incorporated. All rights reserved.