#include <Core/Geometry/deprecated/TopologicalMesh.hpp>

Inherits OpenMesh::PolyMesh_ArrayKernelT< TopologicalMeshTraits >.

Collaboration diagram for Ra::Core::Geometry::deprecated::TopologicalMesh:

Public Member Functions
template<typename NonManifoldFaceCommand >
EIGEN_MAKE_ALIGNED_OPERATOR_NEW	TopologicalMesh (const Ra::Core::Geometry::TriangleMesh &triMesh, NonManifoldFaceCommand command)

	TopologicalMesh (const Ra::Core::Geometry::TriangleMesh &triMesh)
	Convenience constructor. More...

	TopologicalMesh ()

TriangleMesh	toTriangleMesh ()

void	updateTriangleMesh (Ra::Core::Geometry::TriangleMesh &mesh)

HalfedgeHandle	halfedge_handle (VertexHandle vh, FaceHandle fh) const

const Normal &	normal (VertexHandle vh, FaceHandle fh) const

void	set_normal (VertexHandle vh, FaceHandle fh, const Normal &n)

void	propagate_normal_to_halfedges (VertexHandle vh)

const OpenMesh::HPropHandleT< Index > &	getInputTriangleMeshIndexPropHandle () const

const OpenMesh::HPropHandleT< Index > &	getOutputTriangleMeshIndexPropHandle () const

template<typename NonManifoldFaceCommand >
	TopologicalMesh (const TriangleMesh &triMesh, NonManifoldFaceCommand command)

template<typename MeshIndex >
	TopologicalMesh (const Ra::Core::Geometry::IndexedGeometry< MeshIndex > &mesh)

Const access to handles of the HalfEdge properties coming from
the TriangleMesh attributes.
const std::vector< OpenMesh::HPropHandleT< Scalar > > &	getFloatPropsHandles () const

const std::vector< OpenMesh::HPropHandleT< Vector2 > > &	getVector2PropsHandles () const

const std::vector< OpenMesh::HPropHandleT< Vector3 > > &	getVector3PropsHandles () const

const std::vector< OpenMesh::HPropHandleT< Vector4 > > &	getVector4PropsHandles () const

Dealing with normals
Utils to deal with normals when modifying the mesh topology.
void	createNormalPropOnFaces (OpenMesh::FPropHandleT< Normal > &fProp)

void	clearProp (OpenMesh::FPropHandleT< Normal > &fProp)

void	copyNormal (HalfedgeHandle input_heh, HalfedgeHandle copy_heh)

void	copyNormalFromFace (FaceHandle fh, HalfedgeHandle heh, OpenMesh::FPropHandleT< Normal > fProp)

void	interpolateNormal (HalfedgeHandle in_a, HalfedgeHandle in_b, HalfedgeHandle out, Scalar f)

void	interpolateNormalOnFaces (FaceHandle fh, OpenMesh::FPropHandleT< Normal > fProp)

Dealing with custom properties
Utils to deal with custom properties of any type when modifying the mesh topology.
template<typename T >
void	createPropsOnFaces (const std::vector< OpenMesh::HPropHandleT< T >> &input, std::vector< OpenMesh::FPropHandleT< T >> &output)

template<typename T >
void	clearProps (std::vector< OpenMesh::FPropHandleT< T >> &props)

template<typename T >
void	copyProps (HalfedgeHandle input_heh, HalfedgeHandle copy_heh, const std::vector< OpenMesh::HPropHandleT< T >> &props)

template<typename T >
void	copyPropsFromFace (FaceHandle fh, HalfedgeHandle heh, const std::vector< OpenMesh::FPropHandleT< T >> &fProps, const std::vector< OpenMesh::HPropHandleT< T >> &hProps)

template<typename T >
void	interpolateProps (HalfedgeHandle in_a, HalfedgeHandle in_b, HalfedgeHandle out, Scalar f, const std::vector< OpenMesh::HPropHandleT< T >> &props)

template<typename T >
void	interpolatePropsOnFaces (FaceHandle fh, const std::vector< OpenMesh::HPropHandleT< T >> &hProps, const std::vector< OpenMesh::FPropHandleT< T >> &fProps)

Deal with all attributes* Utils to deal with the normal and
custom properties when modifying the mesh topology.
void	createAllPropsOnFaces (OpenMesh::FPropHandleT< Normal > &normalProp, std::vector< OpenMesh::FPropHandleT< Scalar >> &floatProps, std::vector< OpenMesh::FPropHandleT< Vector2 >> &vec2Props, std::vector< OpenMesh::FPropHandleT< Vector3 >> &vec3Props, std::vector< OpenMesh::FPropHandleT< Vector4 >> &vec4Props)

