The vertices of a mesh. More...

#include <geogram/mesh/mesh.h>

Inheritance diagram for GEO::MeshVertices:

Public Member Functions
	MeshVertices (Mesh &mesh)

void	remove_isolated ()
	Removes the vertices that have no mesh element incident to them.

void	delete_elements (vector< index_t > &to_delete, bool remove_isolated_vertices=true) override
	Deletes a set of elements.

void	permute_elements (vector< index_t > &permutation) override
	Applies a permutation to the elements and their attributes.

index_t	create_vertex ()
	Creates a new vertex.

index_t	create_vertex (const double *coords)
	Creates a new vertex.

template<index_t DIM>
index_t	create_vertex (const vecng< DIM, double > &p)
	Creates a vertex from a 3d point.

index_t	create_vertices (index_t nb)
	Creates a contiguous chunk of vertices.

void	clear (bool keep_attributes=true, bool keep_memory=false) override
	Removes all the elements and attributes.

void	set_single_precision ()
	Sets single precision mode.

void	set_double_precision ()
	Sets double precision mode.

bool	single_precision () const
	Tests whether vertices are stored in single-precision mode.

bool	double_precision () const
	Tests whether vertices are stored in double-precision mode.

index_t	dimension () const
	Gets the dimension of the vertices.

void	set_dimension (index_t dim)
	Sets the dimension of the vertices.

const double *	point_ptr (index_t v) const
	Gets a point.

double *	point_ptr (index_t v)
	Gets a point.

template<index_t DIM = 3>
vecng< DIM, double > &	point (index_t v)
	Gets a point.

template<index_t DIM = 3>
const vecng< DIM, double > &	point (index_t v) const
	Gets a point.

const float *	single_precision_point_ptr (index_t v) const
	Gets a (single-precision) point.

float *	single_precision_point_ptr (index_t v)
	Gets a (single-precision) point.

void	assign_points (vector< double > &points, index_t dim, bool steal_arg)
	Assigns all the points.

void	assign_points (const double *points, index_t dim, index_t nb_pts)
	Assigns all the points.

void	pop () override
	Removes the last element.

template<index_t DIM = 3>
auto	points () const
	Gets the 3D points of the mesh as an iterable sequence.

template<index_t DIM = 3>
auto	points ()
	Gets the 3D points of the mesh as an iterable sequence.

Public Member Functions inherited from GEO::MeshSubElementsStore
	MeshSubElementsStore (Mesh &mesh)
	Constructs a new MeshSubElementStore.

virtual	~MeshSubElementsStore ()
	MeshElementStore destructor.

index_t	nb () const
	Gets the number of (sub-)elements.

AttributesManager &	attributes () const
	Gets the attributes manager.

index_as_iterator	begin () const
	Used by range-based for.

index_as_iterator	end () const
	Used by range-based for.

Protected Member Functions
void	clear_store (bool keep_attributes, bool keep_memory=false) override
	Removes all the elements and attributes.

void	resize_store (index_t new_size) override
	Resizes this MeshSubElementsStore.

void	bind_point_attribute (index_t dim, bool single_precision=false)

void	copy (const MeshVertices &rhs, bool copy_attributes=true)

Protected Member Functions inherited from GEO::MeshSubElementsStore
void	reserve_store (index_t nb_to_reserve)
	Reserves space for new elements.

index_t	create_sub_elements (index_t nb)
	Creates a contiguous chunk of attributes for sub-elements.

index_t	create_sub_element ()
	Creates attributes for a sub-element.

void	adjust_store ()
	Makes the size of the store tightly match the number of the elements.

void	copy (const MeshSubElementsStore &rhs, bool copy_attributes=true)
	Copies a MeshSubElementsStore into this one.

Protected Attributes
MeshEdges &	edges_

MeshFacetCornersStore &	facet_corners_

MeshCellCornersStore &	cell_corners_

Attribute< double >	point_

Attribute< float >	point_fp32_

Protected Attributes inherited from GEO::MeshSubElementsStore
Mesh &	mesh_

AttributesManager	attributes_

index_t	nb_

Friends
class	Mesh

class	GeogramIOHandler

Additional Inherited Members
Static Protected Member Functions inherited from GEO::MeshElements
static bool	has_non_zero (const GEO::vector< index_t > &I)
	Tests whether a vector contains a non-zero value.

Detailed Description

The vertices of a mesh.

Definition at line 331 of file mesh.h.

Member Function Documentation

◆ assign_points() [1/2]

void GEO::MeshVertices::assign_points	(	const double *	points,
		index_t	dim,
		index_t	nb_pts
	)

Assigns all the points.

Parameters

[in]	points	a const pointer to the (`dim` * `nb_pts`) coordinates of al the points
[in]	dim	the dimension of the points, i.e. number of coordinates per point
[in]	nb_pts	number of points

◆ assign_points() [2/2]

void GEO::MeshVertices::assign_points	(	vector< double > &	points,
		index_t	dim,
		bool	steal_arg
	)

Assigns all the points.

