Defines a regular cartesian grid volume mesh. More...

#include <MeshViz/3Ddata/PbRegularCartesianGrid3D.h>

Inheritance diagram for PbRegularCartesianGrid3D:

Public Member Functions
	PbRegularCartesianGrid3D (SbBool isDataDuplicate=TRUE)
	Constructor of a default simple mesh.

	PbRegularCartesianGrid3D (const PbRegularCartesianGrid3D &mesh)
	Copy constructor.

	PbRegularCartesianGrid3D (int num_x, int num_y, int num_z, float x_min, float y_min, float z_min, float x_max, float y_max, float z_max, SbBool isDataDuplicate=TRUE)
	Constructor of a 3D regular grid mesh.

	~PbRegularCartesianGrid3D ()
	Destructor.

PbRegularCartesianGrid3D &	operator= (const PbRegularCartesianGrid3D &mesh)
	Assignment operator.

void	setGeometry (int num_x, int num_y, int num_z, float x_min, float y_min, float z_min, float x_max, float y_max, float z_max)
	Defines a new geometry.

void	getGeometry (int &num_x, int &num_y, int &num_z, float &x_min, float &y_min, float &z_min, float &x_max, float &y_max, float &z_max) const
	Gets the mesh geometry.

virtual const PbCell *	findContainingCell (const SbVec3f &point, float tolerance, SbVec3f &pcoord, const PbCell *adjacent_cell) const

virtual const PbCell *	findContainingCell (const SbVec3f &point, float tolerance, SbVec3f &pcoord) const
	Find the mesh's cell that contains the point.

virtual const PbCell *	getCell (int cell_index) const
	Gets the cell which index is cell_index.

virtual SbVec3f	getNodeCoord (int nod_index) const
	Gets the coordinates of a node defined by its index.

virtual SbVec3f	getNodeCoord (int i, int j, int k) const
	Gets the coordinates of a node defined by its i, j, k indices on the grid.

virtual float	getVolume () const
	Gets the volume of the mesh.

void	setCoordinates (const float xnod, const float ynod, const float *znod)
	Set new node coordinates without modifying the mesh topology.

void	getCoordinates (const float &xnod, const float &ynod, const float *&znod, int &size_xnod, int &size_ynod, int &size_znod) const
	Get the current coordinates of the nodes of this mesh.

Public Member Functions inherited from PbGrid3D
	PbGrid3D (SbBool is_data_duplicate=TRUE)
	Constructor.

	PbGrid3D (const PbGrid3D &mesh)
	Copy constructor.

	~PbGrid3D ()
	Destructor.

PbGrid3D &	operator= (const PbGrid3D &mesh)
	Assignment operator.

void	setGeometry (int num_x, int num_y, int num_z, const float x, const float y, const float *z)
	Defines a volume mesh geometry.

void	getGeometry (int &num_x, int &num_y, int &num_z, const float &x, const float &y, const float *&z) const
	Gets the mesh geometry.

void	getDim (int &num_x, int &num_y, int &num_z) const
	Gets the dimensions num_x, num_y, num_z of the grid.

virtual void	getNodeOwnerCellsInd (int nod_index, PbArrayOfInt &owner_cells) const
	Gets the list of index of cells that own the node "nod_index".

virtual void	getAdjacentCellsIndByNode (int cell_index, PbArrayOfInt &adjacent_cells) const
	Gets the list of index of cells that are adjacent (by a node) to cell_index.

virtual void	getAdjacentCellsIndByFacet (int cell_index, PbArrayOfInt &adjacent_cells) const
	Gets the list of index of cells that are adjacent (by a facet) to cell_index.

void	getNodeIndices (int nod_index, int &i, int &j, int &k) const
	Calculates indices i,j,k that verify (inum_y + j)num_z + k.

void	getCellIndices (int cell_index, int &i, int &j, int &k) const
	Calculates indices i,j,k that verify cell_index = (i(num_y-1) + j)(num_z-1) + k.

Public Member Functions inherited from PbMesh3D
virtual float	getArea () const
	Returns always 0.

