6ba243335a6836adb5ccff58a2ae1e36f3badf71
[occt.git] / src / IntPolyh / IntPolyh_MaillageAffinage.hxx
1 // Created on: 1999-03-03
2 // Created by: Fabrice SERVANT
3 // Copyright (c) 1999 Matra Datavision
4 // Copyright (c) 1999-2014 OPEN CASCADE SAS
5 //
6 // This file is part of Open CASCADE Technology software library.
7 //
8 // This library is free software; you can redistribute it and/or modify it under
9 // the terms of the GNU Lesser General Public License version 2.1 as published
10 // by the Free Software Foundation, with special exception defined in the file
11 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
12 // distribution for complete text of the license and disclaimer of any warranty.
13 //
14 // Alternatively, this file may be used under the terms of Open CASCADE
15 // commercial license or contractual agreement.
16
17 #ifndef _IntPolyh_MaillageAffinage_HeaderFile
18 #define _IntPolyh_MaillageAffinage_HeaderFile
19
20 #include <Standard.hxx>
21 #include <Standard_DefineAlloc.hxx>
22 #include <Standard_Handle.hxx>
23
24 #include <Bnd_Box.hxx>
25 #include <Standard_Integer.hxx>
26 #include <Standard_Real.hxx>
27 #include <IntPolyh_ArrayOfPoints.hxx>
28 #include <IntPolyh_ArrayOfEdges.hxx>
29 #include <IntPolyh_ArrayOfTriangles.hxx>
30 #include <IntPolyh_ArrayOfCouples.hxx>
31 #include <IntPolyh_ArrayOfStartPoints.hxx>
32 #include <Standard_Boolean.hxx>
33 #include <TColStd_Array1OfReal.hxx>
34 #include <IntPolyh_ArrayOfSectionLines.hxx>
35 #include <IntPolyh_ArrayOfTangentZones.hxx>
36 class Adaptor3d_HSurface;
37 class Bnd_Box;
38 class IntPolyh_Point;
39 class IntPolyh_StartPoint;
40 class IntPolyh_Triangle;
41 class IntPolyh_SectionLine;
42
43
44 //! Provide the algorythms used in the package
45 class IntPolyh_MaillageAffinage 
46 {
47 public:
48
49   DEFINE_STANDARD_ALLOC
50
51   
52   Standard_EXPORT IntPolyh_MaillageAffinage(const Handle(Adaptor3d_HSurface)& S1, const Standard_Integer NbSU1, const Standard_Integer NbSV1, const Handle(Adaptor3d_HSurface)& S2, const Standard_Integer NbSU2, const Standard_Integer NbSV2, const Standard_Integer PRINT);
53   
54   Standard_EXPORT IntPolyh_MaillageAffinage(const Handle(Adaptor3d_HSurface)& S1, const Handle(Adaptor3d_HSurface)& S2, const Standard_Integer PRINT);
55   
56   //! Compute points on one surface and fill an array of points;
57   //! standard (default) method
58   Standard_EXPORT void FillArrayOfPnt (const Standard_Integer SurfID);
59   
60   //! isShiftFwd flag is added. The purpose is to define shift
61   //! of points along normal to the surface in this point. The
62   //! shift length represents maximal deflection of triangulation.
63   //! The direction (forward or reversed regarding to normal
64   //! direction) is defined by isShiftFwd flag.
65   //! Compute points on one surface and fill an array of points;
66   //! advanced method
67   Standard_EXPORT void FillArrayOfPnt (const Standard_Integer SurfID, const Standard_Boolean isShiftFwd);
68   
69   //! Compute points on one surface and fill an array of points;
70   //! standard (default) method
71   Standard_EXPORT void FillArrayOfPnt (const Standard_Integer SurfID, const TColStd_Array1OfReal& Upars, const TColStd_Array1OfReal& Vpars);
72   
73   //! isShiftFwd flag is added. The purpose is to define shift
74   //! of points along normal to the surface in this point. The
75   //! shift length represents maximal deflection of triangulation.
76   //! The direction (forward or reversed regarding to normal
77   //! direction) is defined by isShiftFwd flag.
78   //! Compute points on one surface and fill an array of points;
79   //! advanced method
80   Standard_EXPORT void FillArrayOfPnt (const Standard_Integer SurfID, const Standard_Boolean isShiftFwd, const TColStd_Array1OfReal& Upars, const TColStd_Array1OfReal& Vpars);
81   
82   //! Compute the common box  witch is the intersection
83   //! of the two bounding boxes,  and mark the points of
84   //! the two surfaces that are inside.
85   Standard_EXPORT void CommonBox (const Bnd_Box& B1, const Bnd_Box& B2, Standard_Real& xMin, Standard_Real& yMin, Standard_Real& zMin, Standard_Real& xMax, Standard_Real& yMax, Standard_Real& zMax);
86   
87   //! Compute edges from the array of points
88   Standard_EXPORT void FillArrayOfEdges (const Standard_Integer SurfID);
89   
90   //! Compute triangles from the array of points, and --
91   //! mark the triangles  that use marked points by the
92   //! CommonBox function.
93   Standard_EXPORT void FillArrayOfTriangles (const Standard_Integer SurfID);
94   
95   //! fill the  edge fields in  Triangle object  for the
96   //! two array of triangles.
97   Standard_EXPORT void LinkEdges2Triangles();
98   
99   //! Refine systematicaly all marked triangles of both surfaces
100   Standard_EXPORT void CommonPartRefinement();
101   
102   //! Refine systematicaly all marked triangles of ONE surface
103   Standard_EXPORT void LocalSurfaceRefinement (const Standard_Integer SurfId);
104   
105   //! Compute deflection  for   all  triangles  of  one
106   //! surface,and sort min and max of deflections
107   Standard_EXPORT void ComputeDeflections (const Standard_Integer SurfID);
108   
109   //! Refine  both  surfaces using  BoundSortBox  as --
110   //! rejection.  The  criterions  used to refine a  --
111   //! triangle are:  The deflection The  size of the --
112   //! bounding boxes   (one surface may be   very small
113   //! compared to the other)
114   Standard_EXPORT void TrianglesDeflectionsRefinementBSB();
115   
116   //! This fonction     Check if two triangles   are  in
117   //! contact or no,  return 1 if yes, return 0
118   //! if no.
119   Standard_EXPORT Standard_Integer TriContact (const IntPolyh_Point& P1, const IntPolyh_Point& P2, const IntPolyh_Point& P3, const IntPolyh_Point& Q1, const IntPolyh_Point& Q2, const IntPolyh_Point& Q3, Standard_Real& Angle) const;
120   
121   Standard_EXPORT Standard_Integer TriangleEdgeContact (const Standard_Integer TriSurfID, const Standard_Integer EdgeIndice, const IntPolyh_Point& P1, const IntPolyh_Point& P2, const IntPolyh_Point& P3, const IntPolyh_Point& C1, const IntPolyh_Point& C2, const IntPolyh_Point& C3, const IntPolyh_Point& Pe1, const IntPolyh_Point& Pe2, const IntPolyh_Point& E, const IntPolyh_Point& N, IntPolyh_StartPoint& SP1, IntPolyh_StartPoint& SP2) const;
122   
123   Standard_EXPORT Standard_Integer TriangleEdgeContact2 (const Standard_Integer TriSurfID, const Standard_Integer EdgeIndice, const IntPolyh_Triangle& Tri1, const IntPolyh_Triangle& Tri2, const IntPolyh_Point& P1, const IntPolyh_Point& P2, const IntPolyh_Point& P3, const IntPolyh_Point& C1, const IntPolyh_Point& C2, const IntPolyh_Point& C3, const IntPolyh_Point& Pe1, const IntPolyh_Point& Pe2, const IntPolyh_Point& E, const IntPolyh_Point& N, IntPolyh_StartPoint& SP1, IntPolyh_StartPoint& SP2) const;
124   
125   Standard_EXPORT Standard_Integer StartingPointsResearch (const Standard_Integer T1, const Standard_Integer T2, IntPolyh_StartPoint& SP1, IntPolyh_StartPoint& SP2) const;
126   
127   //! From  two  triangles compute intersection  points.
128   //! If I found   more  than two intersection  points
129   //! that's mean that those triangle are coplanar
130   Standard_EXPORT Standard_Integer StartingPointsResearch2 (const Standard_Integer T1, const Standard_Integer T2, IntPolyh_StartPoint& SP1, IntPolyh_StartPoint& SP2) const;
131   
132   Standard_EXPORT Standard_Integer NextStartingPointsResearch (const Standard_Integer T1, const Standard_Integer T2, const IntPolyh_StartPoint& SPInit, IntPolyh_StartPoint& SPNext) const;
133   
134   //! from  two triangles  and an intersection   point I
135   //! seach the other point (if it exist).
136   //! This function is used by StartPointChain
137   Standard_EXPORT Standard_Integer NextStartingPointsResearch2 (const Standard_Integer T1, const Standard_Integer T2, const IntPolyh_StartPoint& SPInit, IntPolyh_StartPoint& SPNext) const;
138   
139   //! Analyse  each couple of  triangles from the two --
140   //! array  of triangles,  to   see  if they are  in
141   //! contact,  and  compute the  incidence.  Then  put
142   //! couples  in contact  in  the  array  of  couples
143   Standard_EXPORT Standard_Integer TriangleCompare();
144   
145   //! The   same as   TriangleCompare, plus compute the
146   //! StartPoints without chaining them.
147   Standard_EXPORT Standard_Integer TriangleComparePSP();
148   
149   //! From the array  of couples compute  all the start
150   //! points and display them on the screen
151   Standard_EXPORT void StartPointsCalcul() const;
152   
153   //! Loop on the array of couples. Compute StartPoints.
154   //! Try to chain  the StartPoints into SectionLines or
155   //! put  the  point  in  the    ArrayOfTangentZones if
156   //! chaining it, is not possible.
157   Standard_EXPORT Standard_Integer StartPointsChain (IntPolyh_ArrayOfSectionLines& TSectionLines, IntPolyh_ArrayOfTangentZones& TTangentZones);
158   
159   //! Mainly  used  by StartPointsChain(), this function
160   //! try to compute the next StartPoint.
161   Standard_EXPORT Standard_Integer GetNextChainStartPoint (const IntPolyh_StartPoint& SPInit, IntPolyh_StartPoint& SPNext, IntPolyh_SectionLine& MySectionLine, IntPolyh_ArrayOfTangentZones& TTangentZones, const Standard_Boolean Prepend = Standard_False);
162   
163   Standard_EXPORT const IntPolyh_ArrayOfPoints& GetArrayOfPoints (const Standard_Integer SurfID) const;
164   
165   Standard_EXPORT const IntPolyh_ArrayOfEdges& GetArrayOfEdges (const Standard_Integer SurfID) const;
166   
167   Standard_EXPORT const IntPolyh_ArrayOfTriangles& GetArrayOfTriangles (const Standard_Integer SurfID) const;
168   
169   Standard_EXPORT Standard_Integer GetFinTE (const Standard_Integer SurfID) const;
170   
171   Standard_EXPORT Standard_Integer GetFinTT (const Standard_Integer SurfID) const;
172   
173   Standard_EXPORT Bnd_Box GetBox (const Standard_Integer SurfID) const;
174   
175   Standard_EXPORT void GetBoxDraw (const Standard_Integer SurfID) const;
176   
177   Standard_EXPORT const IntPolyh_ArrayOfStartPoints& GetArrayOfSP() const;
178   
179   //! This method returns array of couples of contact triangles.
180   Standard_EXPORT IntPolyh_ArrayOfCouples& GetArrayOfCouples();
181   
182   Standard_EXPORT void SetEnlargeZone (Standard_Boolean& EnlargeZone);
183   
184   Standard_EXPORT Standard_Boolean GetEnlargeZone() const;
185   
186   //! returns FlecheMin
187   Standard_EXPORT Standard_Real GetMinDeflection (const Standard_Integer SurfID) const;
188   
189   //! returns FlecheMax
190   Standard_EXPORT Standard_Real GetMaxDeflection (const Standard_Integer SurfID) const;
191
192
193
194
195 protected:
196
197
198
199
200
201 private:
202
203
204
205   Handle(Adaptor3d_HSurface) MaSurface1;
206   Handle(Adaptor3d_HSurface) MaSurface2;
207   Bnd_Box MyBox1;
208   Bnd_Box MyBox2;
209   Standard_Integer NbSamplesU1;
210   Standard_Integer NbSamplesU2;
211   Standard_Integer NbSamplesV1;
212   Standard_Integer NbSamplesV2;
213   Standard_Real FlecheMax1;
214   Standard_Real FlecheMax2;
215   Standard_Real FlecheMin1;
216   Standard_Real FlecheMin2;
217   Standard_Real FlecheMoy1;
218   Standard_Real FlecheMoy2;
219   IntPolyh_ArrayOfPoints TPoints1;
220   IntPolyh_ArrayOfPoints TPoints2;
221   IntPolyh_ArrayOfEdges TEdges1;
222   IntPolyh_ArrayOfEdges TEdges2;
223   IntPolyh_ArrayOfTriangles TTriangles1;
224   IntPolyh_ArrayOfTriangles TTriangles2;
225   IntPolyh_ArrayOfCouples TTrianglesContacts;
226   IntPolyh_ArrayOfStartPoints TStartPoints;
227   Standard_Boolean myEnlargeZone;
228
229
230 };
231
232
233
234
235
236
237
238 #endif // _IntPolyh_MaillageAffinage_HeaderFile