Stores buffers related to rendering graphical objects. More...

#include <C:/Users/Andres/source/repos/casm_viewer/external/tinc/external/allolib/include/al/graphics/al_Mesh.hpp>

Inheritance diagram for al::Mesh:

Public Types
enum	Primitive : unsigned int { POINTS = GL_POINTS , LINES = GL_LINES , LINE_STRIP = GL_LINE_STRIP , LINE_LOOP = GL_LINE_LOOP , TRIANGLES = GL_TRIANGLES , TRIANGLE_STRIP = GL_TRIANGLE_STRIP , TRIANGLE_FAN = GL_TRIANGLE_FAN , LINES_ADJACENCY = GL_LINES_ADJACENCY , LINE_STRIP_ADJACENCY = GL_LINE_STRIP_ADJACENCY , TRIANGLES_ADJACENCY = GL_TRIANGLES_ADJACENCY , TRIANGLE_STRIP_ADJACENCY = GL_TRIANGLE_STRIP_ADJACENCY }

typedef Vec3f	Vertex

typedef Vec3f	Normal

typedef float	TexCoord1

typedef Vec2f	TexCoord2

typedef Vec3f	TexCoord3

typedef unsigned int	Index

typedef std::vector< Vertex >	Vertices

typedef std::vector< Normal >	Normals

typedef std::vector< Color >	Colors

typedef std::vector< TexCoord1 >	TexCoord1s

typedef std::vector< TexCoord2 >	TexCoord2s

typedef std::vector< TexCoord3 >	TexCoord3s

typedef std::vector< Index >	Indices

Public Member Functions
	Mesh (Primitive p=TRIANGLES)

	Mesh (const Mesh &cpy)

void	copy (Mesh const &m)

void	getBounds (Vec3f &min, Vec3f &max) const
	Get corners of bounding box of vertices. More...

Vec3f	getCenter () const
	Get center of vertices.

void	compress ()
	Generates indices for a set of vertices.

void	decompress ()
	Convert indices (if any) to flat vertex buffers.

void	equalizeBuffers ()
	Extend buffers to match number of vertices. More...

void	merge (const Mesh &src)
	Append buffers from another mesh:

void	toTriangles ()
	Convert triangle strip to triangles.

Mesh &	reset ()
	Reset all buffers.

void	unitize (bool proportional=true)
	Scale all vertices to lie in [-1,1].

Mesh &	scale (float x, float y, float z)
	Scale all vertices.

Mesh &	scale (float s)

template<class T >
Mesh &	scale (const Vec< 3, T > &v)

Mesh &	translate (float x, float y, float z)
	Translate all vertices.

template<class T >
Mesh &	translate (const Vec< 3, T > &v)

template<class T >
Mesh &	translate (const T &v)

template<class T >
Mesh &	transform (const Mat< 4, T > &m, int begin=0, int end=-1)
	Transform vertices by projective transform matrix. More...

void	generateNormals (bool normalize=true, bool equalWeightPerFace=false)
	Generates normals for a set of vertices. More...

void	invertNormals ()
	Invert direction of normals.

void	createNormalsMesh (Mesh &mesh, float length=0.1, bool perFace=false)
	Creates a mesh filled with lines for each normal of the source. More...

void	ribbonize (float width=0.04, bool faceBinormal=false)
	Ribbonize curve. More...

void	ribbonize (float *widths, int widthsStride=1, bool faceBinormal=false)
	Ribbonize curve. More...

void	smooth (float amount=1, int weighting=0)
	Smooths a triangle mesh. More...

Primitive	primitive () const

const std::vector< Vertex > &	vertices () const

const std::vector< Normal > &	normals () const

const std::vector< Color > &	colors () const

const std::vector< TexCoord1 > &	texCoord1s () const

const std::vector< TexCoord2 > &	texCoord2s () const

const std::vector< TexCoord3 > &	texCoord3s () const

const std::vector< Index > &	indices () const

Mesh &	primitive (Primitive p)
	Set geometric primitive.

Mesh &	repeatLast ()
	Repeat last vertex element(s)

void	index (unsigned int i)
	Append index to index buffer.