Public Member Functions inherited from PbMesh
	PbMesh (SbBool is_data_duplicated=TRUE)
	Constructor.

	PbMesh (const PbMesh &mesh)
	Copy constructor.

	~PbMesh ()
	Destructor.

PbMesh &	operator= (const PbMesh &mesh)
	Assignment operator.

int	getNumNodes () const
	Gets the number of nodes in the mesh.

int	getNumCells () const
	Gets the number of cells in the mesh.

SbBox3f	getBoundingBox () const
	Gets the bounding box of the mesh.

SbBool	isDataDuplicated () const
	Returns TRUE if mesh's data are duplicated, FALSE otherwise.

virtual void	addValuesSet (int set_index, const float *val, const SbString &set_name="")
	Adds a set of scalar values.

void	addValuesSet (int set_index, const float *val, DataBinding binding, const SbString &set_name="")
	Adds a set of scalar values that can be located either at nodes or at cells.

DataBinding	getValuesBinding (int set_index) const
	Gets the binding of the scalar value set.

virtual void	addStringsSet (int set_index, const SbString *val, const SbString &set_name="")
	Adds a set of string values .

virtual void	addVecsSet (int set_index, const SbVec3f *val, const SbString &set_name="")
	Adds a set of vector values .

virtual const SbString *	getValuesSetName (int set_index) const
	Gets the name associated to a scalar values set.

virtual const SbString *	getStringsSetName (int set_index) const
	Gets the name associated to a string values set.

virtual const SbString *	getVecsSetName (int set_index) const
	Gets the name associated to a vec values set.

virtual const float *	getValuesSet (int set_index) const
	Gets a set of scalar values.

virtual const SbString *	getStringsSet (int set_index) const
	Gets a set of string values.

virtual const SbVec3f *	getVecsSet (int set_index) const
	Gets a set of vector values.

virtual SbBool	removeValuesSet (int set_index)
	Remove a set of scalar values.

virtual SbBool	removeStringsSet (int set_index)
	Remove a set of string values.

virtual SbBool	removeVecsSet (int set_index)
	Remove a set of vector values.

virtual void	removeAllValuesSet ()
	Remove all sets of scalar values.

virtual void	removeAllStringsSet ()
	Remove all sets of strings values.

virtual void	removeAllVecsSet ()
	Remove all sets of vector values.

virtual int	getNumValuesSet () const
	Gets the number of set of scalar values.

virtual int	getNumStringsSet () const
	Gets the number of set of string values.

virtual int	getNumVecsSet () const
	Gets the number of set of vector values.

virtual SbBool	getMinValuesSet (int set_index, float &min) const
	Gets the min of a set of scalars.

virtual SbBool	getMinVecsSet (int set_index, float &min) const
	Gets the min module of a set of vectors.

virtual SbBool	getMaxValuesSet (int set_index, float &max) const
	Gets the max of a set of scalars.

virtual SbBool	getMaxVecsSet (int set_index, float &max) const
	Gets the max module of a set of vectors.

virtual void	getNodesOwnerCellsInd (const PbArrayOfInt &nod_indices, PbArrayOfInt &owner_cells) const
	Gets the list of indices of cells that own the list of nodes "nod_indices".

virtual SbBox3f	getSmallestCellBox (int &cell_index) const
	Gets the smallest cell's bounding box, returns also the index of this cell.

virtual SbBox3f	getBiggestCellBox (int &cell_index) const
	Gets the biggest cell's bounding box, returns also the index of this cell.

Public Member Functions inherited from PbBase
void	enableConnection (SbBool flag)
	Activates/deactivates the mechanism of connection.

SbBool	isConnectionEnabled () const
	Returns TRUE if the connection mechanism is active, otherwise FALSE.

void	touch ()
	Simulates the changing of an instance of this object, so all connected objects are informed of this change.

PbBase &	operator= (const PbBase &base)
	Assignment operator.

Friends
int	operator== (const PbRegularCartesianGrid3D &m1, const PbRegularCartesianGrid3D &m2)
	Equality comparison operator.

