// Created on: 1993-03-10 // Created by: JCV // 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 _Geom_SurfaceOfLinearExtrusion_HeaderFile #define _Geom_SurfaceOfLinearExtrusion_HeaderFile #include #include #include #include #include #include #include class Standard_RangeError; class Geom_UndefinedDerivative; class Geom_Curve; class gp_Dir; class gp_Pnt; class gp_Vec; class gp_Trsf; class gp_GTrsf2d; class Geom_Geometry; class Geom_SurfaceOfLinearExtrusion; DEFINE_STANDARD_HANDLE(Geom_SurfaceOfLinearExtrusion, Geom_SweptSurface) //! Describes a surface of linear extrusion ("extruded //! surface"), e.g. a generalized cylinder. Such a surface //! is obtained by sweeping a curve (called the "extruded //! curve" or "basis") in a given direction (referred to as //! the "direction of extrusion" and defined by a unit vector). //! The u parameter is along the extruded curve. The v //! parameter is along the direction of extrusion. //! The parameter range for the u parameter is defined //! by the reference curve. //! The parameter range for the v parameter is ] - //! infinity, + infinity [. //! The position of the curve gives the origin of the v parameter. //! The surface is "CN" in the v parametric direction. //! The form of a surface of linear extrusion is generally a //! ruled surface (GeomAbs_RuledForm). It can be: //! - a cylindrical surface, if the extruded curve is a circle, //! or a trimmed circle, with an axis parallel to the //! direction of extrusion (GeomAbs_CylindricalForm), or //! - a planar surface, if the extruded curve is a line //! (GeomAbs_PlanarForm). //! Note: The surface of extrusion is built from a copy of //! the original basis curve, so the original curve is not //! modified when the surface is modified. //! Warning //! Degenerate surfaces are not detected. A degenerate //! surface is obtained, for example, when the extruded //! curve is a line and the direction of extrusion is parallel //! to that line. class Geom_SurfaceOfLinearExtrusion : public Geom_SweptSurface { public: //! V is the direction of extrusion. //! C is the extruded curve. //! The form of a SurfaceOfLinearExtrusion can be : //! . ruled surface (RuledForm), //! . a cylindrical surface if the extruded curve is a circle or //! a trimmed circle (CylindricalForm), //! . a plane surface if the extruded curve is a Line (PlanarForm). //! Warnings : //! Degenerated surface cases are not detected. For example if the //! curve C is a line and V is parallel to the direction of this //! line. Standard_EXPORT Geom_SurfaceOfLinearExtrusion(const Handle(Geom_Curve)& C, const gp_Dir& V); //! Assigns V as the "direction of extrusion" for this //! surface of linear extrusion. Standard_EXPORT void SetDirection (const gp_Dir& V); //! Modifies this surface of linear extrusion by redefining //! its "basis curve" (the "extruded curve"). Standard_EXPORT void SetBasisCurve (const Handle(Geom_Curve)& C); //! Changes the orientation of this surface of linear //! extrusion in the u parametric direction. The //! bounds of the surface are not changed, but the given //! parametric direction is reversed. Hence the //! orientation of the surface is reversed. //! In the case of a surface of linear extrusion: //! - UReverse reverses the basis curve, and //! - VReverse reverses the direction of linear extrusion. Standard_EXPORT void UReverse() Standard_OVERRIDE; //! Computes the u parameter on the modified //! surface, produced by reversing its u parametric //! direction, for any point of u parameter U on this surface of linear extrusion. //! In the case of an extruded surface: //! - UReverseParameter returns the reversed //! parameter given by the function //! ReversedParameter called with U on the basis curve, Standard_EXPORT Standard_Real UReversedParameter (const Standard_Real U) const Standard_OVERRIDE; //! Changes the orientation of this surface of linear //! extrusion in the v parametric direction. The //! bounds of the surface are not changed, but the given //! parametric direction is reversed. Hence the //! orientation of the surface is reversed. //! In the case of a surface of linear extrusion: //! - UReverse reverses the basis curve, and //! - VReverse reverses the direction of linear extrusion. Standard_EXPORT void VReverse() Standard_OVERRIDE; //! Computes the v parameter on the modified //! surface, produced by reversing its u v parametric //! direction, for any point of v parameter V on this surface of linear extrusion. //! In the case of an extruded surface VReverse returns -V. Standard_EXPORT Standard_Real VReversedParameter (const Standard_Real V) const Standard_OVERRIDE; //! Returns the parametric bounds U1, U2, V1 and V2 of //! this surface of linear extrusion. //! A surface of linear extrusion is infinite in the v //! parametric direction, so: //! - V1 = Standard_Real::RealFirst() //! - V2 = Standard_Real::RealLast(). Standard_EXPORT void Bounds (Standard_Real& U1, Standard_Real& U2, Standard_Real& V1, Standard_Real& V2) const Standard_OVERRIDE; //! IsUClosed returns true if the "basis curve" of this //! surface of linear extrusion is closed. Standard_EXPORT Standard_Boolean IsUClosed() const Standard_OVERRIDE; //! IsVClosed always returns false. Standard_EXPORT Standard_Boolean IsVClosed() const Standard_OVERRIDE; //! IsCNu returns true if the degree of continuity for the //! "basis curve" of this surface of linear extrusion is at least N. //! Raises RangeError if N < 0. Standard_EXPORT Standard_Boolean IsCNu (const Standard_Integer N) const Standard_OVERRIDE; //! IsCNv always returns true. Standard_EXPORT Standard_Boolean IsCNv (const Standard_Integer N) const Standard_OVERRIDE; //! IsUPeriodic returns true if the "basis curve" of this //! surface of linear extrusion is periodic. Standard_EXPORT Standard_Boolean IsUPeriodic() const Standard_OVERRIDE; //! IsVPeriodic always returns false. Standard_EXPORT Standard_Boolean IsVPeriodic() const Standard_OVERRIDE; //! Computes the U isoparametric curve of this surface //! of linear extrusion. This is the line parallel to the //! direction of extrusion, passing through the point of //! parameter U of the basis curve. Standard_EXPORT Handle(Geom_Curve) UIso (const Standard_Real U) const Standard_OVERRIDE; //! Computes the V isoparametric curve of this surface //! of linear extrusion. This curve is obtained by //! translating the extruded curve in the direction of //! extrusion, with the magnitude V. Standard_EXPORT Handle(Geom_Curve) VIso (const Standard_Real V) const Standard_OVERRIDE; //! Computes the point P (U, V) on the surface. //! The parameter U is the parameter on the extruded curve. //! The parametrization V is a linear parametrization, and //! the direction of parametrization is the direction of //! extrusion. If the point is on the extruded curve, V = 0.0 Standard_EXPORT void D0 (const Standard_Real U, const Standard_Real V, gp_Pnt& P) const Standard_OVERRIDE; //! Computes the current point and the first derivatives in the //! directions U and V. //! Raises UndefinedDerivative if the continuity of the surface is not C1. Standard_EXPORT void D1 (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& D1U, gp_Vec& D1V) const Standard_OVERRIDE; //! --- Purpose ; //! Computes the current point, the first and the second derivatives //! in the directions U and V. //! Raises UndefinedDerivative if the continuity of the surface is not C2. 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 current point, the first,the second and the third //! derivatives in the directions U and V. //! Raises UndefinedDerivative if the continuity of the surface is not C3. 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. //! Raises UndefinedDerivative if the continuity of the surface is not CNu in the u //! direction and CNv in the v direction. //! Raises RangeError 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; //! Applies the transformation T to this surface of linear extrusion. Standard_EXPORT void Transform (const gp_Trsf& T) Standard_OVERRIDE; //! Computes the parameters on the transformed surface for //! the transform of the point of parameters U,V on . //! //! me->Transformed(T)->Value(U',V') //! //! is the same point as //! //! me->Value(U,V).Transformed(T) //! //! Where U',V' are the new values of U,V after calling //! //! me->TranformParameters(U,V,T) //! //! This methods multiplies : //! U by BasisCurve()->ParametricTransformation(T) //! V by T.ScaleFactor() Standard_EXPORT virtual void TransformParameters (Standard_Real& U, Standard_Real& V, const gp_Trsf& T) const Standard_OVERRIDE; //! Returns a 2d transformation used to find the new //! parameters of a point on the transformed surface. //! //! me->Transformed(T)->Value(U',V') //! //! is the same point as //! //! me->Value(U,V).Transformed(T) //! //! Where U',V' are obtained by transforming U,V with //! th 2d transformation returned by //! //! me->ParametricTransformation(T) //! //! This methods returns a scale //! U by BasisCurve()->ParametricTransformation(T) //! V by T.ScaleFactor() Standard_EXPORT virtual gp_GTrsf2d ParametricTransformation (const gp_Trsf& T) const Standard_OVERRIDE; //! Creates a new object which is a copy of this surface of linear extrusion. Standard_EXPORT Handle(Geom_Geometry) Copy() const Standard_OVERRIDE; DEFINE_STANDARD_RTTIEXT(Geom_SurfaceOfLinearExtrusion,Geom_SweptSurface) protected: private: Handle(GeomEvaluator_SurfaceOfExtrusion) myEvaluator; }; #endif // _Geom_SurfaceOfLinearExtrusion_HeaderFile