geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t > Class Template Reference

Polygonal mesh composed of triangles. More...

#include <geometry.h>

List of all members.

Public Member Functions
void	calc_face_normals ()
	Recalculate per-face normals using normalized dot-products of directions of face edges.
void	calc_vertex_normals ()
	Recalculate per-vertex normals using precalculated face normals with some smoothing.
void	create_index_buffer_and_batches ()
	Generate index buffer, and, in the same time, list of "batches" referencing spans in that index buffer.
Public Attributes
std::vector< vertex_t >	vertices
	list of vertices
std::vector< face_t >	faces
	list of faces
std::vector< index_t >	indices
	list of indices
std::vector< batch_t >	batches
	list of batches of triangles

---

Detailed Description

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t>
class geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >

Polygonal mesh composed of triangles.

Basically, the mesh is collection of following primitives:

• Vertices : Each vertex is characterized by position and normal. Additional per-vertex data can be specified by user via template parameter vertex_userdata_t.
• Faces : Each face is basically triangle referencing 3 vertices in the vertices array. Each face also holds normal vector (unit length, pointing perpendicular to the face), and material. Type of data used to represent material is specified by class user as template paremeter material_t. Additional per-face data can be specified by user via template parameter face_userdata_t.
• Indices : This is array of numeric indices referencing vertices from the vertex array stored in the mesh. This list is then subdivided into "chunks", storing "batches" of triangles all having similar material. (see below).
• Batches : Array of batch_t structures, each one identifying list of triangles (as span of consequtive indices in indices array), and single "material" applied to all these triangles. Batches are good to optimize mesh rendering on 3D accelerated cards. This is template class with template arguments:
• vertex_userdata_t specifies user-defined type of data which will be held together with each geometry vertex (like texture coordinate set). Must be copy-constructable.
• index_t must be numeric type such as unsigned short (for 16-bit indices) or unsigned long (for 32-bit indices).
• material_t is user defined material type. This type must have "==" operator to be defined on it because tri_mesh's method create_batches() must be able to sort the triangles into batches by material. Must be copy-constructable.

---

Member Function Documentation

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> void geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::calc_face_normals (   )  [inline]

Recalculate per-face normals using normalized dot-products of directions of face edges.

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> void geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::calc_vertex_normals (   )  [inline]

Recalculate per-vertex normals using precalculated face normals with some smoothing. Todo: Smart smoothing (angle threshold) is not implemented yet. Without it - sharp angles between polygons (such as in cubes and diamonds) will appear "rounded".

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> void geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::create_index_buffer_and_batches (   )  [inline]

Generate index buffer, and, in the same time, list of "batches" referencing spans in that index buffer. Vertices in the index buffer are sorted by material, so each such "span" is associated with single material.

---

Member Data Documentation

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> std::vector<vertex_t> geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::vertices

list of vertices

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> std::vector<face_t> geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::faces

list of faces

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> std::vector<index_t> geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::indices

list of indices

template<typename vertex_userdata_t, typename face_userdata_t, typename material_t, typename index_t> std::vector<batch_t> geometry::tri_mesh< vertex_userdata_t, face_userdata_t, material_t, index_t >::batches

list of batches of triangles Each batch hold ONLY triangles having similar material

---

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

• geometry.h

---