Describes the common behavior of surfaces which
have a simple parametric equation in a local
coordinate system. The Geom package provides
several implementations of concrete elementary surfaces:
More...

#include <Geom_ElementarySurface.hxx>

Inheritance diagram for Geom_ElementarySurface:

[legend]

Public Member Functions
void	SetAxis (const gp_Ax1 &A1)
	Changes the main axis (ZAxis) of the elementary surface. Raised if the direction of A1 is parallel to the XAxis of the coordinate system of the surface. More...

void	SetLocation (const gp_Pnt &Loc)
	Changes the location of the local coordinates system of the surface. More...

void	SetPosition (const gp_Ax3 &A3)
	Changes the local coordinates system of the surface. More...

gp_Ax1	Axis () const
	Returns the main axis of the surface (ZAxis). More...

gp_Pnt	Location () const
	Returns the location point of the local coordinate system of the surface. More...

const gp_Ax3 &	Position () const
	Returns the local coordinates system of the surface. More...

virtual void	UReverse ()
	Reverses the U parametric direction of the surface. More...

virtual Standard_Real	UReversedParameter (const Standard_Real U) const =0
	Return the parameter on the Ureversed surface for <br> the point of parameter U on <me>. <br> me->UReversed()->Value(me->UReversedParameter(U),V) is the same point as me->Value(U,V) More...

virtual void	VReverse ()
	Reverses the V parametric direction of the surface. More...

virtual Standard_Real	VReversedParameter (const Standard_Real V) const =0
	Return the parameter on the Vreversed surface for <br> the point of parameter V on <me>. <br> me->VReversed()->Value(U,me->VReversedParameter(V)) is the same point as me->Value(U,V) More...

GeomAbs_Shape	Continuity () const
	Returns GeomAbs_CN, the global continuity of any elementary surface. More...

Standard_Boolean	IsCNu (const Standard_Integer N) const
	Returns True. More...

Standard_Boolean	IsCNv (const Standard_Integer N) const
	Returns True. More...

Public Member Functions inherited from Geom_Surface
Handle_Geom_Surface	UReversed () const
	Reverses the U direction of parametrization of <me>. The bounds of the surface are not modified. A copy of <me> is returned. More...

Handle_Geom_Surface	VReversed () const
	Reverses the V direction of parametrization of <me>. The bounds of the surface are not modified. A copy of <me> is returned. More...

virtual void	TransformParameters (Standard_Real &U, Standard_Real &V, const gp_Trsf &T) const
	Computes the parameters on the transformed surface for <br> the transform of the point of parameters U,V on <me>. <br> me->Transformed(T)->Value(U',V') is the same point as me->Value(U,V).Transformed(T) Where U',V' are the new values of U,V after calling me->TranformParameters(U,V,T) This methods does not change <U> and <V> It can be redefined. For example on the Plane, Cylinder, Cone, Revolved and Extruded surfaces. More...

virtual gp_GTrsf2d	ParametricTransformation (const gp_Trsf &T) const
	Returns a 2d transformation used to find the new <br> parameters of a point on the transformed surface. <br> me->Transformed(T)->Value(U',V') is the same point as me->Value(U,V).Transformed(T) Where U',V' are obtained by transforming U,V with th 2d transformation returned by me->ParametricTransformation(T) This methods returns an identity transformation It can be redefined. For example on the Plane, Cylinder, Cone, Revolved and Extruded surfaces. More...

virtual void	Bounds (Standard_Real &U1, Standard_Real &U2, Standard_Real &V1, Standard_Real &V2) const =0
	Returns the parametric bounds U1, U2, V1 and V2 of this surface. <br> If the surface is infinite, this function can return a value equal to Precision::Infinite: instead of Standard_Real::LastReal. More...

virtual Standard_Boolean	IsUClosed () const =0
	Checks whether this surface is closed in the u <br> parametric direction. Returns true if, in the u parametric direction: taking uFirst and uLast as the parametric bounds in the u parametric direction, for each parameter v, the distance between the points P(uFirst, v) and P(uLast, v) is less than or equal to gp::Resolution(). More...

virtual Standard_Boolean	IsVClosed () const =0
	Checks whether this surface is closed in the u <br> parametric direction. Returns true if, in the v parametric direction: taking vFirst and vLast as the parametric bounds in the v parametric direction, for each parameter u, the distance between the points P(u, vFirst) and P(u, vLast) is less than or equal to gp::Resolution(). More...

virtual Standard_Boolean	IsUPeriodic () const =0
	Checks if this surface is periodic in the u <br> parametric direction. Returns true if: More...

virtual Standard_Real	UPeriod () const
	Returns the period of this surface in the u <br> parametric direction. //! raises if the surface is not uperiodic. More...

virtual Standard_Boolean	IsVPeriodic () const =0
	Checks if this surface is periodic in the v <br> parametric direction. Returns true if: More...

virtual Standard_Real	VPeriod () const
	Returns the period of this surface in the v parametric direction. //! raises if the surface is not vperiodic. More...

