OCCT 8.0.1
OCCT documentation

Search guides and API reference

Enter at least two characters.

    Open CASCADE Technology Reference Manual 8.0.1
    Adaptor3d_Surface Class Reference

    Root class for surfaces on which geometric algorithms work. An adapted surface is an interface between the services provided by a surface and those required of the surface by algorithms which use it. A derived concrete class is provided: GeomAdaptor_Surface for a surface from the Geom package. The Surface class describes the standard behaviour of a surface for generic algorithms. More...

    #include <Adaptor3d_Surface.hxx>

    Inheritance diagram for Adaptor3d_Surface:

    Public Member Functions

    virtual occ::handle< Adaptor3d_SurfaceShallowCopy () const
     Shallow copy of adaptor.
    virtual double FirstUParameter () const
    virtual double LastUParameter () const
    virtual double FirstVParameter () const
    virtual double LastVParameter () const
    virtual GeomAbs_Shape UContinuity () const
    virtual GeomAbs_Shape VContinuity () const
    virtual int NbUIntervals (const GeomAbs_Shape S) const
     Returns the number of U intervals for continuity . May be one if UContinuity(me) >= .
    virtual int NbVIntervals (const GeomAbs_Shape S) const
     Returns the number of V intervals for continuity . May be one if VContinuity(me) >= .
    virtual void UIntervals (NCollection_Array1< double > &T, const GeomAbs_Shape S) const
     Returns the intervals with the requested continuity in the U direction.
    virtual void VIntervals (NCollection_Array1< double > &T, const GeomAbs_Shape S) const
     Returns the intervals with the requested continuity in the V direction.
    virtual occ::handle< Adaptor3d_SurfaceUTrim (const double First, const double Last, const double Tol) const
     Returns a surface trimmed in the U direction equivalent of <me> between parameters <First> and <Last>. <Tol> is used to test for 3d points confusion. If <First> >= <Last>.
    virtual occ::handle< Adaptor3d_SurfaceVTrim (const double First, const double Last, const double Tol) const
     Returns a surface trimmed in the V direction between parameters <First> and <Last>. <Tol> is used to test for 3d points confusion. If <First> >= <Last>.
    virtual bool IsUClosed () const
    virtual bool IsVClosed () const
    virtual bool IsUPeriodic () const
    virtual double UPeriod () const
    virtual bool IsVPeriodic () const
    virtual double VPeriod () const
    gp_Pnt Value (const double theU, const double theV) const
     Computes the point of parameters U,V on the surface. Tip: use GeomLib::NormEstim() to calculate surface normal at specified (U, V) point.
    void D0 (const double theU, const double theV, gp_Pnt &theP) const
     Computes the point of parameters U,V on the surface.
    void D1 (const double theU, const double theV, gp_Pnt &theP, gp_Vec &theD1U, gp_Vec &theD1V) const
     Computes the point and the first derivatives on the surface. Raised if the continuity of the current intervals is not C1.
    void D2 (const double theU, const double theV, gp_Pnt &theP, gp_Vec &theD1U, gp_Vec &theD1V, gp_Vec &theD2U, gp_Vec &theD2V, gp_Vec &theD2UV) const
     Computes the point, the first and second derivatives on the surface. Raised if the continuity of the current intervals is not C2.
    void D3 (const double theU, const double theV, gp_Pnt &theP, gp_Vec &theD1U, gp_Vec &theD1V, gp_Vec &theD2U, gp_Vec &theD2V, gp_Vec &theD2UV, gp_Vec &theD3U, gp_Vec &theD3V, gp_Vec &theD3UUV, gp_Vec &theD3UVV) const
     Computes the point, the first, second and third derivatives on the surface. Raised if the continuity of the current intervals is not C3.
    gp_Vec DN (const double theU, const double theV, const int theNu, const int theNv) const
     Computes the derivative of order Nu in the direction U and Nv in the direction V at the point P(U, V). Raised if the current U interval is not not CNu and the current V interval is not CNv. Raised if Nu + Nv < 1 or Nu < 0 or Nv < 0.
    virtual double UResolution (const double R3d) const
     Returns the parametric U resolution corresponding to the real space resolution <R3d>.
    virtual double VResolution (const double R3d) const
     Returns the parametric V resolution corresponding to the real space resolution <R3d>.
    virtual GeomAbs_SurfaceType GetType () const
     Returns the type of the surface: Plane, Cylinder, Cone, Sphere, Torus, BezierSurface, BSplineSurface, SurfaceOfRevolution, SurfaceOfExtrusion, OtherSurface.
    virtual gp_Pln Plane () const
    virtual gp_Cylinder Cylinder () const
    virtual gp_Cone Cone () const
    virtual gp_Sphere Sphere () const
    virtual gp_Torus Torus () const
    virtual int UDegree () const
    virtual int NbUPoles () const
    virtual int VDegree () const
    virtual int NbVPoles () const
    virtual int NbUKnots () const
    virtual int NbVKnots () const
    virtual bool IsURational () const
    virtual bool IsVRational () const
    virtual occ::handle< Geom_BezierSurfaceBezier () const
    virtual occ::handle< Geom_BSplineSurfaceBSpline () const
    virtual gp_Ax1 AxeOfRevolution () const
    virtual gp_Dir Direction () const
    virtual occ::handle< Adaptor3d_CurveBasisCurve () const
    virtual occ::handle< Adaptor3d_SurfaceBasisSurface () const
    virtual double OffsetValue () const
    virtual gp_Pnt EvalD0 (const double theU, const double theV) const
     Computes the point of parameters (U, V) on the surface. Raises an exception on failure.
    virtual Geom_Surface::ResD1 EvalD1 (const double theU, const double theV) const
     Computes the point and first partial derivatives at (U, V). Raises an exception on failure.
    virtual Geom_Surface::ResD2 EvalD2 (const double theU, const double theV) const
     Computes the point and partial derivatives up to 2nd order at (U, V). Raises an exception on failure.
    virtual Geom_Surface::ResD3 EvalD3 (const double theU, const double theV) const
     Computes the point and partial derivatives up to 3rd order at (U, V). Raises an exception on failure.
    virtual gp_Vec EvalDN (const double theU, const double theV, const int theNu, const int theNv) const
     Computes the derivative of order Nu in U and Nv in V at (U, V). Raises an exception on failure.
     ~Adaptor3d_Surface () override
    Public Member Functions inherited from Standard_Transient
     Standard_Transient ()
     Empty constructor.
     Standard_Transient (const Standard_Transient &)
     Copy constructor – does nothing.
    Standard_Transientoperator= (const Standard_Transient &)
     Assignment operator, needed to avoid copying reference counter.
    virtual ~Standard_Transient ()=default
     Destructor must be virtual.
    virtual const opencascade::handle< Standard_Type > & DynamicType () const
     Returns a type descriptor about this object.
    bool IsInstance (const opencascade::handle< Standard_Type > &theType) const
     Returns a true value if this is an instance of Type.
    bool IsInstance (const char *const theTypeName) const
     Returns a true value if this is an instance of TypeName.
    bool IsKind (const opencascade::handle< Standard_Type > &theType) const
     Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.
    bool IsKind (const char *const theTypeName) const
     Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.
    Standard_TransientThis () const
     Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.
    int GetRefCount () const noexcept
     Get the reference counter of this object.
    void IncrementRefCounter () noexcept
     Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.
    int DecrementRefCounter () noexcept
     Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.
    virtual void Delete () const
     Memory deallocator for transient classes.

    Additional Inherited Members

    typedef void base_type
     Returns a type descriptor about this object.
    static constexpr const char * get_type_name ()
     Returns a type descriptor about this object.
    static const opencascade::handle< Standard_Type > & get_type_descriptor ()
     Returns type descriptor of Standard_Transient class.

    Detailed Description

    Root class for surfaces on which geometric algorithms work. An adapted surface is an interface between the services provided by a surface and those required of the surface by algorithms which use it. A derived concrete class is provided: GeomAdaptor_Surface for a surface from the Geom package. The Surface class describes the standard behaviour of a surface for generic algorithms.

    The Surface can be decomposed in intervals of any continuity in U and V using the method NbIntervals. A current interval can be set. Most of the methods apply to the current interval. Warning: All the methods are virtual and implemented with a raise to allow to redefined only the methods really used.

    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.

    Constructor & Destructor Documentation

    ◆ ~Adaptor3d_Surface()

    Adaptor3d_Surface::~Adaptor3d_Surface ( )
    override

    Member Function Documentation

    ◆ AxeOfRevolution()

    virtual gp_Ax1 Adaptor3d_Surface::AxeOfRevolution ( ) const
    virtual

    ◆ BasisCurve()

    ◆ BasisSurface()

    virtual occ::handle< Adaptor3d_Surface > Adaptor3d_Surface::BasisSurface ( ) const
    virtual

    ◆ Bezier()

    ◆ BSpline()

    ◆ Cone()

    ◆ Cylinder()

    virtual gp_Cylinder Adaptor3d_Surface::Cylinder ( ) const
    virtual

    ◆ D0()

    void Adaptor3d_Surface::D0 ( const double theU,
    const double theV,
    gp_Pnt & theP ) const
    inline

    Computes the point of parameters U,V on the surface.

    ◆ D1()

    void Adaptor3d_Surface::D1 ( const double theU,
    const double theV,
    gp_Pnt & theP,
    gp_Vec & theD1U,
    gp_Vec & theD1V ) const
    inline

    Computes the point and the first derivatives on the surface. Raised if the continuity of the current intervals is not C1.

    Tip: use GeomLib::NormEstim() to calculate surface normal at specified (U, V) point.

    ◆ D2()

    void Adaptor3d_Surface::D2 ( const double theU,
    const double theV,
    gp_Pnt & theP,
    gp_Vec & theD1U,
    gp_Vec & theD1V,
    gp_Vec & theD2U,
    gp_Vec & theD2V,
    gp_Vec & theD2UV ) const
    inline

    Computes the point, the first and second derivatives on the surface. Raised if the continuity of the current intervals is not C2.

    ◆ D3()

    void Adaptor3d_Surface::D3 ( const double theU,
    const double theV,
    gp_Pnt & theP,
    gp_Vec & theD1U,
    gp_Vec & theD1V,
    gp_Vec & theD2U,
    gp_Vec & theD2V,
    gp_Vec & theD2UV,
    gp_Vec & theD3U,
    gp_Vec & theD3V,
    gp_Vec & theD3UUV,
    gp_Vec & theD3UVV ) const
    inline

    Computes the point, the first, second and third derivatives on the surface. Raised if the continuity of the current intervals is not C3.

    ◆ Direction()

    virtual gp_Dir Adaptor3d_Surface::Direction ( ) const
    virtual

    ◆ DN()

    gp_Vec Adaptor3d_Surface::DN ( const double theU,
    const double theV,
    const int theNu,
    const int theNv ) const
    inline

    Computes the derivative of order Nu in the direction U and Nv in the direction V at the point P(U, V). Raised if the current U interval is not not CNu and the current V interval is not CNv. Raised if Nu + Nv < 1 or Nu < 0 or Nv < 0.

    ◆ EvalD0()

    virtual gp_Pnt Adaptor3d_Surface::EvalD0 ( const double theU,
    const double theV ) const
    nodiscardvirtual

    Computes the point of parameters (U, V) on the surface. Raises an exception on failure.

    Reimplemented in GeomAdaptor_Surface, and GeomAdaptor_TransformedSurface.

    ◆ EvalD1()

    virtual Geom_Surface::ResD1 Adaptor3d_Surface::EvalD1 ( const double theU,
    const double theV ) const
    nodiscardvirtual

    Computes the point and first partial derivatives at (U, V). Raises an exception on failure.

    Reimplemented in GeomAdaptor_Surface, and GeomAdaptor_TransformedSurface.

    ◆ EvalD2()

    virtual Geom_Surface::ResD2 Adaptor3d_Surface::EvalD2 ( const double theU,
    const double theV ) const
    nodiscardvirtual

    Computes the point and partial derivatives up to 2nd order at (U, V). Raises an exception on failure.

    Reimplemented in GeomAdaptor_Surface, and GeomAdaptor_TransformedSurface.

    ◆ EvalD3()

    virtual Geom_Surface::ResD3 Adaptor3d_Surface::EvalD3 ( const double theU,
    const double theV ) const
    nodiscardvirtual

    Computes the point and partial derivatives up to 3rd order at (U, V). Raises an exception on failure.

    Reimplemented in GeomAdaptor_Surface, and GeomAdaptor_TransformedSurface.

    ◆ EvalDN()

    virtual gp_Vec Adaptor3d_Surface::EvalDN ( const double theU,
    const double theV,
    const int theNu,
    const int theNv ) const
    nodiscardvirtual

    Computes the derivative of order Nu in U and Nv in V at (U, V). Raises an exception on failure.

    Reimplemented in GeomAdaptor_Surface, and GeomAdaptor_TransformedSurface.

    ◆ FirstUParameter()

    virtual double Adaptor3d_Surface::FirstUParameter ( ) const
    virtual

    ◆ FirstVParameter()

    virtual double Adaptor3d_Surface::FirstVParameter ( ) const
    virtual

    ◆ GetType()

    virtual GeomAbs_SurfaceType Adaptor3d_Surface::GetType ( ) const
    virtual

    Returns the type of the surface: Plane, Cylinder, Cone, Sphere, Torus, BezierSurface, BSplineSurface, SurfaceOfRevolution, SurfaceOfExtrusion, OtherSurface.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ IsUClosed()

    virtual bool Adaptor3d_Surface::IsUClosed ( ) const
    virtual

    ◆ IsUPeriodic()

    virtual bool Adaptor3d_Surface::IsUPeriodic ( ) const
    virtual

    ◆ IsURational()

    virtual bool Adaptor3d_Surface::IsURational ( ) const
    virtual

    ◆ IsVClosed()

    virtual bool Adaptor3d_Surface::IsVClosed ( ) const
    virtual

    ◆ IsVPeriodic()

    virtual bool Adaptor3d_Surface::IsVPeriodic ( ) const
    virtual

    ◆ IsVRational()

    virtual bool Adaptor3d_Surface::IsVRational ( ) const
    virtual

    ◆ LastUParameter()

    virtual double Adaptor3d_Surface::LastUParameter ( ) const
    virtual

    ◆ LastVParameter()

    virtual double Adaptor3d_Surface::LastVParameter ( ) const
    virtual

    ◆ NbUIntervals()

    virtual int Adaptor3d_Surface::NbUIntervals ( const GeomAbs_Shape S) const
    virtual

    Returns the number of U intervals for continuity . May be one if UContinuity(me) >= .

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ NbUKnots()

    virtual int Adaptor3d_Surface::NbUKnots ( ) const
    virtual

    ◆ NbUPoles()

    virtual int Adaptor3d_Surface::NbUPoles ( ) const
    virtual

    ◆ NbVIntervals()

    virtual int Adaptor3d_Surface::NbVIntervals ( const GeomAbs_Shape S) const
    virtual

    Returns the number of V intervals for continuity . May be one if VContinuity(me) >= .

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ NbVKnots()

    virtual int Adaptor3d_Surface::NbVKnots ( ) const
    virtual

    ◆ NbVPoles()

    virtual int Adaptor3d_Surface::NbVPoles ( ) const
    virtual

    ◆ OffsetValue()

    virtual double Adaptor3d_Surface::OffsetValue ( ) const
    virtual

    ◆ Plane()

    virtual gp_Pln Adaptor3d_Surface::Plane ( ) const
    virtual

    ◆ ShallowCopy()

    virtual occ::handle< Adaptor3d_Surface > Adaptor3d_Surface::ShallowCopy ( ) const
    virtual

    ◆ Sphere()

    ◆ Torus()

    ◆ UContinuity()

    virtual GeomAbs_Shape Adaptor3d_Surface::UContinuity ( ) const
    virtual

    ◆ UDegree()

    virtual int Adaptor3d_Surface::UDegree ( ) const
    virtual

    ◆ UIntervals()

    virtual void Adaptor3d_Surface::UIntervals ( NCollection_Array1< double > & T,
    const GeomAbs_Shape S ) const
    virtual

    Returns the intervals with the requested continuity in the U direction.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ UPeriod()

    virtual double Adaptor3d_Surface::UPeriod ( ) const
    virtual

    ◆ UResolution()

    virtual double Adaptor3d_Surface::UResolution ( const double R3d) const
    virtual

    Returns the parametric U resolution corresponding to the real space resolution <R3d>.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ UTrim()

    virtual occ::handle< Adaptor3d_Surface > Adaptor3d_Surface::UTrim ( const double First,
    const double Last,
    const double Tol ) const
    virtual

    Returns a surface trimmed in the U direction equivalent of <me> between parameters <First> and <Last>. <Tol> is used to test for 3d points confusion. If <First> >= <Last>.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ Value()

    gp_Pnt Adaptor3d_Surface::Value ( const double theU,
    const double theV ) const
    inline

    Computes the point of parameters U,V on the surface. Tip: use GeomLib::NormEstim() to calculate surface normal at specified (U, V) point.

    ◆ VContinuity()

    virtual GeomAbs_Shape Adaptor3d_Surface::VContinuity ( ) const
    virtual

    ◆ VDegree()

    virtual int Adaptor3d_Surface::VDegree ( ) const
    virtual

    ◆ VIntervals()

    virtual void Adaptor3d_Surface::VIntervals ( NCollection_Array1< double > & T,
    const GeomAbs_Shape S ) const
    virtual

    Returns the intervals with the requested continuity in the V direction.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ VPeriod()

    virtual double Adaptor3d_Surface::VPeriod ( ) const
    virtual

    ◆ VResolution()

    virtual double Adaptor3d_Surface::VResolution ( const double R3d) const
    virtual

    Returns the parametric V resolution corresponding to the real space resolution <R3d>.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.

    ◆ VTrim()

    virtual occ::handle< Adaptor3d_Surface > Adaptor3d_Surface::VTrim ( const double First,
    const double Last,
    const double Tol ) const
    virtual

    Returns a surface trimmed in the V direction between parameters <First> and <Last>. <Tol> is used to test for 3d points confusion. If <First> >= <Last>.

    Reimplemented in GeomAdaptor_Surface, GeomAdaptor_SurfaceOfLinearExtrusion, GeomAdaptor_SurfaceOfRevolution, and GeomAdaptor_TransformedSurface.


    The documentation for this class was generated from the following file: