1 // Created on: 1997-09-30
2 // Created by: Roman BORISOV
3 // Copyright (c) 1997-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 _Approx_CurveOnSurface_HeaderFile
18 #define _Approx_CurveOnSurface_HeaderFile
20 #include <Adaptor2d_Curve2d.hxx>
21 #include <Adaptor3d_Surface.hxx>
22 #include <GeomAbs_Shape.hxx>
24 class Geom_BSplineCurve;
25 class Geom2d_BSplineCurve;
27 //! Approximation of curve on surface
28 class Approx_CurveOnSurface
34 //! This constructor calls perform method. This constructor is deprecated.
35 Standard_DEPRECATED("This constructor is deprecated. Use other constructor and perform method instead.")
36 Standard_EXPORT Approx_CurveOnSurface(const Handle(Adaptor2d_Curve2d)& C2D, const Handle(Adaptor3d_Surface)& Surf, const Standard_Real First, const Standard_Real Last, const Standard_Real Tol, const GeomAbs_Shape Continuity, const Standard_Integer MaxDegree, const Standard_Integer MaxSegments, const Standard_Boolean Only3d = Standard_False, const Standard_Boolean Only2d = Standard_False);
38 //! This constructor does not call perform method.
39 //! @param theC2D 2D Curve to be approximated in 3D.
40 //! @param theSurf Surface where 2D curve is located.
41 //! @param theFirst First parameter of resulting curve.
42 //! @param theFirst Last parameter of resulting curve.
43 //! @param theTol Computation tolerance.
44 Standard_EXPORT Approx_CurveOnSurface(const Handle(Adaptor2d_Curve2d)& theC2D,
45 const Handle(Adaptor3d_Surface)& theSurf,
46 const Standard_Real theFirst,
47 const Standard_Real theLast,
48 const Standard_Real theTol);
50 Standard_EXPORT Standard_Boolean IsDone() const;
52 Standard_EXPORT Standard_Boolean HasResult() const;
54 Standard_EXPORT Handle(Geom_BSplineCurve) Curve3d() const;
56 Standard_EXPORT Standard_Real MaxError3d() const;
58 Standard_EXPORT Handle(Geom2d_BSplineCurve) Curve2d() const;
60 Standard_EXPORT Standard_Real MaxError2dU() const;
62 //! returns the maximum errors relatively to the U component or the V component of the
64 Standard_EXPORT Standard_Real MaxError2dV() const;
66 //! Constructs the 3d curve. Input parameters are ignored when the input curve is
67 //! U-isoline or V-isoline.
68 //! @param theMaxSegments Maximal number of segments in the resulting spline.
69 //! @param theMaxDegree Maximal degree of the result.
70 //! @param theContinuity Resulting continuity.
71 //! @param theOnly3d Determines building only 3D curve.
72 //! @param theOnly2d Determines building only 2D curve.
73 Standard_EXPORT void Perform(const Standard_Integer theMaxSegments,
74 const Standard_Integer theMaxDegree,
75 const GeomAbs_Shape theContinuity,
76 const Standard_Boolean theOnly3d = Standard_False,
77 const Standard_Boolean theOnly2d = Standard_False);
81 //! Checks whether the 2d curve is a isoline. It can be represented by b-spline, bezier,
82 //! or geometric line. This line should have natural parameterization.
83 //! @param theC2D Trimmed curve to be checked.
84 //! @param theIsU Flag indicating that line is u const.
85 //! @param theParam Line parameter.
86 //! @param theIsForward Flag indicating forward parameterization on a isoline.
87 //! @return Standard_True when 2d curve is a line and Standard_False otherwise.
88 Standard_Boolean isIsoLine(const Handle(Adaptor2d_Curve2d)& theC2D,
89 Standard_Boolean& theIsU,
90 Standard_Real& theParam,
91 Standard_Boolean& theIsForward) const;
93 //! Builds 3D curve for a isoline. This method takes corresponding isoline from
94 //! the input surface.
95 //! @param theC2D Trimmed curve to be approximated.
96 //! @param theIsU Flag indicating that line is u const.
97 //! @param theParam Line parameter.
98 //! @param theIsForward Flag indicating forward parameterization on a isoline.
99 //! @return Standard_True when 3d curve is built and Standard_False otherwise.
100 Standard_Boolean buildC3dOnIsoLine(const Handle(Adaptor2d_Curve2d)& theC2D,
101 const Standard_Boolean theIsU,
102 const Standard_Real theParam,
103 const Standard_Boolean theIsForward);
106 Approx_CurveOnSurface& operator= (const Approx_CurveOnSurface&);
111 const Handle(Adaptor2d_Curve2d) myC2D;
114 const Handle(Adaptor3d_Surface) mySurf;
116 //! First parameter of the result.
117 const Standard_Real myFirst;
119 //! Last parameter of the result.
120 const Standard_Real myLast;
125 Handle(Geom2d_BSplineCurve) myCurve2d;
126 Handle(Geom_BSplineCurve) myCurve3d;
127 Standard_Boolean myIsDone;
128 Standard_Boolean myHasResult;
129 Standard_Real myError3d;
130 Standard_Real myError2dU;
131 Standard_Real myError2dV;
135 #endif // _Approx_CurveOnSurface_HeaderFile