GeomGridEval_Surface Class Reference

Unified grid evaluator for any 3D surface. More...

#include <GeomGridEval_Surface.hxx>

Public Types
using	EvaluatorVariant
	Variant type holding all possible surface evaluators.

Public Member Functions
	GeomGridEval_Surface (const Adaptor3d_Surface &theSurface)
	Construct from adaptor reference (auto-detects surface type). For GeomAdaptor_Surface, extracts underlying Geom_Surface for optimized evaluation. For other adaptors, stores reference for fallback evaluation.
	GeomGridEval_Surface (const occ::handle< Geom_Surface > &theSurface)
	Construct from geometry handle (auto-detects surface type).
	GeomGridEval_Surface (const GeomGridEval_Surface &)=delete
	Non-copyable and non-movable.
GeomGridEval_Surface &	operator= (const GeomGridEval_Surface &)=delete
	GeomGridEval_Surface (GeomGridEval_Surface &&)=delete
GeomGridEval_Surface &	operator= (GeomGridEval_Surface &&)=delete
NCollection_Array2< gp_Pnt >	EvaluateGrid (const NCollection_Array1< double > &theUParams, const NCollection_Array1< double > &theVParams) const
	Evaluate grid points at all specified parameters.
NCollection_Array2< GeomGridEval::SurfD1 >	EvaluateGridD1 (const NCollection_Array1< double > &theUParams, const NCollection_Array1< double > &theVParams) const
	Evaluate grid points with first partial derivatives.
NCollection_Array2< GeomGridEval::SurfD2 >	EvaluateGridD2 (const NCollection_Array1< double > &theUParams, const NCollection_Array1< double > &theVParams) const
	Evaluate grid points with first and second partial derivatives.
NCollection_Array2< GeomGridEval::SurfD3 >	EvaluateGridD3 (const NCollection_Array1< double > &theUParams, const NCollection_Array1< double > &theVParams) const
	Evaluate grid points with derivatives up to third order.
NCollection_Array2< gp_Vec >	EvaluateGridDN (const NCollection_Array1< double > &theUParams, const NCollection_Array1< double > &theVParams, int theNU, int theNV) const
	Evaluate partial derivative d^(NU+NV)S/(dU^NU dV^NV) at all grid points.
GeomAbs_SurfaceType	GetType () const
	Returns the detected surface type.
bool	HasTransformation () const
	Returns true if a transformation is applied.
const std::optional< gp_Trsf > &	GetTransformation () const
	Returns the transformation (empty if not set).

Protected Member Functions
void	initialization (const Adaptor3d_Surface &theSurface)
	Initialize from adaptor reference (auto-detects surface type).
void	initialization (const occ::handle< Geom_Surface > &theSurface)
	Initialize from geometry handle (auto-detects surface type).

Detailed Description

Unified grid evaluator for any 3D surface.

Uses std::variant for compile-time type safety and zero heap allocation for the evaluator itself. Automatically detects surface type from Adaptor3d_Surface and dispatches to the appropriate specialized evaluator.

Supported surface types with optimized evaluation:

• Plane: Direct analytical formula
• Cylinder: Analytical formula
• Sphere: Trigonometric formula
• Cone: Analytical formula
• Torus: Analytical formula
• BezierSurface: Optimized batch evaluation via BSplSLib
• BSplineSurface: Optimized batch evaluation with span-based caching
• OffsetSurface: Optimized batch evaluation using basis surface derivatives
• SurfaceOfRevolution: Batch evaluation using basis curve
• SurfaceOfExtrusion: Batch evaluation using basis curve
• Other: Fallback using Adaptor3d_Surface::D0

Usage:

GeomGridEval_Surface anEval(myAdaptorSurface);
// OR
GeomGridEval_Surface anEval(myGeomSurface);
// Grid evaluation
NCollection_Array2<gp_Pnt> aGrid = anEval.EvaluateGrid(myUParams, myVParams);

Member Typedef Documentation

EvaluatorVariant

using GeomGridEval_Surface::EvaluatorVariant

Initial value:

 std::variant<std::monostate,                   
                                        GeomGridEval_Plane,               
                                        GeomGridEval_Cylinder,            
                                        GeomGridEval_Sphere,              
                                        GeomGridEval_Cone,                
                                        GeomGridEval_Torus,               
                                        GeomGridEval_BezierSurface,       
                                        GeomGridEval_BSplineSurface,      
                                        GeomGridEval_OffsetSurface,       
                                        GeomGridEval_SurfaceOfRevolution, 
                                        GeomGridEval_SurfaceOfExtrusion,  
                                        GeomGridEval_OtherSurface>

Variant type holding all possible surface evaluators.

Constructor & Destructor Documentation

GeomGridEval_Surface() [1/4]

