Composite surface is represented by a grid of surfaces (patches) connected geometrically. Patches may have different parametrisation ranges, but they should be parametrised in the same manner so that parameter of each patch (u,v) can be converted to global parameter on the whole surface (U,V) with help of linear transformation: More...

#include <ShapeExtend_CompositeSurface.hxx>

Inheritance diagram for ShapeExtend_CompositeSurface:

[legend]

Public Member Functions
	ShapeExtend_CompositeSurface ()
	Empty constructor.

	ShapeExtend_CompositeSurface (const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &GridSurf, const ShapeExtend_Parametrisation param=ShapeExtend_Natural)
	Initializes by a grid of surfaces (calls Init()).

	ShapeExtend_CompositeSurface (const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &GridSurf, const NCollection_Array1< double > &UJoints, const NCollection_Array1< double > &VJoints)
	Initializes by a grid of surfaces (calls Init()).

bool	Init (const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &GridSurf, const ShapeExtend_Parametrisation param=ShapeExtend_Natural)
	Initializes by a grid of surfaces. All the Surfaces of the grid must have geometrical connectivity as stated above. If geometrical connectivity is not satisfied, method returns False. However, class is initialized even in that case.

bool	Init (const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &GridSurf, const NCollection_Array1< double > &UJoints, const NCollection_Array1< double > &VJoints)
	Initializes by a grid of surfaces with given global parametrisation defined by UJoints and VJoints arrays, each having length equal to number of patches in corresponding direction + 1. Global joint values should be sorted in increasing order. All the Surfaces of the grid must have geometrical connectivity as stated above. If geometrical connectivity is not satisfied, method returns False. However, class is initialized even in that case.

int	NbUPatches () const
	Returns number of patches in U direction.

int	NbVPatches () const
	Returns number of patches in V direction.

const occ::handle< Geom_Surface > &	Patch (const int i, const int j) const
	Returns one surface patch.

const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &	Patches () const
	Returns grid of surfaces.

occ::handle< NCollection_HArray1< double > >	UJointValues () const
	Returns the array of U values corresponding to joint points between patches as well as to start and end points, which define global parametrisation of the surface.

occ::handle< NCollection_HArray1< double > >	VJointValues () const
	Returns the array of V values corresponding to joint points between patches as well as to start and end points, which define global parametrisation of the surface.

double	UJointValue (const int i) const
	Returns i-th joint value in U direction (1-st is global Umin, (NbUPatches()+1)-th is global Umax on the composite surface)

double	VJointValue (const int j) const
	Returns j-th joint value in V direction (1-st is global Vmin, (NbVPatches()+1)-th is global Vmax on the composite surface)

bool	SetUJointValues (const NCollection_Array1< double > &UJoints)
	Sets the array of U values corresponding to joint points, which define global parametrisation of the surface. Number of values in array should be equal to NbUPatches()+1. All the values should be sorted in increasing order. If this is not satisfied, does nothing and returns False.

bool	SetVJointValues (const NCollection_Array1< double > &VJoints)
	Sets the array of V values corresponding to joint points, which define global parametrisation of the surface Number of values in array should be equal to NbVPatches()+1. All the values should be sorted in increasing order. If this is not satisfied, does nothing and returns False.

void	SetUFirstValue (const double UFirst)
	Changes starting value for global U parametrisation (all other joint values are shifted accordingly)

void	SetVFirstValue (const double VFirst)
	Changes starting value for global V parametrisation (all other joint values are shifted accordingly)

int	LocateUParameter (const double U) const
	Returns number of col that contains given (global) parameter.

int	LocateVParameter (const double V) const
	Returns number of row that contains given (global) parameter.

void	LocateUVPoint (const gp_Pnt2d &pnt, int &i, int &j) const
	Returns number of row and col of surface that contains given point.

const occ::handle< Geom_Surface > &	Patch (const double U, const double V) const
	Returns one surface patch that contains given (global) parameters.

