GeomPlate_Surface Class Reference

Describes the characteristics of plate surface objects returned by BuildPlateSurface::Surface. These can be used to verify the quality of the resulting surface before approximating it to a Geom_BSpline surface generated by MakeApprox. This proves necessary in cases where you want to use the resulting surface as the support for a shape. The algorithmically generated surface cannot fill this function as is, and as a result must be converted first. More...

#include <GeomPlate_Surface.hxx>

Inheritance diagram for GeomPlate_Surface:

Public Member Functions
	GeomPlate_Surface (const Handle< Geom_Surface > &Surfinit, const Plate_Plate &Surfinter)
void	UReverse () override
	Reverses the U direction of parametrization of <me>. The bounds of the surface are not modified.
Standard_Real	UReversedParameter (const Standard_Real U) const override
	Return the parameter on the Ureversed surface for the point of parameter U on <me>.
void	VReverse () override
	Reverses the V direction of parametrization of <me>. The bounds of the surface are not modified.
Standard_Real	VReversedParameter (const Standard_Real V) const override
	Return the parameter on the Vreversed surface for the point of parameter V on <me>.
virtual void	TransformParameters (Standard_Real &U, Standard_Real &V, const gp_Trsf &T) const override
	Computes the parameters on the transformed surface for the transform of the point of parameters U,V on <me>.
virtual gp_GTrsf2d	ParametricTransformation (const gp_Trsf &T) const override
	Returns a 2d transformation used to find the new parameters of a point on the transformed surface.
void	Bounds (Standard_Real &U1, Standard_Real &U2, Standard_Real &V1, Standard_Real &V2) const override
	Returns the parametric bounds U1, U2, V1 and V2 of this surface. If the surface is infinite, this function can return a value equal to Precision::Infinite: instead of Standard_Real::LastReal.
Standard_Boolean	IsUClosed () const override
	Is the surface closed in the parametric direction U ? Returns True if for each parameter V the distance between the point P (UFirst, V) and P (ULast, V) is lower or equal to Resolution from gp. UFirst and ULast are the parametric bounds in the U direction.
Standard_Boolean	IsVClosed () const override
	Is the surface closed in the parametric direction V ? Returns True if for each parameter U the distance between the point P (U, VFirst) and P (U, VLast) is lower or equal to Resolution from gp. VFirst and VLast are the parametric bounds in the V direction.
Standard_Boolean	IsUPeriodic () const override
	Is the parametrization of a surface periodic in the direction U ? It is possible only if the surface is closed in this parametric direction and if the following relation is satisfied : for each parameter V the distance between the point P (U, V) and the point P (U + T, V) is lower or equal to Resolution from package gp. T is the parametric period and must be a constant.
virtual Standard_Real	UPeriod () const override
	returns the Uperiod. raises if the surface is not uperiodic.
Standard_Boolean	IsVPeriodic () const override
	Is the parametrization of a surface periodic in the direction U ? It is possible only if the surface is closed in this parametric direction and if the following relation is satisfied : for each parameter V the distance between the point P (U, V) and the point P (U + T, V) is lower or equal to Resolution from package gp. T is the parametric period and must be a constant.
virtual Standard_Real	VPeriod () const override
	returns the Vperiod. raises if the surface is not vperiodic.
Handle< Geom_Curve >	UIso (const Standard_Real U) const override
	Computes the U isoparametric curve.
Handle< Geom_Curve >	VIso (const Standard_Real V) const override
	Computes the V isoparametric curve.
GeomAbs_Shape	Continuity () const override
	Global Continuity of the surface in direction U and V : C0 : only geometric continuity, C1 : continuity of the first derivative all along the surface, C2 : continuity of the second derivative all along the surface, C3 : continuity of the third derivative all along the surface, G1 : tangency continuity all along the surface, G2 : curvature continuity all along the surface, CN : the order of continuity is infinite. Example : If the surface is C1 in the V parametric direction and C2 in the U parametric direction Shape = C1.
Standard_Boolean	IsCNu (const Standard_Integer N) const override
	Returns the order of continuity of the surface in the U parametric direction. Raised if N < 0.
Standard_Boolean	IsCNv (const Standard_Integer N) const override
	Returns the order of continuity of the surface in the V parametric direction. Raised if N < 0.
void	D0 (const Standard_Real U, const Standard_Real V, gp_Pnt &P) const override
	Computes the point of parameter U,V on the surface.
void	D1 (const Standard_Real U, const Standard_Real V, gp_Pnt &P, gp_Vec &D1U, gp_Vec &D1V) const override
	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.
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 override
	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.
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 override
	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.
gp_Vec	DN (const Standard_Real U, const Standard_Real V, const Standard_Integer Nu, const Standard_Integer Nv) const override
	—Purpose ; Computes the derivative of order Nu in the direction U and Nv in the direction V at the point P(U, V).
Handle< Geom_Geometry >	Copy () const override
	Creates a new object which is a copy of this geometric object.
