0026252: GeomAdaptor_Surface should use inner adaptor to calculate values of complex...
[occt.git] / src / GeomAdaptor / GeomAdaptor_SurfaceOfRevolution.hxx
1 // Created on: 1993-04-21
2 // Created by: Bruno DUMORTIER
3 // Copyright (c) 1993-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 _GeomAdaptor_SurfaceOfRevolution_HeaderFile
18 #define _GeomAdaptor_SurfaceOfRevolution_HeaderFile
19
20 #include <Standard.hxx>
21 #include <Standard_DefineAlloc.hxx>
22 #include <Standard_Handle.hxx>
23
24 #include <gp_Ax1.hxx>
25 #include <gp_Ax3.hxx>
26 #include <GeomAdaptor_Surface.hxx>
27
28 class Adaptor3d_HCurve;
29 class Standard_OutOfRange;
30 class Standard_NoSuchObject;
31 class Standard_DomainError;
32 class gp_Ax1;
33 class Adaptor3d_HSurface;
34 class gp_Pnt;
35 class gp_Vec;
36 class gp_Pln;
37 class gp_Cylinder;
38 class gp_Cone;
39 class gp_Sphere;
40 class gp_Torus;
41 class Geom_BezierSurface;
42 class Geom_BSplineSurface;
43 class gp_Ax3;
44 class gp_Dir;
45
46
47 //! This class defines a complete surface of revolution.
48 //! The surface is obtained by rotating a curve a complete revolution
49 //! about an axis. The curve and the axis must be in the same plane.
50 //! If the curve and the axis are not in the same plane it is always
51 //! possible to be in the previous case after a cylindrical projection
52 //! of the curve in a referenced plane.
53 //! For a complete surface of revolution the parametric range is
54 //! 0 <= U <= 2*PI.       --
55 //! The parametric range for V is defined with the revolved curve.
56 //! The origin of the U parametrization is given by the position
57 //! of the revolved curve (reference). The direction of the revolution
58 //! axis defines the positive sense of rotation (trigonometric sense)
59 //! corresponding to the increasing of the parametric value U.
60 //! The derivatives are always defined for the u direction.
61 //! For the v direction the definition of the derivatives depends on
62 //! the degree of continuity of the referenced curve.
63 class GeomAdaptor_SurfaceOfRevolution  : public GeomAdaptor_Surface
64 {
65 public:
66
67   DEFINE_STANDARD_ALLOC
68
69   
70   Standard_EXPORT GeomAdaptor_SurfaceOfRevolution();
71   
72   //! The Curve is loaded.
73   Standard_EXPORT GeomAdaptor_SurfaceOfRevolution(const Handle(Adaptor3d_HCurve)& C);
74   
75   //! The Curve and the Direction are loaded.
76   Standard_EXPORT GeomAdaptor_SurfaceOfRevolution(const Handle(Adaptor3d_HCurve)& C, const gp_Ax1& V);
77   
78   //! Changes the Curve
79   Standard_EXPORT void Load (const Handle(Adaptor3d_HCurve)& C);
80   
81   //! Changes the Direction
82   Standard_EXPORT void Load (const gp_Ax1& V);
83   
84   Standard_EXPORT gp_Ax1 AxeOfRevolution() const Standard_OVERRIDE;
85   
86   Standard_EXPORT Standard_Real FirstUParameter() const Standard_OVERRIDE;
87   
88   Standard_EXPORT Standard_Real LastUParameter() const Standard_OVERRIDE;
89   
90   Standard_EXPORT Standard_Real FirstVParameter() const Standard_OVERRIDE;
91   
92   Standard_EXPORT Standard_Real LastVParameter() const Standard_OVERRIDE;
93   
94   Standard_EXPORT GeomAbs_Shape UContinuity() const Standard_OVERRIDE;
95   
96   //! Return CN.
97   Standard_EXPORT GeomAbs_Shape VContinuity() const Standard_OVERRIDE;
98   
99   //! Returns the number of U intervals for  continuity
100   //! <S>. May be one if UContinuity(me) >= <S>
101   Standard_EXPORT Standard_Integer NbUIntervals (const GeomAbs_Shape S) const Standard_OVERRIDE;
102   
103   //! Returns the number of V intervals for  continuity
104   //! <S>. May be one if VContinuity(me) >= <S>
105   Standard_EXPORT Standard_Integer NbVIntervals (const GeomAbs_Shape S) const Standard_OVERRIDE;
106   
107   //! Returns the  intervals with the requested continuity
108   //! in the U direction.
109   Standard_EXPORT void UIntervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const Standard_OVERRIDE;
110   
111   //! Returns the  intervals with the requested continuity
112   //! in the V direction.
113   Standard_EXPORT void VIntervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const Standard_OVERRIDE;
114   
115   //! Returns    a  surface trimmed in the U direction
116   //! equivalent   of  <me>  between
117   //! parameters <First>  and <Last>. <Tol>  is used  to
118   //! test for 3d points confusion.
119   //! If <First> >= <Last>
120   Standard_EXPORT Handle(Adaptor3d_HSurface) UTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const Standard_OVERRIDE;
121   
122   //! Returns    a  surface trimmed in the V direction  between
123   //! parameters <First>  and <Last>. <Tol>  is used  to
124   //! test for 3d points confusion.
125   //! If <First> >= <Last>
126   Standard_EXPORT Handle(Adaptor3d_HSurface) VTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const Standard_OVERRIDE;
127   
128   Standard_EXPORT Standard_Boolean IsUClosed() const Standard_OVERRIDE;
129   
130   Standard_EXPORT Standard_Boolean IsVClosed() const Standard_OVERRIDE;
131   
132   Standard_EXPORT Standard_Boolean IsUPeriodic() const Standard_OVERRIDE;
133   
134   Standard_EXPORT Standard_Real UPeriod() const Standard_OVERRIDE;
135   
136   Standard_EXPORT Standard_Boolean IsVPeriodic() const Standard_OVERRIDE;
137   
138   Standard_EXPORT Standard_Real VPeriod() const Standard_OVERRIDE;
139
140   //! Returns the parametric U  resolution corresponding
141   //! to the real space resolution <R3d>.
142   Standard_EXPORT Standard_Real UResolution (const Standard_Real R3d) const Standard_OVERRIDE;
143   
144   //! Returns the parametric V  resolution corresponding
145   //! to the real space resolution <R3d>.
146   Standard_EXPORT Standard_Real VResolution (const Standard_Real R3d) const Standard_OVERRIDE;
147   
148   //! Returns the type of the surface : Plane, Cylinder,
149   //! Cone,      Sphere,        Torus,    BezierSurface,
150   //! BSplineSurface,               SurfaceOfRevolution,
151   //! SurfaceOfExtrusion, OtherSurface
152   Standard_EXPORT GeomAbs_SurfaceType GetType() const Standard_OVERRIDE;
153   
154   Standard_EXPORT gp_Pln Plane() const Standard_OVERRIDE;
155   
156   Standard_EXPORT gp_Cylinder Cylinder() const Standard_OVERRIDE;
157   
158   //! Apex of the Cone = Cone.Position().Location()
159   //! ==> ReferenceRadius = 0.
160   Standard_EXPORT gp_Cone Cone() const Standard_OVERRIDE;
161   
162   Standard_EXPORT gp_Sphere Sphere() const Standard_OVERRIDE;
163   
164   Standard_EXPORT gp_Torus Torus() const Standard_OVERRIDE;
165
166   Standard_EXPORT Standard_Integer VDegree() const Standard_OVERRIDE;
167   
168   Standard_EXPORT Standard_Integer NbVPoles() const Standard_OVERRIDE;
169
170   Standard_EXPORT Standard_Integer NbVKnots() const Standard_OVERRIDE;
171   
172   Standard_EXPORT Standard_Boolean IsURational() const Standard_OVERRIDE;
173   
174   Standard_EXPORT Standard_Boolean IsVRational() const Standard_OVERRIDE;
175   
176   Standard_EXPORT Handle(Geom_BezierSurface) Bezier() const Standard_OVERRIDE;
177   
178   Standard_EXPORT Handle(Geom_BSplineSurface) BSpline() const Standard_OVERRIDE;
179   
180   Standard_EXPORT const gp_Ax3& Axis() const;
181   
182   Standard_EXPORT Handle(Adaptor3d_HCurve) BasisCurve() const Standard_OVERRIDE;
183
184
185
186
187 protected:
188
189
190
191
192
193 private:
194   Handle(Adaptor3d_HCurve) myBasisCurve; ///< revolved curve
195   gp_Ax1                   myAxis;       ///< axis of revolution
196   Standard_Boolean         myHaveAxis;   ///< whether axis of revolution is initialized
197   gp_Ax3                   myAxeRev;     ///< auxiliary trihedron according to the curve position
198 };
199
200
201
202
203
204
205
206 #endif // _GeomAdaptor_SurfaceOfRevolution_HeaderFile