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

File indexing completed on 2026-05-04 08:45:20

 // 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 <Standard.hxx>
 #include <Standard_Type.hxx>
 
 #include <Geom_SweptSurface.hxx>
 #include <GeomEvaluator_SurfaceOfExtrusion.hxx>
 #include <Standard_Integer.hxx>
 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>.
   //! @code
   //!   me->Transformed(T)->Value(U',V')
   //! @endcode
   //! is the same point as
   //! @code
   //!   me->Value(U,V).Transformed(T)
   //! @endcode
   //! Where U',V' are the new values of U,V after calling
   //! @code
   //!   me->TransformParameters(U,V,T)
   //! @endcode
   //! This method 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.
   //! @code
   //!   me->Transformed(T)->Value(U',V')
   //! @endcode
   //! is the same point as
   //! @code
   //!   me->Value(U,V).Transformed(T)
   //! @endcode
   //! Where U',V' are  obtained by transforming U,V with
   //! the 2d transformation returned by
   //! @code
   //!   me->ParametricTransformation(T)
   //! @endcode
   //! This method 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;
 
   //! Dumps the content of me into the stream
   Standard_EXPORT virtual void DumpJson(Standard_OStream& theOStream,
                                         Standard_Integer  theDepth = -1) const Standard_OVERRIDE;
 
   DEFINE_STANDARD_RTTIEXT(Geom_SurfaceOfLinearExtrusion, Geom_SweptSurface)
 
 protected:
 private:
   Handle(GeomEvaluator_SurfaceOfExtrusion) myEvaluator;
 };
 
 #endif // _Geom_SurfaceOfLinearExtrusion_HeaderFile

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