Parameters

[in]	points	a vector that contains all the coordinates of the points
[in]	dim	the dimension of the points, i.e. number of coordinates per point
[in]	steal_arg	if true, memory is stolen from `points`, using std::vector::swap (no memory copy).

◆ clear()

void GEO::MeshVertices::clear	(	bool	keep_attributes = `true`,
		bool	keep_memory = `false`
	)

overridevirtual

Removes all the elements and attributes.

Parameters

[in]	keep_attributes	if true, then all the existing attribute names / bindings are kept (but they are cleared). If false, they are destroyed.
[in]	keep_memory	if true, then memory is kept and can be reused by subsequent mesh element creations.

Implements GEO::MeshElements.

◆ clear_store()

void GEO::MeshVertices::clear_store	(	bool	keep_attributes,
		bool	keep_memory = `false`
	)

overrideprotectedvirtual

Removes all the elements and attributes.

Parameters

[in]	keep_attributes	if true, then all the existing attribute names / bindings are kept (but they are cleared). If false, they are destroyed.
[in]	keep_memory	if true, then memory is kept and can be reused by subsequent mesh element creations.

Reimplemented from GEO::MeshSubElementsStore.

◆ copy()

void GEO::MeshVertices::copy	(	const MeshVertices &	rhs,
		bool	copy_attributes = `true`
	)

inlineprotected

Definition at line 630 of file mesh.h.

◆ create_vertex() [1/3]

index_t GEO::MeshVertices::create_vertex ( )

inline

Creates a new vertex.

Returns: the index of the created vertex

Definition at line 353 of file mesh.h.

◆ create_vertex() [2/3]

index_t GEO::MeshVertices::create_vertex ( const double * coords )

inline

Creates a new vertex.

Parameters

[in] coords a pointer to dimension() coordinates

Returns: the index of the created vertex

Definition at line 362 of file mesh.h.

◆ create_vertex() [3/3]

template<index_t DIM>

index_t GEO::MeshVertices::create_vertex ( const vecng< DIM, double > & p )

inline

Creates a vertex from a 3d point.

Parameters

[in] p a const reference to the 3d point

Returns: the index of the created vertex

Precondition: dimension() == 3

Definition at line 385 of file mesh.h.

◆ create_vertices()

index_t GEO::MeshVertices::create_vertices ( index_t nb )

inline

Creates a contiguous chunk of vertices.

Parameters

[in] nb number of sub-elements to create

Returns: the index of the first created vertex

Definition at line 397 of file mesh.h.

◆ delete_elements()

void GEO::MeshVertices::delete_elements	(	vector< index_t > &	to_delete,
		bool	remove_isolated_vertices = `true`
	)

overridevirtual

Deletes a set of elements.

Parameters

[in]	to_delete	a vector of size nb(). If to_delete[e] is different from 0, then element e will be destroyed, else it will be kept. On exit, to_delete is modified (it is used for internal bookkeeping).
[in]	remove_isolated_vertices	if true, then the vertices that are no longer incident to any element are deleted.

Implements GEO::MeshElements.

◆ dimension()

index_t GEO::MeshVertices::dimension ( ) const

inline

Gets the dimension of the vertices.

Returns: the number of coordinates in each vertex

Definition at line 449 of file mesh.h.

◆ double_precision()

bool GEO::MeshVertices::double_precision ( ) const

inline

Tests whether vertices are stored in double-precision mode.

Double precision mode is the default. Single-precision mode is used for instance by Vorpaview, to make it more memory efficient.

Definition at line 441 of file mesh.h.

◆ permute_elements()

void GEO::MeshVertices::permute_elements ( vector< index_t > & permutation )

overridevirtual

Applies a permutation to the elements and their attributes.

On exit, permutation is modified (used for internal bookkeeping). Applying a permutation permutation is equivalent to:

for(i=0; i<permutation.size(); i++) {
   data2[i] = data[permutation[i]]
}
data = data2 ;

Implements GEO::MeshElements.

◆ point() [1/2]

template<index_t DIM = 3>

vecng< DIM, double > & GEO::MeshVertices::point ( index_t v )

inline

Gets a point.

Parameters

[in] v the vertex, in 0..nb()-1

Returns: a modifiable reference to the point that corresponds to the vertex

Precondition: !single_precision()

Definition at line 504 of file mesh.h.

◆ point() [2/2]

template<index_t DIM = 3>

const vecng< DIM, double > & GEO::MeshVertices::point ( index_t v ) const

inline

Gets a point.

Parameters

[in] v the vertex, in 0..nb()-1

Returns: a const reference to the point that corresponds to the vertex

Precondition: !single_precision()

Definition at line 520 of file mesh.h.

◆ point_ptr() [1/2]

double * GEO::MeshVertices::point_ptr ( index_t v )

inline

Gets a point.

Parameters

[in] v the vertex, in 0..nb()-1

Returns: a pointer to the coordinates of the point that correspond to the vertex

Precondition: !single_precision()

Definition at line 490 of file mesh.h.