void	clearAllProps (OpenMesh::FPropHandleT< Normal > &normalProp, std::vector< OpenMesh::FPropHandleT< Scalar >> &floatProps, std::vector< OpenMesh::FPropHandleT< Vector2 >> &vec2Props, std::vector< OpenMesh::FPropHandleT< Vector3 >> &vec3Props, std::vector< OpenMesh::FPropHandleT< Vector4 >> &vec4Props)

void	copyAllProps (HalfedgeHandle input_heh, HalfedgeHandle copy_heh)

void	copyAllPropsFromFace (FaceHandle fh, HalfedgeHandle heh, OpenMesh::FPropHandleT< Normal > normalProp, std::vector< OpenMesh::FPropHandleT< Scalar >> &floatProps, std::vector< OpenMesh::FPropHandleT< Vector2 >> &vec2Props, std::vector< OpenMesh::FPropHandleT< Vector3 >> &vec3Props, std::vector< OpenMesh::FPropHandleT< Vector4 >> &vec4Props)

void	interpolateAllProps (HalfedgeHandle in_a, HalfedgeHandle in_b, HalfedgeHandle out, Scalar f)

void	interpolateAllPropsOnFaces (FaceHandle fh, OpenMesh::FPropHandleT< Normal > normalProp, std::vector< OpenMesh::FPropHandleT< Scalar >> &floatProps, std::vector< OpenMesh::FPropHandleT< Vector2 >> &vec2Props, std::vector< OpenMesh::FPropHandleT< Vector3 >> &vec3Props, std::vector< OpenMesh::FPropHandleT< Vector4 >> &vec4Props)

Topological operations
bool	splitEdge (TopologicalMesh::EdgeHandle eh, Scalar f)

bool	splitEdgeWedge (TopologicalMesh::EdgeHandle eh, Scalar f)

Friends
class	TMOperations

Detailed Description

This class represents a mesh with topological information on the vertex graph, using a half-edge representation.

This integration is inspired by: https://gist.github.com/Unril/03fa353d0461ed6bd41d

Todo:

rename methods to respect Radium guideline (get/set/is, camelCase)

private inheritance from OpenMesh, and import relevant methods.

Definition at line 56 of file TopologicalMesh.hpp.

Constructor & Destructor Documentation

◆ TopologicalMesh() [1/3]

template<typename NonManifoldFaceCommand >

EIGEN_MAKE_ALIGNED_OPERATOR_NEW Ra::Core::Geometry::deprecated::TopologicalMesh::TopologicalMesh	(	const Ra::Core::Geometry::TriangleMesh &	triMesh,
		NonManifoldFaceCommand	command
	)

explicit

Construct a topological mesh from a triangle mesh. This operation merges vertex with same position, but keeps vertex attributes on halfedges, so that TriangleMesh vertices with the same 3D position are represented only once in the topological mesh.

Note: This is a costly operation.

Template Parameters

NonManifoldFaceCommand

Command executed when non-manifold faces are found. API and default implementation:

