This class implements the algorithms used to
create 2d circles TANgent to 2 entities and
having the center ON a curve.
The order of the tangency argument is always
QualifiedCirc, QualifiedLin, QualifiedCurv, Pnt2d.
the arguments are :
More...

#include <Geom2dGcc_Circ2d2TanOn.hxx>

Public Member Functions
	Geom2dGcc_Circ2d2TanOn (const Geom2dGcc_QualifiedCurve &Qualified1, const Geom2dGcc_QualifiedCurve &Qualified2, const Geom2dAdaptor_Curve &OnCurve, const Standard_Real Tolerance, const Standard_Real Param1, const Standard_Real Param2, const Standard_Real ParamOn)
	This method implements the algorithms used to create 2d circles TANgent to two curves and having the center ON a 2d curve. Param1 is the initial guess on the first curve QualifiedCurv. Param1 is the initial guess on the second curve QualifiedCurv. ParamOn is the initial guess on the center curve OnCurv. Tolerance is used for the limit cases. More...

	Geom2dGcc_Circ2d2TanOn (const Geom2dGcc_QualifiedCurve &Qualified1, const Handle< Geom2d_Point > &Point, const Geom2dAdaptor_Curve &OnCurve, const Standard_Real Tolerance, const Standard_Real Param1, const Standard_Real ParamOn)
	This method implements the algorithms used to create 2d circles TANgent to one curve and one point and having the center ON a 2d curve. Param1 is the initial guess on the first curve QualifiedCurv. ParamOn is the initial guess on the center curve OnCurv. Tolerance is used for the limit cases. More...

	Geom2dGcc_Circ2d2TanOn (const Handle< Geom2d_Point > &Point1, const Handle< Geom2d_Point > &Point2, const Geom2dAdaptor_Curve &OnCurve, const Standard_Real Tolerance)
	This method implements the algorithms used to create 2d circles TANgent to two points and having the center ON a 2d curve. Tolerance is used for the limit cases. More...

void	Results (const GccAna_Circ2d2TanOn &Circ)

void	Results (const Geom2dGcc_MyCirc2d2TanOn &Circ)

Standard_Boolean	IsDone () const
	Returns true if the construction algorithm does not fail (even if it finds no solution). Note: IsDone protects against a failure arising from a more internal intersection algorithm, which has reached its numeric limits. More...

Standard_Integer	NbSolutions () const
	This method returns the number of solutions. NotDone is raised if the algorithm failed. More...

gp_Circ2d	ThisSolution (const Standard_Integer Index) const
	Returns the solution number Index and raises OutOfRange <br> exception if Index is greater than the number of solutions. Be carefull: the Index is only a way to get all the solutions, but is not associated to theses outside the context of the algorithm-object. Exceptions Standard_OutOfRange if Index is less than or equal to zero or greater than the number of solutions computed by this algorithm. StdFail_NotDone if the construction fails. More...

void	WhichQualifier (const Standard_Integer Index, GccEnt_Position &Qualif1, GccEnt_Position &Qualif2) const
	It returns the informations about the qualifiers of <br> the tangency <br> arguments concerning the solution number Index. <br> It returns the real qualifiers (the qualifiers given to the <br> constructor method in case of enclosed, enclosing and outside <br> and the qualifiers computedin case of unqualified). <br> Exceptions Standard_OutOfRange if Index is less than zero or greater than the number of solutions computed by this algorithm. StdFail_NotDone if the construction fails. More...

void	Tangency1 (const Standard_Integer Index, Standard_Real &ParSol, Standard_Real &ParArg, gp_Pnt2d &PntSol) const
	Returns informations about the tangency point between the <br> result and the first argument. ParSol is the intrinsic parameter of the point PntSol on the solution curv. ParArg is the intrinsic parameter of the point PntSol on the argument curv. More...

void	Tangency2 (const Standard_Integer Index, Standard_Real &ParSol, Standard_Real &ParArg, gp_Pnt2d &PntSol) const
	Returns informations about the tangency point between the <br> result and the second argument. ParSol is the intrinsic parameter of the point PntSol on the solution curv. ParArg is the intrinsic parameter of the point PntSol on the argument curv. More...