◆ point_ptr() [2/2]

const double * GEO::MeshVertices::point_ptr ( index_t v ) const

inline

Gets a point.

Parameters

[in] v the index of the vertex

Returns: a const pointer to the coordinates of the point that correspond to the vertex

Precondition: !single_precision()

Definition at line 477 of file mesh.h.

◆ points() [1/2]

template<index_t DIM = 3>

auto GEO::MeshVertices::points ( )

inline

Gets the 3D points of the mesh as an iterable sequence.

Each point is returned as a modifiable reference

Definition at line 606 of file mesh.h.

◆ points() [2/2]

template<index_t DIM = 3>

auto GEO::MeshVertices::points ( ) const

inline

Gets the 3D points of the mesh as an iterable sequence.

Each point is returned as a const reference

Definition at line 590 of file mesh.h.

◆ pop()

void GEO::MeshVertices::pop ( )

overridevirtual

Removes the last element.

Implements GEO::MeshElements.

◆ resize_store()

void GEO::MeshVertices::resize_store ( index_t new_size )

overrideprotectedvirtual

Resizes this MeshSubElementsStore.

On exit, nb() == new_size, elements are created or destroyed if needed.

Parameters

[in] new_size the desired size

Reimplemented from GEO::MeshSubElementsStore.

◆ set_dimension()

void GEO::MeshVertices::set_dimension ( index_t dim )

inline

Sets the dimension of the vertices.

Existing coordinates are kept, newly created coordinates are initialized to zero.

Parameters

[in] dim new dimension

Definition at line 462 of file mesh.h.

◆ set_double_precision()

void GEO::MeshVertices::set_double_precision ( )

Sets double precision mode.

Double precision mode is the default. Single-precision mode is used for instance by Vorpaview, to make it more memory efficient. Existing point coordinates are copied and converted to double precision.

◆ set_single_precision()

void GEO::MeshVertices::set_single_precision ( )

Sets single precision mode.

Single-precision mode is used for instance by Vorpaview, to make it more memory efficient. Existing point coordinates are copied and converted to single precision.

◆ single_precision()

bool GEO::MeshVertices::single_precision ( ) const

inline

Tests whether vertices are stored in single-precision mode.

Single-precision mode is used for instance by Vorpaview, to make it more memory efficient.

Definition at line 430 of file mesh.h.

◆ single_precision_point_ptr() [1/2]

float * GEO::MeshVertices::single_precision_point_ptr ( index_t v )

inline

Gets a (single-precision) point.

Parameters

[in] v the index of the vertex

Returns: a pointer to the coordinates of the point that corresponds to the vertex

Precondition: single_precision()

Definition at line 551 of file mesh.h.

◆ single_precision_point_ptr() [2/2]

const float * GEO::MeshVertices::single_precision_point_ptr ( index_t v ) const

inline

Gets a (single-precision) point.

Parameters

[in] v the index of the vertex

Returns: a const pointer to the coordinates of the point that corresponds to the vertex

Precondition: single_precision()

Definition at line 538 of file mesh.h.

Friends And Related Symbol Documentation

◆ GeogramIOHandler

friend class GeogramIOHandler

friend

Definition at line 680 of file mesh.h.

◆ Mesh

friend class Mesh

friend

Definition at line 679 of file mesh.h.

Member Data Documentation

◆ cell_corners_

MeshCellCornersStore& GEO::MeshVertices::cell_corners_

protected

Definition at line 675 of file mesh.h.

◆ edges_

MeshEdges& GEO::MeshVertices::edges_

protected

Definition at line 673 of file mesh.h.

◆ facet_corners_

MeshFacetCornersStore& GEO::MeshVertices::facet_corners_

protected

Definition at line 674 of file mesh.h.

◆ point_

Attribute<double> GEO::MeshVertices::point_

protected

Definition at line 676 of file mesh.h.

◆ point_fp32_

Attribute<float> GEO::MeshVertices::point_fp32_

protected

Definition at line 677 of file mesh.h.

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

geogram/mesh/mesh.h

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ assign_points() [1/2]

◆ assign_points() [2/2]

◆ clear()

◆ clear_store()

◆ copy()

◆ create_vertex() [1/3]

◆ create_vertex() [2/3]

◆ create_vertex() [3/3]

◆ create_vertices()

◆ delete_elements()

◆ dimension()

◆ double_precision()

◆ permute_elements()

◆ point() [1/2]

◆ point() [2/2]

◆ point_ptr() [1/2]

◆ point_ptr() [2/2]

◆ points() [1/2]

◆ points() [2/2]

◆ pop()

◆ resize_store()

◆ set_dimension()

◆ set_double_precision()

◆ set_single_precision()

◆ single_precision()

◆ single_precision_point_ptr() [1/2]

◆ single_precision_point_ptr() [2/2]

Friends And Related Symbol Documentation

◆ GeogramIOHandler

◆ Mesh

Member Data Documentation

◆ cell_corners_

◆ edges_

◆ facet_corners_

◆ point_

◆ point_fp32_