template<class Tindex >
void	index (const Tindex *buf, int size, Tindex indexOffset=0)
	Append indices to index buffer.

template<class... Indices>
void	index (unsigned i, Indices... indices)

void	color (const Color &v)
	Append color to color buffer.

void	color (const HSV &v)
	Append color to color buffer.

void	color (const RGB &v)
	Append color to color buffer.

void	color (float r, float g, float b, float a=1)
	Append color to color buffer.

template<class T >
void	color (const Vec< 4, T > &v)
	Append color to color buffer.

template<class T >
void	color (const T *src, int numColors)
	Append colors from flat array.

void	normal (float x, float y, float z=0)
	Append normal to normal buffer.

void	normal (const Normal &v)
	Append normal to normal buffer.

template<class T >
void	normal (const Vec< 2, T > &v, float z=0)
	Append normal to normal buffer.

template<class T >
void	normal (const T *src, int numNormals)
	Append normals from flat array.

void	texCoord (float u)
	Append texture coordinate to 1D texture coordinate buffer.

void	texCoord (float u, float v)
	Append texture coordinate to 2D texture coordinate buffer.

template<class T >
void	texCoord (const Vec< 2, T > &v)
	Append texture coordinate to 2D texture coordinate buffer.

void	texCoord (float u, float v, float w)
	Append texture coordinate to 3D texture coordinate buffer.

template<class T >
void	texCoord (const Vec< 3, T > &v)
	Append texture coordinate to 3D texture coordinate buffer.

void	vertex (float x, float y, float z=0)
	Append vertex to vertex buffer.

void	vertex (const Vertex &v)
	Append vertex to vertex buffer.

template<class T >
void	vertex (const Vec< 2, T > &v, float z=0)
	Append vertex to vertex buffer.

template<class T >
void	vertex (const T *src, int numVerts)
	Append vertices from flat array.

template<class T >
void	vertex (const Vec< 3, T > *src, int numVerts)
	Append vertices to vertex buffer.

Vertices &	vertices ()

Normals &	normals ()

Colors &	colors ()

TexCoord1s &	texCoord1s ()

TexCoord2s &	texCoord2s ()

TexCoord3s &	texCoord3s ()

Indices &	indices ()

bool	save (const char filePath, const char solidName="", bool binary=true) const
	Save mesh to file. More...

bool	saveSTL (const char filePath, const char solidName="") const
	Save mesh to an STL file. More...

bool	savePLY (const char filePath, const char solidName="", bool binary=true) const
	Save mesh to a PLY file. More...

void	print (FILE *dst=stderr) const
	Print information about Mesh.

Protected Attributes
Vertices	mVertices

Normals	mNormals

Colors	mColors

TexCoord1s	mTexCoord1s

TexCoord2s	mTexCoord2s

TexCoord3s	mTexCoord3s

Indices	mIndices

Primitive	mPrimitive

Detailed Description

Stores buffers related to rendering graphical objects.

A mesh is a collection of buffers storing vertices, colors, indices, etc. that define the geometry and coloring/shading of a graphical object.

Definition at line 62 of file al_Mesh.hpp.

Constructor & Destructor Documentation

◆ Mesh()

al::Mesh::Mesh ( Primitive p = TRIANGLES )

Parameters

[in] primitive renderer-dependent primitive number

Member Function Documentation

◆ createNormalsMesh()

void al::Mesh::createNormalsMesh	(	Mesh &	mesh,
		float	length = `0.1`,
		bool	perFace = `false`
	)

Creates a mesh filled with lines for each normal of the source.

Parameters

[out]	mesh	normal lines
[in]	length	length of normals
[in]	perFace	whether normals line should be generated per face rather than per vertex

◆ equalizeBuffers()

void al::Mesh::equalizeBuffers ( )

Extend buffers to match number of vertices.

This will resize all populated buffers to match the size of the vertex buffer. Buffers are extended by copying their last element.

◆ generateNormals()

void al::Mesh::generateNormals	(	bool	normalize = `true`,
		bool	equalWeightPerFace = `false`
	)

Generates normals for a set of vertices.

This method will generate a normal for each vertex in the buffer assuming the drawing primitive is either triangles or a triangle strip. Averaged vertex normals are generated if indices are present and, for triangles only, face normals are generated if no indices are present. This will replace any normals currently in use.