virtual Handle_Geom_Curve	UIso (const Standard_Real U) const =0
	Computes the U isoparametric curve. More...

virtual Handle_Geom_Curve	VIso (const Standard_Real V) const =0
	Computes the V isoparametric curve. More...

virtual void	D0 (const Standard_Real U, const Standard_Real V, gp_Pnt &P) const =0
	Computes the point of parameter U,V on the surface. <br> Raised only for an "OffsetSurface" if it is not possible to compute the current point. More...

virtual void	D1 (const Standard_Real U, const Standard_Real V, gp_Pnt &P, gp_Vec &D1U, gp_Vec &D1V) const =0
	Computes the point P and the first derivatives in the directions U and V at this point. //! Raised if the continuity of the surface is not C1. More...

virtual void	D2 (const Standard_Real U, const Standard_Real V, gp_Pnt &P, gp_Vec &D1U, gp_Vec &D1V, gp_Vec &D2U, gp_Vec &D2V, gp_Vec &D2UV) const =0
	Computes the point P, the first and the second derivatives in the directions U and V at this point. //! Raised if the continuity of the surface is not C2. More...

virtual void	D3 (const Standard_Real U, const Standard_Real V, gp_Pnt &P, gp_Vec &D1U, gp_Vec &D1V, gp_Vec &D2U, gp_Vec &D2V, gp_Vec &D2UV, gp_Vec &D3U, gp_Vec &D3V, gp_Vec &D3UUV, gp_Vec &D3UVV) const =0
	Computes the point P, the first,the second and the third derivatives in the directions U and V at this point. //! Raised if the continuity of the surface is not C2. More...

virtual gp_Vec	DN (const Standard_Real U, const Standard_Real V, const Standard_Integer Nu, const Standard_Integer Nv) const =0
	—Purpose ; Computes the derivative of order Nu in the direction U and Nv in the direction V at the point P(U, V). Raised if the continuity of the surface is not CNu in the U direction or not CNv in the V direction. //! Raised if Nu + Nv < 1 or Nu < 0 or Nv < 0. More...

gp_Pnt	Value (const Standard_Real U, const Standard_Real V) const
	Computes the point of parameter U on the surface. <br> It is implemented with D0 Raised only for an "OffsetSurface" if it is not possible to compute the current point. More...

Public Member Functions inherited from Geom_Geometry
void	Mirror (const gp_Pnt &P)
	Performs the symmetrical transformation of a Geometry with respect to the point P which is the center of the symmetry. More...

void	Mirror (const gp_Ax1 &A1)
	Performs the symmetrical transformation of a Geometry with respect to an axis placement which is the axis of the symmetry. More...

void	Mirror (const gp_Ax2 &A2)
	Performs the symmetrical transformation of a Geometry with respect to a plane. The axis placement A2 locates the plane of the symmetry : (Location, XDirection, YDirection). More...

void	Rotate (const gp_Ax1 &A1, const Standard_Real Ang)
	Rotates a Geometry. A1 is the axis of the rotation. Ang is the angular value of the rotation in radians. More...

void	Scale (const gp_Pnt &P, const Standard_Real S)
	Scales a Geometry. S is the scaling value. More...

void	Translate (const gp_Vec &V)
	Translates a Geometry. V is the vector of the tanslation. More...

void	Translate (const gp_Pnt &P1, const gp_Pnt &P2)
	Translates a Geometry from the point P1 to the point P2. More...

virtual void	Transform (const gp_Trsf &T)=0
	Transformation of a geometric object. This tansformation can be a translation, a rotation, a symmetry, a scaling or a complex transformation obtained by combination of the previous elementaries transformations. (see class Transformation of the package Geom). More...

Handle_Geom_Geometry	Mirrored (const gp_Pnt &P) const

Handle_Geom_Geometry	Mirrored (const gp_Ax1 &A1) const

Handle_Geom_Geometry	Mirrored (const gp_Ax2 &A2) const

Handle_Geom_Geometry	Rotated (const gp_Ax1 &A1, const Standard_Real Ang) const

Handle_Geom_Geometry	Scaled (const gp_Pnt &P, const Standard_Real S) const

Handle_Geom_Geometry	Transformed (const gp_Trsf &T) const

Handle_Geom_Geometry	Translated (const gp_Vec &V) const

Handle_Geom_Geometry	Translated (const gp_Pnt &P1, const gp_Pnt &P2) const

virtual Handle_Geom_Geometry	Copy () const =0
	Creates a new object which is a copy of this geometric object. More...

Public Member Functions inherited from MMgt_TShared
virtual void	Delete () const
	Memory deallocator for transient classes. More...

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor. More...

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing. More...

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter. More...

virtual	~Standard_Transient ()
	Destructor must be virtual. More...

virtual void	ShallowDump (Standard_OStream &) const

virtual const Handle_Standard_Type &	DynamicType () const
	Returns a type information object about this object. More...

