0024002: Overall code and build procedure refactoring -- automatic
[occt.git] / src / GeomConvert / GeomConvert_BSplineSurfaceToBezierSurface.hxx
diff --git a/src/GeomConvert/GeomConvert_BSplineSurfaceToBezierSurface.hxx b/src/GeomConvert/GeomConvert_BSplineSurfaceToBezierSurface.hxx
new file mode 100644 (file)
index 0000000..641a3dd
--- /dev/null
@@ -0,0 +1,202 @@
+// Created on: 1996-03-12
+// Created by: Bruno DUMORTIER
+// Copyright (c) 1996-1999 Matra Datavision
+// Copyright (c) 1999-2014 OPEN CASCADE SAS
+//
+// This file is part of Open CASCADE Technology software library.
+//
+// This library is free software; you can redistribute it and/or modify it under
+// the terms of the GNU Lesser General Public License version 2.1 as published
+// by the Free Software Foundation, with special exception defined in the file
+// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
+// distribution for complete text of the license and disclaimer of any warranty.
+//
+// Alternatively, this file may be used under the terms of Open CASCADE
+// commercial license or contractual agreement.
+
+#ifndef _GeomConvert_BSplineSurfaceToBezierSurface_HeaderFile
+#define _GeomConvert_BSplineSurfaceToBezierSurface_HeaderFile
+
+#include <Standard.hxx>
+#include <Standard_DefineAlloc.hxx>
+#include <Standard_Handle.hxx>
+
+#include <Standard_Real.hxx>
+#include <Standard_Integer.hxx>
+#include <TColGeom_Array2OfBezierSurface.hxx>
+#include <TColStd_Array1OfReal.hxx>
+class Geom_BSplineSurface;
+class Standard_DimensionError;
+class Standard_DomainError;
+class Standard_OutOfRange;
+class Geom_BezierSurface;
+
+
+
+//! This algorithm converts a B-spline surface into several
+//! Bezier surfaces. It uses an algorithm of knot insertion.
+//! A BSplineSurfaceToBezierSurface object provides a framework for:
+//! -   defining the BSpline surface to be converted,
+//! -   implementing the construction algorithm, and
+//! -   consulting the results.
+//! References :
+//! Generating the Bezier points of B-spline curves and surfaces
+//! (Wolfgang Bohm) CAD volume 13 number 6 november 1981
+class GeomConvert_BSplineSurfaceToBezierSurface 
+{
+public:
+
+  DEFINE_STANDARD_ALLOC
+
+  
+  //! Computes all the data needed to convert
+  //! -   the BSpline surface BasisSurface into a series of adjacent Bezier surfaces.
+  //! The result consists of a grid of BasisSurface patches
+  //! limited by isoparametric curves corresponding to knot
+  //! values, both in the u and v parametric directions of
+  //! the surface. A row in the grid corresponds to a series
+  //! of adjacent patches, all limited by the same two
+  //! u-isoparametric curves. A column in the grid
+  //! corresponds to a series of adjacent patches, all
+  //! limited by the same two v-isoparametric curves.
+  //! Use the available interrogation functions to ascertain
+  //! the number of computed Bezier patches, and then to
+  //! construct each individual Bezier surface (or all Bezier surfaces).
+  //! Note: ParametricTolerance is not used.
+  Standard_EXPORT GeomConvert_BSplineSurfaceToBezierSurface(const Handle(Geom_BSplineSurface)& BasisSurface);
+  
+  //! Computes all the data needed to convert
+  //! the patch of the BSpline surface BasisSurface
+  //! limited by the two parameter values U1 and U2 in
+  //! the u parametric direction, and by the two
+  //! parameter values V1 and V2 in the v parametric
+  //! direction, into a series of adjacent Bezier surfaces.
+  //! The result consists of a grid of BasisSurface patches
+  //! limited by isoparametric curves corresponding to knot
+  //! values, both in the u and v parametric directions of
+  //! the surface. A row in the grid corresponds to a series
+  //! of adjacent patches, all limited by the same two
+  //! u-isoparametric curves. A column in the grid
+  //! corresponds to a series of adjacent patches, all
+  //! limited by the same two v-isoparametric curves.
+  //! Use the available interrogation functions to ascertain
+  //! the number of computed Bezier patches, and then to
+  //! construct each individual Bezier surface (or all Bezier surfaces).
+  //! Note: ParametricTolerance is not used.  Raises DomainError
+  //! if U1 or U2 or V1 or V2 are out of the parametric bounds
+  //! of the basis surface [FirstUKnotIndex, LastUKnotIndex] ,
+  //! [FirstVKnotIndex, LastVKnotIndex] The tolerance criterion is
+  //! ParametricTolerance.
+  //! Raised if U2 - U1 <= ParametricTolerance or
+  //! V2 - V1 <= ParametricTolerance.
+  Standard_EXPORT GeomConvert_BSplineSurfaceToBezierSurface(const Handle(Geom_BSplineSurface)& BasisSurface, const Standard_Real U1, const Standard_Real U2, const Standard_Real V1, const Standard_Real V2, const Standard_Real ParametricTolerance);
+  
+  //! Constructs and returns the Bezier surface of indices
+  //! (UIndex, VIndex) to the patch grid computed on the
+  //! BSpline surface analyzed by this algorithm.
+  //! This Bezier surface has the same orientation as the
+  //! BSpline surface analyzed in this framework.
+  //! UIndex is an index common to a row in the patch
+  //! grid. A row in the grid corresponds to a series of
+  //! adjacent patches, all limited by the same two
+  //! u-isoparametric curves of the surface. VIndex is an
+  //! index common to a column in the patch grid. A column
+  //! in the grid corresponds to a series of adjacent
+  //! patches, all limited by the same two v-isoparametric
+  //! curves of the surface.
+  //! Exceptions
+  //! Standard_OutOfRange if:
+  //! -   UIndex is less than 1 or greater than the number
+  //! of rows in the patch grid computed on the BSpline
+  //! surface analyzed by this algorithm (as returned by
+  //! the function NbUPatches); or if
+  //! -   VIndex is less than 1 or greater than the number
+  //! of columns in the patch grid computed on the
+  //! BSpline surface analyzed by this algorithm (as
+  //! returned by the function NbVPatches).
+  Standard_EXPORT Handle(Geom_BezierSurface) Patch (const Standard_Integer UIndex, const Standard_Integer VIndex);
+  
+  //! Constructs all the Bezier surfaces whose data is
+  //! computed by this algorithm, and loads them into the Surfaces table.
+  //! These Bezier surfaces have the same orientation as
+  //! the BSpline surface analyzed in this framework.
+  //! The Surfaces array is organised in the same way as
+  //! the patch grid computed on the BSpline surface
+  //! analyzed by this algorithm. A row in the array
+  //! corresponds to a series of adjacent patches, all
+  //! limited by the same two u-isoparametric curves of
+  //! the surface. A column in the array corresponds to a
+  //! series of adjacent patches, all limited by the same two
+  //! v-isoparametric curves of the surface.
+  //! Exceptions
+  //! Standard_DimensionError if the Surfaces array
+  //! was not created with the following bounds:
+  //! -   1, and the number of adjacent patch series in the
+  //! u parametric direction of the patch grid computed
+  //! on the BSpline surface, analyzed by this algorithm
+  //! (as given by the function NbUPatches) as row bounds,
+  //! -   1, and the number of adjacent patch series in the
+  //! v parametric direction of the patch grid computed
+  //! on the BSpline surface, analyzed by this algorithm
+  //! (as given by the function NbVPatches) as column bounds.
+  Standard_EXPORT void Patches (TColGeom_Array2OfBezierSurface& Surfaces);
+  
+  //! This methode returns the bspline's u-knots associated to
+  //! the converted Patches
+  //! Raised  if the length  of Curves is not equal to
+  //! NbUPatches +  1.
+  Standard_EXPORT void UKnots (TColStd_Array1OfReal& TKnots) const;
+  
+  //! This methode returns the bspline's v-knots associated to
+  //! the converted Patches
+  //! Raised  if the length  of Curves is not equal to
+  //! NbVPatches +  1.
+  Standard_EXPORT void VKnots (TColStd_Array1OfReal& TKnots) const;
+  
+
+  //! Returns the number of Bezier surfaces in the U direction.
+  //! If at the creation time you have decomposed the basis Surface
+  //! between the parametric values UFirst, ULast the number of
+  //! Bezier surfaces in the U direction depends on the number of
+  //! knots included inside the interval [UFirst, ULast].
+  //! If you have decomposed the whole basis B-spline surface the
+  //! number of Bezier surfaces NbUPatches is equal to the number of
+  //! UKnots less one.
+  Standard_EXPORT Standard_Integer NbUPatches() const;
+  
+
+  //! Returns the number of Bezier surfaces in the V direction.
+  //! If at the creation time you have decomposed the basis surface
+  //! between the parametric values VFirst, VLast the number of
+  //! Bezier surfaces in the V direction depends on the number of
+  //! knots included inside the interval [VFirst, VLast].
+  //! If you have decomposed the whole basis B-spline surface the
+  //! number of Bezier surfaces NbVPatches is equal to the number of
+  //! VKnots less one.
+  Standard_EXPORT Standard_Integer NbVPatches() const;
+
+
+
+
+protected:
+
+
+
+
+
+private:
+
+
+
+  Handle(Geom_BSplineSurface) mySurface;
+
+
+};
+
+
+
+
+
+
+
+#endif // _GeomConvert_BSplineSurfaceToBezierSurface_HeaderFile