|
| | ShapeAnalysis_Wire () |
| | Empty constructor.
|
| |
| | ShapeAnalysis_Wire (const TopoDS_Wire &wire, const TopoDS_Face &face, const double precision) |
| | Creates object with standard TopoDS_Wire, face and precision.
|
| |
| | ShapeAnalysis_Wire (const occ::handle< ShapeExtend_WireData > &sbwd, const TopoDS_Face &face, const double precision) |
| | Creates the object with WireData object, face and precision.
|
| |
| void | Init (const TopoDS_Wire &wire, const TopoDS_Face &face, const double precision) |
| | Initializes the object with standard TopoDS_Wire, face and precision.
|
| |
| void | Init (const occ::handle< ShapeExtend_WireData > &sbwd, const TopoDS_Face &face, const double precision) |
| | Initializes the object with WireData object, face and precision.
|
| |
| void | Load (const TopoDS_Wire &wire) |
| | Loads the object with standard TopoDS_Wire.
|
| |
| void | Load (const occ::handle< ShapeExtend_WireData > &sbwd) |
| | Loads the object with WireData object.
|
| |
| void | SetFace (const TopoDS_Face &face) |
| | Loads the face the wire lies on.
|
| |
| void | SetFace (const TopoDS_Face &theFace, const occ::handle< ShapeAnalysis_Surface > &theSurfaceAnalysis) |
| | Loads the face the wire lies on and surface analysis object.
|
| |
| void | SetSurface (const occ::handle< ShapeAnalysis_Surface > &theSurfaceAnalysis) |
| | Loads the surface analysis object.
|
| |
| void | SetSurface (const occ::handle< Geom_Surface > &surface) |
| | Loads the surface the wire lies on.
|
| |
| void | SetSurface (const occ::handle< Geom_Surface > &surface, const TopLoc_Location &location) |
| | Loads the surface the wire lies on.
|
| |
| void | SetPrecision (const double precision) |
| |
| void | ClearStatuses () |
| | Unsets all the status and distance fields wire, face and precision are not cleared.
|
| |
| bool | IsLoaded () const |
| | Returns True if wire is loaded and has number of edges >0.
|
| |
| bool | IsReady () const |
| | Returns True if IsLoaded and underlying face is not null.
|
| |
| double | Precision () const |
| | Returns the value of precision.
|
| |
| const occ::handle< ShapeExtend_WireData > & | WireData () const |
| | Returns wire object being analyzed.
|
| |
| int | NbEdges () const |
| | Returns the number of edges in the wire, or 0 if it is not loaded.
|
| |
| const TopoDS_Face & | Face () const |
| | Returns the working face.
|
| |
| const occ::handle< ShapeAnalysis_Surface > & | Surface () const |
| | Returns the working surface.
|
| |
| bool | Perform () |
| | Performs all the checks in the following order : CheckOrder, CheckSmall, CheckConnected, CheckEdgeCurves, CheckDegenerated, CheckSelfIntersection, CheckLacking, CheckClosed Returns: True if at least one method returned True; For deeper analysis use Status...(status) methods.
|
| |
| bool | CheckOrder (const bool isClosed=true, const bool mode3d=true) |
| | Calls CheckOrder and returns False if wire is already ordered (tail-to-head), True otherwise Flag <isClosed> defines if the wire is closed or not Flag <mode3d> defines which mode is used (3d or 2d)
|
| |
| bool | CheckConnected (const double prec=0.0) |
| | Calls to CheckConnected for each edge Returns: True if at least one pair of disconnected edges (not sharing the same vertex) was detected.
|
| |
| bool | CheckSmall (const double precsmall=0.0) |
| | Calls to CheckSmall for each edge Returns: True if at least one small edge was detected.
|
| |
| bool | CheckEdgeCurves () |
| | Checks edges geometry (consistency of 2d and 3d senses, adjasment of curves to the vertices, etc.). The order of the checks : Call ShapeAnalysis_Wire to check: ShapeAnalysis_Edge::CheckCurve3dWithPCurve (1), ShapeAnalysis_Edge::CheckVertcesWithPCurve (2), ShapeAnalysis_Edge::CheckVertcesWithCurve3d (3), CheckSeam (4) Additional: CheckGap3d (5), CheckGap2d (6), ShapeAnalysis_Edge::CheckSameParameter (7) Returns: True if at least one check returned True Remark: The numbers in brackets show with what DONEi or FAILi the status can be queried.
|
| |
| bool | CheckDegenerated () |
| | Calls to CheckDegenerated for each edge Returns: True if at least one incorrect degenerated edge was detected.
|
| |
| bool | CheckClosed (const double prec=0.0) |
| | Checks if wire is closed, performs CheckConnected, CheckDegenerated and CheckLacking for the first and the last edges Returns: True if at least one check returned True Status: FAIL1 or DONE1: see CheckConnected FAIL2 or DONE2: see CheckDegenerated.
|
| |
| bool | CheckSelfIntersection () |
| | Checks self-intersection of the wire (considering pcurves) Looks for self-intersecting edges and each pair of intersecting edges. Warning: It does not check each edge with any other one (only each two adjacent edges) The order of the checks : CheckSelfIntersectingEdge, CheckIntersectingEdges Returns: True if at least one check returned True Status: FAIL1 or DONE1 - see CheckSelfIntersectingEdge FAIL2 or DONE2 - see CheckIntersectingEdges.
|
| |
| bool | CheckLacking () |
| | Calls to CheckLacking for each edge Returns: True if at least one lacking edge was detected.
|
| |
| bool | CheckGaps3d () |
| |
| bool | CheckGaps2d () |
| |
| bool | CheckCurveGaps () |
| |
| bool | CheckOrder (ShapeAnalysis_WireOrder &sawo, bool isClosed=true, bool theMode3D=true, bool theModeBoth=false) |
| | Analyzes the order of the edges in the wire, uses class WireOrder for that purpose. Flag <isClosed> defines if the wire is closed or not Flag <theMode3D> defines 3D or 2d mode. Flag <theModeBoth> defines miscible mode and the flag <theMode3D> is ignored. Returns False if wire is already ordered (tail-to-head), True otherwise. Use returned WireOrder object for deeper analysis. Status: OK : the same edges orientation, the same edges sequence DONE1: the same edges orientation, not the same edges sequence DONE2: as DONE1 and gaps more than myPrecision DONE3: not the same edges orientation (some need to be reversed) DONE4: as DONE3 and gaps more than myPrecision FAIL : algorithm failed (could not detect order)
|
| |
| bool | CheckConnected (const int num, const double prec=0.0) |
| | Checks connected edges (num-th and preceding). Tests with starting preci from <SBWD> or with <prec> if it is greater. Considers Vertices. Returns: False if edges are connected by the common vertex, else True Status : OK : Vertices (end of num-1 th edge and start on num-th one) are already the same DONE1 : Absolutely confused (gp::Resolution) DONE2 : Confused at starting <preci> from <SBWD> DONE3 : Confused at <prec> but not <preci> FAIL1 : Not confused FAIL2 : Not confused but confused with <preci> if reverse num-th edge.
|
| |
| bool | CheckSmall (const int num, const double precsmall=0.0) |
| | Checks if an edge has a length not greater than myPreci or precsmall (if it is smaller) Returns: False if its length is greater than precision Status: OK : edge is not small or degenerated DONE1: edge is small, vertices are the same DONE2: edge is small, vertices are not the same FAIL : no 3d curve and pcurve.
|
| |
| bool | CheckSeam (const int num, occ::handle< Geom2d_Curve > &C1, occ::handle< Geom2d_Curve > &C2, double &cf, double &cl) |
| | Checks if a seam pcurves are correct oriented Returns: False (status OK) if given edge is not a seam or if it is OK C1 - current pcurve for FORWARD edge, C2 - current pcurve for REVERSED edge (if returns True they should be swapped for the seam), cf, cl - first and last parameters on curves Status: OK : Pcurves are correct or edge is not seam DONE : Seam pcurves should be swapped.
|
| |
| bool | CheckSeam (const int num) |
| | Checks if a seam pcurves are correct oriented See previous functions for details.
|
| |
| bool | CheckDegenerated (const int num, gp_Pnt2d &dgnr1, gp_Pnt2d &dgnr2) |
| | Checks for degenerated edge between two adjacent ones. Fills parameters dgnr1 and dgnr2 with points in parametric space that correspond to the singularity (either gap that needs to be filled by degenerated edge or that already filled) Returns: False if no singularity or edge is already degenerated, otherwise True Status: OK : No surface singularity, or edge is already degenerated DONE1: Degenerated edge should be inserted (gap in 2D) DONE2: Edge <num> should be made degenerated (recompute pcurve and set the flag) FAIL1: One of edges neighbouring to degenerated one has no pcurve FAIL2: Edge marked as degenerated and has no pcurve but singularity is not detected.
|
| |
| bool | CheckDegenerated (const int num) |
| | Checks for degenerated edge between two adjacent ones. Remark : Calls previous function Status : See the function above for details.
|
| |
| bool | CheckGap3d (const int num=0) |
| | Checks gap between edges in 3D (3d curves). Checks the distance between ends of 3d curves of the num-th and preceding edge. The distance can be queried by MinDistance3d.
|
| |
| bool | CheckGap2d (const int num=0) |
| | Checks gap between edges in 2D (pcurves). Checks the distance between ends of pcurves of the num-th and preceding edge. The distance can be queried by MinDistance2d.
|
| |
| bool | CheckCurveGap (const int num=0) |
| | Checks gap between points on 3D curve and points on surface generated by pcurve of the num-th edge. The distance can be queried by MinDistance3d.
|
| |
| bool | CheckSelfIntersectingEdge (const int num, NCollection_Sequence< IntRes2d_IntersectionPoint > &points2d, NCollection_Sequence< gp_Pnt > &points3d) |
| | Checks if num-th edge is self-intersecting. Self-intersection is reported only if intersection point lies outside of both end vertices of the edge. Returns: True if edge is self-intersecting. If returns True it also fills the sequences of intersection points and corresponding 3d points (only that are not enclosed by a vertices) Status: FAIL1 : No pcurve FAIL2 : No vertices DONE1 : Self-intersection found.
|
| |
| bool | CheckSelfIntersectingEdge (const int num) |
| |
| bool | CheckIntersectingEdges (const int num, NCollection_Sequence< IntRes2d_IntersectionPoint > &points2d, NCollection_Sequence< gp_Pnt > &points3d, NCollection_Sequence< double > &errors) |
| | Checks two adjacent edges for intersecting. Intersection is reported only if intersection point is not enclosed by the common end vertex of the edges. Returns: True if intersection is found. If returns True it also fills the sequences of intersection points, corresponding 3d points, and errors for them (half-distances between intersection points in 3d calculated from one and from another edge) Status: FAIL1 : No pcurve FAIL2 : No vertices DONE1 : Self-intersection found.
|
| |
| bool | CheckIntersectingEdges (const int num) |
| | Checks two adjacent edges for intersecting. Remark : Calls the previous method Status : See the function above for details.
|
| |
| bool | CheckIntersectingEdges (const int num1, const int num2, NCollection_Sequence< IntRes2d_IntersectionPoint > &points2d, NCollection_Sequence< gp_Pnt > &points3d, NCollection_Sequence< double > &errors) |
| | Checks i-th and j-th edges for intersecting. Remark : See the previous method for details.
|
| |
| bool | CheckIntersectingEdges (const int num1, const int num2) |
| | Checks i-th and j-th edges for intersecting. Remark : Calls previous method. Status : See the function above for details.
|
| |
| bool | CheckLacking (const int num, const double Tolerance, gp_Pnt2d &p2d1, gp_Pnt2d &p2d2) |
| | Checks if there is a gap in 2d between edges, not comprised by the tolerance of their common vertex. If <Tolerance> is greater than 0. and less than tolerance of the vertex, then this value is used for check. Returns: True if not closed gap was detected p2d1 and p2d2 are the endpoint of <num-1>th edge and start of the <num>th edge in 2d. Status: OK: No edge is lacking (3d and 2d connection) FAIL1: edges have no vertices (at least one of them) FAIL2: edges are neither connected by common vertex, nor have coincided vertices FAIL1: edges have no pcurves DONE1: the gap is detected which cannot be closed by the tolerance of the common vertex (or with value of <Tolerance>) DONE2: is set (together with DONE1) if gap is detected and the vector (p2d2 - p2d1) goes in direction opposite to the pcurves of the edges (if angle is more than 0.9*PI).
|
| |
| bool | CheckLacking (const int num, const double Tolerance=0.0) |
| | Checks if there is a gap in 2D between edges and not comprised by vertex tolerance The value of SBWD.thepreci is used. Returns: False if no edge should be inserted Status: OK : No edge is lacking (3d and 2d connection) DONE1 : The vertex tolerance should be increased only (2d gap is small) DONE2 : Edge can be inserted (3d and 2d gaps are large enough)
|
| |
| bool | CheckOuterBound (const bool APIMake=true) |
| | Checks if wire defines an outer bound on the face Uses ShapeAnalysis::IsOuterBound for analysis If <APIMake> is True uses BRepAPI_MakeWire to build the wire, if False (to be used only when edges share common vertices) uses BRep_Builder to build the wire.
|
| |
| bool | CheckNotchedEdges (const int num, int &shortNum, double ¶m, const double Tolerance=0.0) |
| | Detects a notch.
|
| |
| bool | CheckSmallArea (const TopoDS_Wire &theWire) |
| | Checks if wire has parametric area less than precision.
|
| |
| bool | CheckShapeConnect (const TopoDS_Shape &shape, const double prec=0.0) |
| | Checks with what orientation <shape> (wire or edge) can be connected to the wire. Tests distances with starting <preci> from <SBWD> (close confusion), but if given <prec> is greater, tests with <prec> (coarse confusion). The smallest found distance can be returned by MinDistance3d.
|
| |
| bool | CheckShapeConnect (double &tailhead, double &tailtail, double &headtail, double &headhead, const TopoDS_Shape &shape, const double prec=0.0) |
| | The same as previous CheckShapeConnect but is more advanced. It returns the distances between each end of <sbwd> and each end of <shape>. For example, <tailhead> stores distance between tail of <sbwd> and head of <shape> Remark: First method CheckShapeConnect calls this one.
|
| |
| bool | CheckLoop (NCollection_IndexedMap< TopoDS_Shape, TopTools_ShapeMapHasher > &aMapLoopVertices, NCollection_DataMap< TopoDS_Shape, NCollection_List< TopoDS_Shape >, TopTools_ShapeMapHasher > &aMapVertexEdges, NCollection_Map< TopoDS_Shape, TopTools_ShapeMapHasher > &aMapSmallEdges, NCollection_Map< TopoDS_Shape, TopTools_ShapeMapHasher > &aMapSeemEdges) |
| | Checks existence of loop on wire and return vertices which are loop vertices (vertices belonging to a few pairs of edges)
|
| |
| bool | CheckTail (const TopoDS_Edge &theEdge1, const TopoDS_Edge &theEdge2, const double theMaxSine, const double theMaxWidth, const double theMaxTolerance, TopoDS_Edge &theEdge11, TopoDS_Edge &theEdge12, TopoDS_Edge &theEdge21, TopoDS_Edge &theEdge22) |
| |
| bool | StatusOrder (const ShapeExtend_Status Status) const |
| |
| bool | StatusConnected (const ShapeExtend_Status Status) const |
| |
| bool | StatusEdgeCurves (const ShapeExtend_Status Status) const |
| |
| bool | StatusDegenerated (const ShapeExtend_Status Status) const |
| |
| bool | StatusClosed (const ShapeExtend_Status Status) const |
| |
| bool | StatusSmall (const ShapeExtend_Status Status) const |
| |
| bool | StatusSelfIntersection (const ShapeExtend_Status Status) const |
| |
| bool | StatusLacking (const ShapeExtend_Status Status) const |
| |
| bool | StatusGaps3d (const ShapeExtend_Status Status) const |
| |
| bool | StatusGaps2d (const ShapeExtend_Status Status) const |
| |
| bool | StatusCurveGaps (const ShapeExtend_Status Status) const |
| |
| bool | StatusLoop (const ShapeExtend_Status Status) const |
| |
| bool | LastCheckStatus (const ShapeExtend_Status Status) const |
| | Querying the status of the LAST performed 'Advanced' checking procedure.
|
| |
| double | MinDistance3d () const |
| | Returns the last lowest distance in 3D computed by CheckOrientation, CheckConnected, CheckContinuity3d, CheckVertex, CheckNewVertex.
|
| |
| double | MinDistance2d () const |
| | Returns the last lowest distance in 2D-UV computed by CheckContinuity2d.
|
| |
| double | MaxDistance3d () const |
| | Returns the last maximal distance in 3D computed by CheckOrientation, CheckConnected, CheckContinuity3d, CheckVertex, CheckNewVertex, CheckSameParameter.
|
| |
| double | MaxDistance2d () const |
| | Returns the last maximal distance in 2D-UV computed by CheckContinuity2d.
|
| |
 Public Member Functions inherited from Standard_Transient |
