|
Open CASCADE Technology
6.7.1
|
This class is intended to control and, if possible, redefine
the order of a list of edges which define a wire
Edges are not given directly, but as their bounds (start,end)
This allows to use this tool, either on existing wire, or on
data just taken from a file (coordinates are easy to get)
It can work, either in 2D, or in 3D, but not miscible
Warning about tolerance : according to the mode (2D/3D), it
must be given as 2D or 3D (i.e. metric) tolerance, uniform
on the whole list
Two phases : firstly add the couples (start,end)
secondly perform then get the result
More...
#include <ShapeAnalysis_WireOrder.hxx>
Public Member Functions | |
| ShapeAnalysis_WireOrder () | |
| Empty constructor More... | |
| ShapeAnalysis_WireOrder (const Standard_Boolean mode3d, const Standard_Real tol) | |
| Creates a WireOrder in 3D (if mode3d is True) or 2D (if False) with a tolerance More... | |
| void | SetMode (const Standard_Boolean mode3d, const Standard_Real tol) |
| Sets new values. Clears the connexion list If <mode3d> changes, also clears the edge list (else, doesnt) More... | |
| Standard_Real | Tolerance () const |
| Returns the working tolerance More... | |
| void | Clear () |
| Clears the list of edges, but not mode and tol More... | |
| void | Add (const gp_XYZ &start3d, const gp_XYZ &end3d) |
| Adds a couple of points 3D (start,end) More... | |
| void | Add (const gp_XY &start2d, const gp_XY &end2d) |
| Adds a couple of points 2D (start,end) More... | |
| Standard_Integer | NbEdges () const |
| Returns the count of added couples of points (one per edges) More... | |
| Standard_Boolean & | KeepLoopsMode () |
| If this mode is True method perform does not sort edges of different loops. The resulting order is first loop, second one etc... More... | |
| void | Perform (const Standard_Boolean closed=Standard_True) |
| Computes the better order If <closed> is True (D) considers also closure Optimised if the couples were already in order The criterium is : two couples in order if distance between end-prec and start-cur is less then starting tolerance <tol> Else, the smallest distance is reached Gap corresponds to a smallest distance greater than <tol> More... | |
| Standard_Boolean | IsDone () const |
| Tells if Perform has been done Else, the following methods returns original values More... | |
| Standard_Integer | Status () const |
| Returns the status of the order (0 if not done) : 0 : all edges are direct and in sequence 1 : all edges are direct but some are not in sequence 2 : in addition, unresolved gaps remain -1 : some edges are reversed, but no gap remain -2 : some edges are reversed and some gaps remain -10 : COULD NOT BE RESOLVED, Failure on Reorder gap : regarding starting <tol> More... | |
| Standard_Integer | Ordered (const Standard_Integer n) const |
Returns the number of original edge which correspond to the <br>
newly ordered number <n> <br>
Warning : the returned value is NEGATIVE if edge should be reversed | |
| void | XYZ (const Standard_Integer num, gp_XYZ &start3d, gp_XYZ &end3d) const |
| Returns the values of the couple <num>, as 3D values More... | |
| void | XY (const Standard_Integer num, gp_XY &start2d, gp_XY &end2d) const |
| Returns the values of the couple <num>, as 2D values More... | |
| Standard_Real | Gap (const Standard_Integer num=0) const |
| Returns the gap between a couple and its preceeding <num> is considered ordered If <num> = 0 (D), returns the greatest gap found More... | |
| void | SetChains (const Standard_Real gap) |
| Determines the chains inside which successive edges have a gap less than a given value. Queried by NbChains and Chain More... | |
| Standard_Integer | NbChains () const |
| Returns the count of computed chains More... | |
| void | Chain (const Standard_Integer num, Standard_Integer &n1, Standard_Integer &n2) const |
| Returns, for the chain n0 num, starting and ending numbers of edges. In the list of ordered edges (see Ordered for originals) More... | |
| void | SetCouples (const Standard_Real gap) |
| Determines the couples of edges for which end and start fit inside a given gap. Queried by NbCouples and Couple More... | |
| Standard_Integer | NbCouples () const |
| Returns the count of computed couples More... | |
| void | Couple (const Standard_Integer num, Standard_Integer &n1, Standard_Integer &n2) const |
| Returns, for the couple n0 num, the two implied edges In the list of ordered edges More... | |
This class is intended to control and, if possible, redefine
the order of a list of edges which define a wire
Edges are not given directly, but as their bounds (start,end)
This allows to use this tool, either on existing wire, or on
data just taken from a file (coordinates are easy to get)
It can work, either in 2D, or in 3D, but not miscible
Warning about tolerance : according to the mode (2D/3D), it
must be given as 2D or 3D (i.e. metric) tolerance, uniform
on the whole list
Two phases : firstly add the couples (start,end)
secondly perform then get the result
| ShapeAnalysis_WireOrder::ShapeAnalysis_WireOrder | ( | ) |
Empty constructor
| ShapeAnalysis_WireOrder::ShapeAnalysis_WireOrder | ( | const Standard_Boolean | mode3d, |
| const Standard_Real | tol | ||
| ) |
Creates a WireOrder in 3D (if mode3d is True) or 2D (if False)
with a tolerance
Adds a couple of points 3D (start,end)
Adds a couple of points 2D (start,end)
| void ShapeAnalysis_WireOrder::Chain | ( | const Standard_Integer | num, |
| Standard_Integer & | n1, | ||
| Standard_Integer & | n2 | ||
| ) | const |
Returns, for the chain n0 num, starting and ending numbers of
edges. In the list of ordered edges (see Ordered for originals)
| void ShapeAnalysis_WireOrder::Clear | ( | ) |
Clears the list of edges, but not mode and tol
| void ShapeAnalysis_WireOrder::Couple | ( | const Standard_Integer | num, |
| Standard_Integer & | n1, | ||
| Standard_Integer & | n2 | ||
| ) | const |
Returns, for the couple n0 num, the two implied edges
In the list of ordered edges
| Standard_Real ShapeAnalysis_WireOrder::Gap | ( | const Standard_Integer | num = 0 | ) | const |
Returns the gap between a couple and its preceeding
<num> is considered ordered
If <num> = 0 (D), returns the greatest gap found
| Standard_Boolean ShapeAnalysis_WireOrder::IsDone | ( | ) | const |
Tells if Perform has been done
Else, the following methods returns original values
| Standard_Boolean& ShapeAnalysis_WireOrder::KeepLoopsMode | ( | ) |
If this mode is True method perform does not sort edges of
different loops. The resulting order is first loop, second
one etc...
| Standard_Integer ShapeAnalysis_WireOrder::NbChains | ( | ) | const |
Returns the count of computed chains
| Standard_Integer ShapeAnalysis_WireOrder::NbCouples | ( | ) | const |
Returns the count of computed couples
| Standard_Integer ShapeAnalysis_WireOrder::NbEdges | ( | ) | const |
Returns the count of added couples of points (one per edges)
| Standard_Integer ShapeAnalysis_WireOrder::Ordered | ( | const Standard_Integer | n | ) | const |
Returns the number of original edge which correspond to the <br>
newly ordered number <n> <br>
Warning : the returned value is NEGATIVE if edge should be reversed
| void ShapeAnalysis_WireOrder::Perform | ( | const Standard_Boolean | closed = Standard_True | ) |
Computes the better order
If <closed> is True (D) considers also closure
Optimised if the couples were already in order
The criterium is : two couples in order if distance between
end-prec and start-cur is less then starting tolerance <tol>
Else, the smallest distance is reached
Gap corresponds to a smallest distance greater than <tol>
| void ShapeAnalysis_WireOrder::SetChains | ( | const Standard_Real | gap | ) |
Determines the chains inside which successive edges have a gap
less than a given value. Queried by NbChains and Chain
| void ShapeAnalysis_WireOrder::SetCouples | ( | const Standard_Real | gap | ) |
Determines the couples of edges for which end and start fit
inside a given gap. Queried by NbCouples and Couple
| void ShapeAnalysis_WireOrder::SetMode | ( | const Standard_Boolean | mode3d, |
| const Standard_Real | tol | ||
| ) |
Sets new values. Clears the connexion list
If <mode3d> changes, also clears the edge list (else, doesnt)
| Standard_Integer ShapeAnalysis_WireOrder::Status | ( | ) | const |
Returns the status of the order (0 if not done) :
0 : all edges are direct and in sequence
1 : all edges are direct but some are not in sequence
2 : in addition, unresolved gaps remain
-1 : some edges are reversed, but no gap remain
-2 : some edges are reversed and some gaps remain
-10 : COULD NOT BE RESOLVED, Failure on Reorder
gap : regarding starting <tol>
| Standard_Real ShapeAnalysis_WireOrder::Tolerance | ( | ) | const |
Returns the working tolerance
| void ShapeAnalysis_WireOrder::XY | ( | const Standard_Integer | num, |
| gp_XY & | start2d, | ||
| gp_XY & | end2d | ||
| ) | const |
Returns the values of the couple <num>, as 2D values
| void ShapeAnalysis_WireOrder::XYZ | ( | const Standard_Integer | num, |
| gp_XYZ & | start3d, | ||
| gp_XYZ & | end3d | ||
| ) | const |
Returns the values of the couple <num>, as 3D values
1.8.5