// Created on: 1993-05-14 // Created by: Bruno DUMORTIER // Copyright (c) 1993-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 _GeomAdaptor_Surface_HeaderFile #define _GeomAdaptor_Surface_HeaderFile #include #include #include #include #include #include #include DEFINE_STANDARD_HANDLE(GeomAdaptor_Surface, Adaptor3d_Surface) //! An interface between the services provided by any //! surface from the package Geom and those required //! of the surface by algorithms which use it. //! Creation of the loaded surface the surface is C1 by piece //! //! Polynomial coefficients of BSpline surfaces used for their evaluation are //! cached for better performance. Therefore these evaluations are not //! thread-safe and parallel evaluations need to be prevented. class GeomAdaptor_Surface : public Adaptor3d_Surface { DEFINE_STANDARD_RTTIEXT(GeomAdaptor_Surface, Adaptor3d_Surface) public: GeomAdaptor_Surface() : myUFirst(0.), myULast(0.), myVFirst(0.), myVLast (0.), myTolU(0.), myTolV(0.), mySurfaceType (GeomAbs_OtherSurface) {} GeomAdaptor_Surface(const Handle(Geom_Surface)& theSurf) : myTolU(0.), myTolV(0.) { Load (theSurf); } //! Standard_ConstructionError is raised if UFirst>ULast or VFirst>VLast GeomAdaptor_Surface (const Handle(Geom_Surface)& theSurf, const Standard_Real theUFirst, const Standard_Real theULast, const Standard_Real theVFirst, const Standard_Real theVLast, const Standard_Real theTolU = 0.0, const Standard_Real theTolV = 0.0) { Load (theSurf, theUFirst, theULast, theVFirst, theVLast, theTolU, theTolV); } //! Shallow copy of adaptor Standard_EXPORT virtual Handle(Adaptor3d_Surface) ShallowCopy() const Standard_OVERRIDE; void Load (const Handle(Geom_Surface)& theSurf) { if (theSurf.IsNull()) { throw Standard_NullObject("GeomAdaptor_Surface::Load"); } Standard_Real aU1, aU2, aV1, aV2; theSurf->Bounds (aU1, aU2, aV1, aV2); load (theSurf, aU1, aU2, aV1, aV2); } //! Standard_ConstructionError is raised if theUFirst>theULast or theVFirst>theVLast void Load (const Handle(Geom_Surface)& theSurf, const Standard_Real theUFirst, const Standard_Real theULast, const Standard_Real theVFirst, const Standard_Real theVLast, const Standard_Real theTolU = 0.0, const Standard_Real theTolV = 0.0) { if (theSurf.IsNull()) { throw Standard_NullObject("GeomAdaptor_Surface::Load"); } if (theUFirst > theULast || theVFirst > theVLast) { throw Standard_ConstructionError("GeomAdaptor_Surface::Load"); } load (theSurf, theUFirst, theULast, theVFirst, theVLast, theTolU, theTolV); } const Handle(Geom_Surface)& Surface() const { return mySurface; } virtual Standard_Real FirstUParameter() const Standard_OVERRIDE { return myUFirst; } virtual Standard_Real LastUParameter() const Standard_OVERRIDE { return myULast; } virtual Standard_Real FirstVParameter() const Standard_OVERRIDE { return myVFirst; } virtual Standard_Real LastVParameter() const Standard_OVERRIDE { return myVLast; } Standard_EXPORT GeomAbs_Shape UContinuity() const Standard_OVERRIDE; Standard_EXPORT GeomAbs_Shape VContinuity() const Standard_OVERRIDE; //! Returns the number of U intervals for continuity //! . May be one if UContinuity(me) >= Standard_EXPORT Standard_Integer NbUIntervals (const GeomAbs_Shape S) const Standard_OVERRIDE; //! Returns the number of V intervals for continuity //! . May be one if VContinuity(me) >= Standard_EXPORT Standard_Integer NbVIntervals (const GeomAbs_Shape S) const Standard_OVERRIDE; //! Returns the intervals with the requested continuity //! in the U direction. Standard_EXPORT void UIntervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const Standard_OVERRIDE; //! Returns the intervals with the requested continuity //! in the V direction. Standard_EXPORT void VIntervals (TColStd_Array1OfReal& T, const GeomAbs_Shape S) const Standard_OVERRIDE; //! Returns a surface trimmed in the U direction //! equivalent of between //! parameters and . is used to //! test for 3d points confusion. //! If >= Standard_EXPORT Handle(Adaptor3d_Surface) UTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const Standard_OVERRIDE; //! Returns a surface trimmed in the V direction between //! parameters and . is used to //! test for 3d points confusion. //! If >= Standard_EXPORT Handle(Adaptor3d_Surface) VTrim (const Standard_Real First, const Standard_Real Last, const Standard_Real Tol) const Standard_OVERRIDE; Standard_EXPORT Standard_Boolean IsUClosed() const Standard_OVERRIDE; Standard_EXPORT Standard_Boolean IsVClosed() const Standard_OVERRIDE; Standard_EXPORT Standard_Boolean IsUPeriodic() const Standard_OVERRIDE; Standard_EXPORT Standard_Real UPeriod() const Standard_OVERRIDE; Standard_EXPORT Standard_Boolean IsVPeriodic() const Standard_OVERRIDE; Standard_EXPORT Standard_Real VPeriod() const Standard_OVERRIDE; //! Computes the point of parameters U,V on the surface. Standard_EXPORT gp_Pnt Value (const Standard_Real U, const Standard_Real V) const Standard_OVERRIDE; //! Computes the point of parameters U,V on the surface. Standard_EXPORT void D0 (const Standard_Real U, const Standard_Real V, gp_Pnt& P) const Standard_OVERRIDE; //! Computes the point and the first derivatives on //! the surface. //! //! Warning : On the specific case of BSplineSurface: //! if the surface is cut in interval of continuity at least C1, //! the derivatives are computed on the current interval. //! else the derivatives are computed on the basis surface. Standard_EXPORT void D1 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V) const Standard_OVERRIDE; //! Computes the point, the first and second //! derivatives on the surface. //! //! Warning : On the specific case of BSplineSurface: //! if the surface is cut in interval of continuity at least C2, //! the derivatives are computed on the current interval. //! else the derivatives are computed on the basis surface. Standard_EXPORT void D2 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V, gp_Vec& D2U, gp_Vec& D2V, gp_Vec& D2UV) const Standard_OVERRIDE; //! Computes the point, the first, second and third //! derivatives on the surface. //! //! Warning : On the specific case of BSplineSurface: //! if the surface is cut in interval of continuity at least C3, //! the derivatives are computed on the current interval. //! else the derivatives are computed on the basis surface. Standard_EXPORT void D3 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V, gp_Vec& D2U, gp_Vec& D2V, gp_Vec& D2UV, gp_Vec& D3U, gp_Vec& D3V, gp_Vec& D3UUV, gp_Vec& D3UVV) const Standard_OVERRIDE; //! Computes the derivative of order Nu in the //! direction U and Nv in the direction V at the point P(U, V). //! //! Warning : On the specific case of BSplineSurface: //! if the surface is cut in interval of continuity CN, //! the derivatives are computed on the current interval. //! else the derivatives are computed on the basis surface. //! Raised if Nu + Nv < 1 or Nu < 0 or Nv < 0. Standard_EXPORT gp_Vec DN (const Standard_Real U, const Standard_Real V, const Standard_Integer Nu, const Standard_Integer Nv) const Standard_OVERRIDE; //! Returns the parametric U resolution corresponding //! to the real space resolution . Standard_EXPORT Standard_Real UResolution (const Standard_Real R3d) const Standard_OVERRIDE; //! Returns the parametric V resolution corresponding //! to the real space resolution . Standard_EXPORT Standard_Real VResolution (const Standard_Real R3d) const Standard_OVERRIDE; //! Returns the type of the surface : Plane, Cylinder, //! Cone, Sphere, Torus, BezierSurface, //! BSplineSurface, SurfaceOfRevolution, //! SurfaceOfExtrusion, OtherSurface virtual GeomAbs_SurfaceType GetType() const Standard_OVERRIDE { return mySurfaceType; } Standard_EXPORT gp_Pln Plane() const Standard_OVERRIDE; Standard_EXPORT gp_Cylinder Cylinder() const Standard_OVERRIDE; Standard_EXPORT gp_Cone Cone() const Standard_OVERRIDE; Standard_EXPORT gp_Sphere Sphere() const Standard_OVERRIDE; Standard_EXPORT gp_Torus Torus() const Standard_OVERRIDE; Standard_EXPORT Standard_Integer UDegree() const Standard_OVERRIDE; Standard_EXPORT Standard_Integer NbUPoles() const Standard_OVERRIDE; Standard_EXPORT Standard_Integer VDegree() const Standard_OVERRIDE; Standard_EXPORT Standard_Integer NbVPoles() const Standard_OVERRIDE; Standard_EXPORT Standard_Integer NbUKnots() const Standard_OVERRIDE; Standard_EXPORT Standard_Integer NbVKnots() const Standard_OVERRIDE; Standard_EXPORT Standard_Boolean IsURational() const Standard_OVERRIDE; Standard_EXPORT Standard_Boolean IsVRational() const Standard_OVERRIDE; //! This will NOT make a copy of the //! Bezier Surface : If you want to modify //! the Surface please make a copy yourself //! Also it will NOT trim the surface to //! myU/VFirst/Last. Standard_EXPORT Handle(Geom_BezierSurface) Bezier() const Standard_OVERRIDE; //! This will NOT make a copy of the //! BSpline Surface : If you want to modify //! the Surface please make a copy yourself //! Also it will NOT trim the surface to //! myU/VFirst/Last. Standard_EXPORT Handle(Geom_BSplineSurface) BSpline() const Standard_OVERRIDE; Standard_EXPORT gp_Ax1 AxeOfRevolution() const Standard_OVERRIDE; Standard_EXPORT gp_Dir Direction() const Standard_OVERRIDE; Standard_EXPORT Handle(Adaptor3d_Curve) BasisCurve() const Standard_OVERRIDE; Standard_EXPORT Handle(Adaptor3d_Surface) BasisSurface() const Standard_OVERRIDE; Standard_EXPORT Standard_Real OffsetValue() const Standard_OVERRIDE; private: Standard_EXPORT void Span (const Standard_Integer Side, const Standard_Integer Ideb, const Standard_Integer Ifin, Standard_Integer& OutIdeb, Standard_Integer& OutIfin, const Standard_Integer FKIndx, const Standard_Integer LKIndx) const; Standard_EXPORT Standard_Boolean IfUVBound (const Standard_Real U, const Standard_Real V, Standard_Integer& Ideb, Standard_Integer& Ifin, Standard_Integer& IVdeb, Standard_Integer& IVfin, const Standard_Integer USide, const Standard_Integer VSide) const; Standard_EXPORT void load (const Handle(Geom_Surface)& S, const Standard_Real UFirst, const Standard_Real ULast, const Standard_Real VFirst, const Standard_Real VLast, const Standard_Real TolU = 0.0, const Standard_Real TolV = 0.0); //! Rebuilds B-spline cache //! \param theU first parameter to identify the span for caching //! \param theV second parameter to identify the span for caching Standard_EXPORT void RebuildCache (const Standard_Real theU, const Standard_Real theV) const; protected: Handle(Geom_Surface) mySurface; Standard_Real myUFirst; Standard_Real myULast; Standard_Real myVFirst; Standard_Real myVLast; Standard_Real myTolU; Standard_Real myTolV; Handle(Geom_BSplineSurface) myBSplineSurface; ///< B-spline representation to prevent downcasts mutable Handle(BSplSLib_Cache) mySurfaceCache; ///< Cached data for B-spline or Bezier surface GeomAbs_SurfaceType mySurfaceType; Handle(GeomEvaluator_Surface) myNestedEvaluator; ///< Calculates values of nested complex surfaces (offset surface, surface of extrusion or revolution) }; #endif // _GeomAdaptor_Surface_HeaderFile