| | Standard_Transient () |
| | Empty constructor.
|
| |
| | Standard_Transient (const Standard_Transient &) |
| | Copy constructor – does nothing.
|
| |
| Standard_Transient & | operator= (const Standard_Transient &) |
| | Assignment operator, needed to avoid copying reference counter.
|
| |
| virtual | ~Standard_Transient ()=default |
| | Destructor must be virtual.
|
| |
| virtual const opencascade::handle< Standard_Type > & | DynamicType () const |
| | Returns a type descriptor about this object.
|
| |
| bool | IsInstance (const opencascade::handle< Standard_Type > &theType) const |
| | Returns a true value if this is an instance of Type.
|
| |
| bool | IsInstance (const char *const theTypeName) const |
| | Returns a true value if this is an instance of TypeName.
|
| |
| bool | IsKind (const opencascade::handle< Standard_Type > &theType) const |
| | Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.
|
| |
| bool | IsKind (const char *const theTypeName) const |
| | Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.
|
| |
| Standard_Transient * | This () const |
| | Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.
|
| |
| int | GetRefCount () const noexcept |
| | Get the reference counter of this object.
|
| |
| void | IncrementRefCounter () noexcept |
| | Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.
|
| |
| int | DecrementRefCounter () noexcept |
| | Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.
|
| |
| virtual void | Delete () const |
| | Memory deallocator for transient classes.
|
| |
This class provides analysis of a wire to be compliant to CAS.CADE requirements.
The functionalities provided are the following:
- consistency of 2d and 3d edge curve senses
- connection of adjacent edges regarding to: a. their vertices b. their pcurves c. their 3d curves
- adjacency of the edge vertices to its pcurve and 3d curve
- if a wire is closed or not (considering its 3d and 2d contour)
- if a wire is outer on its face (considering pcurves)
This class can be used in conjunction with class ShapeFix_Wire, which will fix the problems detected by this class.
The methods of the given class match to ones of the class ShapeFix_Wire, e.g., CheckSmall and FixSmall. This class also includes some auxiliary methods (e.g., CheckOuterBound, etc.), which have no pair in ShapeFix_Wire.
Like methods of ShapeFix_Wire the ones of this class are grouped into two levels:
- Public which are recommended for use (the most global method is Perform),
- Advanced, for optional use only
For analyzing result of Public API checking methods use corresponding Status... method. The 'advanced' functions share the single status field which contains the result of the last performed 'advanced' method. It is queried by the method LastCheckStatus().
In order to prepare an analyzer, it is necessary to load a wire, set face and precision.
1.10.0