Generic class for computing extremal distances between a point and a curve. More...

#include <Extrema_GGExtPC.hxx>

Public Member Functions
	Extrema_GGExtPC ()
	Default constructor.

	Extrema_GGExtPC (const ThePoint &theP, const TheCurve &theC, const double theUinf, const double theUsup, const double theTolF=1.0e-10)
	Calculates all extremum distances between point P and curve C within the specified parameter range.

	Extrema_GGExtPC (const ThePoint &theP, const TheCurve &theC, const double theTolF=1.0e-10)
	Calculates all extremum distances between point P and curve C using the full curve parameter range.

void	Initialize (const TheCurve &theC, const double theUinf, const double theUsup, const double theTolF=1.0e-10)
	Initializes the algorithm with curve and parameter range.

void	Perform (const ThePoint &theP)
	Performs the extremum computation for the given point.

bool	IsDone () const
	Returns true if the distances are found.

double	SquareDistance (const int theN) const
	Returns the Nth extremum square distance.

int	NbExt () const
	Returns the number of extremum distances.

bool	IsMin (const int theN) const
	Returns true if the Nth extremum distance is a minimum.

const ThePOnC &	Point (const int theN) const
	Returns the point of the Nth extremum distance.

void	TrimmedSquareDistances (double &theDist1, double &theDist2, ThePoint &theP1, ThePoint &theP2) const
	Returns the distances at curve endpoints.

Protected Member Functions
void	IntervalPerform (const ThePoint &theP)
	Performs extremum search on the current interval.

void	AddSol (const double theU, const ThePoint &theP, const double theSqDist, const bool isMin)
	Adds a solution if not already present.

Detailed Description

template<typename TheCurve, typename TheCurveTool, typename TheExtPElC, typename ThePoint, typename TheVector, typename ThePOnC, typename TheSequenceOfPOnC, typename TheEPC>
class Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >

Generic class for computing extremal distances between a point and a curve.

This template class provides comprehensive extremum search functionality, handling different curve types (lines, circles, ellipses, parabolas, hyperbolas, Bezier, BSpline, and general curves) with optimized algorithms.

Template Parameters

TheCurve	The curve type (e.g., Adaptor3d_Curve, Adaptor2d_Curve2d)
TheCurveTool	The curve tool providing static methods
TheExtPElC	The elementary curve extremum class
ThePoint	The point type (e.g., gp_Pnt, gp_Pnt2d)
TheVector	The vector type (e.g., gp_Vec, gp_Vec2d)
ThePOnC	The point-on-curve type
TheSequenceOfPOnC	The sequence of points on curve
TheEPC	The general extremum point-curve class

Constructor & Destructor Documentation

◆ Extrema_GGExtPC() [1/3]

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::Extrema_GGExtPC ( )

inline

Default constructor.

◆ Extrema_GGExtPC() [2/3]

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::Extrema_GGExtPC	(	const ThePoint &	theP,
		const TheCurve &	theC,
		const double	theUinf,
		const double	theUsup,
		const double	theTolF = 1.0e-10 )

inline

Calculates all extremum distances between point P and curve C within the specified parameter range.

Parameters

theP	The point
theC	The curve
theUinf	Lower bound of parameter range
theUsup	Upper bound of parameter range
theTolF	Tolerance on function value (default 1.0e-10)

◆ Extrema_GGExtPC() [3/3]

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::Extrema_GGExtPC	(	const ThePoint &	theP,
		const TheCurve &	theC,
		const double	theTolF = 1.0e-10 )

inline

Calculates all extremum distances between point P and curve C using the full curve parameter range.

Parameters

theP	The point
theC	The curve
theTolF	Tolerance on function value (default 1.0e-10)

Member Function Documentation

◆ AddSol()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

void Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::AddSol	(	const double	theU,
		const ThePoint &	theP,
		const double	theSqDist,
		const bool	isMin )

inlineprotected

Adds a solution if not already present.

◆ Initialize()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

void Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::Initialize	(	const TheCurve &	theC,
		const double	theUinf,
		const double	theUsup,
		const double	theTolF = 1.0e-10 )

inline

Initializes the algorithm with curve and parameter range.

Parameters

theC	The curve
theUinf	Lower bound of parameter range
theUsup	Upper bound of parameter range
theTolF	Tolerance on function value (default 1.0e-10)

◆ IntervalPerform()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

void Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::IntervalPerform ( const ThePoint & theP )

inlineprotected

Performs extremum search on the current interval.

◆ IsDone()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

bool Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::IsDone ( ) const

inline

Returns true if the distances are found.

◆ IsMin()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

bool Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::IsMin ( const int theN ) const

inline

Returns true if the Nth extremum distance is a minimum.

Parameters

theN	Index of the extremum (1-based)

Returns: true if minimum, false if maximum

◆ NbExt()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

int Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::NbExt ( ) const

inline

Returns the number of extremum distances.

Returns: Number of extrema found

◆ Perform()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

void Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::Perform ( const ThePoint & theP )

inline

Performs the extremum computation for the given point.

Parameters

theP	The point to find extrema from

◆ Point()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

const ThePOnC & Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::Point ( const int theN ) const

inline

Returns the point of the Nth extremum distance.

Parameters

theN	Index of the extremum (1-based)

Returns: The point on curve

◆ SquareDistance()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

double Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::SquareDistance ( const int theN ) const

inline

Returns the Nth extremum square distance.

Parameters

theN	Index of the extremum (1-based)

Returns: Square distance value

◆ TrimmedSquareDistances()

template<typename TheCurve , typename TheCurveTool , typename TheExtPElC , typename ThePoint , typename TheVector , typename ThePOnC , typename TheSequenceOfPOnC , typename TheEPC >

void Extrema_GGExtPC< TheCurve, TheCurveTool, TheExtPElC, ThePoint, TheVector, ThePOnC, TheSequenceOfPOnC, TheEPC >::TrimmedSquareDistances	(	double &	theDist1,
		double &	theDist2,
		ThePoint &	theP1,
		ThePoint &	theP2 ) const

inline

Returns the distances at curve endpoints.

Parameters

[out]	theDist1	Square distance to first point
[out]	theDist2	Square distance to last point
[out]	theP1	First point on curve
[out]	theP2	Last point on curve

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

Extrema_GGExtPC.hxx

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Extrema_GGExtPC() [1/3]

◆ Extrema_GGExtPC() [2/3]

◆ Extrema_GGExtPC() [3/3]

Member Function Documentation

◆ AddSol()

◆ Initialize()

◆ IntervalPerform()

◆ IsDone()

◆ IsMin()

◆ NbExt()

◆ Perform()

◆ Point()

◆ SquareDistance()

◆ TrimmedSquareDistances()