MRMeshNormals.h File Reference

#include <MRCMisc/common.h>
#include <MRCMisc/exports.h>
#include <stddef.h>

Go to the source code of this file.

Typedefs
typedef struct MR_FaceNormals	MR_FaceNormals
typedef struct MR_Mesh	MR_Mesh
typedef struct MR_UndirectedEdgeBitSet	MR_UndirectedEdgeBitSet
typedef struct MR_Vector4f	MR_Vector4f
typedef struct MR_Vector_std_array_MR_Vector3f_3_MR_FaceId	MR_Vector_std_array_MR_Vector3f_3_MR_FaceId
typedef struct MR_VertCoords	MR_VertCoords
typedef struct MR_MeshNormals	MR_MeshNormals

Functions
MRC_API const MR_FaceNormals *	MR_MeshNormals_Get_faceNormals (const MR_MeshNormals *_this)
MRC_API void	MR_MeshNormals_Set_faceNormals (MR_MeshNormals *_this, MR_PassBy value_pass_by, MR_FaceNormals *value)
MRC_API MR_FaceNormals *	MR_MeshNormals_GetMutable_faceNormals (MR_MeshNormals *_this)
MRC_API const MR_VertCoords *	MR_MeshNormals_Get_vertNormals (const MR_MeshNormals *_this)
MRC_API void	MR_MeshNormals_Set_vertNormals (MR_MeshNormals *_this, MR_PassBy value_pass_by, MR_VertCoords *value)
MRC_API MR_VertCoords *	MR_MeshNormals_GetMutable_vertNormals (MR_MeshNormals *_this)
MRC_API MR_MeshNormals *	MR_MeshNormals_DefaultConstruct (void)
MRC_API MR_MeshNormals *	MR_MeshNormals_DefaultConstructArray (size_t num_elems)
MRC_API MR_MeshNormals *	MR_MeshNormals_ConstructFrom (MR_PassBy faceNormals_pass_by, MR_FaceNormals *faceNormals, MR_PassBy vertNormals_pass_by, MR_VertCoords *vertNormals)
MRC_API const MR_MeshNormals *	MR_MeshNormals_OffsetPtr (const MR_MeshNormals *ptr, ptrdiff_t i)
MRC_API MR_MeshNormals *	MR_MeshNormals_OffsetMutablePtr (MR_MeshNormals *ptr, ptrdiff_t i)
MRC_API MR_MeshNormals *	MR_MeshNormals_ConstructFromAnother (MR_PassBy _other_pass_by, MR_MeshNormals *_other)
MRC_API void	MR_MeshNormals_Destroy (const MR_MeshNormals *_this)
	Destroys a heap-allocated instance of MR_MeshNormals. Does nothing if the pointer is null.
MRC_API void	MR_MeshNormals_DestroyArray (const MR_MeshNormals *_this)
	Destroys a heap-allocated array of MR_MeshNormals. Does nothing if the pointer is null.
MRC_API MR_MeshNormals *	MR_MeshNormals_AssignFromAnother (MR_MeshNormals *_this, MR_PassBy _other_pass_by, MR_MeshNormals *_other)
MRC_API MR_FaceNormals *	MR_computePerFaceNormals (const MR_Mesh *mesh)
MRC_API void	MR_computePerFaceNormals4 (const MR_Mesh *mesh, MR_Vector4f *faceNormals, MR_uint64_t size)
MRC_API MR_VertCoords *	MR_computePerVertNormals (const MR_Mesh *mesh)
MRC_API MR_VertCoords *	MR_computePerVertPseudoNormals (const MR_Mesh *mesh)
MRC_API MR_MeshNormals *	MR_computeMeshNormals (const MR_Mesh *mesh)
MRC_API MR_Vector_std_array_MR_Vector3f_3_MR_FaceId *	MR_computePerCornerNormals (const MR_Mesh *mesh, const MR_UndirectedEdgeBitSet *creases)

Typedef Documentation

MR_FaceNormals

typedef struct MR_FaceNormals MR_FaceNormals

MR_Mesh

typedef struct MR_Mesh MR_Mesh

MR_MeshNormals

typedef struct MR_MeshNormals MR_MeshNormals

