EIC code displayed by LXR master/​include/​opencascade/​ShapeExtend_CompositeSurface.hxx	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

File indexing completed on 2026-10-09 09:35:02

 // Created on: 1999-04-27
 // Created by: Andrey BETENEV
 // Copyright (c) 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 _ShapeExtend_CompositeSurface_HeaderFile
 #define _ShapeExtend_CompositeSurface_HeaderFile
 
 #include <Standard.hxx>
 #include <Standard_Type.hxx>
 
 #include <Geom_Surface.hxx>
 #include <NCollection_Array2.hxx>
 #include <NCollection_HArray2.hxx>
 #include <NCollection_Array1.hxx>
 #include <NCollection_HArray1.hxx>
 #include <ShapeExtend_Parametrisation.hxx>
 #include <GeomAbs_Shape.hxx>
 class gp_Pnt2d;
 class gp_Trsf2d;
 class gp_Trsf;
 class Geom_Geometry;
 class Geom_Curve;
 
 //! Composite surface is represented by a grid of surfaces
 //! (patches) connected geometrically. Patches may have different
 //! parametrisation ranges, but they should be parametrised in
 //! the same manner so that parameter of each patch (u,v) can be converted
 //! to global parameter on the whole surface (U,V) with help of linear
 //! transformation:
 //!
 //! for any i,j-th patch
 //! U = Ui + ( u - uijmin ) * ( Ui+1 - Ui ) / ( uijmax - uijmin )
 //! V = Vj + ( v - vijmin ) * ( Vj+1 - Vj ) / ( vijmax - vijmin )
 //!
 //! where
 //!
 //! [uijmin, uijmax] * [ vijmin, vijmax] - parametric range of i,j-th patch,
 //!
 //! Ui (i=1,..,Nu+1), Vi (j=1,..,Nv+1) - values defining global
 //! parametrisation by U and V (correspond to points between patches and
 //! bounds, (Ui,Uj) corresponds to (uijmin,vijmin) on i,j-th patch) and to
 //! (u(i-1)(j-1)max,v(i-1)(j-1)max) on (i-1),(j-1)-th patch.
 //!
 //! Geometrical connectivity is expressed via global parameters:
 //! S[i,j](Ui+1,V) = S[i+1,j](Ui+1,V) for any i, j, V
 //! S[i,j](U,Vj+1) = S[i,j+1](U,Vj+1) for any i, j, U
 //! It is checked with Precision::Confusion() by default.
 //!
 //! NOTE 1: This class is inherited from Geom_Surface in order to
 //! make it more easy to store and deal with it. However, it should
 //! not be passed to standard methods dealing with geometry since
 //! this type is not known to them.
 //! NOTE 2: Not all the inherited methods are implemented, and some are
 //! implemented not in the full form.
 class ShapeExtend_CompositeSurface : public Geom_Surface
 {
 
 public:
   //! Empty constructor.
   Standard_EXPORT ShapeExtend_CompositeSurface();
 
   //! Initializes by a grid of surfaces (calls Init()).
   Standard_EXPORT ShapeExtend_CompositeSurface(
     const occ::handle<NCollection_HArray2<occ::handle<Geom_Surface>>>& GridSurf,
     const ShapeExtend_Parametrisation                                  param = ShapeExtend_Natural);
 
   //! Initializes by a grid of surfaces (calls Init()).
   Standard_EXPORT ShapeExtend_CompositeSurface(
     const occ::handle<NCollection_HArray2<occ::handle<Geom_Surface>>>& GridSurf,
     const NCollection_Array1<double>&                                  UJoints,
     const NCollection_Array1<double>&                                  VJoints);
 
   //! Initializes by a grid of surfaces.
   //! All the Surfaces of the grid must have geometrical
   //! connectivity as stated above.
   //! If geometrical connectivity is not satisfied, method
   //! returns False.
   //! However, class is initialized even in that case.
   //!
   //! Last parameter defines how global parametrisation
   //! (joint values) will be computed:
   //! ShapeExtend_Natural: U1 = u11min, Ui+1 = Ui + (ui1max-ui1min), etc.
   //! ShapeExtend_Uniform: Ui = i-1, Vj = j-1
   //! ShapeExtend_Unitary: Ui = (i-1)/Nu, Vi = (j-1)/Nv
   Standard_EXPORT bool Init(
     const occ::handle<NCollection_HArray2<occ::handle<Geom_Surface>>>& GridSurf,
     const ShapeExtend_Parametrisation                                  param = ShapeExtend_Natural);
 
   //! Initializes by a grid of surfaces with given global
   //! parametrisation defined by UJoints and VJoints arrays,
   //! each having length equal to number of patches in corresponding
   //! direction + 1. Global joint values should be sorted in
   //! increasing order.
   //! All the Surfaces of the grid must have geometrical
   //! connectivity as stated above.
   //! If geometrical connectivity is not satisfied, method
   //! returns False.
   //! However, class is initialized even in that case.
   Standard_EXPORT bool Init(
     const occ::handle<NCollection_HArray2<occ::handle<Geom_Surface>>>& GridSurf,
     const NCollection_Array1<double>&                                  UJoints,
     const NCollection_Array1<double>&                                  VJoints);
 
   //! Returns number of patches in U direction.
   Standard_EXPORT int NbUPatches() const;
 
   //! Returns number of patches in V direction.
   Standard_EXPORT int NbVPatches() const;
 
   //! Returns one surface patch
   Standard_EXPORT const occ::handle<Geom_Surface>& Patch(const int i, const int j) const;
 
   //! Returns grid of surfaces
   Standard_EXPORT const occ::handle<NCollection_HArray2<occ::handle<Geom_Surface>>>& Patches()
     const;
 
   //! Returns the array of U values corresponding to joint
   //! points between patches as well as to start and end points,
   //! which define global parametrisation of the surface
   Standard_EXPORT occ::handle<NCollection_HArray1<double>> UJointValues() const;
 
   //! Returns the array of V values corresponding to joint
   //! points between patches as well as to start and end points,
   //! which define global parametrisation of the surface
   Standard_EXPORT occ::handle<NCollection_HArray1<double>> VJointValues() const;
 
   //! Returns i-th joint value in U direction
   //! (1-st is global Umin, (NbUPatches()+1)-th is global Umax
   //! on the composite surface)
   Standard_EXPORT double UJointValue(const int i) const;
 
   //! Returns j-th joint value in V direction
   //! (1-st is global Vmin, (NbVPatches()+1)-th is global Vmax
   //! on the composite surface)
   Standard_EXPORT double VJointValue(const int j) const;
 
   //! Sets the array of U values corresponding to joint
   //! points, which define global parametrisation of the surface.
   //! Number of values in array should be equal to NbUPatches()+1.
   //! All the values should be sorted in increasing order.
   //! If this is not satisfied, does nothing and returns False.
   Standard_EXPORT bool SetUJointValues(const NCollection_Array1<double>& UJoints);
 
   //! Sets the array of V values corresponding to joint
   //! points, which define global parametrisation of the surface
   //! Number of values in array should be equal to NbVPatches()+1.
   //! All the values should be sorted in increasing order.
   //! If this is not satisfied, does nothing and returns False.
   Standard_EXPORT bool SetVJointValues(const NCollection_Array1<double>& VJoints);
 
   //! Changes starting value for global U parametrisation (all
   //! other joint values are shifted accordingly)
   Standard_EXPORT void SetUFirstValue(const double UFirst);
 
   //! Changes starting value for global V parametrisation (all
   //! other joint values are shifted accordingly)
   Standard_EXPORT void SetVFirstValue(const double VFirst);
 
   //! Returns number of col that contains given (global) parameter
   Standard_EXPORT int LocateUParameter(const double U) const;
 
   //! Returns number of row that contains given (global) parameter
   Standard_EXPORT int LocateVParameter(const double V) const;
 
   //! Returns number of row and col of surface that contains
   //! given point
   Standard_EXPORT void LocateUVPoint(const gp_Pnt2d& pnt, int& i, int& j) const;
 
   //! Returns one surface patch that contains given (global) parameters
   Standard_EXPORT const occ::handle<Geom_Surface>& Patch(const double U, const double V) const;
 
   //! Returns one surface patch that contains given point
   Standard_EXPORT const occ::handle<Geom_Surface>& Patch(const gp_Pnt2d& pnt) const;
 
   //! Converts local parameter u on patch i,j to global parameter U
   Standard_EXPORT double ULocalToGlobal(const int i, const int j, const double u) const;
 
   //! Converts local parameter v on patch i,j to global parameter V
   Standard_EXPORT double VLocalToGlobal(const int i, const int j, const double v) const;
 
   //! Converts local parameters uv on patch i,j to global parameters UV
   Standard_EXPORT gp_Pnt2d LocalToGlobal(const int i, const int j, const gp_Pnt2d& uv) const;
 
   //! Converts global parameter U to local parameter u on patch i,j
   Standard_EXPORT double UGlobalToLocal(const int i, const int j, const double U) const;
 
   //! Converts global parameter V to local parameter v on patch i,j
   Standard_EXPORT double VGlobalToLocal(const int i, const int j, const double V) const;
 
   //! Converts global parameters UV to local parameters uv on patch i,j
   Standard_EXPORT gp_Pnt2d GlobalToLocal(const int i, const int j, const gp_Pnt2d& UV) const;
 
   //! Computes transformation operator and uFactor descrinbing affine
   //! transformation required to convert global parameters on composite
   //! surface to local parameters on patch (i,j):
   //! uv = ( uFactor, 1. ) X Trsf * UV;
   //! NOTE: Thus Trsf contains shift and scale by V, scale by U is stored in uFact.
   //! Returns True if transformation is not an identity
   Standard_EXPORT bool GlobalToLocalTransformation(const int  i,
                                                    const int  j,
                                                    double&    uFact,
                                                    gp_Trsf2d& Trsf) const;
 
   //! Applies transformation to all the patches
   Standard_EXPORT void Transform(const gp_Trsf& T) override;
 
   //! Returns a copy of the surface
   Standard_EXPORT occ::handle<Geom_Geometry> Copy() const override;
 
   //! NOT IMPLEMENTED (does nothing)
   Standard_EXPORT void UReverse() override;
 
   //! Returns U
   Standard_EXPORT double UReversedParameter(const double U) const override;
 
   //! NOT IMPLEMENTED (does nothing)
   Standard_EXPORT void VReverse() override;
 
   //! Returns V
   Standard_EXPORT double VReversedParameter(const double V) const override;
 
   //! Returns the parametric bounds of grid
   Standard_EXPORT void Bounds(double& U1, double& U2, double& V1, double& V2) const override;
 
   //! Returns True if grid is closed in U direction
   //! (i.e. connected with Precision::Confusion)
   Standard_EXPORT bool IsUClosed() const override;
 
   //! Returns True if grid is closed in V direction
   //! (i.e. connected with Precision::Confusion)
   Standard_EXPORT bool IsVClosed() const override;
 
   //! Returns False
   Standard_EXPORT bool IsUPeriodic() const override;
 
   //! Returns False
   Standard_EXPORT bool IsVPeriodic() const override;
 
   //! NOT IMPLEMENTED (returns Null curve)
   Standard_EXPORT occ::handle<Geom_Curve> UIso(const double U) const override;
 
   //! NOT IMPLEMENTED (returns Null curve)
   Standard_EXPORT occ::handle<Geom_Curve> VIso(const double V) const override;
 
   //! returns C0
   Standard_EXPORT GeomAbs_Shape Continuity() const override;
 
   //! returns True if N <=0
   Standard_EXPORT bool IsCNu(const int N) const override;
 
   //! returns True if N <=0
   Standard_EXPORT bool IsCNv(const int N) const override;
 
   //! Computes the point of parameter U,V on the grid.
   Standard_EXPORT gp_Pnt EvalD0(const double U, const double V) const override;
 
   //! Computes the point P and the first derivatives in the
   //! directions U and V at this point.
   Standard_EXPORT Geom_Surface::ResD1 EvalD1(const double U, const double V) const override;
 
   //! Computes the point P, the first and the second derivatives in
   //! the directions U and V at this point.
   Standard_EXPORT Geom_Surface::ResD2 EvalD2(const double U, const double V) const override;
 
   //! Computes the point P, the first,the second and the third
   //! derivatives in the directions U and V at this point.
   Standard_EXPORT Geom_Surface::ResD3 EvalD3(const double U, const double V) const override;
 
   //! Computes the derivative of order Nu in the direction U and Nv
   //! in the direction V at the point P(U, V).
   Standard_EXPORT gp_Vec EvalDN(const double U,
                                 const double V,
                                 const int    Nu,
                                 const int    Nv) const override;
 
   //! Computes the point of parameter pnt on the grid.
   Standard_EXPORT gp_Pnt Value(const gp_Pnt2d& pnt) const;
 
   //! Computes Joint values according to parameter
   Standard_EXPORT void ComputeJointValues(
     const ShapeExtend_Parametrisation param = ShapeExtend_Natural);
 
   //! Checks geometrical connectivity of the patches, including
   //! closedness (sets fields muUClosed and myVClosed)
   Standard_EXPORT bool CheckConnectivity(const double prec);
 
   DEFINE_STANDARD_RTTIEXT(ShapeExtend_CompositeSurface, Geom_Surface)
 
 private:
   occ::handle<NCollection_HArray2<occ::handle<Geom_Surface>>> myPatches;
   occ::handle<NCollection_HArray1<double>>                    myUJointValues;
   occ::handle<NCollection_HArray1<double>>                    myVJointValues;
   bool                                                        myUClosed;
   bool                                                        myVClosed;
 };
 
 #endif // _ShapeExtend_CompositeSurface_HeaderFile

This page was automatically generated by the 2.3.7 LXR engine. The LXR team