gce_MakeCone Class Reference

This class implements construction algorithms for gp_Cone. Supported constructions include: More...

#include <gce_MakeCone.hxx>

Inheritance diagram for gce_MakeCone:

Public Member Functions
	gce_MakeCone (const gp_Ax2 &A2, const double Ang, const double Radius)
	Creates a cone from axis placement, semi-angle and reference radius.
	gce_MakeCone (const gp_Cone &Cone, const gp_Pnt &Point)
	Creates a cone coaxial to input cone and passing through a point.
	gce_MakeCone (const gp_Cone &Cone, const double Dist)
	Creates a cone coaxial to input cone at signed distance.
	gce_MakeCone (const gp_Pnt &P1, const gp_Pnt &P2, const gp_Pnt &P3, const gp_Pnt &P4)
	Creates a cone from four points.
	gce_MakeCone (const gp_Ax1 &Axis, const gp_Pnt &P1, const gp_Pnt &P2)
	Creates a cone from axis and two points.
	gce_MakeCone (const gp_Lin &Axis, const gp_Pnt &P1, const gp_Pnt &P2)
	Creates a cone from line axis and two points.
	gce_MakeCone (const gp_Pnt &P1, const gp_Pnt &P2, const double R1, const double R2)
	Creates a cone from two axis points and two section radii.
const gp_Cone &	Value () const
	Returns the constructed cone. Exceptions StdFail_NotDone if no cone is constructed.
gp_Cone	Operator () const
	Alias for Value() returning a copy.
	operator gp_Cone () const
	Conversion operator returning the constructed object.
Public Member Functions inherited from gce_Root
bool	IsDone () const
	Returns true if the construction is successful.
bool	IsError () const
	Returns true if the construction has failed.
gce_ErrorType	Status () const
	Returns the status of the construction:

Additional Inherited Members
Protected Attributes inherited from gce_Root
gce_ErrorType	TheError

Detailed Description

This class implements construction algorithms for gp_Cone. Supported constructions include:

• from axis placement, semi-angle and reference radius;
• cone coaxial to another cone, through a point or at signed offset;
• cone from four points;
• cone from axis and two points;
• cone from two axis points and two section radii.

Constructor & Destructor Documentation

gce_MakeCone() [1/7]

gce_MakeCone::gce_MakeCone	(	const gp_Ax2 &	A2,
		const double	Ang,
		const double	Radius )

Creates a cone from axis placement, semi-angle and reference radius.

Note

A2 defines cone position and reference section plane.

Ang is the cone semi-angle (radians), expected in ]0, PI/2[.

Construction fails with gce_NegativeRadius if Radius is negative.

Construction fails with gce_BadAngle if Ang <= gp::Resolution() or PI/2 - Ang <= gp::Resolution().

Parameters

[in]	A2	local coordinate system
[in]	Ang	angle value
[in]	Radius	radius value

gce_MakeCone() [2/7]

gce_MakeCone::gce_MakeCone	(	const gp_Cone &	Cone,
		const gp_Pnt &	Point )

Creates a cone coaxial to input cone and passing through a point.

Note

Construction fails with gce_NegativeRadius when no non-negative solution radius can be found.

Parameters

[in]	Cone	source cone
[in]	Point	reference point

gce_MakeCone() [3/7]

gce_MakeCone::gce_MakeCone	(	const gp_Cone &	Cone,
		const double	Dist )

Creates a cone coaxial to input cone at signed distance.

Note

Construction fails with gce_NullAngle if semi-angle cosine is numerically too small.

Construction fails with gce_NegativeRadius if resulting radius is negative.

Parameters

[in]	Cone	source cone
[in]	Dist	signed distance

gce_MakeCone() [4/7]

gce_MakeCone::gce_MakeCone	(	const gp_Pnt &	P1,
		const gp_Pnt &	P2,
		const gp_Pnt &	P3,
		const gp_Pnt &	P4 )

Creates a cone from four points.

Note

P1 and P2 define the axis direction.

Distance from P3 to that axis defines base radius.

Distance from P4 to that axis defines radius of section through P4.

Construction fails with gce_ConfusedPoints if P1/P2 or P3/P4 are coincident.

Construction fails with gce_NullAngle if section distances produce zero cone angle.

Construction fails with gce_NullRadius for degenerate right-angle or zero-angle radius configuration.

Parameters

[in]	P1	first point
[in]	P2	second point
[in]	P3	third point
[in]	P4	fourth point

gce_MakeCone() [5/7]

gce_MakeCone::gce_MakeCone	(	const gp_Ax1 &	Axis,
		const gp_Pnt &	P1,
		const gp_Pnt &	P2 )

Creates a cone from axis and two points.

Note

Distance from P1 to axis gives first section radius.

Distance from P2 to axis gives second section radius.

Error status is propagated from the 4-point construction.

Parameters

[in]	Axis	axis definition
[in]	P1	first point
[in]	P2	second point

gce_MakeCone() [6/7]

gce_MakeCone::gce_MakeCone	(	const gp_Lin &	Axis,
		const gp_Pnt &	P1,
		const gp_Pnt &	P2 )

Creates a cone from line axis and two points.

Note

Distance from P1 to axis gives first section radius.

Distance from P2 to axis gives second section radius.

Error status is propagated from the 4-point construction.

Parameters

[in]	Axis	axis definition
[in]	P1	first point
[in]	P2	second point

gce_MakeCone() [7/7]

gce_MakeCone::gce_MakeCone	(	const gp_Pnt &	P1,
		const gp_Pnt &	P2,
		const double	R1,
		const double	R2 )

Creates a cone from two axis points and two section radii.

Note

The axis is the line passing through P1 and P2.

R1 is section radius at P1, R2 is section radius at P2.

Construction fails with gce_NullAxis if P1 and P2 are coincident.

Construction fails with gce_NegativeRadius if R1 or R2 is negative.

Construction fails with gce_NullAngle for degenerate zero-angle or right-angle configurations.

Parameters

[in]	P1	first point
[in]	P2	second point
[in]	R1	first radius value
[in]	R2	second radius value

Member Function Documentation

Operator()

gp_Cone gce_MakeCone::Operator ( ) const

inline

Alias for Value() returning a copy.

Returns

resulting object

operator gp_Cone()

gce_MakeCone::operator gp_Cone ( ) const

inline

Conversion operator returning the constructed object.

Returns

resulting object

Value()

const gp_Cone & gce_MakeCone::Value

(

)

const

Returns the constructed cone. Exceptions StdFail_NotDone if no cone is constructed.

Returns

resulting cone

---

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

• gce_MakeCone.hxx