ExtremaPC_Curve Class Reference

Main aggregator for Point-Curve extrema computation. More...

#include <ExtremaPC_Curve.hxx>

Public Types
using	EvaluatorVariant
	Variant type holding all specialized evaluators.

Public Member Functions
	ExtremaPC_Curve (const GeomAdaptor_Curve &theCurve)
	Constructor with curve adaptor. Uses the curve's natural parameter bounds as domain.
	ExtremaPC_Curve (const GeomAdaptor_Curve &theCurve, double theUMin, double theUMax)
	Constructor with curve adaptor and parameter range.
	ExtremaPC_Curve (const GeomAdaptor_TransformedCurve &theCurve)
	Constructor with transformed curve adaptor. Uses the curve's natural parameter bounds as domain. For elementary curves, uses already-transformed primitives (analytical solver). For BSpline/Bezier, uses inverse-transform optimization with post-processing. For offset/other curves, delegates through Adaptor3d_Curve interface.
	ExtremaPC_Curve (const GeomAdaptor_TransformedCurve &theCurve, double theUMin, double theUMax)
	Constructor with transformed curve adaptor and parameter range.
	ExtremaPC_Curve (const occ::handle< Geom_Curve > &theCurve)
	Constructor with Geom_Curve. For non-trimmed curves, does NOT set domain (uses natural/unbounded behavior). For trimmed curves, uses the trimmed bounds as domain.
	ExtremaPC_Curve (const occ::handle< Geom_Curve > &theCurve, double theUMin, double theUMax)
	Constructor with Geom_Curve and parameter range. For trimmed curves, intersects input bounds with trimmed bounds.
	ExtremaPC_Curve (const ExtremaPC_Curve &)=delete
ExtremaPC_Curve &	operator= (const ExtremaPC_Curve &)=delete
	ExtremaPC_Curve (ExtremaPC_Curve &&)=delete
ExtremaPC_Curve &	operator= (ExtremaPC_Curve &&)=delete
const ExtremaPC::Result &	Perform (const gp_Pnt &theP, double theTol, ExtremaPC::SearchMode theMode=ExtremaPC::SearchMode::MinMax) const
	Computes extrema between point P and the curve. Uses domain specified at construction time.
const ExtremaPC::Result &	PerformWithEndpoints (const gp_Pnt &theP, double theTol, ExtremaPC::SearchMode theMode=ExtremaPC::SearchMode::MinMax) const
	Computes extrema between point P and the curve, including endpoints. Uses domain specified at construction time.
bool	IsInitialized () const
	Returns true if the evaluator is properly initialized.

Detailed Description

Main aggregator for Point-Curve extrema computation.

Provides a unified interface for computing extrema between a 3D point and any type of curve. Uses std::variant with std::visit for efficient curve type dispatch at runtime.

Supports all elementary curve types (analytical solutions):

• Line, Circle, Ellipse, Hyperbola, Parabola

And numerical curves (grid-based with Newton refinement):

• BSpline, Bezier, Offset, and general curves

Note

The parameter domain is fixed at construction time for optimal performance. The inner curve evaluators build their grids eagerly in the constructor, so multiple Perform() calls reuse the pre-built data without rebuilding.

Usage example:

ExtremaPC_Curve anExtPC(myAdaptorCurve);
const ExtremaPC::Result& aResult = anExtPC.Perform(myPoint, 1.0e-9);
if (aResult.IsDone())
{
  for (int i = 0; i < aResult.NbExt(); ++i)
  {
    double aDist = std::sqrt(aResult[i].SquareDistance);
    gp_Pnt aPtOnCurve = aResult[i].Point;
  }
}

Member Typedef Documentation

EvaluatorVariant

using ExtremaPC_Curve::EvaluatorVariant

Initial value:

 std::variant<std::monostate,
                                        ExtremaPC_Line,
                                        ExtremaPC_Circle,
                                        ExtremaPC_Ellipse,
                                        ExtremaPC_Hyperbola,
                                        ExtremaPC_Parabola,
                                        ExtremaPC_BezierCurve,
                                        ExtremaPC_BSplineCurve,
                                        ExtremaPC_OffsetCurve,
                                        ExtremaPC_OtherCurve>

Variant type holding all specialized evaluators.

Constructor & Destructor Documentation

ExtremaPC_Curve() [1/8]

