src/Approx/Approx_CurvlinFunc.hxx

   1 // Created on: 1998-05-12
   2 // Created by: Roman BORISOV
   3 // Copyright (c) 1998-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 _Approx_CurvlinFunc_HeaderFile
  18 #define _Approx_CurvlinFunc_HeaderFile
  19
  20 #include <Standard.hxx>
  21 #include <Standard_Type.hxx>
  22
  23 #include <Standard_Integer.hxx>
  24 #include <Standard_Real.hxx>
  25 #include <TColStd_HArray1OfReal.hxx>
  26 #include <Standard_Transient.hxx>
  27 #include <GeomAbs_Shape.hxx>
  28 #include <TColStd_Array1OfReal.hxx>
  29 #include <Standard_Boolean.hxx>
  30 class Adaptor3d_HCurve;
  31 class Adaptor2d_HCurve2d;
  32 class Adaptor3d_HSurface;
  33 class Standard_OutOfRange;
  34 class Standard_DomainError;
  35 class Standard_ConstructionError;
  36 class Adaptor3d_Curve;
  37
  38
  39 class Approx_CurvlinFunc;
  40 DEFINE_STANDARD_HANDLE(Approx_CurvlinFunc, Standard_Transient)
  41
  42 //! defines an abstract curve with
  43 //! curvilinear parametrization
  44 class Approx_CurvlinFunc : public Standard_Transient
  45 {
  46
  47 public:
  48
  49
  50   Standard_EXPORT Approx_CurvlinFunc(const Handle(Adaptor3d_HCurve)& C, const Standard_Real Tol);
  51
  52   Standard_EXPORT Approx_CurvlinFunc(const Handle(Adaptor2d_HCurve2d)& C2D, const Handle(Adaptor3d_HSurface)& S, const Standard_Real Tol);
  53
  54   Standard_EXPORT Approx_CurvlinFunc(const Handle(Adaptor2d_HCurve2d)& C2D1, const Handle(Adaptor2d_HCurve2d)& C2D2, const Handle(Adaptor3d_HSurface)& S1, const Handle(Adaptor3d_HSurface)& S2, const Standard_Real Tol);
  55
  56   //! ---Purpose Update the tolerance to used
  57   Standard_EXPORT void SetTol (const Standard_Real Tol);
  58
  59   Standard_EXPORT Standard_Real FirstParameter() const;
  60
  61   Standard_EXPORT Standard_Real LastParameter() const;
  62
  63   //! Returns  the number  of  intervals for  continuity
  64   //! <S>. May be one if Continuity(me) >= <S>
  65   Standard_EXPORT Standard_Integer NbIntervals (const GeomAbs_Shape S) const;
  66
  67   //! Stores in <T> the  parameters bounding the intervals
  68   //! of continuity <S>.
  69   //!
  70   //! The array must provide  enough room to  accomodate
  71   //! for the parameters. i.e. T.Length() > NbIntervals()
  72   Standard_EXPORT void Intervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const;
  73
  74   //! if First < 0 or Last > 1
  75   Standard_EXPORT void Trim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol);
  76
  77   //! Computes length of the curve.
  78   Standard_EXPORT void Length();
  79
  80   //! Computes length of the curve segment.
  81   Standard_EXPORT Standard_Real Length (Adaptor3d_Curve& C, const Standard_Real FirstU, const Standard_Real LasrU) const;
  82
  83   Standard_EXPORT Standard_Real GetLength() const;
  84
  85   //! returns  original parameter correponding S.  if
  86   //! Case == 1 computation is performed on myC2D1 and mySurf1,
  87   //! otherwise it is done on myC2D2 and mySurf2.
  88   Standard_EXPORT Standard_Real GetUParameter (Adaptor3d_Curve& C, const Standard_Real S, const Standard_Integer NumberOfCurve) const;
  89
  90   //! returns original parameter correponding S.
  91   Standard_EXPORT Standard_Real GetSParameter (const Standard_Real U) const;
  92
  93   //! if myCase != 1
  94   Standard_EXPORT Standard_Boolean EvalCase1 (const Standard_Real S, const Standard_Integer Order, TColStd_Array1OfReal& Result) const;
  95
  96   //! if myCase != 2
  97   Standard_EXPORT Standard_Boolean EvalCase2 (const Standard_Real S, const Standard_Integer Order, TColStd_Array1OfReal& Result) const;
  98
  99   //! if myCase != 3
 100   Standard_EXPORT Standard_Boolean EvalCase3 (const Standard_Real S, const Standard_Integer Order, TColStd_Array1OfReal& Result);
 101
 102
 103
 104
 105   DEFINE_STANDARD_RTTIEXT(Approx_CurvlinFunc,Standard_Transient)
 106
 107 protected:
 108
 109
 110
 111
 112 private:
 113
 114
 115   Standard_EXPORT void Init();
 116
 117   Standard_EXPORT void Init (Adaptor3d_Curve& C, Handle(TColStd_HArray1OfReal)& Si, Handle(TColStd_HArray1OfReal)& Ui) const;
 118
 119   //! returns curvilinear parameter correponding U.
 120   Standard_EXPORT Standard_Real GetSParameter (Adaptor3d_Curve& C, const Standard_Real U, const Standard_Real Length) const;
 121
 122   Standard_EXPORT Standard_Boolean EvalCurOnSur (const Standard_Real S, const Standard_Integer Order, TColStd_Array1OfReal& Result, const Standard_Integer NumberOfCurve) const;
 123
 124   Handle(Adaptor3d_HCurve) myC3D;
 125   Handle(Adaptor2d_HCurve2d) myC2D1;
 126   Handle(Adaptor2d_HCurve2d) myC2D2;
 127   Handle(Adaptor3d_HSurface) mySurf1;
 128   Handle(Adaptor3d_HSurface) mySurf2;
 129   Standard_Integer myCase;
 130   Standard_Real myFirstS;
 131   Standard_Real myLastS;
 132   Standard_Real myFirstU1;
 133   Standard_Real myLastU1;
 134   Standard_Real myFirstU2;
 135   Standard_Real myLastU2;
 136   Standard_Real myLength;
 137   Standard_Real myLength1;
 138   Standard_Real myLength2;
 139   Standard_Real myTolLen;
 140   Standard_Real myPrevS;
 141   Standard_Real myPrevU;
 142   Handle(TColStd_HArray1OfReal) myUi_1;
 143   Handle(TColStd_HArray1OfReal) mySi_1;
 144   Handle(TColStd_HArray1OfReal) myUi_2;
 145   Handle(TColStd_HArray1OfReal) mySi_2;
 146
 147
 148 };
 149
 150
 151
 152
 153
 154
 155
 156 #endif // _Approx_CurvlinFunc_HeaderFile