const occ::handle< Geom_Surface > &	Patch (const gp_Pnt2d &pnt) const
	Returns one surface patch that contains given point.

double	ULocalToGlobal (const int i, const int j, const double u) const
	Converts local parameter u on patch i,j to global parameter U.

double	VLocalToGlobal (const int i, const int j, const double v) const
	Converts local parameter v on patch i,j to global parameter V.

gp_Pnt2d	LocalToGlobal (const int i, const int j, const gp_Pnt2d &uv) const
	Converts local parameters uv on patch i,j to global parameters UV.

double	UGlobalToLocal (const int i, const int j, const double U) const
	Converts global parameter U to local parameter u on patch i,j.

double	VGlobalToLocal (const int i, const int j, const double V) const
	Converts global parameter V to local parameter v on patch i,j.

gp_Pnt2d	GlobalToLocal (const int i, const int j, const gp_Pnt2d &UV) const
	Converts global parameters UV to local parameters uv on patch i,j.

bool	GlobalToLocalTransformation (const int i, const int j, double &uFact, gp_Trsf2d &Trsf) const
	Computes transformation operator and uFactor descrinbing affine transformation required to convert global parameters on composite surface to local parameters on patch (i,j): uv = ( uFactor, 1. ) X Trsf * UV; NOTE: Thus Trsf contains shift and scale by V, scale by U is stored in uFact. Returns True if transformation is not an identity.

void	Transform (const gp_Trsf &T) override
	Applies transformation to all the patches.

occ::handle< Geom_Geometry >	Copy () const override
	Returns a copy of the surface.

void	UReverse () override
	NOT IMPLEMENTED (does nothing)

double	UReversedParameter (const double U) const override
	Returns U.

void	VReverse () override
	NOT IMPLEMENTED (does nothing)

double	VReversedParameter (const double V) const override
	Returns V.

void	Bounds (double &U1, double &U2, double &V1, double &V2) const override
	Returns the parametric bounds of grid.

bool	IsUClosed () const override
	Returns True if grid is closed in U direction (i.e. connected with Precision::Confusion)

bool	IsVClosed () const override
	Returns True if grid is closed in V direction (i.e. connected with Precision::Confusion)

bool	IsUPeriodic () const override
	Returns False.

bool	IsVPeriodic () const override
	Returns False.

occ::handle< Geom_Curve >	UIso (const double U) const override
	NOT IMPLEMENTED (returns Null curve)

occ::handle< Geom_Curve >	VIso (const double V) const override
	NOT IMPLEMENTED (returns Null curve)

GeomAbs_Shape	Continuity () const override
	returns C0

bool	IsCNu (const int N) const override
	returns True if N <=0

bool	IsCNv (const int N) const override
	returns True if N <=0

gp_Pnt	EvalD0 (const double U, const double V) const override
	Computes the point of parameter U,V on the grid.

Geom_Surface::ResD1	EvalD1 (const double U, const double V) const override
	Computes the point P and the first derivatives in the directions U and V at this point.

Geom_Surface::ResD2	EvalD2 (const double U, const double V) const override
	Computes the point P, the first and the second derivatives in the directions U and V at this point.

Geom_Surface::ResD3	EvalD3 (const double U, const double V) const override
	Computes the point P, the first,the second and the third derivatives in the directions U and V at this point.

gp_Vec	EvalDN (const double U, const double V, const int Nu, const int Nv) const override
	Computes the derivative of order Nu in the direction U and Nv in the direction V at the point P(U, V).

gp_Pnt	Value (const gp_Pnt2d &pnt) const
	Computes the point of parameter pnt on the grid.

void	ComputeJointValues (const ShapeExtend_Parametrisation param=ShapeExtend_Natural)
	Computes Joint values according to parameter.

bool	CheckConnectivity (const double prec)
	Checks geometrical connectivity of the patches, including closedness (sets fields muUClosed and myVClosed)

Public Member Functions inherited from Geom_Surface
occ::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.

occ::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.