Parameters

[in]	normalize	whether to normalize normals
[in]	equalWeightPerFace	whether to use an equal weighting of face normals rather than a weighting based on face areas

◆ getBounds()

void al::Mesh::getBounds	(	Vec3f &	min,
		Vec3f &	max
	)		const

Get corners of bounding box of vertices.

Parameters

[out]	min	minimum corner of bounding box
[out]	max	maximum corner of bounding box

◆ ribbonize() [1/2]

void al::Mesh::ribbonize	(	float *	widths,
		int	widthsStride = `1`,
		bool	faceBinormal = `false`
	)

Ribbonize curve.

This creates a two-dimensional ribbon from a one-dimensional space curve. The result is to be rendered with a triangle strip.

Parameters

[in]	widths	Array specifying width of ribbon at each point along curve
[in]	widthsStride	Stride factor of width array
[in]	faceBinormal	If true, surface faces binormal vector of curve. If false, surface faces normal vector of curve.

◆ ribbonize() [2/2]

void al::Mesh::ribbonize	(	float	width = `0.04`,
		bool	faceBinormal = `false`
	)

inline

Ribbonize curve.

This creates a two-dimensional ribbon from a one-dimensional space curve. The result is to be rendered with a triangle strip.

Parameters

[in]	width	Width of ribbon
[in]	faceBinormal	If true, surface faces binormal vector of curve. If false, surface faces normal vector of curve.

Definition at line 194 of file al_Mesh.hpp.

◆ save()

bool al::Mesh::save	(	const char *	filePath,
		const char *	solidName = `""`,
		bool	binary = `true`
	)		const

Save mesh to file.

Currently supported are STL and PLY files.

Parameters

[in]	filePath	path of file to save to
[in]	solidName	solid name defined within the file (optional)
[in]	binary	write data in binary form as opposed to ASCII

Returns: true on successful save, otherwise false

◆ savePLY()

bool al::Mesh::savePLY	(	const char *	filePath,
		const char *	solidName = `""`,
		bool	binary = `true`
	)		const

Save mesh to a PLY file.

This implementation saves an ASCII (as opposed to binary) PLY file.

Parameters

[in]	filePath	path of file to save to
[in]	solidName	solid name defined within the file (optional)
[in]	binary	write data in binary form as opposed to ASCII

Returns: true on successful save, otherwise false

◆ saveSTL()

bool al::Mesh::saveSTL	(	const char *	filePath,
		const char *	solidName = `""`
	)		const

Save mesh to an STL file.

STL (STereoLithography) is a file format used widely for rapid prototyping. It contains only surface geometry (vertices and normals) as a list of triangular facets. This implementation saves an ASCII (as opposed to binary) STL file.

Parameters

[in]	filePath	path of file to save to
[in]	solidName	solid name defined within the file (optional)

Returns: true on successful save, otherwise false

◆ smooth()

void al::Mesh::smooth	(	float	amount = `1`,
		int	weighting = `0`
	)

Smooths a triangle mesh.

This smooths a triangle mesh using Laplacian (low-pass) filtering. New vertex positions are a weighted sum of their nearest neighbors. The number of vertices is not changed.

Parameters

[in]	amount	interpolation fraction between original and smoothed result
[in]	weighting	0 = equal weight, 1 = inverse distance weight

◆ transform()

template<class T >

Mesh & al::Mesh::transform	(	const Mat< 4, T > &	m,
		int	begin = `0`,
		int	end = `-1`
	)

Transform vertices by projective transform matrix.

Parameters

[in]	m	projective transform matrix
[in]	begin	beginning index of vertices
[in]	end	ending index of vertices, negative amounts specify distance from one past last element

Definition at line 398 of file al_Mesh.hpp.

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

al_Mesh.hpp

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Mesh()

Member Function Documentation

◆ createNormalsMesh()

◆ equalizeBuffers()

◆ generateNormals()

◆ getBounds()

◆ ribbonize() [1/2]

◆ ribbonize() [2/2]

◆ save()

◆ savePLY()

◆ saveSTL()

◆ smooth()

◆ transform()