Generated from class MR::MeshNormals. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).

MR_UndirectedEdgeBitSet

typedef struct MR_UndirectedEdgeBitSet MR_UndirectedEdgeBitSet

MR_Vector4f

typedef struct MR_Vector4f MR_Vector4f

MR_Vector_std_array_MR_Vector3f_3_MR_FaceId

typedef struct MR_Vector_std_array_MR_Vector3f_3_MR_FaceId MR_Vector_std_array_MR_Vector3f_3_MR_FaceId

MR_VertCoords

typedef struct MR_VertCoords MR_VertCoords

Function Documentation

MR_computeMeshNormals()

MRC_API MR_MeshNormals * MR_computeMeshNormals

(

const MR_Mesh *

mesh

)

computes both per-face and per-vertex normals more efficiently then just calling both previous functions Generated from function MR::computeMeshNormals. Parameter mesh can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_MeshNormals_Destroy() to free it when you're done using it.

MR_computePerCornerNormals()

MRC_API MR_Vector_std_array_MR_Vector3f_3_MR_FaceId * MR_computePerCornerNormals	(	const MR_Mesh *	mesh,
		const MR_UndirectedEdgeBitSet *	creases )

returns a vector with corner normals in every element for valid mesh faces; corner normals of adjacent triangles are equal, unless they are separated by crease edges Generated from function MR::computePerCornerNormals. Parameter mesh can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_Vector_std_array_MR_Vector3f_3_MR_FaceId_Destroy() to free it when you're done using it.

MR_computePerFaceNormals()

MRC_API MR_FaceNormals * MR_computePerFaceNormals

(

const MR_Mesh *

mesh

)

returns a vector with face-normal in every element for valid mesh faces Generated from function MR::computePerFaceNormals. Parameter mesh can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_FaceNormals_Destroy() to free it when you're done using it.

MR_computePerFaceNormals4()

MRC_API void MR_computePerFaceNormals4	(	const MR_Mesh *	mesh,
		MR_Vector4f *	faceNormals,
		MR_uint64_t	size )

fills buffer with face-normals as Vector4f for valid mesh faces Generated from function MR::computePerFaceNormals4. Parameter mesh can not be null. It is a single object.

MR_computePerVertNormals()

MRC_API MR_VertCoords * MR_computePerVertNormals

(

const MR_Mesh *

mesh

)

returns a vector with vertex normals in every element for valid mesh vertices Generated from function MR::computePerVertNormals. Parameter mesh can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_VertCoords_Destroy() to free it when you're done using it.

MR_computePerVertPseudoNormals()

MRC_API MR_VertCoords * MR_computePerVertPseudoNormals

(

const MR_Mesh *

mesh

)

returns a vector with vertex pseudonormals in every element for valid mesh vertices see http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.107.9173&rep=rep1&type=pdf Generated from function MR::computePerVertPseudoNormals. Parameter mesh can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_VertCoords_Destroy() to free it when you're done using it.

MR_MeshNormals_AssignFromAnother()

MRC_API MR_MeshNormals * MR_MeshNormals_AssignFromAnother	(	MR_MeshNormals *	_this,
		MR_PassBy	_other_pass_by,
		MR_MeshNormals *	_other )

Generated from method MR::MeshNormals::operator=. Parameter _this can not be null. It is a single object. The reference to things referred to by the parameter _other (if any) might be preserved in this object. The returned pointer will never be null. It is non-owning, do NOT destroy it. When this function is called, this object will drop any object references it had previously.

MR_MeshNormals_ConstructFrom()

MRC_API MR_MeshNormals * MR_MeshNormals_ConstructFrom	(	MR_PassBy	faceNormals_pass_by,
		MR_FaceNormals *	faceNormals,
		MR_PassBy	vertNormals_pass_by,
		MR_VertCoords *	vertNormals )

Constructs MR::MeshNormals elementwise. The reference to the parameter faceNormals might be preserved in the constructed object. The reference to the parameter vertNormals might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_MeshNormals_Destroy() to free it when you're done using it. When this function is called, this object will drop any object references it had previously.

MR_MeshNormals_ConstructFromAnother()

