1 // Created on: 1995-07-02
2 // Created by: Laurent BUCHARD
3 // Copyright (c) 1995-1999 Matra Datavision
4 // Copyright (c) 1999-2014 OPEN CASCADE SAS
6 // This file is part of Open CASCADE Technology software library.
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.
14 // Alternatively, this file may be used under the terms of Open CASCADE
15 // commercial license or contractual agreement.
17 #ifndef _IntPatch_HInterTool_HeaderFile
18 #define _IntPatch_HInterTool_HeaderFile
20 #include <Standard.hxx>
21 #include <Standard_DefineAlloc.hxx>
22 #include <Standard_Handle.hxx>
24 #include <Standard_Real.hxx>
25 #include <Standard_Boolean.hxx>
26 #include <Standard_Integer.hxx>
27 class Adaptor3d_HSurface;
28 class Adaptor2d_HCurve2d;
30 class Adaptor3d_HVertex;
34 //! Tool for the intersection between 2 surfaces.
35 //! Regroupe pour l instant les methodes hors Adaptor3d...
36 class IntPatch_HInterTool
43 Standard_EXPORT IntPatch_HInterTool();
45 static Standard_Boolean SingularOnUMin (const Handle(Adaptor3d_HSurface)& S);
47 static Standard_Boolean SingularOnUMax (const Handle(Adaptor3d_HSurface)& S);
49 static Standard_Boolean SingularOnVMin (const Handle(Adaptor3d_HSurface)& S);
51 static Standard_Boolean SingularOnVMax (const Handle(Adaptor3d_HSurface)& S);
53 Standard_EXPORT static Standard_Integer NbSamplesU (const Handle(Adaptor3d_HSurface)& S, const Standard_Real u1, const Standard_Real u2);
55 Standard_EXPORT static Standard_Integer NbSamplesV (const Handle(Adaptor3d_HSurface)& S, const Standard_Real v1, const Standard_Real v2);
57 Standard_EXPORT Standard_Integer NbSamplePoints (const Handle(Adaptor3d_HSurface)& S);
59 Standard_EXPORT void SamplePoint (const Handle(Adaptor3d_HSurface)& S, const Standard_Integer Index, Standard_Real& U, Standard_Real& V) const;
61 //! Returns True if all the intersection point and edges
62 //! are known on the Arc.
63 //! The intersection point are given as vertices.
64 //! The intersection edges are given as intervals between
66 Standard_EXPORT static Standard_Boolean HasBeenSeen (const Handle(Adaptor2d_HCurve2d)& C);
68 //! returns the number of points which is used to make
69 //! a sample on the arc. this number is a function of
70 //! the Surface and the CurveOnSurface complexity.
71 Standard_EXPORT static Standard_Integer NbSamplesOnArc (const Handle(Adaptor2d_HCurve2d)& A);
73 //! Returns the parametric limits on the arc C.
74 //! These limits must be finite : they are either
75 //! the real limits of the arc, for a finite arc,
76 //! or a bounding box for an infinite arc.
77 Standard_EXPORT static void Bounds (const Handle(Adaptor2d_HCurve2d)& C, Standard_Real& Ufirst, Standard_Real& Ulast);
79 //! Projects the point P on the arc C.
80 //! If the methods returns Standard_True, the projection is
81 //! successful, and Paramproj is the parameter on the arc
82 //! of the projected point, Ptproj is the projected Point.
83 //! If the method returns Standard_False, Param proj and Ptproj
84 //! are not significant.
85 Standard_EXPORT static Standard_Boolean Project (const Handle(Adaptor2d_HCurve2d)& C, const gp_Pnt2d& P, Standard_Real& Paramproj, gp_Pnt2d& Ptproj);
87 //! Returns the parametric tolerance used to consider
88 //! that the vertex and another point meet, i-e
89 //! if Abs(parameter(Vertex) - parameter(OtherPnt))<=
90 //! Tolerance, the points are "merged".
91 Standard_EXPORT static Standard_Real Tolerance (const Handle(Adaptor3d_HVertex)& V, const Handle(Adaptor2d_HCurve2d)& C);
93 //! Returns the parameter of the vertex V on the arc A.
94 Standard_EXPORT static Standard_Real Parameter (const Handle(Adaptor3d_HVertex)& V, const Handle(Adaptor2d_HCurve2d)& C);
96 //! Returns the number of intersection points on the arc A.
97 Standard_EXPORT static Standard_Integer NbPoints (const Handle(Adaptor2d_HCurve2d)& C);
99 //! Returns the value (Pt), the tolerance (Tol), and
100 //! the parameter (U) on the arc A , of the intersection
101 //! point of range Index.
102 Standard_EXPORT static void Value (const Handle(Adaptor2d_HCurve2d)& C, const Standard_Integer Index, gp_Pnt& Pt, Standard_Real& Tol, Standard_Real& U);
104 //! Returns True if the intersection point of range Index
105 //! corresponds with a vertex on the arc A.
106 Standard_EXPORT static Standard_Boolean IsVertex (const Handle(Adaptor2d_HCurve2d)& C, const Standard_Integer Index);
108 //! When IsVertex returns True, this method returns the
109 //! vertex on the arc A.
110 Standard_EXPORT static void Vertex (const Handle(Adaptor2d_HCurve2d)& C, const Standard_Integer Index, Handle(Adaptor3d_HVertex)& V);
112 //! returns the number of part of A solution of the
113 //! of intersection problem.
114 Standard_EXPORT static Standard_Integer NbSegments (const Handle(Adaptor2d_HCurve2d)& C);
116 //! Returns True when the segment of range Index is not
117 //! open at the left side. In that case, IndFirst is the
118 //! range in the list intersection points (see NbPoints)
119 //! of the one which defines the left bound of the segment.
120 //! Otherwise, the method has to return False, and IndFirst
122 Standard_EXPORT static Standard_Boolean HasFirstPoint (const Handle(Adaptor2d_HCurve2d)& C, const Standard_Integer Index, Standard_Integer& IndFirst);
124 //! Returns True when the segment of range Index is not
125 //! open at the right side. In that case, IndLast is the
126 //! range in the list intersection points (see NbPoints)
127 //! of the one which defines the right bound of the segment.
128 //! Otherwise, the method has to return False, and IndLast
130 Standard_EXPORT static Standard_Boolean HasLastPoint (const Handle(Adaptor2d_HCurve2d)& C, const Standard_Integer Index, Standard_Integer& IndLast);
132 //! Returns True when the whole restriction is solution
133 //! of the intersection problem.
134 Standard_EXPORT static Standard_Boolean IsAllSolution (const Handle(Adaptor2d_HCurve2d)& C);
158 #include <IntPatch_HInterTool.lxx>
164 #endif // _IntPatch_HInterTool_HeaderFile