void	Transform (const gp_Trsf &T) override
	Transformation of a geometric object. This transformation 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).
Handle< Geom_Surface >	CallSurfinit () const
void	SetBounds (const Standard_Real Umin, const Standard_Real Umax, const Standard_Real Vmin, const Standard_Real Vmax)
void	RealBounds (Standard_Real &U1, Standard_Real &U2, Standard_Real &V1, Standard_Real &V2) const
void	Constraints (TColgp_SequenceOfXY &Seq) const
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.
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.
gp_Pnt	Value (const Standard_Real U, const Standard_Real V) const
	Computes the point of parameter (U, V) on the surface.
virtual void	DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const override
	Dumps the content of me into the stream.
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.
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.
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).
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.
void	Scale (const gp_Pnt &P, const Standard_Real S)
	Scales a Geometry. S is the scaling value.
void	Translate (const gp_Vec &V)
	Translates a Geometry. V is the vector of the translation.
void	Translate (const gp_Pnt &P1, const gp_Pnt &P2)
	Translates a Geometry from the point P1 to the point P2.
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
Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.
	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.
Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.
virtual	~Standard_Transient ()
	Destructor must be virtual.
virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.
Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.
Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName.
Standard_Boolean	IsKind (const opencascade::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.
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.
Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.
Standard_Integer	GetRefCount () const noexcept
	Get the reference counter of this object.
void	IncrementRefCounter () noexcept
	Increments the reference counter of this object.
Standard_Integer	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value.
virtual void	Delete () const
	Memory deallocator for transient classes.

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.
Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.
static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Detailed Description

Describes the characteristics of plate surface objects returned by BuildPlateSurface::Surface. These can be used to verify the quality of the resulting surface before approximating it to a Geom_BSpline surface generated by MakeApprox. This proves necessary in cases where you want to use the resulting surface as the support for a shape. The algorithmically generated surface cannot fill this function as is, and as a result must be converted first.

Constructor & Destructor Documentation

GeomPlate_Surface()

GeomPlate_Surface::GeomPlate_Surface	(	const Handle< Geom_Surface > &	Surfinit,
		const Plate_Plate &	Surfinter )

Member Function Documentation

Bounds()

void GeomPlate_Surface::Bounds ( Standard_Real & U1, Standard_Real & U2, Standard_Real & V1, Standard_Real & V2 ) const

overridevirtual

Returns the parametric bounds U1, U2, V1 and V2 of this surface. If the surface is infinite, this function can return a value equal to Precision::Infinite: instead of Standard_Real::LastReal.

Implements Geom_Surface.

CallSurfinit()

Handle< Geom_Surface > GeomPlate_Surface::CallSurfinit

(

)

const

Constraints()

void GeomPlate_Surface::Constraints

(

TColgp_SequenceOfXY &

Seq

)

const

Continuity()

GeomAbs_Shape GeomPlate_Surface::Continuity ( ) const

overridevirtual

Global Continuity of the surface in direction U and V : C0 : only geometric continuity, C1 : continuity of the first derivative all along the surface, C2 : continuity of the second derivative all along the surface, C3 : continuity of the third derivative all along the surface, G1 : tangency continuity all along the surface, G2 : curvature continuity all along the surface, CN : the order of continuity is infinite. Example : If the surface is C1 in the V parametric direction and C2 in the U parametric direction Shape = C1.

Implements Geom_Surface.

Copy()

Handle< Geom_Geometry > GeomPlate_Surface::Copy ( ) const

overridevirtual

Creates a new object which is a copy of this geometric object.

Implements Geom_Geometry.

D0()

void GeomPlate_Surface::D0 ( const Standard_Real U, const Standard_Real V, gp_Pnt & P ) const

overridevirtual

Computes the point of parameter U,V on the surface.

Raised only for an "OffsetSurface" if it is not possible to compute the current point.

Implements Geom_Surface.

D1()

void GeomPlate_Surface::D1 ( const Standard_Real U, const Standard_Real V, gp_Pnt & P, gp_Vec & D1U, gp_Vec & D1V ) const

overridevirtual

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.

Implements Geom_Surface.

D2()

void GeomPlate_Surface::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

overridevirtual

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.

Implements Geom_Surface.

D3()

void GeomPlate_Surface::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

overridevirtual

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.

Implements Geom_Surface.

DN()

gp_Vec GeomPlate_Surface::DN ( const Standard_Real U, const Standard_Real V, const Standard_Integer Nu, const Standard_Integer Nv ) const

overridevirtual

—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.

Implements Geom_Surface.

IsCNu()

Standard_Boolean GeomPlate_Surface::IsCNu ( const Standard_Integer N ) const

overridevirtual

Returns the order of continuity of the surface in the U parametric direction. Raised if N < 0.

Implements Geom_Surface.

IsCNv()

Standard_Boolean GeomPlate_Surface::IsCNv ( const Standard_Integer N ) const

overridevirtual

Returns the order of continuity of the surface in the V parametric direction. Raised if N < 0.

Implements Geom_Surface.

IsUClosed()

Standard_Boolean GeomPlate_Surface::IsUClosed ( ) const

overridevirtual

Is the surface closed in the parametric direction U ? Returns True if for each parameter V the distance between the point P (UFirst, V) and P (ULast, V) is lower or equal to Resolution from gp. UFirst and ULast are the parametric bounds in the U direction.

Implements Geom_Surface.

IsUPeriodic()

Standard_Boolean GeomPlate_Surface::IsUPeriodic ( ) const

overridevirtual

Is the parametrization of a surface periodic in the direction U ? It is possible only if the surface is closed in this parametric direction and if the following relation is satisfied : for each parameter V the distance between the point P (U, V) and the point P (U + T, V) is lower or equal to Resolution from package gp. T is the parametric period and must be a constant.

Implements Geom_Surface.

IsVClosed()

Standard_Boolean GeomPlate_Surface::IsVClosed ( ) const

overridevirtual

Is the surface closed in the parametric direction V ? Returns True if for each parameter U the distance between the point P (U, VFirst) and P (U, VLast) is lower or equal to Resolution from gp. VFirst and VLast are the parametric bounds in the V direction.

Implements Geom_Surface.

IsVPeriodic()

Standard_Boolean GeomPlate_Surface::IsVPeriodic ( ) const

overridevirtual

Is the parametrization of a surface periodic in the direction U ? It is possible only if the surface is closed in this parametric direction and if the following relation is satisfied : for each parameter V the distance between the point P (U, V) and the point P (U + T, V) is lower or equal to Resolution from package gp. T is the parametric period and must be a constant.

Implements Geom_Surface.

ParametricTransformation()

virtual gp_GTrsf2d GeomPlate_Surface::ParametricTransformation ( const gp_Trsf & T ) const

overridevirtual

Returns a 2d transformation used to find the new parameters of a point on the transformed surface.

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 the 2d transformation returned by

me->ParametricTransformation(T)

This method returns an identity transformation

It can be redefined. For example on the Plane, Cylinder, Cone, Revolved and Extruded surfaces.

Reimplemented from Geom_Surface.

RealBounds()

void GeomPlate_Surface::RealBounds	(	Standard_Real &	U1,
		Standard_Real &	U2,
		Standard_Real &	V1,
		Standard_Real &	V2 ) const

SetBounds()

void GeomPlate_Surface::SetBounds	(	const Standard_Real	Umin,
		const Standard_Real	Umax,
		const Standard_Real	Vmin,
		const Standard_Real	Vmax )

Transform()

void GeomPlate_Surface::Transform ( const gp_Trsf & T )

overridevirtual

Transformation of a geometric object. This transformation 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).

