Deferred class for a function used to compute a blending surface between two surfaces, using a guide line. The vector <X> used in Value, Values and Derivatives methods has to be the vector of the parametric coordinates U1,V1, U2,V2, of the extremities of a section on the first and second surface. More...

#include <Blend_Function.hxx>

Inheritance diagram for Blend_Function:

[legend]

Public Member Functions
Standard_Integer	NbVariables () const override
	Returns 4.

const gp_Pnt &	Pnt1 () const override
	Returns the point on the first support.

const gp_Pnt &	Pnt2 () const override
	Returns the point on the seconde support.

virtual const gp_Pnt &	PointOnS1 () const =0
	Returns the point on the first surface, at parameter Sol(1),Sol(2) (Sol is the vector used in the call of IsSolution.

virtual const gp_Pnt &	PointOnS2 () const =0
	Returns the point on the second surface, at parameter Sol(3),Sol(4) (Sol is the vector used in the call of IsSolution.

virtual Standard_Boolean	IsTangencyPoint () const =0
	Returns True when it is not possible to compute the tangent vectors at PointOnS1 and/or PointOnS2.

virtual const gp_Vec &	TangentOnS1 () const =0
	Returns the tangent vector at PointOnS1, in 3d space.

virtual const gp_Vec2d &	Tangent2dOnS1 () const =0
	Returns the tangent vector at PointOnS1, in the parametric space of the first surface.

virtual const gp_Vec &	TangentOnS2 () const =0
	Returns the tangent vector at PointOnS2, in 3d space.

virtual const gp_Vec2d &	Tangent2dOnS2 () const =0
	Returns the tangent vector at PointOnS2, in the parametric space of the second surface.

virtual void	Tangent (const Standard_Real U1, const Standard_Real V1, const Standard_Real U2, const Standard_Real V2, gp_Vec &TgFirst, gp_Vec &TgLast, gp_Vec &NormFirst, gp_Vec &NormLast) const =0
	Returns the tangent vector at the section, at the beginning and the end of the section, and returns the normal (of the surfaces) at these points.

virtual Standard_Boolean	TwistOnS1 () const

virtual Standard_Boolean	TwistOnS2 () const

virtual void	Section (const Blend_Point &P, TColgp_Array1OfPnt &Poles, TColgp_Array1OfPnt2d &Poles2d, TColStd_Array1OfReal &Weigths) override=0

virtual Standard_Boolean	Section (const Blend_Point &P, TColgp_Array1OfPnt &Poles, TColgp_Array1OfVec &DPoles, TColgp_Array1OfVec &D2Poles, TColgp_Array1OfPnt2d &Poles2d, TColgp_Array1OfVec2d &DPoles2d, TColgp_Array1OfVec2d &D2Poles2d, TColStd_Array1OfReal &Weigths, TColStd_Array1OfReal &DWeigths, TColStd_Array1OfReal &D2Weigths) override
	Used for the first and last section The method returns Standard_True if the derivatives are computed, otherwise it returns Standard_False.

Public Member Functions inherited from Blend_AppFunction
virtual Standard_Integer	NbEquations () const =0
	returns the number of equations of the function.

virtual Standard_Boolean	Value (const math_Vector &X, math_Vector &F)=0
	computes the values <F> of the Functions for the variable <X>. Returns True if the computation was done successfully, False otherwise.

virtual Standard_Boolean	Derivatives (const math_Vector &X, math_Matrix &D)=0
	returns the values <D> of the derivatives for the variable <X>. Returns True if the computation was done successfully, False otherwise.

virtual Standard_Boolean	Values (const math_Vector &X, math_Vector &F, math_Matrix &D)=0
	returns the values <F> of the functions and the derivatives <D> for the variable <X>. Returns True if the computation was done successfully, False otherwise.

virtual void	Set (const Standard_Real Param)=0
	Sets the value of the parameter along the guide line. This determines the plane in which the solution has to be found.

virtual void	Set (const Standard_Real First, const Standard_Real Last)=0
	Sets the bounds of the parametric interval on the guide line. This determines the derivatives in these values if the function is not Cn.

virtual void	GetTolerance (math_Vector &Tolerance, const Standard_Real Tol) const =0
	Returns in the vector Tolerance the parametric tolerance for each of the 4 variables; Tol is the tolerance used in 3d space.

virtual void	GetBounds (math_Vector &InfBound, math_Vector &SupBound) const =0
	Returns in the vector InfBound the lowest values allowed for each of the 4 variables. Returns in the vector SupBound the greatest values allowed for each of the 4 variables.

virtual Standard_Boolean	IsSolution (const math_Vector &Sol, const Standard_Real Tol)=0
	Returns Standard_True if Sol is a zero of the function. Tol is the tolerance used in 3d space. The computation is made at the current value of the parameter on the guide line.

virtual Standard_Real	GetMinimalDistance () const =0
	Returns the minimal Distance between two extremities of calculated sections.

virtual Standard_Boolean	IsRational () const =0
	Returns if the section is rational.

virtual Standard_Real	GetSectionSize () const =0
	Returns the length of the maximum section.

virtual void	GetMinimalWeight (TColStd_Array1OfReal &Weigths) const =0
	Compute the minimal value of weight for each poles of all sections.

virtual Standard_Integer	NbIntervals (const GeomAbs_Shape S) const =0
	Returns the number of intervals for continuity ~~. May be one if Continuity(me) >=~~

virtual void	Intervals (TColStd_Array1OfReal &T, const GeomAbs_Shape S) const =0
	Stores in <T> the parameters bounding the intervals of continuity .

virtual void	GetShape (Standard_Integer &NbPoles, Standard_Integer &NbKnots, Standard_Integer &Degree, Standard_Integer &NbPoles2d)=0

virtual void	GetTolerance (const Standard_Real BoundTol, const Standard_Real SurfTol, const Standard_Real AngleTol, math_Vector &Tol3d, math_Vector &Tol1D) const =0
	Returns the tolerance to reach in approximation to respect BoundTol error at the Boundary AngleTol tangent error at the Boundary SurfTol error inside the surface.

virtual void	Knots (TColStd_Array1OfReal &TKnots)=0

virtual void	Mults (TColStd_Array1OfInteger &TMults)=0

virtual Standard_Boolean	Section (const Blend_Point &P, TColgp_Array1OfPnt &Poles, TColgp_Array1OfVec &DPoles, TColgp_Array1OfPnt2d &Poles2d, TColgp_Array1OfVec2d &DPoles2d, TColStd_Array1OfReal &Weigths, TColStd_Array1OfReal &DWeigths)=0
	Used for the first and last section The method returns Standard_True if the derivatives are computed, otherwise it returns Standard_False.

virtual void	Resolution (const Standard_Integer IC2d, const Standard_Real Tol, Standard_Real &TolU, Standard_Real &TolV) const =0

Standard_Real	Parameter (const Blend_Point &P) const
	Returns the parameter of the point P. Used to impose the parameters in the approximation.

Public Member Functions inherited from math_FunctionSetWithDerivatives
Public Member Functions inherited from math_FunctionSet
virtual Standard_Integer	GetStateNumber ()
	Returns the state of the function corresponding to the latestcall of any methods associated with the function. This function is called by each of the algorithms described later which define the function Integer Algorithm::StateNumber(). The algorithm has the responsibility to call this function when it has found a solution (i.e. a root or a minimum) and has to maintain the association between the solution found and this StateNumber. Byu default, this method returns 0 (which means for the algorithm: no state has been saved). It is the responsibility of the programmer to decide if he needs to save the current state of the function and to return an Integer that allows retrieval of the state.

virtual	~math_FunctionSet ()

Detailed Description

Deferred class for a function used to compute a blending surface between two surfaces, using a guide line. The vector <X> used in Value, Values and Derivatives methods has to be the vector of the parametric coordinates U1,V1, U2,V2, of the extremities of a section on the first and second surface.

Member Function Documentation

◆ IsTangencyPoint()

virtual Standard_Boolean Blend_Function::IsTangencyPoint ( ) const

pure virtual

Returns True when it is not possible to compute the tangent vectors at PointOnS1 and/or PointOnS2.

Implemented in BlendFunc_Chamfer, BlendFunc_ChAsym, BlendFunc_ConstRad, BlendFunc_ConstThroat, BlendFunc_EvolRad, and BlendFunc_Ruled.

◆ NbVariables()

Standard_Integer Blend_Function::NbVariables ( ) const

overridevirtual

Returns 4.

Implements Blend_AppFunction.

◆ Pnt1()

const gp_Pnt & Blend_Function::Pnt1 ( ) const

overridevirtual

Returns the point on the first support.

Implements Blend_AppFunction.

◆ Pnt2()

const gp_Pnt & Blend_Function::Pnt2 ( ) const

overridevirtual

Returns the point on the seconde support.

Implements Blend_AppFunction.

◆ PointOnS1()

virtual const gp_Pnt & Blend_Function::PointOnS1 ( ) const

pure virtual

Returns the point on the first surface, at parameter Sol(1),Sol(2) (Sol is the vector used in the call of IsSolution.

Implemented in BlendFunc_Chamfer, BlendFunc_ChAsym, BlendFunc_ConstRad, BlendFunc_ConstThroat, BlendFunc_EvolRad, and BlendFunc_Ruled.

◆ PointOnS2()

virtual const gp_Pnt & Blend_Function::PointOnS2 ( ) const

pure virtual

Returns the point on the second surface, at parameter Sol(3),Sol(4) (Sol is the vector used in the call of IsSolution.

Implemented in BlendFunc_Chamfer, BlendFunc_ChAsym, BlendFunc_ConstRad, BlendFunc_ConstThroat, BlendFunc_EvolRad, and BlendFunc_Ruled.

◆ Section() [1/2]

virtual void Blend_Function::Section	(	const Blend_Point &	P,
		TColgp_Array1OfPnt &	Poles,
		TColgp_Array1OfPnt2d &	Poles2d,
		TColStd_Array1OfReal &	Weigths )

overridepure virtual

Implements Blend_AppFunction.

Implemented in BlendFunc_ChAsym, BlendFunc_ConstRad, BlendFunc_EvolRad, BlendFunc_GenChamfer, and BlendFunc_Ruled.

◆ Section() [2/2]

virtual Standard_Boolean Blend_Function::Section	(	const Blend_Point &	P,
		TColgp_Array1OfPnt &	Poles,
		TColgp_Array1OfVec &	DPoles,
		TColgp_Array1OfVec &	D2Poles,
		TColgp_Array1OfPnt2d &	Poles2d,
		TColgp_Array1OfVec2d &	DPoles2d,
		TColgp_Array1OfVec2d &	D2Poles2d,
		TColStd_Array1OfReal &	Weigths,
		TColStd_Array1OfReal &	DWeigths,
		TColStd_Array1OfReal &	D2Weigths )

overridevirtual

Used for the first and last section The method returns Standard_True if the derivatives are computed, otherwise it returns Standard_False.

Implements Blend_AppFunction.

Reimplemented in BlendFunc_ChAsym, BlendFunc_ConstRad, BlendFunc_EvolRad, BlendFunc_GenChamfer, and BlendFunc_Ruled.

◆ Tangent()

virtual void Blend_Function::Tangent	(	const Standard_Real	U1,
		const Standard_Real	V1,
		const Standard_Real	U2,
		const Standard_Real	V2,
		gp_Vec &	TgFirst,
		gp_Vec &	TgLast,
		gp_Vec &	NormFirst,
		gp_Vec &	NormLast ) const