vcg::tri::UpdateNormal< ComputeMeshType > Class Template Reference

Management, updating and computation of per-vertex, per-face, and per-wedge normals. More...

#include <vcg/complex/algorithms/update/normal.h>

Static Public Member Functions
static void	PerVertexClear (ComputeMeshType &m, bool ClearAllVertNormal=false)
	Set to zero all the PerVertex normals.
static void	PerVertex (ComputeMeshType &m)
	Calculates the vertex normal as the classic area weighted average. It does not need or exploit current face normals.
static void	PerVertexAngleWeighted (ComputeMeshType &m)
	Calculates the vertex normal as an angle weighted average. It does not need or exploit current face normals.
static void	PerVertexNelsonMaxWeighted (ComputeMeshType &m)
	Calculates the vertex normal using the Max et al. weighting scheme. It does not need or exploit current face normals.
static void	PerFace (ComputeMeshType &m)
	Calculates the face normal.
static void	PerPolygonalFace (ComputeMeshType &m)
	computePerPolygonalFace computes the normal of each polygonal face.
static void	PerVertexFromCurrentFaceNormal (ComputeMeshType &m)
	Calculates the vertex normal by averaging the current per-face normals.
static void	PerFaceFromCurrentVertexNormal (ComputeMeshType &m)
	Calculates the face normal by averaging the current per-vertex normals.
static void	NormalizePerVertex (ComputeMeshType &m)
	Normalize the length of the vertex normals.
static void	NormalizePerFace (ComputeMeshType &m)
	Normalize the length of the face normals.
static void	NormalizePerFaceByArea (ComputeMeshType &m)
	Set the length of the face normals to their area (without recomputing their directions).
static void	PerVertexNormalized (ComputeMeshType &m)
	Equivalent to PerVertex() and NormalizePerVertex()
static void	PerFaceNormalized (ComputeMeshType &m)
	Equivalent to PerFace() and NormalizePerFace()
static void	PerPolygonalFaceNormalized (ComputeMeshType &m)
	Equivalent to PerPolygonalFace() and NormalizePerFace()
static void	PerVertexPerFace (ComputeMeshType &m)
	Equivalent to PerVertex() and PerFace().
static void	PerVertexNormalizedPerFace (ComputeMeshType &m)
	Equivalent to PerVertexNormalized() and PerFace().
static void	PerVertexNormalizedPerFaceNormalized (ComputeMeshType &m)
	Equivalent to PerVertexNormalizedPerFace() and NormalizePerFace().
static void	PerBitQuadFaceNormalized (ComputeMeshType &m)
	Exploit bitquads to compute a per-polygon face normal.
static void	PerBitPolygonFaceNormalized (ComputeMeshType &m)
	Exploit bitquads to compute a per-polygon face normal.
static void	PerVertexMatrix (ComputeMeshType &m, const Matrix44< ScalarType > &mat, bool remove_scaling=true)
	Multiply the vertex normals by the matrix passed. By default, the scale component is removed.
static void	PerFaceMatrix (ComputeMeshType &m, const Matrix44< ScalarType > &mat, bool remove_scaling=true)
	Multiply the face normals by the matrix passed. By default, the scale component is removed.
static void	PerWedgeCrease (ComputeMeshType &m, ScalarType angleRad)
	Compute per wedge normals taking into account the angle between adjacent faces.

Detailed Description

template<class ComputeMeshType>
class vcg::tri::UpdateNormal< ComputeMeshType >

Management, updating and computation of per-vertex, per-face, and per-wedge normals.

This class is used to compute or to update the normals that can be stored in the various component of a mesh. A number of different algorithms for computing per vertex normals are present.

It must be included after complex.h

Definition at line 45 of file normal.h.

Member Function Documentation

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::NormalizePerFace ( ComputeMeshType &  m )

inlinestatic

Normalize the length of the face normals.

Definition at line 243 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::NormalizePerFaceByArea ( ComputeMeshType &  m )

inlinestatic

Set the length of the face normals to their area (without recomputing their directions).

Definition at line 251 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::NormalizePerVertex ( ComputeMeshType &  m )

inlinestatic

Normalize the length of the vertex normals.

Definition at line 234 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerBitPolygonFaceNormalized ( ComputeMeshType &  m )

inlinestatic

Exploit bitquads to compute a per-polygon face normal.

Definition at line 320 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerBitQuadFaceNormalized ( ComputeMeshType &  m )

inlinestatic

Exploit bitquads to compute a per-polygon face normal.

Definition at line 305 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerFace ( ComputeMeshType &  m )

inlinestatic

Calculates the face normal.

Not normalized. Use PerFaceNormalized() or call NormalizePerVertex() if you need unit length per face normals.

Definition at line 166 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerFaceFromCurrentVertexNormal ( ComputeMeshType &  m )

inlinestatic

Calculates the face normal by averaging the current per-vertex normals.

The normal of a face f is the average of the normals of the vertices of f.

Definition at line 217 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerFaceMatrix ( ComputeMeshType &  m, const Matrix44< ScalarType > &  mat, bool  remove_scaling = true  )

inlinestatic

Multiply the face normals by the matrix passed. By default, the scale component is removed.

Definition at line 365 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerFaceNormalized ( ComputeMeshType &  m )

inlinestatic

Equivalent to PerFace() and NormalizePerFace()

Definition at line 271 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerPolygonalFace ( ComputeMeshType &  m )

inlinestatic

computePerPolygonalFace computes the normal of each polygonal face.

Not normalized. Use PerPolygonalFaceNormalized() or call NormalizePerFace() if you need unit length per face normals.

Definition at line 178 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerPolygonalFaceNormalized ( ComputeMeshType &  m )

inlinestatic

Equivalent to PerPolygonalFace() and NormalizePerFace()

Definition at line 278 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertex ( ComputeMeshType &  m )

inlinestatic

Calculates the vertex normal as the classic area weighted average. It does not need or exploit current face normals.

The normal of a vertex v is the classical area-weigthed average of the normals of the faces incident on v.

Definition at line 86 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexAngleWeighted ( ComputeMeshType &  m )

inlinestatic

Calculates the vertex normal as an angle weighted average. It does not need or exploit current face normals.

The normal of a vertex v computed as a weighted sum f the incident face normals. The weight is simlply the angle of the involved wedge. Described in:

G. Thurmer, C. A. Wuthrich "Computing vertex normals from polygonal facets" Journal of Graphics Tools, 1998

Definition at line 119 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexClear ( ComputeMeshType &  m, bool  ClearAllVertNormal = false  )

inlinestatic

Set to zero all the PerVertex normals.

Set to zero all the PerVertex normals. Used by all the face averaging algorithms. by default it does not clear the normals of unreferenced vertices because they could be still useful

Definition at line 64 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexFromCurrentFaceNormal ( ComputeMeshType &  m )

inlinestatic

Calculates the vertex normal by averaging the current per-face normals.

The normal of a vertex v is the average of the un-normalized normals of the faces incident on v.

Definition at line 194 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexMatrix ( ComputeMeshType &  m, const Matrix44< ScalarType > &  mat, bool  remove_scaling = true  )

inlinestatic

Multiply the vertex normals by the matrix passed. By default, the scale component is removed.

Definition at line 343 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexNelsonMaxWeighted ( ComputeMeshType &  m )

inlinestatic

Calculates the vertex normal using the Max et al. weighting scheme. It does not need or exploit current face normals.

The normal of a vertex v is computed according to the formula described by Nelson Max in Max, N., "Weights for Computing Vertex Normals from Facet Normals", Journal of Graphics Tools, 4(2) (1999)

The weight for each wedge is the cross product of the two edge over the product of the square of the two edge lengths. According to the original paper it is perfect only for spherical surface, but it should perform well...

Definition at line 145 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexNormalized ( ComputeMeshType &  m )

inlinestatic

Equivalent to PerVertex() and NormalizePerVertex()

Definition at line 264 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexNormalizedPerFace ( ComputeMeshType &  m )

inlinestatic

Equivalent to PerVertexNormalized() and PerFace().

Definition at line 291 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexNormalizedPerFaceNormalized ( ComputeMeshType &  m )

inlinestatic

Equivalent to PerVertexNormalizedPerFace() and NormalizePerFace().

Definition at line 298 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerVertexPerFace ( ComputeMeshType &  m )

inlinestatic

Equivalent to PerVertex() and PerFace().

Definition at line 284 of file normal.h.

template<class ComputeMeshType >

static void vcg::tri::UpdateNormal< ComputeMeshType >::PerWedgeCrease ( ComputeMeshType &  m, ScalarType  angleRad  )

inlinestatic

Compute per wedge normals taking into account the angle between adjacent faces.

The PerWedge normals are averaged on common vertexes only if the angle between two faces is larger than angleRad. It requires FFAdjacency.

Definition at line 390 of file normal.h.

---

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

• normal.h