struct DefaultNonManifoldFaceCommand {
    DefaultNonManifoldFaceCommand( const std::string& details = {} ) : m_details { details } {}
    inline void initialize( const TriangleMesh& /*triMesh*/ ) {}
    inline void process( const std::vector<TopologicalMesh::VertexHandle>& /*face_vhandles*/ ) {
        LOG( logWARNING ) << "Invalid face handle returned : face not added " + m_details;
    }
    inline void postProcess( TopologicalMesh& /*tm*/ ) {}

◆ TopologicalMesh() [2/3]

Ra::Core::Geometry::deprecated::TopologicalMesh::TopologicalMesh ( const Ra::Core::Geometry::TriangleMesh & triMesh )

explicit

Convenience constructor.

See also: TopologicalMesh( const Ra::Core::Geometry::TriangleMesh&, NonManifoldFaceCommand)

Definition at line 76 of file TopologicalMesh.cpp.

◆ TopologicalMesh() [3/3]

Ra::Core::Geometry::deprecated::TopologicalMesh::TopologicalMesh ( )

explicit

Construct an empty topological mesh, only init mandatory properties.

Definition at line 79 of file TopologicalMesh.cpp.

Member Function Documentation

◆ clearAllProps()

void Ra::Core::Geometry::deprecated::TopologicalMesh::clearAllProps	(	OpenMesh::FPropHandleT< Normal > &	normalProp,
		std::vector< OpenMesh::FPropHandleT< Scalar >> &	floatProps,
		std::vector< OpenMesh::FPropHandleT< Vector2 >> &	vec2Props,
		std::vector< OpenMesh::FPropHandleT< Vector3 >> &	vec3Props,
		std::vector< OpenMesh::FPropHandleT< Vector4 >> &	vec4Props
	)

inline

Remove all the given properties from mesh.

Note: Invalidates normalProp and clears the given property containers.

Definition at line 761 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ clearProp()

void Ra::Core::Geometry::deprecated::TopologicalMesh::clearProp ( OpenMesh::FPropHandleT< Normal > & fProp )

inline

Remove face property prop from mesh.

Note: Invalidates the property handle.

Definition at line 608 of file TopologicalMesh.hpp.

◆ clearProps()

template<typename T >

void Ra::Core::Geometry::deprecated::TopologicalMesh::clearProps ( std::vector< OpenMesh::FPropHandleT< T >> & props )

Remove props from mesh.

Note: Clears props.

Definition at line 676 of file TopologicalMesh.hpp.

◆ copyAllProps()

void Ra::Core::Geometry::deprecated::TopologicalMesh::copyAllProps	(	HalfedgeHandle	input_heh,
		HalfedgeHandle	copy_heh
	)

inline

Copy all properties from input_heh to copy_heh.

Definition at line 773 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ copyAllPropsFromFace()

void Ra::Core::Geometry::deprecated::TopologicalMesh::copyAllPropsFromFace	(	FaceHandle	fh,
		HalfedgeHandle	heh,
		OpenMesh::FPropHandleT< Normal >	normalProp,
		std::vector< OpenMesh::FPropHandleT< Scalar >> &	floatProps,
		std::vector< OpenMesh::FPropHandleT< Vector2 >> &	vec2Props,
		std::vector< OpenMesh::FPropHandleT< Vector3 >> &	vec3Props,
		std::vector< OpenMesh::FPropHandleT< Vector4 >> &	vec4Props
	)

inline

Copy all given face properties from fh to heh.

Note: Each property must have been previously created either all at once through createAllPropsOnFaces(), or individually through createNormalPropOnFaces() and createPropsOnFaces().

Definition at line 782 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ copyNormal()

void Ra::Core::Geometry::deprecated::TopologicalMesh::copyNormal	(	HalfedgeHandle	input_heh,
		HalfedgeHandle	copy_heh
	)

inline

Copy the normal property from input_heh to copy_heh.

Definition at line 612 of file TopologicalMesh.hpp.

◆ copyNormalFromFace()

void Ra::Core::Geometry::deprecated::TopologicalMesh::copyNormalFromFace	(	FaceHandle	fh,
		HalfedgeHandle	heh,
		OpenMesh::FPropHandleT< Normal >	fProp
	)

inline

Copy the face normal property fProp from fh to heh.

Note: fProp must have been previously created through createNormalPropOnFaces().

Definition at line 621 of file TopologicalMesh.hpp.

◆ copyProps()

template<typename T >

void Ra::Core::Geometry::deprecated::TopologicalMesh::copyProps	(	HalfedgeHandle	input_heh,
		HalfedgeHandle	copy_heh,
		const std::vector< OpenMesh::HPropHandleT< T >> &	props
	)

Copy props properties from input_heh to copy_heh.

Definition at line 684 of file TopologicalMesh.hpp.

◆ copyPropsFromFace()

template<typename T >

void Ra::Core::Geometry::deprecated::TopologicalMesh::copyPropsFromFace	(	FaceHandle	fh,
		HalfedgeHandle	heh,
		const std::vector< OpenMesh::FPropHandleT< T >> &	fProps,
		const std::vector< OpenMesh::HPropHandleT< T >> &	hProps
	)

Copy face properties props from fh to heh.

Note: fProps must have been previously created through createPropsOnFaces().

Definition at line 693 of file TopologicalMesh.hpp.

◆ createAllPropsOnFaces()

void Ra::Core::Geometry::deprecated::TopologicalMesh::createAllPropsOnFaces	(	OpenMesh::FPropHandleT< Normal > &	normalProp,
		std::vector< OpenMesh::FPropHandleT< Scalar >> &	floatProps,
		std::vector< OpenMesh::FPropHandleT< Vector2 >> &	vec2Props,
		std::vector< OpenMesh::FPropHandleT< Vector3 >> &	vec3Props,
		std::vector< OpenMesh::FPropHandleT< Vector4 >> &	vec4Props
	)

inline

Create a new property for each property of mesh on faces. Outputs the new face properties handles in the corresponding output parameters.

Note: These new properties will have to be propagated onto the newly created halfedges with copyAllProps().

Definition at line 748 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ createNormalPropOnFaces()

void Ra::Core::Geometry::deprecated::TopologicalMesh::createNormalPropOnFaces ( OpenMesh::FPropHandleT< Normal > & fProp )

inline

Create a new property for normals on faces of mesh.

Note: This new property will have to be propagated onto the newly created halfedges with copyNormal().

Definition at line 599 of file TopologicalMesh.hpp.

◆ createPropsOnFaces()

template<typename T >

void Ra::Core::Geometry::deprecated::TopologicalMesh::createPropsOnFaces	(	const std::vector< OpenMesh::HPropHandleT< T >> &	input,
		std::vector< OpenMesh::FPropHandleT< T >> &	output
	)

Create a new property for each input properties of mesh on faces.

Note: This new property will have to be propagated onto the newly created halfedges with copyProps().

Definition at line 665 of file TopologicalMesh.hpp.

◆ getInputTriangleMeshIndexPropHandle()

const OpenMesh::HPropHandleT< TopologicalMesh::Index > & Ra::Core::Geometry::deprecated::TopologicalMesh::getInputTriangleMeshIndexPropHandle ( ) const

inline

Return a handle to the halfedge property storing vertices indices within the TriangleMesh *this has been built on.

Definition at line 570 of file TopologicalMesh.hpp.

◆ getOutputTriangleMeshIndexPropHandle()

const OpenMesh::HPropHandleT< TopologicalMesh::Index > & Ra::Core::Geometry::deprecated::TopologicalMesh::getOutputTriangleMeshIndexPropHandle ( ) const

inline

Return a handle to the halfedge property storing vertices indices within the TriangleMesh returned by toTriangleMesh().

Note: This property is valid only after toTriangleMesh() has been called.

Definition at line 575 of file TopologicalMesh.hpp.

◆ halfedge_handle()

TopologicalMesh::HalfedgeHandle Ra::Core::Geometry::deprecated::TopologicalMesh::halfedge_handle	(	VertexHandle	vh,
		FaceHandle	fh
	)		const

inline

Return the half-edge associated with a given vertex and face.

Note: Asserts if vh is not a member of fh.

Definition at line 560 of file TopologicalMesh.hpp.

◆ interpolateAllProps()

void Ra::Core::Geometry::deprecated::TopologicalMesh::interpolateAllProps	(	HalfedgeHandle	in_a,
		HalfedgeHandle	in_b,
		HalfedgeHandle	out,
		Scalar	f
	)

inline

Interpolate all properties on edge center (after edge split).

Definition at line 796 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ interpolateAllPropsOnFaces()

void Ra::Core::Geometry::deprecated::TopologicalMesh::interpolateAllPropsOnFaces	(	FaceHandle	fh,
		OpenMesh::FPropHandleT< Normal >	normalProp,
		std::vector< OpenMesh::FPropHandleT< Scalar >> &	floatProps,
		std::vector< OpenMesh::FPropHandleT< Vector2 >> &	vec2Props,
		std::vector< OpenMesh::FPropHandleT< Vector3 >> &	vec3Props,
		std::vector< OpenMesh::FPropHandleT< Vector4 >> &	vec4Props
	)

inline

Interpolate hprops on face center.

Note: Each property must have been previously created either all at once through createAllPropsOnFaces(), or individually through createNormalPropOnFaces() and createPropsOnFaces().

Definition at line 807 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ interpolateNormal()

void Ra::Core::Geometry::deprecated::TopologicalMesh::interpolateNormal	(	HalfedgeHandle	in_a,
		HalfedgeHandle	in_b,
		HalfedgeHandle	out,
		Scalar	f
	)

inline

Interpolate normal property on edge center (after edge split).

Definition at line 632 of file TopologicalMesh.hpp.

◆ interpolateNormalOnFaces()

void Ra::Core::Geometry::deprecated::TopologicalMesh::interpolateNormalOnFaces	(	FaceHandle	fh,
		OpenMesh::FPropHandleT< Normal >	fProp
	)

inline

Interpolate normal property on face center.

Note: fProp must have been previously created through createNormalPropOnFaces().

Definition at line 641 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ interpolateProps()

template<typename T >

void Ra::Core::Geometry::deprecated::TopologicalMesh::interpolateProps	(	HalfedgeHandle	in_a,
		HalfedgeHandle	in_b,
		HalfedgeHandle	out,
		Scalar	f,
		const std::vector< OpenMesh::HPropHandleT< T >> &	props
	)

Interpolate props on edge center (after edge split).

Definition at line 705 of file TopologicalMesh.hpp.

◆ interpolatePropsOnFaces()

template<typename T >

void Ra::Core::Geometry::deprecated::TopologicalMesh::interpolatePropsOnFaces	(	FaceHandle	fh,
		const std::vector< OpenMesh::HPropHandleT< T >> &	hProps,
		const std::vector< OpenMesh::FPropHandleT< T >> &	fProps
	)

Interpolate hprops on face center.

Note: fProps must have been previously created through createPropsOnFaces().

Definition at line 717 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ normal()

const TopologicalMesh::Normal & Ra::Core::Geometry::deprecated::TopologicalMesh::normal	(	VertexHandle	vh,
		FaceHandle	fh
	)		const

inline

Get normal of the vertex vh, when member of fh.

Note: Asserts if vh is not a member of fh.

Definition at line 530 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ propagate_normal_to_halfedges()

void Ra::Core::Geometry::deprecated::TopologicalMesh::propagate_normal_to_halfedges ( VertexHandle vh )

inline

Set the normal n to all the halfedges that points to vh (i.e. incomming halfedges) . If you work with vertex normals, please call this function on all vertex handles before convertion with toTriangleMesh.

Definition at line 550 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ set_normal()

void Ra::Core::Geometry::deprecated::TopologicalMesh::set_normal	(	VertexHandle	vh,
		FaceHandle	fh,
		const Normal &	n
	)

inline

Set normal of the vertex vh, when member of fh.

Note: Asserts if vh is not a member of fh.

Definition at line 541 of file TopologicalMesh.hpp.

Here is the call graph for this function:

◆ splitEdge()

bool Ra::Core::Geometry::deprecated::TopologicalMesh::splitEdge	(	TopologicalMesh::EdgeHandle	eh,
		Scalar	f
	)

Apply a 2-4 edge split.

Parameters

eh	The handle to the edge to split.
f	The interpolation factor to place the new point on the edge. Must be in [0,1].

Returns: True if the edge has been split, false otherwise.

Note: Only applies on edges between 2 triangles, and if f is in [0,1].; Mesh attributes are linearly interpolated on the newly created halfedge.; f=0 correspond to halfedge_handle( eh, 0 ) (i.e. first vertex of the edge)

Definition at line 197 of file TopologicalMesh.cpp.

Here is the call graph for this function:

◆ toTriangleMesh()

TriangleMesh Ra::Core::Geometry::deprecated::TopologicalMesh::toTriangleMesh ( )

Return a triangleMesh from the topological mesh.

Note: This is a costly operation.

Definition at line 83 of file TopologicalMesh.cpp.

Here is the call graph for this function:

◆ updateTriangleMesh()

void Ra::Core::Geometry::deprecated::TopologicalMesh::updateTriangleMesh ( Ra::Core::Geometry::TriangleMesh & mesh )

Update triangle mesh data, assuming the mesh and this topo mesh has the same topology.

Warning: note implemented yet.

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

/home/runner/work/Radium-Engine/Radium-Engine/src/Radium-Engine/src/Core/Geometry/deprecated/TopologicalMesh.hpp
/home/runner/work/Radium-Engine/Radium-Engine/src/Radium-Engine/src/Core/Geometry/deprecated/TopologicalMesh.cpp

Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ TopologicalMesh() [1/3]

◆ TopologicalMesh() [2/3]

◆ TopologicalMesh() [3/3]

Member Function Documentation

◆ clearAllProps()

◆ clearProp()

◆ clearProps()

◆ copyAllProps()

◆ copyAllPropsFromFace()

◆ copyNormal()

◆ copyNormalFromFace()

◆ copyProps()

◆ copyPropsFromFace()

◆ createAllPropsOnFaces()

◆ createNormalPropOnFaces()

◆ createPropsOnFaces()

◆ getInputTriangleMeshIndexPropHandle()

◆ getOutputTriangleMeshIndexPropHandle()

◆ halfedge_handle()

◆ interpolateAllProps()

◆ interpolateAllPropsOnFaces()

◆ interpolateNormal()

◆ interpolateNormalOnFaces()

◆ interpolateProps()

◆ interpolatePropsOnFaces()

◆ normal()

◆ propagate_normal_to_halfedges()

◆ set_normal()

◆ splitEdge()

◆ toTriangleMesh()

◆ updateTriangleMesh()