MR::FastWindingNumber Class Reference

#include <MRFastWindingNumber.h>

Inheritance diagram for MR::FastWindingNumber:

Public Member Functions
MRMESH_API	FastWindingNumber (const Mesh &mesh)
MRMESH_API void	calcFromVector (std::vector< float > &res, const std::vector< Vector3f > &points, float beta, FaceId skipFace={}) override
	calculates winding numbers in the points from given vector
MRMESH_API bool	calcSelfIntersections (FaceBitSet &res, float beta, ProgressCallback cb) override
	calculates winding numbers for all centers of mesh's triangles. if winding number is less than 0 or greater then 1, that face is marked as self-intersected
MRMESH_API Expected< void >	calcFromGrid (std::vector< float > &res, const Vector3i &dims, const AffineXf3f &gridToMeshXf, float beta, ProgressCallback cb) override
	calculates winding numbers in each point from a three-dimensional grid
MRMESH_API float	calcWithDistances (const Vector3f &p, float windingNumberThreshold, float beta, float maxDistSq, float minDistSq)
MRMESH_API Expected< void >	calcFromGridWithDistances (std::vector< float > &res, const Vector3i &dims, const AffineXf3f &gridToMeshXf, float windingNumberThreshold, float beta, float maxDistSq, float minDistSq, ProgressCallback cb) override
	calculates distances with the sign obtained from winding number in each point from a three-dimensional grid
Public Member Functions inherited from MR::IFastWindingNumber
virtual	~IFastWindingNumber ()=default

Detailed Description

the class for fast approximate computation of winding number for a mesh (using its AABB tree)

Note, this used to be [[nodiscard]], but GCC 12 doesn't understand both [[...]] and __attribute__(...) on the same class. A possible fix is to change MRMESH_CLASS globally to [[__gnu__::__visibility__("default")]].

Constructor & Destructor Documentation

FastWindingNumber()

MRMESH_API MR::FastWindingNumber::FastWindingNumber ( const Mesh & mesh )

nodiscard

constructs this from AABB tree of given mesh; this remains valid only if tree is valid

Member Function Documentation

calcFromGrid()

MRMESH_API Expected< void > MR::FastWindingNumber::calcFromGrid ( std::vector< float > & res, const Vector3i & dims, const AffineXf3f & gridToMeshXf, float beta, ProgressCallback cb )

overridevirtual

calculates winding numbers in each point from a three-dimensional grid

Parameters

res	resulting winding numbers, will be resized automatically
dims	dimensions of the grid
gridToMeshXf	transform from integer grid locations to voxel's centers in mesh reference frame
beta	determines the precision of the approximation: the more the better, recommended value 2 or more

Implements MR::IFastWindingNumber.

calcFromGridWithDistances()

MRMESH_API Expected< void > MR::FastWindingNumber::calcFromGridWithDistances ( std::vector< float > & res, const Vector3i & dims, const AffineXf3f & gridToMeshXf, float windingNumberThreshold, float beta, float maxDistSq, float minDistSq, ProgressCallback cb )

overridevirtual

calculates distances with the sign obtained from winding number in each point from a three-dimensional grid

Parameters

res	resulting signed distances, will be resized automatically
dims	dimensions of the grid
gridToMeshXf	transform from integer grid locations to voxel's centers in mesh reference frame
windingNumberThreshold	positive distance if winding number below or equal this threshold
beta	determines the precision of the approximation: the more the better, recommended value 2 or more

Implements MR::IFastWindingNumber.

calcFromVector()

MRMESH_API void MR::FastWindingNumber::calcFromVector ( std::vector< float > & res, const std::vector< Vector3f > & points, float beta, FaceId skipFace = {} )

overridevirtual

calculates winding numbers in the points from given vector

Parameters

res	resulting winding numbers, will be resized automatically
points	incoming points
beta	determines the precision of the approximation: the more the better, recommended value 2 or more
skipFace	this triangle (if it is close to q) will be skipped from summation

Implements MR::IFastWindingNumber.

calcSelfIntersections()

MRMESH_API bool MR::FastWindingNumber::calcSelfIntersections ( FaceBitSet & res, float beta, ProgressCallback cb )

overridevirtual

calculates winding numbers for all centers of mesh's triangles. if winding number is less than 0 or greater then 1, that face is marked as self-intersected

Parameters

res	resulting bit set
beta	determines the precision of the approximation: the more the better, recommended value 2 or more

Returns

false if the operation was canceled by the user

Implements MR::IFastWindingNumber.

calcWithDistances()

MRMESH_API float MR::FastWindingNumber::calcWithDistances	(	const Vector3f &	p,
		float	windingNumberThreshold,
		float	beta,
		float	maxDistSq,
		float	minDistSq )

---

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

• MRFastWindingNumber.h