Classes
struct	MR::MeshRelaxParams

struct	MR::MeshEqualizeTriAreasParams

struct	MR::MeshApproxRelaxParams

Functions
MRMESH_API bool	MR::relax (Mesh &mesh, const MeshRelaxParams &params={}, const ProgressCallback &cb={})

MRMESH_API bool	MR::relax (const MeshTopology &topology, VertCoords &points, const MeshRelaxParams &params={}, const ProgressCallback &cb={})

MRMESH_API Vector3f	MR::vertexPosEqualNeiAreas (const Mesh &mesh, VertId v, bool noShrinkage)

MRMESH_API Vector3f	MR::vertexPosEqualNeiAreas (const MeshTopology &topology, const VertCoords &points, VertId v, bool noShrinkage)

MRMESH_API bool	MR::equalizeTriAreas (Mesh &mesh, const MeshEqualizeTriAreasParams &params={}, const ProgressCallback &cb={})

MRMESH_API bool	MR::equalizeTriAreas (const MeshTopology &topology, VertCoords &points, const MeshEqualizeTriAreasParams &params={}, const ProgressCallback &cb={})

MRMESH_API bool	MR::relaxKeepVolume (Mesh &mesh, const MeshRelaxParams &params={}, const ProgressCallback &cb={})

MRMESH_API bool	MR::relaxKeepVolume (const MeshTopology &topology, VertCoords &points, const MeshRelaxParams &params={}, const ProgressCallback &cb={})

MRMESH_API bool	MR::relaxApprox (Mesh &mesh, const MeshApproxRelaxParams &params={}, const ProgressCallback &cb={})

MRMESH_API bool	MR::relaxApprox (const MeshTopology &topology, VertCoords &points, const MeshApproxRelaxParams &params={}, const ProgressCallback &cb={})

MRMESH_API void	MR::removeSpikes (Mesh &mesh, int maxIterations, float minSumAngle, const VertBitSet *region=nullptr)
	applies at most given number of relaxation iterations the spikes detected by given threshold

MRMESH_API void	MR::removeSpikes (const MeshTopology &topology, VertCoords &points, int maxIterations, float minSumAngle, const VertBitSet *region=nullptr)

MRMESH_API void	MR::smoothRegionBoundary (Mesh &mesh, const FaceBitSet &regionFaces, int numIters=4)

MRMESH_API void	MR::hardSmoothTetrahedrons (Mesh &mesh, const VertBitSet *region=nullptr)
	move all region vertices with exactly three neighbor vertices in the center of the neighbors

MRMESH_API void	MR::hardSmoothTetrahedrons (const MeshTopology &topology, VertCoords &points, const VertBitSet *region=nullptr)

Detailed Description

Function Documentation

◆ equalizeTriAreas() [1/2]

MRMESH_API bool MR::equalizeTriAreas	(	const MeshTopology &	topology,
		VertCoords &	points,
		const MeshEqualizeTriAreasParams &	params = {},
		const ProgressCallback &	cb = {} )

◆ equalizeTriAreas() [2/2]

MRMESH_API bool MR::equalizeTriAreas	(	Mesh &	mesh,
		const MeshEqualizeTriAreasParams &	params = {},
		const ProgressCallback &	cb = {} )

applies given number of iterations with movement toward vertexPosEqualNeiAreas() to the whole mesh ( or some region if it is specified )

Returns: true if the operation completed successfully, and false if it was interrupted by the progress callback.

◆ hardSmoothTetrahedrons() [1/2]

MRMESH_API void MR::hardSmoothTetrahedrons	(	const MeshTopology &	topology,
		VertCoords &	points,
		const VertBitSet *	region = nullptr )

◆ hardSmoothTetrahedrons() [2/2]

MRMESH_API void MR::hardSmoothTetrahedrons	(	Mesh &	mesh,
		const VertBitSet *	region = nullptr )

move all region vertices with exactly three neighbor vertices in the center of the neighbors

◆ relax() [1/2]

MRMESH_API bool MR::relax	(	const MeshTopology &	topology,
		VertCoords &	points,
		const MeshRelaxParams &	params = {},
		const ProgressCallback &	cb = {} )

◆ relax() [2/2]

MRMESH_API bool MR::relax	(	Mesh &	mesh,
		const MeshRelaxParams &	params = {},
		const ProgressCallback &	cb = {} )

applies given number of relaxation iterations to the whole mesh ( or some region if it is specified )

Returns: true if was finished successfully, false if was interrupted by progress callback

◆ relaxApprox() [1/2]

MRMESH_API bool MR::relaxApprox	(	const MeshTopology &	topology,
		VertCoords &	points,
		const MeshApproxRelaxParams &	params = {},
		const ProgressCallback &	cb = {} )

◆ relaxApprox() [2/2]

MRMESH_API bool MR::relaxApprox	(	Mesh &	mesh,
		const MeshApproxRelaxParams &	params = {},
		const ProgressCallback &	cb = {} )

applies given number of relaxation iterations to the whole mesh ( or some region if it is specified ) approx neighborhoods

Returns: true if the operation completed successfully, and false if it was interrupted by the progress callback.

◆ relaxKeepVolume() [1/2]

MRMESH_API bool MR::relaxKeepVolume	(	const MeshTopology &	topology,
		VertCoords &	points,
		const MeshRelaxParams &	params = {},
		const ProgressCallback &	cb = {} )

◆ relaxKeepVolume() [2/2]

MRMESH_API bool MR::relaxKeepVolume	(	Mesh &	mesh,
		const MeshRelaxParams &	params = {},
		const ProgressCallback &	cb = {} )

applies given number of relaxation iterations to the whole mesh ( or some region if it is specified )
do not really keeps volume but tries hard

Returns: true if the operation completed successfully, and false if it was interrupted by the progress callback.

◆ removeSpikes() [1/2]

MRMESH_API void MR::removeSpikes	(	const MeshTopology &	topology,
		VertCoords &	points,
		int	maxIterations,
		float	minSumAngle,
		const VertBitSet *	region = nullptr )

◆ removeSpikes() [2/2]

MRMESH_API void MR::removeSpikes	(	Mesh &	mesh,
		int	maxIterations,
		float	minSumAngle,
		const VertBitSet *	region = nullptr )

applies at most given number of relaxation iterations the spikes detected by given threshold

◆ smoothRegionBoundary()

MRMESH_API void MR::smoothRegionBoundary	(	Mesh &	mesh,
		const FaceBitSet &	regionFaces,
		int	numIters = 4 )

given a region of faces on the mesh, moves boundary vertices of the region to make the region contour much smoother with minor optimization of mesh topology near region boundary;

Parameters

numIters >= 1 how many times to run the algorithm to achieve a better quality, solution is typically oscillates back and forth so even number of iterations is recommended

◆ vertexPosEqualNeiAreas() [1/2]

MRMESH_API Vector3f MR::vertexPosEqualNeiAreas	(	const Mesh &	mesh,
		VertId	v,
		bool	noShrinkage )

nodiscard

computes position of a vertex, when all neighbor triangles have almost equal areas, more precisely it minimizes sum_i (area_i)^2 by adjusting the position of this vertex only

◆ vertexPosEqualNeiAreas() [2/2]

MRMESH_API Vector3f MR::vertexPosEqualNeiAreas	(	const MeshTopology &	topology,
		const VertCoords &	points,
		VertId	v,
		bool	noShrinkage )