virtual void	TransformParameters (double &U, double &V, const gp_Trsf &T) const
	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
	Returns a 2d transformation used to find the new parameters of a point on the transformed surface.

virtual double	UPeriod () const
	Returns the period of this surface in the u parametric direction. Raises if the surface is not uperiodic.

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

void	D0 (const double U, const double V, gp_Pnt &P) const
	Computes the point of parameter (U, V).

void	D1 (const double U, const double V, gp_Pnt &P, gp_Vec &D1U, gp_Vec &D1V) const
	Computes the point and first partial derivatives.

void	D2 (const double U, const double V, gp_Pnt &P, gp_Vec &D1U, gp_Vec &D1V, gp_Vec &D2U, gp_Vec &D2V, gp_Vec &D2UV) const
	Computes the point and partial derivatives up to 2nd order.

void	D3 (const double U, const double 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
	Computes the point and partial derivatives up to 3rd order.

gp_Vec	DN (const double U, const double V, const int Nu, const int Nv) const
	Computes the derivative of order Nu in U and Nv in V.

gp_Pnt	Value (const double U, const double V) const
	Computes the point of parameter (U, V) on the surface.

void	DumpJson (Standard_OStream &theOStream, int 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 double 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 double 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.

occ::handle< Geom_Geometry >	Mirrored (const gp_Pnt &P) const

occ::handle< Geom_Geometry >	Mirrored (const gp_Ax1 &A1) const

occ::handle< Geom_Geometry >	Mirrored (const gp_Ax2 &A2) const

occ::handle< Geom_Geometry >	Rotated (const gp_Ax1 &A1, const double Ang) const

occ::handle< Geom_Geometry >	Scaled (const gp_Pnt &P, const double S) const

occ::handle< Geom_Geometry >	Transformed (const gp_Trsf &T) const

occ::handle< Geom_Geometry >	Translated (const gp_Vec &V) const

occ::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 ()=default
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

bool	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

bool	IsInstance (const char *const theTypeName) const
	Returns a true value if this is an instance of TypeName.

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

bool	IsKind (const char *const 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.

int	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.

int	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.

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

Composite surface is represented by a grid of surfaces (patches) connected geometrically. Patches may have different parametrisation ranges, but they should be parametrised in the same manner so that parameter of each patch (u,v) can be converted to global parameter on the whole surface (U,V) with help of linear transformation:

for any i,j-th patch U = Ui + ( u - uijmin ) * ( Ui+1 - Ui ) / ( uijmax - uijmin ) V = Vj + ( v - vijmin ) * ( Vj+1 - Vj ) / ( vijmax - vijmin )

where

[uijmin, uijmax] * [ vijmin, vijmax] - parametric range of i,j-th patch,

Ui (i=1,..,Nu+1), Vi (j=1,..,Nv+1) - values defining global parametrisation by U and V (correspond to points between patches and bounds, (Ui,Uj) corresponds to (uijmin,vijmin) on i,j-th patch) and to (u(i-1)(j-1)max,v(i-1)(j-1)max) on (i-1),(j-1)-th patch.

Geometrical connectivity is expressed via global parameters: S[i,j](Ui+1,V) = S[i+1,j](Ui+1,V) for any i, j, V S[i,j](U,Vj+1) = S[i,j+1](U,Vj+1) for any i, j, U It is checked with Precision::Confusion() by default.

NOTE 1: This class is inherited from Geom_Surface in order to make it more easy to store and deal with it. However, it should not be passed to standard methods dealing with geometry since this type is not known to them. NOTE 2: Not all the inherited methods are implemented, and some are implemented not in the full form.

Constructor & Destructor Documentation

◆ ShapeExtend_CompositeSurface() [1/3]

ShapeExtend_CompositeSurface::ShapeExtend_CompositeSurface ( )

Empty constructor.

◆ ShapeExtend_CompositeSurface() [2/3]

ShapeExtend_CompositeSurface::ShapeExtend_CompositeSurface	(	const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &	GridSurf,
		const ShapeExtend_Parametrisation	param = ShapeExtend_Natural )

Initializes by a grid of surfaces (calls Init()).

◆ ShapeExtend_CompositeSurface() [3/3]

ShapeExtend_CompositeSurface::ShapeExtend_CompositeSurface	(	const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &	GridSurf,
		const NCollection_Array1< double > &	UJoints,
		const NCollection_Array1< double > &	VJoints )

Initializes by a grid of surfaces (calls Init()).

Member Function Documentation

◆ Bounds()

void ShapeExtend_CompositeSurface::Bounds	(	double &	U1,
		double &	U2,
		double &	V1,
		double &	V2 ) const

overridevirtual

Returns the parametric bounds of grid.

gp_Pnt2d ShapeExtend_CompositeSurface::GlobalToLocal	(	const int	i,
		const int	j,
		const gp_Pnt2d &	UV ) const

bool ShapeExtend_CompositeSurface::GlobalToLocalTransformation	(	const int	i,
		const int	j,
		double &	uFact,
		gp_Trsf2d &	Trsf ) const

bool ShapeExtend_CompositeSurface::Init	(	const occ::handle< NCollection_HArray2< occ::handle< Geom_Surface > > > &	GridSurf,
		const NCollection_Array1< double > &	UJoints,
		const NCollection_Array1< double > &	VJoints )

gp_Pnt2d ShapeExtend_CompositeSurface::LocalToGlobal	(	const int	i,
		const int	j,
		const gp_Pnt2d &	uv ) const

void ShapeExtend_CompositeSurface::LocateUVPoint	(	const gp_Pnt2d &	pnt,
		int &	i,
		int &	j ) const

const occ::handle< Geom_Surface > & ShapeExtend_CompositeSurface::Patch	(	const double	U,
		const double	V ) const

double ShapeExtend_CompositeSurface::UGlobalToLocal	(	const int	i,
		const int	j,
		const double	U ) const

double ShapeExtend_CompositeSurface::ULocalToGlobal	(	const int	i,
		const int	j,
		const double	u ) const

double ShapeExtend_CompositeSurface::VGlobalToLocal	(	const int	i,
		const int	j,
		const double	V ) const

double ShapeExtend_CompositeSurface::VLocalToGlobal	(	const int	i,
		const int	j,
		const double	v ) const

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ShapeExtend_CompositeSurface() [1/3]

◆ ShapeExtend_CompositeSurface() [2/3]

◆ ShapeExtend_CompositeSurface() [3/3]

Member Function Documentation

◆ Bounds()

◆ CheckConnectivity()

◆ ComputeJointValues()

◆ Continuity()

◆ Copy()

◆ EvalD0()

◆ EvalD1()

◆ EvalD2()

◆ EvalD3()

◆ EvalDN()

◆ GlobalToLocal()

◆ GlobalToLocalTransformation()

◆ Init() [1/2]

◆ Init() [2/2]

◆ IsCNu()

◆ IsCNv()

◆ IsUClosed()

◆ IsUPeriodic()

◆ IsVClosed()

◆ IsVPeriodic()

◆ LocalToGlobal()

◆ LocateUParameter()

◆ LocateUVPoint()

◆ LocateVParameter()

◆ NbUPatches()

◆ NbVPatches()

◆ Patch() [1/3]

◆ Patch() [2/3]

◆ Patch() [3/3]

◆ Patches()

◆ SetUFirstValue()

◆ SetUJointValues()

◆ SetVFirstValue()

◆ SetVJointValues()

◆ Transform()

◆ UGlobalToLocal()

◆ UIso()

◆ UJointValue()

◆ UJointValues()

◆ ULocalToGlobal()

◆ UReverse()

◆ UReversedParameter()

◆ Value()

◆ VGlobalToLocal()

◆ VIso()

◆ VJointValue()

◆ VJointValues()

◆ VLocalToGlobal()

◆ VReverse()

◆ VReversedParameter()