ExtremaPC_Curve::ExtremaPC_Curve ( const GeomAdaptor_Curve & theCurve )

explicit

Constructor with curve adaptor. Uses the curve's natural parameter bounds as domain.

Parameters

[in]

theCurve

curve adaptor

ExtremaPC_Curve() [2/8]

ExtremaPC_Curve::ExtremaPC_Curve	(	const GeomAdaptor_Curve &	theCurve,
		double	theUMin,
		double	theUMax )

Constructor with curve adaptor and parameter range.

Parameters

[in]	theCurve	curve adaptor
[in]	theUMin	lower parameter bound
[in]	theUMax	upper parameter bound

ExtremaPC_Curve() [3/8]

ExtremaPC_Curve::ExtremaPC_Curve ( const GeomAdaptor_TransformedCurve & theCurve )

explicit

Constructor with transformed curve adaptor. Uses the curve's natural parameter bounds as domain. For elementary curves, uses already-transformed primitives (analytical solver). For BSpline/Bezier, uses inverse-transform optimization with post-processing. For offset/other curves, delegates through Adaptor3d_Curve interface.

Parameters

[in]

theCurve

transformed curve adaptor

ExtremaPC_Curve() [4/8]

ExtremaPC_Curve::ExtremaPC_Curve	(	const GeomAdaptor_TransformedCurve &	theCurve,
		double	theUMin,
		double	theUMax )

Constructor with transformed curve adaptor and parameter range.

Parameters

[in]	theCurve	transformed curve adaptor
[in]	theUMin	lower parameter bound
[in]	theUMax	upper parameter bound

ExtremaPC_Curve() [5/8]

ExtremaPC_Curve::ExtremaPC_Curve ( const occ::handle< Geom_Curve > & theCurve )

explicit

Constructor with Geom_Curve. For non-trimmed curves, does NOT set domain (uses natural/unbounded behavior). For trimmed curves, uses the trimmed bounds as domain.

Parameters

[in]

theCurve

geometric curve handle

ExtremaPC_Curve() [6/8]

ExtremaPC_Curve::ExtremaPC_Curve	(	const occ::handle< Geom_Curve > &	theCurve,
		double	theUMin,
		double	theUMax )

Constructor with Geom_Curve and parameter range. For trimmed curves, intersects input bounds with trimmed bounds.

Parameters

[in]	theCurve	geometric curve handle
[in]	theUMin	lower parameter bound
[in]	theUMax	upper parameter bound

ExtremaPC_Curve() [7/8]

ExtremaPC_Curve::ExtremaPC_Curve ( const ExtremaPC_Curve & )

delete

ExtremaPC_Curve() [8/8]

ExtremaPC_Curve::ExtremaPC_Curve ( ExtremaPC_Curve && )

delete

Member Function Documentation

IsInitialized()

bool ExtremaPC_Curve::IsInitialized ( ) const

inline

Returns true if the evaluator is properly initialized.

operator=() [1/2]

ExtremaPC_Curve & ExtremaPC_Curve::operator= ( const ExtremaPC_Curve & )

delete

operator=() [2/2]

ExtremaPC_Curve & ExtremaPC_Curve::operator= ( ExtremaPC_Curve && )

delete

Perform()

const ExtremaPC::Result & ExtremaPC_Curve::Perform	(	const gp_Pnt &	theP,
		double	theTol,
		ExtremaPC::SearchMode	theMode = ExtremaPC::SearchMode::MinMax ) const

Computes extrema between point P and the curve. Uses domain specified at construction time.

Parameters

[in]	theP	query point
[in]	theTol	tolerance for extrema computation
[in]	theMode	search mode (MinMax, Min, or Max)

Returns

const reference to result containing all found extrema

PerformWithEndpoints()

const ExtremaPC::Result & ExtremaPC_Curve::PerformWithEndpoints	(	const gp_Pnt &	theP,
		double	theTol,
		ExtremaPC::SearchMode	theMode = ExtremaPC::SearchMode::MinMax ) const

Computes extrema between point P and the curve, including endpoints. Uses domain specified at construction time.

Parameters

[in]	theP	query point
[in]	theTol	tolerance for extrema computation
[in]	theMode	search mode (MinMax, Min, or Max)

Returns

const reference to result containing interior + endpoint extrema

---

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

• ExtremaPC_Curve.hxx