int	operator!= (const PbRegularCartesianGrid3D &m1, const PbRegularCartesianGrid3D &m2)
	Inequality comparison operator.

Additional Inherited Members
Public Types inherited from PbMesh
enum	DataBinding { PER_CELL = PoMeshProperty::PER_CELL , PER_NODE = PoMeshProperty::PER_NODE }
	Data binding. More...

Detailed Description

Defines a regular cartesian grid volume mesh.

Class to define a volume mesh represented by a grid, with cartesian coordinates, of which the lines are parallel to X-axis, Y-axis or Z-axis. This mesh is said regular because the gap between 2 consecutive parallel
lines is constant.

The geometry of such a mesh is defined by the 3 dimensions of its grid (num_x, num_y, num_z), and by its bounding box (x_min, y_min, z_min, x_max, y_max, z_max)

The values on the mesh nodes are defined by the PbMesh::addValuesSet(set_index, val) method, where val argument is an array of num_x * num_y * num_z floats.

Definition at line 50 of file PbRegularCartesianGrid3D.h.

Constructor & Destructor Documentation

◆ PbRegularCartesianGrid3D() [1/3]

PbRegularCartesianGrid3D::PbRegularCartesianGrid3D ( SbBool isDataDuplicate = TRUE )

Constructor of a default simple mesh.

See also PbMesh for more explanations about data duplication.

◆ PbRegularCartesianGrid3D() [2/3]

PbRegularCartesianGrid3D::PbRegularCartesianGrid3D ( const PbRegularCartesianGrid3D & mesh )

Copy constructor.

◆ PbRegularCartesianGrid3D() [3/3]

PbRegularCartesianGrid3D::PbRegularCartesianGrid3D	(	int	num_x,
		int	num_y,
		int	num_z,
		float	x_min,
		float	y_min,
		float	z_min,
		float	x_max,
		float	y_max,
		float	z_max,
		SbBool	isDataDuplicate = `TRUE`
	)

Constructor of a 3D regular grid mesh.

See also PbMesh for more explanations about data duplication.

◆ ~PbRegularCartesianGrid3D()

PbRegularCartesianGrid3D::~PbRegularCartesianGrid3D ( )

Destructor.

Member Function Documentation

◆ findContainingCell() [1/2]

virtual const PbCell * PbRegularCartesianGrid3D::findContainingCell	(	const SbVec3f &	point,
		float	tolerance,
		SbVec3f &	pcoord
	)		const

virtual

Find the mesh's cell that contains the point.

If the (optional) adjacent cell is given, searching the containing cell starts by the cells around this adjacent one. Returns also the parametric coordinates of the point in the found cell. Parametric coordinates are the coordinates of the point relative to a topologically equivalent unit cell. A point is inside a cell if its parametric coordinates range from 0 to 1. However we use a test with a tolerance value: a point is inside the cell if its parametric coordinates p verify -tolerance <= p <= 1+tolerance. Parametric coordinates are useful to interpolate the value in the cell (see PbCell::getValue). Attention! This method returns always the same address of an internal private cell. This private cell is updated each time findContainingCell is called. If the cell exists, it returns a PbVoxelCell.

Reimplemented from PbMesh.

◆ findContainingCell() [2/2]

virtual const PbCell * PbRegularCartesianGrid3D::findContainingCell	(	const SbVec3f &	point,
		float	tolerance,
		SbVec3f &	pcoord,
		const PbCell *	adjacent_cell
	)		const

virtual

Reimplemented from PbMesh.

◆ getCell()

virtual const PbCell * PbRegularCartesianGrid3D::getCell ( int cell_index ) const

virtual

Gets the cell which index is cell_index.

Returns NULL if the cell does not exist, otherwise returns always a PbVoxelCell object. Attention! This method returns always the same address of an internal private cell. This private cell is updated each time getCell is called.

Implements PbMesh.

◆ getCoordinates()

void PbRegularCartesianGrid3D::getCoordinates	(	const float *&	xnod,
		const float *&	ynod,
		const float *&	znod,
		int &	size_xnod,
		int &	size_ynod,
		int &	size_znod
	)		const