MRC_API MR_MeshNormals * MR_MeshNormals_ConstructFromAnother	(	MR_PassBy	_other_pass_by,
		MR_MeshNormals *	_other )

Generated from constructor MR::MeshNormals::MeshNormals. The reference to things referred to by the parameter _other (if any) might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_MeshNormals_Destroy() to free it when you're done using it.

MR_MeshNormals_DefaultConstruct()

MRC_API MR_MeshNormals * MR_MeshNormals_DefaultConstruct

(

void

)

Constructs an empty (default-constructed) instance. Never returns null. Returns an instance allocated on the heap! Must call MR_MeshNormals_Destroy() to free it when you're done using it.

MR_MeshNormals_DefaultConstructArray()

MRC_API MR_MeshNormals * MR_MeshNormals_DefaultConstructArray

(

size_t

num_elems

)

Constructs an array of empty (default-constructed) instances, of the specified size. Will never return null. The array must be destroyed using MR_MeshNormals_DestroyArray(). Use MR_MeshNormals_OffsetMutablePtr() and MR_MeshNormals_OffsetPtr() to access the array elements.

MR_MeshNormals_Destroy()

MRC_API void MR_MeshNormals_Destroy

(

const MR_MeshNormals *

_this

)

Destroys a heap-allocated instance of MR_MeshNormals. Does nothing if the pointer is null.

MR_MeshNormals_DestroyArray()

MRC_API void MR_MeshNormals_DestroyArray

(

const MR_MeshNormals *

_this

)

Destroys a heap-allocated array of MR_MeshNormals. Does nothing if the pointer is null.

MR_MeshNormals_Get_faceNormals()

MRC_API const MR_FaceNormals * MR_MeshNormals_Get_faceNormals

(

const MR_MeshNormals *

_this

)

Returns a pointer to a member variable of class MR::MeshNormals named faceNormals. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it.

MR_MeshNormals_Get_vertNormals()

MRC_API const MR_VertCoords * MR_MeshNormals_Get_vertNormals

(

const MR_MeshNormals *

_this

)

Returns a pointer to a member variable of class MR::MeshNormals named vertNormals. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it.

MR_MeshNormals_GetMutable_faceNormals()

MRC_API MR_FaceNormals * MR_MeshNormals_GetMutable_faceNormals

(

MR_MeshNormals *

_this

)

Returns a mutable pointer to a member variable of class MR::MeshNormals named faceNormals. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it.

MR_MeshNormals_GetMutable_vertNormals()

MRC_API MR_VertCoords * MR_MeshNormals_GetMutable_vertNormals

(

MR_MeshNormals *

_this

)

Returns a mutable pointer to a member variable of class MR::MeshNormals named vertNormals. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it.

MR_MeshNormals_OffsetMutablePtr()

MRC_API MR_MeshNormals * MR_MeshNormals_OffsetMutablePtr	(	MR_MeshNormals *	ptr,
		ptrdiff_t	i )

Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element. The reference to the parameter ptr might be preserved in the return value.

MR_MeshNormals_OffsetPtr()

MRC_API const MR_MeshNormals * MR_MeshNormals_OffsetPtr	(	const MR_MeshNormals *	ptr,
		ptrdiff_t	i )

Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element. The reference to the parameter ptr might be preserved in the return value.

MR_MeshNormals_Set_faceNormals()

MRC_API void MR_MeshNormals_Set_faceNormals	(	MR_MeshNormals *	_this,
		MR_PassBy	value_pass_by,
		MR_FaceNormals *	value )

Modifies a member variable of class MR::MeshNormals named faceNormals. Parameter _this can not be null. It is a single object. The reference to the parameter value might be preserved in this object in element faceNormals. When this function is called, this object will drop object references it had previously in faceNormals.

MR_MeshNormals_Set_vertNormals()

MRC_API void MR_MeshNormals_Set_vertNormals	(	MR_MeshNormals *	_this,
		MR_PassBy	value_pass_by,
		MR_VertCoords *	value )

Modifies a member variable of class MR::MeshNormals named vertNormals. Parameter _this can not be null. It is a single object. The reference to the parameter value might be preserved in this object in element vertNormals. When this function is called, this object will drop object references it had previously in vertNormals.