Standard_Boolean	IsInstance (const Handle_Standard_Type &theType) const
	Returns a true value if this is an instance of Type. More...

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName. More...

Standard_Boolean	IsKind (const Handle_Standard_Type &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

virtual Handle_Standard_Transient	This () const
	Returns a Handle which references this object. Must never be called to objects created in stack. More...

Standard_Integer	GetRefCount () const
	Get the reference counter of this object. More...

Protected Attributes
gp_Ax3	pos

Detailed Description

Describes the common behavior of surfaces which
have a simple parametric equation in a local
coordinate system. The Geom package provides
several implementations of concrete elementary surfaces:

the plane, and
four simple surfaces of revolution: the cylinder, the
cone, the sphere and the torus.
An elementary surface inherits the common behavior
of Geom_Surface surfaces. Furthermore, it is located
in 3D space by a coordinate system (a gp_Ax3
object) which is also its local coordinate system.
Any elementary surface is oriented, i.e. the normal
vector is always defined, and gives the same
orientation to the surface, at any point on the surface.
In topology this property is referred to as the "outside <br> region of the surface". This orientation is related to
the two parametric directions of the surface.
Rotation of a surface around the "main Axis" of its
coordinate system, in the trigonometric sense given
by the "X Direction" and the "Y Direction" of the
coordinate system, defines the u parametric direction
of that elementary surface of revolution. This is the
default construction mode.
It is also possible, however, to change the orientation
of a surface by reversing one of the two parametric
directions: use the UReverse or VReverse functions
to change the orientation of the normal at any point on the surface.
Warning
The local coordinate system of an elementary surface
is not necessarily direct:
if it is direct, the trigonometric sense defined by its
"main Direction" is the same as the trigonometric
sense defined by its two vectors "X Direction" and "Y Direction":
"main Direction" = "X Direction" ^ "Y Direction"
if it is indirect, the two definitions of trigonometric
sense are opposite:
"main Direction" = - "X Direction" ^ "Y Direction"

Member Function Documentation

gp_Ax1 Geom_ElementarySurface::Axis ( ) const

Returns the main axis of the surface (ZAxis).

GeomAbs_Shape Geom_ElementarySurface::Continuity ( ) const

virtual

Returns GeomAbs_CN, the global continuity of any elementary surface.

Implements Geom_Surface.

Standard_Boolean Geom_ElementarySurface::IsCNu ( const Standard_Integer N ) const

virtual

Returns True.

Implements Geom_Surface.

Standard_Boolean Geom_ElementarySurface::IsCNv ( const Standard_Integer N ) const

virtual

Returns True.

Implements Geom_Surface.

gp_Pnt Geom_ElementarySurface::Location ( ) const

Returns the location point of the local coordinate system of the
surface.

const gp_Ax3& Geom_ElementarySurface::Position ( ) const

Returns the local coordinates system of the surface.

void Geom_ElementarySurface::SetAxis ( const gp_Ax1 & A1 )

Changes the main axis (ZAxis) of the elementary surface.
Raised if the direction of A1 is parallel to the XAxis of the
coordinate system of the surface.

void Geom_ElementarySurface::SetLocation ( const gp_Pnt & Loc )

Changes the location of the local coordinates system of the
surface.

void Geom_ElementarySurface::SetPosition ( const gp_Ax3 & A3 )

Changes the local coordinates system of the surface.

virtual void Geom_ElementarySurface::UReverse ( )

virtual

Reverses the U parametric direction of the surface.

Implements Geom_Surface.

Reimplemented in Geom_Plane.

virtual Standard_Real Geom_ElementarySurface::UReversedParameter ( const Standard_Real U ) const

pure virtual

 Return the  parameter on the  Ureversed surface for <br>
     the point of parameter U on <me>. <br>

me->UReversed()->Value(me->UReversedParameter(U),V)
is the same point as
me->Value(U,V)

Implements Geom_Surface.

Implemented in Geom_ToroidalSurface, Geom_ConicalSurface, Geom_SphericalSurface, Geom_Plane, and Geom_CylindricalSurface.

virtual void Geom_ElementarySurface::VReverse ( )

virtual

Reverses the V parametric direction of the surface.

Implements Geom_Surface.

Reimplemented in Geom_ConicalSurface, and Geom_Plane.

virtual Standard_Real Geom_ElementarySurface::VReversedParameter ( const Standard_Real V ) const

pure virtual

 Return the  parameter on the  Vreversed surface for <br>
     the point of parameter V on <me>. <br>

me->VReversed()->Value(U,me->VReversedParameter(V))
is the same point as
me->Value(U,V)

Implements Geom_Surface.

Implemented in Geom_ToroidalSurface, Geom_ConicalSurface, Geom_SphericalSurface, Geom_Plane, and Geom_CylindricalSurface.

Field Documentation

gp_Ax3 Geom_ElementarySurface::pos

protected

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

Geom_ElementarySurface.hxx

Public Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

Field Documentation