1 // Created on: 1993-05-14
2 // Created by: Bruno DUMORTIER
3 // Copyright (c) 1993-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 _GeomAdaptor_Surface_HeaderFile
18 #define _GeomAdaptor_Surface_HeaderFile
20 #include <Adaptor3d_Surface.hxx>
21 #include <BSplSLib_Cache.hxx>
22 #include <GeomAbs_Shape.hxx>
23 #include <GeomEvaluator_Surface.hxx>
24 #include <Geom_Surface.hxx>
25 #include <Standard_NullObject.hxx>
26 #include <TColStd_Array1OfReal.hxx>
28 DEFINE_STANDARD_HANDLE(GeomAdaptor_Surface, Adaptor3d_Surface)
30 //! An interface between the services provided by any
31 //! surface from the package Geom and those required
32 //! of the surface by algorithms which use it.
33 //! Creation of the loaded surface the surface is C1 by piece
35 //! Polynomial coefficients of BSpline surfaces used for their evaluation are
36 //! cached for better performance. Therefore these evaluations are not
37 //! thread-safe and parallel evaluations need to be prevented.
38 class GeomAdaptor_Surface : public Adaptor3d_Surface
40 DEFINE_STANDARD_RTTIEXT(GeomAdaptor_Surface, Adaptor3d_Surface)
44 : myUFirst(0.), myULast(0.),
45 myVFirst(0.), myVLast (0.),
46 myTolU(0.), myTolV(0.),
47 mySurfaceType (GeomAbs_OtherSurface) {}
49 GeomAdaptor_Surface(const Handle(Geom_Surface)& theSurf)
50 : myTolU(0.), myTolV(0.)
55 //! Standard_ConstructionError is raised if UFirst>ULast or VFirst>VLast
56 GeomAdaptor_Surface (const Handle(Geom_Surface)& theSurf,
57 const Standard_Real theUFirst, const Standard_Real theULast,
58 const Standard_Real theVFirst, const Standard_Real theVLast,
59 const Standard_Real theTolU = 0.0, const Standard_Real theTolV = 0.0)
61 Load (theSurf, theUFirst, theULast, theVFirst, theVLast, theTolU, theTolV);
64 //! Shallow copy of adaptor
65 Standard_EXPORT virtual Handle(Adaptor3d_Surface) ShallowCopy() const Standard_OVERRIDE;
67 void Load (const Handle(Geom_Surface)& theSurf)
69 if (theSurf.IsNull()) { throw Standard_NullObject("GeomAdaptor_Surface::Load"); }
71 Standard_Real aU1, aU2, aV1, aV2;
72 theSurf->Bounds (aU1, aU2, aV1, aV2);
73 load (theSurf, aU1, aU2, aV1, aV2);
76 //! Standard_ConstructionError is raised if theUFirst>theULast or theVFirst>theVLast
77 void Load (const Handle(Geom_Surface)& theSurf,
78 const Standard_Real theUFirst, const Standard_Real theULast,
79 const Standard_Real theVFirst, const Standard_Real theVLast,
80 const Standard_Real theTolU = 0.0, const Standard_Real theTolV = 0.0)
82 if (theSurf.IsNull()) { throw Standard_NullObject("GeomAdaptor_Surface::Load"); }
83 if (theUFirst > theULast || theVFirst > theVLast) { throw Standard_ConstructionError("GeomAdaptor_Surface::Load"); }
85 load (theSurf, theUFirst, theULast, theVFirst, theVLast, theTolU, theTolV);
88 const Handle(Geom_Surface)& Surface() const { return mySurface; }
90 virtual Standard_Real FirstUParameter() const Standard_OVERRIDE { return myUFirst; }
92 virtual Standard_Real LastUParameter() const Standard_OVERRIDE { return myULast; }
94 virtual Standard_Real FirstVParameter() const Standard_OVERRIDE { return myVFirst; }
96 virtual Standard_Real LastVParameter() const Standard_OVERRIDE { return myVLast; }
98 Standard_EXPORT GeomAbs_Shape UContinuity() const Standard_OVERRIDE;
100 Standard_EXPORT GeomAbs_Shape VContinuity() const Standard_OVERRIDE;
102 //! Returns the number of U intervals for continuity
103 //! <S>. May be one if UContinuity(me) >= <S>
104 Standard_EXPORT Standard_Integer NbUIntervals (const GeomAbs_Shape S) const Standard_OVERRIDE;
106 //! Returns the number of V intervals for continuity
107 //! <S>. May be one if VContinuity(me) >= <S>
108 Standard_EXPORT Standard_Integer NbVIntervals (const GeomAbs_Shape S) const Standard_OVERRIDE;
110 //! Returns the intervals with the requested continuity
111 //! in the U direction.
112 Standard_EXPORT void UIntervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const Standard_OVERRIDE;
114 //! Returns the intervals with the requested continuity
115 //! in the V direction.
116 Standard_EXPORT void VIntervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const Standard_OVERRIDE;
118 //! Returns a surface trimmed in the U direction
119 //! equivalent of <me> between
120 //! parameters <First> and <Last>. <Tol> is used to
121 //! test for 3d points confusion.
122 //! If <First> >= <Last>
123 Standard_EXPORT Handle(Adaptor3d_Surface) UTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const Standard_OVERRIDE;
125 //! Returns a surface trimmed in the V direction between
126 //! parameters <First> and <Last>. <Tol> is used to
127 //! test for 3d points confusion.
128 //! If <First> >= <Last>
129 Standard_EXPORT Handle(Adaptor3d_Surface) VTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const Standard_OVERRIDE;
131 Standard_EXPORT Standard_Boolean IsUClosed() const Standard_OVERRIDE;
133 Standard_EXPORT Standard_Boolean IsVClosed() const Standard_OVERRIDE;
135 Standard_EXPORT Standard_Boolean IsUPeriodic() const Standard_OVERRIDE;
137 Standard_EXPORT Standard_Real UPeriod() const Standard_OVERRIDE;
139 Standard_EXPORT Standard_Boolean IsVPeriodic() const Standard_OVERRIDE;
141 Standard_EXPORT Standard_Real VPeriod() const Standard_OVERRIDE;
143 //! Computes the point of parameters U,V on the surface.
144 Standard_EXPORT gp_Pnt Value (const Standard_Real U, const Standard_Real V) const Standard_OVERRIDE;
146 //! Computes the point of parameters U,V on the surface.
147 Standard_EXPORT void D0 (const Standard_Real U, const Standard_Real V, gp_Pnt& P) const Standard_OVERRIDE;
149 //! Computes the point and the first derivatives on
152 //! Warning : On the specific case of BSplineSurface:
153 //! if the surface is cut in interval of continuity at least C1,
154 //! the derivatives are computed on the current interval.
155 //! else the derivatives are computed on the basis surface.
156 Standard_EXPORT void D1 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V) const Standard_OVERRIDE;
158 //! Computes the point, the first and second
159 //! derivatives on the surface.
161 //! Warning : On the specific case of BSplineSurface:
162 //! if the surface is cut in interval of continuity at least C2,
163 //! the derivatives are computed on the current interval.
164 //! else the derivatives are computed on the basis surface.
165 Standard_EXPORT void D2 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V, gp_Vec& D2U, gp_Vec& D2V, gp_Vec& D2UV) const Standard_OVERRIDE;
167 //! Computes the point, the first, second and third
168 //! derivatives on the surface.
170 //! Warning : On the specific case of BSplineSurface:
171 //! if the surface is cut in interval of continuity at least C3,
172 //! the derivatives are computed on the current interval.
173 //! else the derivatives are computed on the basis surface.
174 Standard_EXPORT void D3 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V, gp_Vec& D2U, gp_Vec& D2V, gp_Vec& D2UV, gp_Vec& D3U, gp_Vec& D3V, gp_Vec& D3UUV, gp_Vec& D3UVV) const Standard_OVERRIDE;
176 //! Computes the derivative of order Nu in the
177 //! direction U and Nv in the direction V at the point P(U, V).
179 //! Warning : On the specific case of BSplineSurface:
180 //! if the surface is cut in interval of continuity CN,
181 //! the derivatives are computed on the current interval.
182 //! else the derivatives are computed on the basis surface.
183 //! Raised if Nu + Nv < 1 or Nu < 0 or Nv < 0.
184 Standard_EXPORT gp_Vec DN (const Standard_Real U, const Standard_Real V, const Standard_Integer Nu, const Standard_Integer Nv) const Standard_OVERRIDE;
186 //! Returns the parametric U resolution corresponding
187 //! to the real space resolution <R3d>.
188 Standard_EXPORT Standard_Real UResolution (const Standard_Real R3d) const Standard_OVERRIDE;
190 //! Returns the parametric V resolution corresponding
191 //! to the real space resolution <R3d>.
192 Standard_EXPORT Standard_Real VResolution (const Standard_Real R3d) const Standard_OVERRIDE;
194 //! Returns the type of the surface : Plane, Cylinder,
195 //! Cone, Sphere, Torus, BezierSurface,
196 //! BSplineSurface, SurfaceOfRevolution,
197 //! SurfaceOfExtrusion, OtherSurface
198 virtual GeomAbs_SurfaceType GetType() const Standard_OVERRIDE { return mySurfaceType; }
200 Standard_EXPORT gp_Pln Plane() const Standard_OVERRIDE;
202 Standard_EXPORT gp_Cylinder Cylinder() const Standard_OVERRIDE;
204 Standard_EXPORT gp_Cone Cone() const Standard_OVERRIDE;
206 Standard_EXPORT gp_Sphere Sphere() const Standard_OVERRIDE;
208 Standard_EXPORT gp_Torus Torus() const Standard_OVERRIDE;
210 Standard_EXPORT Standard_Integer UDegree() const Standard_OVERRIDE;
212 Standard_EXPORT Standard_Integer NbUPoles() const Standard_OVERRIDE;
214 Standard_EXPORT Standard_Integer VDegree() const Standard_OVERRIDE;
216 Standard_EXPORT Standard_Integer NbVPoles() const Standard_OVERRIDE;
218 Standard_EXPORT Standard_Integer NbUKnots() const Standard_OVERRIDE;
220 Standard_EXPORT Standard_Integer NbVKnots() const Standard_OVERRIDE;
222 Standard_EXPORT Standard_Boolean IsURational() const Standard_OVERRIDE;
224 Standard_EXPORT Standard_Boolean IsVRational() const Standard_OVERRIDE;
226 //! This will NOT make a copy of the
227 //! Bezier Surface : If you want to modify
228 //! the Surface please make a copy yourself
229 //! Also it will NOT trim the surface to
231 Standard_EXPORT Handle(Geom_BezierSurface) Bezier() const Standard_OVERRIDE;
233 //! This will NOT make a copy of the
234 //! BSpline Surface : If you want to modify
235 //! the Surface please make a copy yourself
236 //! Also it will NOT trim the surface to
238 Standard_EXPORT Handle(Geom_BSplineSurface) BSpline() const Standard_OVERRIDE;
240 Standard_EXPORT gp_Ax1 AxeOfRevolution() const Standard_OVERRIDE;
242 Standard_EXPORT gp_Dir Direction() const Standard_OVERRIDE;
244 Standard_EXPORT Handle(Adaptor3d_Curve) BasisCurve() const Standard_OVERRIDE;
246 Standard_EXPORT Handle(Adaptor3d_Surface) BasisSurface() const Standard_OVERRIDE;
248 Standard_EXPORT Standard_Real OffsetValue() const Standard_OVERRIDE;
252 Standard_EXPORT void Span (const Standard_Integer Side, const Standard_Integer Ideb, const Standard_Integer Ifin, Standard_Integer& OutIdeb, Standard_Integer& OutIfin, const Standard_Integer FKIndx, const Standard_Integer LKIndx) const;
254 Standard_EXPORT Standard_Boolean IfUVBound (const Standard_Real U, const Standard_Real V, Standard_Integer& Ideb, Standard_Integer& Ifin, Standard_Integer& IVdeb, Standard_Integer& IVfin, const Standard_Integer USide, const Standard_Integer VSide) const;
256 Standard_EXPORT void load (const Handle(Geom_Surface)& S, const Standard_Real UFirst, const Standard_Real ULast, const Standard_Real VFirst, const Standard_Real VLast, const Standard_Real TolU = 0.0, const Standard_Real TolV = 0.0);
258 //! Rebuilds B-spline cache
259 //! \param theU first parameter to identify the span for caching
260 //! \param theV second parameter to identify the span for caching
261 Standard_EXPORT void RebuildCache (const Standard_Real theU, const Standard_Real theV) const;
265 Handle(Geom_Surface) mySurface;
266 Standard_Real myUFirst;
267 Standard_Real myULast;
268 Standard_Real myVFirst;
269 Standard_Real myVLast;
270 Standard_Real myTolU;
271 Standard_Real myTolV;
273 Handle(Geom_BSplineSurface) myBSplineSurface; ///< B-spline representation to prevent downcasts
274 mutable Handle(BSplSLib_Cache) mySurfaceCache; ///< Cached data for B-spline or Bezier surface
276 GeomAbs_SurfaceType mySurfaceType;
277 Handle(GeomEvaluator_Surface) myNestedEvaluator; ///< Calculates values of nested complex surfaces (offset surface, surface of extrusion or revolution)
280 #endif // _GeomAdaptor_Surface_HeaderFile