inlinevirtual

Get the current coordinates of the nodes of this mesh.

Parameters

xnod	array of 2 floats, min and max x coord
ynod	array of 2 floats, min and max y coord
znod	array of 2 floats, min and max z coord
size_xnod	: size of the array xnod = 2
size_ynod	: size of the array ynod = 2
size_znod	: size of the array znod = 2

Reimplemented from PbMesh.

Definition at line 178 of file PbRegularCartesianGrid3D.h.

◆ getGeometry()

void PbRegularCartesianGrid3D::getGeometry	(	int &	num_x,
		int &	num_y,
		int &	num_z,
		float &	x_min,
		float &	y_min,
		float &	z_min,
		float &	x_max,
		float &	y_max,
		float &	z_max
	)		const

inline

Gets the mesh geometry.

Definition at line 234 of file PbRegularCartesianGrid3D.h.

◆ getNodeCoord() [1/2]

virtual SbVec3f PbRegularCartesianGrid3D::getNodeCoord	(	int	i,
		int	j,
		int	k
	)		const

inlinevirtual

Gets the coordinates of a node defined by its i, j, k indices on the grid.

Implements PbGrid3D.

Definition at line 149 of file PbRegularCartesianGrid3D.h.

◆ getNodeCoord() [2/2]

virtual SbVec3f PbRegularCartesianGrid3D::getNodeCoord ( int nod_index ) const

virtual

Gets the coordinates of a node defined by its index.

Implements PbGrid3D.

◆ getVolume()

virtual float PbRegularCartesianGrid3D::getVolume ( ) const

inlinevirtual

Gets the volume of the mesh.

Reimplemented from PbMesh3D.

Definition at line 155 of file PbRegularCartesianGrid3D.h.

◆ operator=()

PbRegularCartesianGrid3D & PbRegularCartesianGrid3D::operator= ( const PbRegularCartesianGrid3D & mesh )

Assignment operator.

◆ setCoordinates()

void PbRegularCartesianGrid3D::setCoordinates	(	const float *	xnod,
		const float *	ynod,
		const float *	znod
	)

virtual

Set new node coordinates without modifying the mesh topology.

For performance reasons, this method should be called instead of setGeometry when doing a mesh deformation animation. It allows to update the coordinates of a existing level surface, skin, cross section etc, without rebuilding them totally.

Parameters

xnod	array of 2 floats, min and max x coord
ynod	array of 2 floats, min and max y coord
znod	array of 2 floats, min and max z coord

Reimplemented from PbMesh.

◆ setGeometry()

void PbRegularCartesianGrid3D::setGeometry	(	int	num_x,
		int	num_y,
		int	num_z,
		float	x_min,
		float	y_min,
		float	z_min,
		float	x_max,
		float	y_max,
		float	z_max
	)

Defines a new geometry.

Friends And Related Symbol Documentation

◆ operator!=

int operator!=	(	const PbRegularCartesianGrid3D &	m1,
		const PbRegularCartesianGrid3D &	m2
	)

friend

Inequality comparison operator.

Definition at line 92 of file PbRegularCartesianGrid3D.h.

◆ operator==

int operator==	(	const PbRegularCartesianGrid3D &	m1,
		const PbRegularCartesianGrid3D &	m2
	)

friend

Equality comparison operator.

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

MeshViz/3Ddata/PbRegularCartesianGrid3D.h

Open Inventor Release 2024.2.1

Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ PbRegularCartesianGrid3D() [1/3]

◆ PbRegularCartesianGrid3D() [2/3]

◆ PbRegularCartesianGrid3D() [3/3]

◆ ~PbRegularCartesianGrid3D()

Member Function Documentation

◆ findContainingCell() [1/2]

◆ findContainingCell() [2/2]

◆ getCell()

◆ getCoordinates()

◆ getGeometry()

◆ getNodeCoord() [1/2]

◆ getNodeCoord() [2/2]

◆ getVolume()

◆ operator=()

◆ setCoordinates()

◆ setGeometry()

Friends And Related Symbol Documentation

◆ operator!=

◆ operator==