void	CenterOn3 (const Standard_Integer Index, Standard_Real &ParArg, gp_Pnt2d &PntSol) const
	Returns the center PntSol of the solution of index Index <br> computed by this algorithm. ParArg is the parameter of the point PntSol on the third argument. Exceptions Standard_OutOfRange if Index is less than zero or greater than the number of solutions computed by this algorithm. StdFail_NotDone if the construction fails. More...

Standard_Boolean	IsTheSame1 (const Standard_Integer Index) const
	Returns true if the solution of index Index and, <br> respectively, the first or second argument of this algorithm are the same (i.e. there are 2 identical circles). If Rarg is the radius of the first or second argument, Rsol is the radius of the solution and dist is the distance between the two centers, we consider the two circles to be identical if \|Rarg - Rsol\| and dist are less than or equal to the tolerance criterion given at the time of construction of this algorithm. Exceptions Standard_OutOfRange if Index is less than zero or greater than the number of solutions computed by this algorithm. StdFail_NotDone if the construction fails. More...

Standard_Boolean	IsTheSame2 (const Standard_Integer Index) const
	Returns true if the solution of index Index and, <br> respectively, the first or second argument of this algorithm are the same (i.e. there are 2 identical circles). If Rarg is the radius of the first or second argument, Rsol is the radius of the solution and dist is the distance between the two centers, we consider the two circles to be identical if \|Rarg - Rsol\| and dist are less than or equal to the tolerance criterion given at the time of construction of this algorithm. Exceptions Standard_OutOfRange if Index is less than zero or greater than the number of solutions computed by this algorithm. StdFail_NotDone if the construction fails. More...

Detailed Description

This class implements the algorithms used to
create 2d circles TANgent to 2 entities and
having the center ON a curve.
The order of the tangency argument is always
QualifiedCirc, QualifiedLin, QualifiedCurv, Pnt2d.
the arguments are :

The two tangency arguments.
The center line.
The parameter for each tangency argument which
is a curve.
The tolerance.

Constructor & Destructor Documentation

Geom2dGcc_Circ2d2TanOn::Geom2dGcc_Circ2d2TanOn	(	const Geom2dGcc_QualifiedCurve &	Qualified1,
		const Geom2dGcc_QualifiedCurve &	Qualified2,
		const Geom2dAdaptor_Curve &	OnCurve,
		const Standard_Real	Tolerance,
		const Standard_Real	Param1,
		const Standard_Real	Param2,
		const Standard_Real	ParamOn
	)

This method implements the algorithms used to
create 2d circles TANgent to two curves and
having the center ON a 2d curve.
Param1 is the initial guess on the first curve QualifiedCurv.
Param1 is the initial guess on the second curve QualifiedCurv.
ParamOn is the initial guess on the center curve OnCurv.
Tolerance is used for the limit cases.

Geom2dGcc_Circ2d2TanOn::Geom2dGcc_Circ2d2TanOn	(	const Geom2dGcc_QualifiedCurve &	Qualified1,
		const Handle< Geom2d_Point > &	Point,
		const Geom2dAdaptor_Curve &	OnCurve,
		const Standard_Real	Tolerance,
		const Standard_Real	Param1,
		const Standard_Real	ParamOn
	)

This method implements the algorithms used to
create 2d circles TANgent to one curve and one point and
having the center ON a 2d curve.
Param1 is the initial guess on the first curve QualifiedCurv.
ParamOn is the initial guess on the center curve OnCurv.
Tolerance is used for the limit cases.

Geom2dGcc_Circ2d2TanOn::Geom2dGcc_Circ2d2TanOn	(	const Handle< Geom2d_Point > &	Point1,
		const Handle< Geom2d_Point > &	Point2,
		const Geom2dAdaptor_Curve &	OnCurve,
		const Standard_Real	Tolerance
	)

This method implements the algorithms used to
create 2d circles TANgent to two points and
having the center ON a 2d curve.
Tolerance is used for the limit cases.

Member Function Documentation

void Geom2dGcc_Circ2d2TanOn::CenterOn3	(	const Standard_Integer	Index,
		Standard_Real &	ParArg,
		gp_Pnt2d &	PntSol
	)		const

 Returns the center PntSol of the solution of index Index <br>

computed by this algorithm.
ParArg is the parameter of the point PntSol on the third argument.
Exceptions
Standard_OutOfRange if Index is less than zero or
greater than the number of solutions computed by this algorithm.
StdFail_NotDone if the construction fails.