Implements Geom_Geometry.

TransformParameters()

virtual void GeomPlate_Surface::TransformParameters ( Standard_Real & U, Standard_Real & V, const gp_Trsf & T ) const

overridevirtual

Computes the parameters on the transformed surface for the transform of the point of parameters U,V on <me>.

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->TransformParameters(U,V,T)

This methods does not change and <V>

It can be redefined. For example on the Plane, Cylinder, Cone, Revolved and Extruded surfaces.

Reimplemented from Geom_Surface.

UIso()

Handle< Geom_Curve > GeomPlate_Surface::UIso ( const Standard_Real U ) const

overridevirtual

Computes the U isoparametric curve.

Implements Geom_Surface.

UPeriod()

virtual Standard_Real GeomPlate_Surface::UPeriod ( ) const

overridevirtual

returns the Uperiod. raises if the surface is not uperiodic.

Reimplemented from Geom_Surface.

UReverse()

void GeomPlate_Surface::UReverse ( )

overridevirtual

Reverses the U direction of parametrization of <me>. The bounds of the surface are not modified.

Implements Geom_Surface.

UReversedParameter()

Standard_Real GeomPlate_Surface::UReversedParameter ( const Standard_Real U ) const

overridevirtual

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

me->UReversed()->Value(me->UReversedParameter(U),V)

is the same point as

me->Value(U,V)

Implements Geom_Surface.

VIso()

Handle< Geom_Curve > GeomPlate_Surface::VIso ( const Standard_Real V ) const

overridevirtual

Computes the V isoparametric curve.

Implements Geom_Surface.

VPeriod()

virtual Standard_Real GeomPlate_Surface::VPeriod ( ) const

overridevirtual

returns the Vperiod. raises if the surface is not vperiodic.

Reimplemented from Geom_Surface.

VReverse()

void GeomPlate_Surface::VReverse ( )

overridevirtual

Reverses the V direction of parametrization of <me>. The bounds of the surface are not modified.

Implements Geom_Surface.

VReversedParameter()

Standard_Real GeomPlate_Surface::VReversedParameter ( const Standard_Real V ) const

overridevirtual

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

me->VReversed()->Value(U,me->VReversedParameter(V))

is the same point as

me->Value(U,V)

Implements Geom_Surface.

---

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

• GeomPlate_Surface.hxx