0026701: BOPAlgo_Builder::Perform crash.
[occt.git] / src / BOPTools / BOPTools_AlgoTools2D.hxx
1 // Created by: Peter KURNEV
2 // Copyright (c) 1999-2014 OPEN CASCADE SAS
3 //
4 // This file is part of Open CASCADE Technology software library.
5 //
6 // This library is free software; you can redistribute it and/or modify it under
7 // the terms of the GNU Lesser General Public License version 2.1 as published
8 // by the Free Software Foundation, with special exception defined in the file
9 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
10 // distribution for complete text of the license and disclaimer of any warranty.
11 //
12 // Alternatively, this file may be used under the terms of Open CASCADE
13 // commercial license or contractual agreement.
14
15 #ifndef _BOPTools_AlgoTools2D_HeaderFile
16 #define _BOPTools_AlgoTools2D_HeaderFile
17
18 #include <Standard.hxx>
19 #include <Standard_DefineAlloc.hxx>
20 #include <Standard_Handle.hxx>
21
22 #include <Standard_Boolean.hxx>
23 #include <Standard_Real.hxx>
24 #include <BOPCol_ListOfShape.hxx>
25 #include <Standard_Integer.hxx>
26 class TopoDS_Edge;
27 class TopoDS_Face;
28 class gp_Vec;
29 class Geom2d_Curve;
30 class Geom_Curve;
31 class BRepAdaptor_Surface;
32 class ProjLib_ProjectedCurve;
33 class IntTools_Context;
34
35
36
37 //! The class contains handy static functions
38 //! dealing with the topology
39 //! This is the copy of the BOPTools_AlgoTools2D.cdl
40 class BOPTools_AlgoTools2D 
41 {
42 public:
43
44   DEFINE_STANDARD_ALLOC
45
46   
47
48   //! Compute P-Curve for the edge <aE> on the face <aF>
49   //! Raises exception Standard_ConstructionError if projection algorithm fails
50   Standard_EXPORT static void BuildPCurveForEdgeOnFace (const TopoDS_Edge& aE, const TopoDS_Face& aF);
51   
52
53   //! Compute tangent for the edge  <aE> [in 3D]  at parameter <aT>
54   Standard_EXPORT static Standard_Boolean EdgeTangent (const TopoDS_Edge& anE, const Standard_Real aT, gp_Vec& Tau);
55   
56
57   //! Compute surface parameters <U,V> of the face <aF>
58   //! for  the point from the edge <aE> at parameter <aT>.
59   //! If <aE> has't pcurve on surface, algorithm tries to get it by
60   //! projection and can
61   //! raise exception Standard_ConstructionError if projection algorithm fails
62   Standard_EXPORT static void PointOnSurface (const TopoDS_Edge& aE, const TopoDS_Face& aF, const Standard_Real aT, Standard_Real& U, Standard_Real& V);
63   
64
65   //! Get P-Curve <aC>  for the edge <aE> on surface <aF> .
66   //! If the P-Curve does not exist, build  it using Make2D().
67   //! [aToler] - reached tolerance
68   //! Raises exception Standard_ConstructionError if algorithm Make2D() fails
69   Standard_EXPORT static void CurveOnSurface (const TopoDS_Edge& aE, const TopoDS_Face& aF, Handle(Geom2d_Curve)& aC, Standard_Real& aToler);
70   
71
72   //! Get P-Curve <aC>  for the edge <aE> on surface <aF> .
73   //! If the P-Curve does not exist, build  it using Make2D().
74   //! [aFirst, aLast] - range of the P-Curve
75   //! [aToler] - reached tolerance
76   //! Raises exception Standard_ConstructionError if algorithm Make2D() fails
77   Standard_EXPORT static void CurveOnSurface (const TopoDS_Edge& aE, const TopoDS_Face& aF, Handle(Geom2d_Curve)& aC, Standard_Real& aFirst, Standard_Real& aLast, Standard_Real& aToler);
78   
79
80   //! Returns TRUE if the edge <aE>  has  P-Curve <aC>
81   //! on surface <aF> .
82   //! [aFirst, aLast] - range of the P-Curve
83   //! [aToler] - reached tolerance
84   //! If the P-Curve does not exist, aC.IsNull()=TRUE.
85   Standard_EXPORT static Standard_Boolean HasCurveOnSurface (const TopoDS_Edge& aE, const TopoDS_Face& aF, Handle(Geom2d_Curve)& aC, Standard_Real& aFirst, Standard_Real& aLast, Standard_Real& aToler);
86   
87
88   //! Returns TRUE if the edge <aE>  has  P-Curve <aC>
89   //! on surface <aF> .
90   //! If the P-Curve does not exist, aC.IsNull()=TRUE.
91   Standard_EXPORT static Standard_Boolean HasCurveOnSurface (const TopoDS_Edge& aE, const TopoDS_Face& aF);
92   
93
94   //! Adjust P-Curve <aC2D> (3D-curve <C3D>) on surface <aF> .
95   Standard_EXPORT static void AdjustPCurveOnFace (const TopoDS_Face& aF, const Handle(Geom_Curve)& C3D, const Handle(Geom2d_Curve)& aC2D, Handle(Geom2d_Curve)& aC2DA);
96   
97
98   //! Adjust P-Curve <aC2D> (3D-curve <C3D>) on surface <aF> .
99   //! [aT1,  aT2] - range to adjust
100   Standard_EXPORT static void AdjustPCurveOnFace (const TopoDS_Face& aF, const Standard_Real aT1, const Standard_Real aT2, const Handle(Geom2d_Curve)& aC2D, Handle(Geom2d_Curve)& aC2DA);
101   
102
103   //! Adjust P-Curve <aC2D> (3D-curve <C3D>) on surface <aF> .
104   //! [aT1,  aT2] - range to adjust
105   Standard_EXPORT static void AdjustPCurveOnFace (const BRepAdaptor_Surface& aF, const Standard_Real aT1, const Standard_Real aT2, const Handle(Geom2d_Curve)& aC2D, Handle(Geom2d_Curve)& aC2DA);
106   
107
108   //! Compute intermediate  value in  between [aFirst, aLast] .
109   Standard_EXPORT static Standard_Real IntermediatePoint (const Standard_Real aFirst, const Standard_Real aLast);
110   
111
112   //! Compute intermediate value of parameter for the edge <anE>.
113   Standard_EXPORT static Standard_Real IntermediatePoint (const TopoDS_Edge& anE);
114   
115   //! Build pcurve of edge on face if the surface is plane, and update the edge.
116   Standard_EXPORT static void BuildPCurveForEdgeOnPlane (const TopoDS_Edge& theE, const TopoDS_Face& theF);
117   
118   //! Build pcurve of edge on face if the surface is plane, but do not update the edge.
119   //! The output are the pcurve and the flag telling that pcurve was built.
120   Standard_EXPORT static void BuildPCurveForEdgeOnPlane (const TopoDS_Edge& theE, const TopoDS_Face& theF,
121                                                          Handle(Geom2d_Curve)& aC2D, Standard_Boolean& bToUpdate);
122
123   Standard_EXPORT static void BuildPCurveForEdgesOnPlane (const BOPCol_ListOfShape& theLE, const TopoDS_Face& theF);
124   
125
126   //! Make P-Curve <aC> for the edge <aE> on surface <aF> .
127   //! [aFirst, aLast] - range of the P-Curve
128   //! [aToler] - reached tolerance
129   //! Raises exception Standard_ConstructionError if algorithm fails
130   Standard_EXPORT static void Make2D (const TopoDS_Edge& aE, const TopoDS_Face& aF, Handle(Geom2d_Curve)& aC, Standard_Real& aFirst, Standard_Real& aLast, Standard_Real& aToler);
131   
132
133   //! Make P-Curve <aC> for the 3D-curve <C3D> on surface <aF> .
134   //! [aToler] - reached tolerance
135   //! Raises exception Standard_ConstructionError if projection algorithm fails
136   Standard_EXPORT static void MakePCurveOnFace (const TopoDS_Face& aF, const Handle(Geom_Curve)& C3D, Handle(Geom2d_Curve)& aC, Standard_Real& aToler);
137   
138
139   //! Make P-Curve <aC> for the 3D-curve <C3D> on surface <aF> .
140   //! [aT1,  aT2] - range to build
141   //! [aToler] - reached tolerance
142   //! Raises exception Standard_ConstructionError if projection algorithm fails
143   Standard_EXPORT static void MakePCurveOnFace (const TopoDS_Face& aF, const Handle(Geom_Curve)& C3D, const Standard_Real aT1, const Standard_Real aT2, Handle(Geom2d_Curve)& aC, Standard_Real& aToler);
144   
145
146   //! Make empty  P-Curve <aC> of relevant to <PC> type
147   Standard_EXPORT static void MakePCurveOfType (const ProjLib_ProjectedCurve& PC, Handle(Geom2d_Curve)& aC);
148   
149
150   //! Attach P-Curve from the edge <aEold> on surface <aF>
151   //! to the edge <aEnew>
152   //! Returns 0 in case of success
153   Standard_EXPORT static Standard_Integer AttachExistingPCurve (const TopoDS_Edge& aEold, const TopoDS_Edge& aEnew, const TopoDS_Face& aF, const Handle(IntTools_Context)& aCtx);
154
155
156
157
158 protected:
159
160
161
162
163
164 private:
165
166
167
168
169
170 };
171
172
173
174
175
176
177
178 #endif // _BOPTools_AlgoTools2D_HeaderFile