GC_MakeConicalSurface Class Reference

Implements construction algorithms for conical surfaces. Supported constructions include: More...

#include <GC_MakeConicalSurface.hxx>

Inheritance diagram for GC_MakeConicalSurface:

Public Member Functions
	GC_MakeConicalSurface (const gp_Ax2 &theA2, const double theAng, const double theRadius)
	Creates a conical surface from local frame, semi-angle and radius.
	GC_MakeConicalSurface (const gp_Cone &theC)
	Creates a conical surface from a gp_Cone.
	GC_MakeConicalSurface (const gp_Pnt &theP1, const gp_Pnt &theP2, const gp_Pnt &theP3, const gp_Pnt &theP4)
	Creates a conical surface from four points.
	GC_MakeConicalSurface (const gp_Pnt &theP1, const gp_Pnt &theP2, const double theR1, const double theR2)
	Creates a conical surface with two points and two radii.
const occ::handle< Geom_ConicalSurface > &	Value () const
	Returns the constructed cone. Exceptions StdFail_NotDone if no cone is constructed.
	operator const occ::handle< Geom_ConicalSurface > & () const
	Conversion operator returning the constructed object.
Public Member Functions inherited from GC_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 GC_Root
gce_ErrorType	TheError

Detailed Description

Implements construction algorithms for conical surfaces. Supported constructions include:

• a conical surface from axis placement and angle/radius;
• conversion from gp_Cone;
• a conical surface through four points;
• a conical surface from two points and two radii. The local coordinate system of the ConicalSurface is defined with an axis placement (see class ElementarySurface).

The "ZAxis" is the symmetry axis of the ConicalSurface, it gives the direction of increasing parametric value V. The apex of the surface is on the negative side of this axis.

The parametrization range is: U [0, 2*PI], V ]-infinite, + infinite[

The "XAxis" and the "YAxis" define the placement plane of the surface (Z = 0, and parametric value V = 0) perpendicular to the symmetry axis. The "XAxis" defines the origin of the parameter U = 0. The trigonometric sense gives the positive orientation for the parameter U.

When you create a ConicalSurface the U and V directions of parametrization are such that at each point of the surface the normal is oriented towards the "outside region".

Constructor & Destructor Documentation

GC_MakeConicalSurface() [1/4]

GC_MakeConicalSurface::GC_MakeConicalSurface	(	const gp_Ax2 &	theA2,
		const double	theAng,
		const double	theRadius )

Creates a conical surface from local frame, semi-angle and radius.

Parameters

[in]	theA2	local coordinate system
[in]	theAng	semi-angle
[in]	theRadius	reference radius in placement plane

Note

theA2 defines the local coordinate system of the conical surface.

theAng is the conical surface semi-angle ]0, PI/2[.

theRadius is the radius of the circle Viso in the placement plane of the conical surface defined with "XAxis" and "YAxis".

The "ZDirection" of theA2 defines the direction of the surface axis of symmetry.

If the location point of theA2 is the apex of the surface, theRadius is zero.

The created surface is parametrized such that the normal vector (N = D1U ^ D1V) is oriented towards the "outside region".

Status is gce_NegativeRadius if theRadius < 0.0, or gce_BadAngle if theAng is outside valid range.

GC_MakeConicalSurface() [2/4]

GC_MakeConicalSurface::GC_MakeConicalSurface

(

const gp_Cone &

theC

)

Creates a conical surface from a gp_Cone.

Parameters

[in]

theC

source cone

GC_MakeConicalSurface() [3/4]

GC_MakeConicalSurface::GC_MakeConicalSurface	(	const gp_Pnt &	theP1,
		const gp_Pnt &	theP2,
		const gp_Pnt &	theP3,
		const gp_Pnt &	theP4 )

Creates a conical surface from four points.

Parameters

[in]	theP1	first point defining axis
[in]	theP2	second point defining axis
[in]	theP3	point defining first section radius
[in]	theP4	point defining second section radius

Note

Axis is defined by points theP1 and theP2, and base radius is the distance between point theP3 and that axis.

The distance between point theP4 and that axis is the radius of the section passing through P4.

Construction fails if points theP1, theP2, theP3 and theP4 are collinear, or if vector (theP3,theP4) is perpendicular/collinear to vector (theP1,theP2).

GC_MakeConicalSurface() [4/4]

GC_MakeConicalSurface::GC_MakeConicalSurface	(	const gp_Pnt &	theP1,
		const gp_Pnt &	theP2,
		const double	theR1,
		const double	theR2 )

Creates a conical surface with two points and two radii.

Parameters

[in]	theP1	first axis point
[in]	theP2	second axis point
[in]	theR1	radius at P1
[in]	theR2	radius at P2

Note

The axis of the solution is the line passing through theP1 and theP2.

theR1 and theR2 are radii of sections passing through theP1 and theP2.

Member Function Documentation

operator const occ::handle< Geom_ConicalSurface > &()

GC_MakeConicalSurface::operator const occ::handle< Geom_ConicalSurface > & ( ) const

inline

Conversion operator returning the constructed object.

Returns

resulting object

Value()

const occ::handle< Geom_ConicalSurface > & GC_MakeConicalSurface::Value

(

)

const

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

Returns

resulting conical surface

---

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

• GC_MakeConicalSurface.hxx