Back to home page

EIC code displayed by LXR

 
 

    


File indexing completed on 2026-09-09 09:15:32

0001 // Created on: 1992-03-26
0002 // Created by: Herve LEGRAND
0003 // Copyright (c) 1992-1999 Matra Datavision
0004 // Copyright (c) 1999-2014 OPEN CASCADE SAS
0005 //
0006 // This file is part of Open CASCADE Technology software library.
0007 //
0008 // This library is free software; you can redistribute it and/or modify it under
0009 // the terms of the GNU Lesser General Public License version 2.1 as published
0010 // by the Free Software Foundation, with special exception defined in the file
0011 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
0012 // distribution for complete text of the license and disclaimer of any warranty.
0013 //
0014 // Alternatively, this file may be used under the terms of Open CASCADE
0015 // commercial license or contractual agreement.
0016 
0017 #ifndef _GeomLProp_SLProps_HeaderFile
0018 #define _GeomLProp_SLProps_HeaderFile
0019 
0020 #include <Standard.hxx>
0021 #include <Standard_DefineAlloc.hxx>
0022 #include <Standard_Handle.hxx>
0023 
0024 #include <Standard_Integer.hxx>
0025 #include <gp_Pnt.hxx>
0026 #include <gp_Vec.hxx>
0027 #include <gp_Dir.hxx>
0028 #include <LProp_Status.hxx>
0029 class Geom_Surface;
0030 class LProp_BadContinuity;
0031 class Standard_DomainError;
0032 class Standard_OutOfRange;
0033 class LProp_NotDefined;
0034 class GeomLProp_SurfaceTool;
0035 class gp_Pnt;
0036 class gp_Vec;
0037 class gp_Dir;
0038 
0039 class GeomLProp_SLProps
0040 {
0041 public:
0042   DEFINE_STANDARD_ALLOC
0043 
0044   //! Initializes the local properties of the surface <S>
0045   //! for the parameter values (<U>, <V>).
0046   //! The current point and the derivatives are
0047   //! computed at the same time, which allows an
0048   //! optimization of the computation time.
0049   //! <N> indicates the maximum number of derivations to
0050   //! be done (0, 1, or 2). For example, to compute
0051   //! only the tangent, N should be equal to 1.
0052   //! <Resolution> is the linear tolerance (it is used to test
0053   //! if a vector is null).
0054   Standard_EXPORT GeomLProp_SLProps(const Handle(Geom_Surface)& S,
0055                                     const Standard_Real         U,
0056                                     const Standard_Real         V,
0057                                     const Standard_Integer      N,
0058                                     const Standard_Real         Resolution);
0059 
0060   //! idem as previous constructor but without setting the value
0061   //! of parameters <U> and <V>.
0062   Standard_EXPORT GeomLProp_SLProps(const Handle(Geom_Surface)& S,
0063                                     const Standard_Integer      N,
0064                                     const Standard_Real         Resolution);
0065 
0066   //! idem as previous constructor but without setting the value
0067   //! of parameters <U> and <V> and the surface.
0068   //! the surface can have an empty constructor.
0069   Standard_EXPORT GeomLProp_SLProps(const Standard_Integer N, const Standard_Real Resolution);
0070 
0071   //! Initializes the local properties of the surface S
0072   //! for the new surface.
0073   Standard_EXPORT void SetSurface(const Handle(Geom_Surface)& S);
0074 
0075   //! Initializes the local properties of the surface S
0076   //! for the new parameter values (<U>, <V>).
0077   Standard_EXPORT void SetParameters(const Standard_Real U, const Standard_Real V);
0078 
0079   //! Returns the point.
0080   Standard_EXPORT const gp_Pnt& Value() const;
0081 
0082   //! Returns the first U derivative.
0083   //! The derivative is computed if it has not been yet.
0084   Standard_EXPORT const gp_Vec& D1U();
0085 
0086   //! Returns the first V derivative.
0087   //! The derivative is computed if it has not been yet.
0088   Standard_EXPORT const gp_Vec& D1V();
0089 
0090   //! Returns the second U derivatives
0091   //! The derivative is computed if it has not been yet.
0092   Standard_EXPORT const gp_Vec& D2U();
0093 
0094   //! Returns the second V derivative.
0095   //! The derivative is computed if it has not been yet.
0096   Standard_EXPORT const gp_Vec& D2V();
0097 
0098   //! Returns the second UV cross-derivative.
0099   //! The derivative is computed if it has not been yet.
0100   Standard_EXPORT const gp_Vec& DUV();
0101 
0102   //! returns True if the U tangent is defined.
0103   //! For example, the tangent is not defined if the
0104   //! two first U derivatives are null.
0105   Standard_EXPORT Standard_Boolean IsTangentUDefined();
0106 
0107   //! Returns the tangent direction <D> on the iso-V.
0108   Standard_EXPORT void TangentU(gp_Dir& D);
0109 
0110   //! returns if the V tangent is defined.
0111   //! For example, the tangent is not defined if the
0112   //! two first V derivatives are null.
0113   Standard_EXPORT Standard_Boolean IsTangentVDefined();
0114 
0115   //! Returns the tangent direction <D> on the iso-V.
0116   Standard_EXPORT void TangentV(gp_Dir& D);
0117 
0118   //! Tells if the normal is defined.
0119   Standard_EXPORT Standard_Boolean IsNormalDefined();
0120 
0121   //! Returns the normal direction.
0122   Standard_EXPORT const gp_Dir& Normal();
0123 
0124   //! returns True if the curvature is defined.
0125   Standard_EXPORT Standard_Boolean IsCurvatureDefined();
0126 
0127   //! returns True if the point is umbilic (i.e. if the
0128   //! curvature is constant).
0129   Standard_EXPORT Standard_Boolean IsUmbilic();
0130 
0131   //! Returns the maximum curvature
0132   Standard_EXPORT Standard_Real MaxCurvature();
0133 
0134   //! Returns the minimum curvature
0135   Standard_EXPORT Standard_Real MinCurvature();
0136 
0137   //! Returns the direction of the maximum and minimum curvature
0138   //! <MaxD> and <MinD>
0139   Standard_EXPORT void CurvatureDirections(gp_Dir& MaxD, gp_Dir& MinD);
0140 
0141   //! Returns the mean curvature.
0142   Standard_EXPORT Standard_Real MeanCurvature();
0143 
0144   //! Returns the Gaussian curvature
0145   Standard_EXPORT Standard_Real GaussianCurvature();
0146 
0147 protected:
0148 private:
0149   Handle(Geom_Surface) mySurf;
0150   Standard_Real        myU;
0151   Standard_Real        myV;
0152   Standard_Integer     myDerOrder;
0153   Standard_Integer     myCN;
0154   Standard_Real        myLinTol;
0155   gp_Pnt               myPnt;
0156   gp_Vec               myD1u;
0157   gp_Vec               myD1v;
0158   gp_Vec               myD2u;
0159   gp_Vec               myD2v;
0160   gp_Vec               myDuv;
0161   gp_Dir               myNormal;
0162   Standard_Real        myMinCurv;
0163   Standard_Real        myMaxCurv;
0164   gp_Dir               myDirMinCurv;
0165   gp_Dir               myDirMaxCurv;
0166   Standard_Real        myMeanCurv;
0167   Standard_Real        myGausCurv;
0168   Standard_Integer     mySignificantFirstDerivativeOrderU;
0169   Standard_Integer     mySignificantFirstDerivativeOrderV;
0170   LProp_Status         myUTangentStatus;
0171   LProp_Status         myVTangentStatus;
0172   LProp_Status         myNormalStatus;
0173   LProp_Status         myCurvatureStatus;
0174 };
0175 
0176 #endif // _GeomLProp_SLProps_HeaderFile