GeomGridEval_Surface::GeomGridEval_Surface

(

const Adaptor3d_Surface &

theSurface

)

Construct from adaptor reference (auto-detects surface type). For GeomAdaptor_Surface, extracts underlying Geom_Surface for optimized evaluation. For other adaptors, stores reference for fallback evaluation.

Note

The surface adaptor reference must remain valid during the lifetime of this evaluator when using fallback evaluation.

Parameters

[in]

theSurface

surface adaptor reference to evaluate

GeomGridEval_Surface() [2/4]

GeomGridEval_Surface::GeomGridEval_Surface

(

const occ::handle< Geom_Surface > &

theSurface

)

Construct from geometry handle (auto-detects surface type).

Parameters

[in]

theSurface

geometry to evaluate

GeomGridEval_Surface() [3/4]

GeomGridEval_Surface::GeomGridEval_Surface ( const GeomGridEval_Surface & )

delete

Non-copyable and non-movable.

GeomGridEval_Surface() [4/4]

GeomGridEval_Surface::GeomGridEval_Surface ( GeomGridEval_Surface && )

delete

Member Function Documentation

EvaluateGrid()

NCollection_Array2< gp_Pnt > GeomGridEval_Surface::EvaluateGrid	(	const NCollection_Array1< double > &	theUParams,
		const NCollection_Array1< double > &	theVParams ) const

Evaluate grid points at all specified parameters.

Parameters

[in]	theUParams	array of U parameter values
[in]	theVParams	array of V parameter values

Returns

2D array of 3D points (1-based indexing)

EvaluateGridD1()

NCollection_Array2< GeomGridEval::SurfD1 > GeomGridEval_Surface::EvaluateGridD1	(	const NCollection_Array1< double > &	theUParams,
		const NCollection_Array1< double > &	theVParams ) const

Evaluate grid points with first partial derivatives.

Parameters

[in]	theUParams	array of U parameter values
[in]	theVParams	array of V parameter values

Returns

2D array of SurfD1 (1-based indexing)

EvaluateGridD2()

NCollection_Array2< GeomGridEval::SurfD2 > GeomGridEval_Surface::EvaluateGridD2	(	const NCollection_Array1< double > &	theUParams,
		const NCollection_Array1< double > &	theVParams ) const

Evaluate grid points with first and second partial derivatives.

Parameters

[in]	theUParams	array of U parameter values
[in]	theVParams	array of V parameter values

Returns

2D array of SurfD2 (1-based indexing)

EvaluateGridD3()

NCollection_Array2< GeomGridEval::SurfD3 > GeomGridEval_Surface::EvaluateGridD3	(	const NCollection_Array1< double > &	theUParams,
		const NCollection_Array1< double > &	theVParams ) const

Evaluate grid points with derivatives up to third order.

Parameters

[in]	theUParams	array of U parameter values
[in]	theVParams	array of V parameter values

Returns

2D array of SurfD3 (1-based indexing)

EvaluateGridDN()

NCollection_Array2< gp_Vec > GeomGridEval_Surface::EvaluateGridDN	(	const NCollection_Array1< double > &	theUParams,
		const NCollection_Array1< double > &	theVParams,
		int	theNU,
		int	theNV ) const

Evaluate partial derivative d^(NU+NV)S/(dU^NU dV^NV) at all grid points.

Parameters

[in]	theUParams	array of U parameter values
[in]	theVParams	array of V parameter values
[in]	theNU	derivative order in U direction
[in]	theNV	derivative order in V direction

Returns

2D array of derivative vectors (1-based indexing)

GetTransformation()

const std::optional< gp_Trsf > & GeomGridEval_Surface::GetTransformation ( ) const

inline

Returns the transformation (empty if not set).

GetType()

GeomAbs_SurfaceType GeomGridEval_Surface::GetType ( ) const

inline

Returns the detected surface type.

HasTransformation()

bool GeomGridEval_Surface::HasTransformation ( ) const

inline

Returns true if a transformation is applied.

initialization() [1/2]

void GeomGridEval_Surface::initialization ( const Adaptor3d_Surface & theSurface )

protected

Initialize from adaptor reference (auto-detects surface type).

Parameters

[in]

theSurface

surface adaptor reference to evaluate

initialization() [2/2]

void GeomGridEval_Surface::initialization ( const occ::handle< Geom_Surface > & theSurface )

protected

Initialize from geometry handle (auto-detects surface type).

Parameters

[in]

theSurface

geometry to evaluate

operator=() [1/2]

GeomGridEval_Surface & GeomGridEval_Surface::operator= ( const GeomGridEval_Surface & )

delete

operator=() [2/2]

GeomGridEval_Surface & GeomGridEval_Surface::operator= ( GeomGridEval_Surface && )

delete

---

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

• GeomGridEval_Surface.hxx