Standard_Boolean Geom2dGcc_Circ2d2TanOn::IsDone ( ) const

Returns true if the construction algorithm does not fail
(even if it finds no solution).
Note: IsDone protects against a failure arising from a
more internal intersection algorithm, which has
reached its numeric limits.

Standard_Boolean Geom2dGcc_Circ2d2TanOn::IsTheSame1 ( const Standard_Integer Index ) const

 Returns true if the solution of index Index and, <br>

respectively, the first or second argument of this
algorithm are the same (i.e. there are 2 identical circles).
If Rarg is the radius of the first or second argument,
Rsol is the radius of the solution and dist is the
distance between the two centers, we consider the two
circles to be identical if |Rarg - Rsol| and dist
are less than or equal to the tolerance criterion given at
the time of construction of this algorithm.
Exceptions
Standard_OutOfRange if Index is less than zero or
greater than the number of solutions computed by this algorithm.
StdFail_NotDone if the construction fails.

Standard_Boolean Geom2dGcc_Circ2d2TanOn::IsTheSame2 ( const Standard_Integer Index ) const

 Returns true if the solution of index Index and, <br>

respectively, the first or second argument of this
algorithm are the same (i.e. there are 2 identical circles).
If Rarg is the radius of the first or second argument,
Rsol is the radius of the solution and dist is the
distance between the two centers, we consider the two
circles to be identical if |Rarg - Rsol| and dist
are less than or equal to the tolerance criterion given at
the time of construction of this algorithm.
Exceptions
Standard_OutOfRange if Index is less than zero or
greater than the number of solutions computed by this algorithm.
StdFail_NotDone if the construction fails.

Standard_Integer Geom2dGcc_Circ2d2TanOn::NbSolutions ( ) const

This method returns the number of solutions.
NotDone is raised if the algorithm failed.

void Geom2dGcc_Circ2d2TanOn::Results ( const GccAna_Circ2d2TanOn & Circ )

void Geom2dGcc_Circ2d2TanOn::Results ( const Geom2dGcc_MyCirc2d2TanOn & Circ )

void Geom2dGcc_Circ2d2TanOn::Tangency1	(	const Standard_Integer	Index,
		Standard_Real &	ParSol,
		Standard_Real &	ParArg,
		gp_Pnt2d &	PntSol
	)		const

 Returns informations about the tangency point between the <br>

result and the first argument.
ParSol is the intrinsic parameter of the point PntSol on the solution curv.
ParArg is the intrinsic parameter of the point PntSol on the argument curv.

void Geom2dGcc_Circ2d2TanOn::Tangency2	(	const Standard_Integer	Index,
		Standard_Real &	ParSol,
		Standard_Real &	ParArg,
		gp_Pnt2d &	PntSol
	)		const

 Returns informations about the tangency point between the <br>

result and the second argument.
ParSol is the intrinsic parameter of the point PntSol on the solution curv.
ParArg is the intrinsic parameter of the point PntSol on the argument curv.

gp_Circ2d Geom2dGcc_Circ2d2TanOn::ThisSolution ( const Standard_Integer Index ) const

 Returns the solution number Index and raises OutOfRange <br>

exception if Index is greater than the number of solutions.
Be carefull: the Index is only a way to get all the
solutions, but is not associated to theses outside the context
of the algorithm-object.
Exceptions
Standard_OutOfRange if Index is less than or equal
to zero or greater than the number of solutions
computed by this algorithm.
StdFail_NotDone if the construction fails.

void Geom2dGcc_Circ2d2TanOn::WhichQualifier	(	const Standard_Integer	Index,
		GccEnt_Position &	Qualif1,
		GccEnt_Position &	Qualif2
	)		const

 It returns the informations about the qualifiers of <br>
     the tangency <br>
     arguments concerning the solution number Index. <br>
     It returns the real qualifiers (the qualifiers given to the <br>
     constructor method in case of enclosed, enclosing and outside <br>
     and the qualifiers computedin case of unqualified). <br>

Exceptions
Standard_OutOfRange if Index is less than zero or
greater than the number of solutions computed by this algorithm.
StdFail_NotDone if the construction fails.

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

Geom2dGcc_Circ2d2TanOn.hxx

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation