VCG Library
Static Public Member Functions | List of all members
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: