Open CASCADE Technology Reference Manual 8.0.0
Loading...
Searching...
No Matches
Public Member Functions
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:
Inheritance graph
[legend]

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

- Public Types inherited from Standard_Transient
typedef void base_type
 Returns a type descriptor about this object.
 
- Static Public Member Functions inherited from Standard_Transient
static constexpr const charget_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()

virtual occ::handle< Adaptor3d_Curve > Adaptor3d_Surface::BasisCurve ( ) const
virtual

◆ BasisSurface()

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

◆ Bezier()

virtual occ::handle< Geom_BezierSurface > Adaptor3d_Surface::Bezier ( ) const
virtual

◆ BSpline()

virtual occ::handle< Geom_BSplineSurface > Adaptor3d_Surface::BSpline ( ) const
virtual

◆ Cone()

virtual gp_Cone Adaptor3d_Surface::Cone ( ) const
virtual

◆ 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
virtual

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
virtual

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
virtual

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
virtual

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
virtual

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()

virtual gp_Sphere Adaptor3d_Surface::Sphere ( ) const
virtual

◆ Torus()

virtual gp_Torus Adaptor3d_Surface::Torus ( ) const
virtual

◆ 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: