include/opencascade/GeomPlate_BuildAveragePlane.hxx

0001 // Created on: 1996-03-18
0002 // Created by: Stagiaire Frederic CALOONE
0003 // Copyright (c) 1996-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 _GeomPlate_BuildAveragePlane_HeaderFile
0018 #define _GeomPlate_BuildAveragePlane_HeaderFile
0019
0020 #include <Standard.hxx>
0021 #include <Standard_DefineAlloc.hxx>
0022 #include <Standard_Handle.hxx>
0023
0024 #include <gp_Pnt.hxx>
0025 #include <NCollection_Array1.hxx>
0026 #include <NCollection_HArray1.hxx>
0027 #include <gp_Vec.hxx>
0028 #include <Standard_Integer.hxx>
0029 #include <NCollection_Sequence.hxx>
0030 #include <GeomPlate_Aij.hxx>
0031 class Geom_Plane;
0032 class Geom_Line;
0033
0034 //! This class computes an average inertial plane with an
0035 //! array of points.
0036 //! Computes the initial surface (average plane) in the cases
0037 //! when the initial surface is not given.
0038 class GeomPlate_BuildAveragePlane
0039 {
0040 public:
0041   DEFINE_STANDARD_ALLOC
0042
0043   //! Tol is a Tolerance to make the difference between
0044   //! the result plane and the result line.
0045   //! if POption = 1 : automatic parametrisation
0046   //! if POption = 2 : parametrisation by eigen vectors
0047   //! if NOption = 1 : the average plane is the inertial plane.
0048   //! if NOption = 2 : the average plane is the plane of max. flux.
0049   Standard_EXPORT GeomPlate_BuildAveragePlane(const occ::handle<NCollection_HArray1<gp_Pnt>>& Pts,
0050                                               const int    NbBoundPoints,
0051                                               const double Tol,
0052                                               const int    POption,
0053                                               const int    NOption);
0054
0055   //! Creates the plane from the "best vector"
0056   Standard_EXPORT GeomPlate_BuildAveragePlane(const NCollection_Sequence<gp_Vec>& Normals,
0057                                               const occ::handle<NCollection_HArray1<gp_Pnt>>& Pts);
0058
0059   //! Return the average Plane.
0060   Standard_EXPORT occ::handle<Geom_Plane> Plane() const;
0061
0062   //! Return a Line when 2 eigenvalues are null.
0063   Standard_EXPORT occ::handle<Geom_Line> Line() const;
0064
0065   //! return OK if is a plane.
0066   Standard_EXPORT bool IsPlane() const;
0067
0068   //! return OK if is a line.
0069   Standard_EXPORT bool IsLine() const;
0070
0071   //! computes the minimal box to include all normal
0072   //! projection points of the initial array on the plane.
0073   Standard_EXPORT void MinMaxBox(double& Umin, double& Umax, double& Vmin, double& Vmax) const;
0074
0075   Standard_EXPORT static bool HalfSpace(const NCollection_Sequence<gp_Vec>&  NewNormals,
0076                                         NCollection_Sequence<gp_Vec>&        Normals,
0077                                         NCollection_Sequence<GeomPlate_Aij>& Bset,
0078                                         const double                         LinTol,
0079                                         const double                         AngTol);
0080
0081 private:
0082   //! Computes a base of the average plane defined by (myG,N)
0083   //! using eigen vectors
0084   Standard_EXPORT void BasePlan(const gp_Vec& N);
0085
0086   //! Defines the average plane.
0087   //! if NOption = 1 : the average plane is the inertial plane.
0088   //! if NOption = 2 : the average plane is the plane of max. flux.
0089   Standard_EXPORT gp_Vec DefPlan(const int NOption);
0090
0091   occ::handle<NCollection_HArray1<gp_Pnt>> myPts;
0092   double                                   myUmax;
0093   double                                   myVmax;
0094   double                                   myVmin;
0095   double                                   myUmin;
0096   occ::handle<Geom_Plane>                  myPlane;
0097   double                                   myTol;
0098   occ::handle<Geom_Line>                   myLine;
0099   gp_Vec                                   myOX;
0100   gp_Vec                                   myOY;
0101   gp_Pnt                                   myG;
0102   int                                      myNbBoundPoints;
0103 };
0104
0105 #endif // _GeomPlate_BuildAveragePlane_HeaderFile