docs/html/mesh_8h_source.html

 /*

-  This file is part of the MinGfx Project.

-

-  Copyright (c) 2017,2018 Regents of the University of Minnesota.

-  All Rights Reserved.

-

-  Original Author(s) of this File:

-     Dan Keefe, 2018, University of Minnesota

-

-  Author(s) of Significant Updates/Modifications to the File:

-     ...

-  */

-

- #ifndef SRC_MESH_H_

- #define SRC_MESH_H_

-

-

-

- #include "bvh.h"

- #include "color.h"

- #include "opengl_headers.h"

- #include "point2.h"

- #include "point3.h"

- #include "vector3.h"

-

- #include <vector>

-

-

- namespace mingfx {

-

- class Matrix4;

-

- class Mesh {

- public:

-     Mesh();

-

-     Mesh(const Mesh &other);

-

-     virtual ~Mesh();

-

-

-     void LoadFromOBJ(const std::string &filename);

-

-

-

-     // ---- TRIANGLE LIST MODE ----

-     // No indices are stored, each set of 3 vertices forms a triangle, and if the

-     // triangles share vertices, those vertices need to be repeated.

-

-     int AddTriangle(Point3 v1, Point3 v2, Point3 v3);

-

-     void UpdateTriangle(int triangle_id, Point3 v1, Point3 v2, Point3 v3);

-

-     void SetNormals(int triangle_id, Vector3 n1, Vector3 n2, Vector3 n3);

-

-     void SetColors(int triangle_id, Color c1, Color c2, Color c3);

-

-     void SetTexCoords(int triangle_id, int texture_unit, Point2 uv1, Point2 uv2, Point2 uv3);

-

-

-

-     // ---- INDEXED TRIANGLES MODE ----

-     // Vertices are stored in an array and indices are stored in a separate array

-     // each set of 3 indices into the vertex array defines one triangle.  Here,

-     // you cannot add one triangle at a time to the mesh.  Instead you must set

-     // the arrays of indices, vertices, and other attributes for the mesh at

-     // once.

-

-     void SetVertices(const std::vector<Point3> &verts);

-

-     void SetNormals(const std::vector<Vector3> &norms);

-

-     void SetColors(const std::vector<Color> &colors);

-

-     void SetTexCoords(int texture_unit, const std::vector<Point2> &tex_coords);

-

-     void SetIndices(const std::vector<unsigned int> index_array);

-

-

-     void SetInstanceTransforms(const std::vector<Matrix4> &xforms);

-

-

-     // ---- These functions can be used instead of the above if you are working with

-     // regular C-style arrays and floats rather than the higher level types like

-     // Point3 and Vector3. ----

-

-     void SetVertices(float *verts_array, int num_verts);

-

-     void SetNormals(float *norms_array, int num_norms);

-

-     void SetColors(float *colors_array, int num_colors);

-

-     void SetTexCoords(int texture_unit, float *tex_coords_array, int num_tex_coords);

-

-     void SetIndices(unsigned int *index_array, int num_indices);

-

-

-

-     void UpdateGPUMemory();

-

-     void Draw();

-

-

-

-     void CalcPerFaceNormals();

-

-     void CalcPerVertexNormals();

-

-

-     void BuildBVH();

-

-     BVH* bvh_ptr();

-

-     // Access to properties indexed by vertex number

-

-     int num_vertices() const;

-

-     Point3 read_vertex_data(int vertex_id) const;

-

-     Vector3 read_normal_data(int vertex_id) const;

-

-     Color read_color_data(int vertex_id) const;

-

-     Point2 read_tex_coords_data(int texture_unit, int vertex_id) const;

-

-

-     // Access to triangles

-

-     int num_triangles() const;

-

-     // of unsigned ints.  Use the SetIndices() function to set (or edit) the indices for the mesh.

-     std::vector<unsigned int> read_triangle_indices_data(int triangle_id) const;

-

-

- private:

-     std::vector<float> verts_;

-     std::vector<float> norms_;

-     std::vector<float> colors_;

-     std::vector< std::vector<float> > tex_coords_;

-     std::vector<unsigned int> indices_;

-     std::vector<float> instance_xforms_;

-

-     bool gpu_dirty_;

-     GLuint vertex_buffer_;

-     GLuint vertex_array_;

-     GLuint element_buffer_;

-

-     bool bvh_dirty_;

-     BVH bvh_;

- };

-

-

- } // end namespace

-

-

- #endif

-bvh.h

-mingfx::BVH
A Bounding Volume Hierarchy (BVH) data structure that can be used to accelerate ray-object intersecti...
Definition: bvh.h:40

-mingfx::Color
Represents a 4-component (R,G,B,A) color, stored internally in a float array to be compatable with Op...
Definition: color.h:41

-mingfx::Mesh
A triangle mesh data structure that can be rendered with a ShaderProgram like DefaultShader.
Definition: mesh.h:127

-mingfx::Mesh::SetVertices
void SetVertices(float *verts_array, int num_verts)
Sets the vertex array for the mesh directly. Vertices are stored as (x,y,z), (x,y,...

-mingfx::Mesh::SetColors
void SetColors(int triangle_id, Color c1, Color c2, Color c3)
Sets per-vertex colors for the three vertices of a triangle that has already been added to the mesh.

-mingfx::Mesh::read_triangle_indices_data
std::vector< unsigned int > read_triangle_indices_data(int triangle_id) const
Read only access to the indices that make up a particular triangle. Data are returned as a 3-element ...

-mingfx::Mesh::SetTexCoords
void SetTexCoords(int triangle_id, int texture_unit, Point2 uv1, Point2 uv2, Point2 uv3)
Sets the texture coordinates for the three vertices of a triangle that has already been added to the ...

-mingfx::Mesh::CalcPerFaceNormals
void CalcPerFaceNormals()
This (re)calculates the normals for the mesh and stores them with the mesh data structure.

-mingfx::Mesh::SetVertices
void SetVertices(const std::vector< Point3 > &verts)
Sets the vertex array for the mesh directly.

-mingfx::Mesh::SetIndices
void SetIndices(const std::vector< unsigned int > index_array)
Sets the indices into the vertex array to use to create the triangles. Each consecutive set of 3 indi...

-mingfx::Mesh::AddTriangle
int AddTriangle(Point3 v1, Point3 v2, Point3 v3)
Adds a triangle to the mesh datastructure and returns a triangle ID.

-mingfx::Mesh::UpdateTriangle
void UpdateTriangle(int triangle_id, Point3 v1, Point3 v2, Point3 v3)
Updates the vertex positions for a triangle that has already been added to the mesh.

-mingfx::Mesh::read_normal_data
Vector3 read_normal_data(int vertex_id) const
Read only access to per-vertex normal data. Data are returned as a Vector3. Indexed by vertex number....

-mingfx::Mesh::SetNormals
void SetNormals(int triangle_id, Vector3 n1, Vector3 n2, Vector3 n3)
Sets the normals for the three vertices of a triangle that has already been added to the mesh.

-mingfx::Mesh::read_tex_coords_data
Point2 read_tex_coords_data(int texture_unit, int vertex_id) const
Read only access to per-vertex texture coordinates data. Data are returned as a Point2....

-mingfx::Mesh::Mesh
Mesh()
Creates an empty mesh.

-mingfx::Mesh::SetNormals
void SetNormals(float *norms_array, int num_norms)
Sets the normal array for the mesh directly. Normals are stored as (x,y,z), (x,y,z),...

-mingfx::Mesh::SetInstanceTransforms
void SetInstanceTransforms(const std::vector< Matrix4 > &xforms)

-mingfx::Mesh::Draw
void Draw()
This sends the mesh vertices and attributes down the graphics pipe using glDrawArrays() for the non-i...

-mingfx::Mesh::Mesh
Mesh(const Mesh &other)
Copies all data and sets GPU dirty bit for the new mesh.

-mingfx::Mesh::SetIndices
void SetIndices(unsigned int *index_array, int num_indices)
Sets the indices into the vertex array to use to create the triangles. Each consecutive set of 3 indi...

-mingfx::Mesh::LoadFromOBJ
void LoadFromOBJ(const std::string &filename)
This reads a mesh stored in the common Wavefront Obj file format.

-mingfx::Mesh::BuildBVH
void BuildBVH()
This (re)calculates a Bounding Volume Hierarchy for the mesh, which can be used together with Ray::Fa...

-mingfx::Mesh::bvh_ptr
BVH * bvh_ptr()
Returns a pointer to the underlying BVH data structure.

-mingfx::Mesh::num_triangles
int num_triangles() const
The total number of triangles in the mesh.

-mingfx::Mesh::num_vertices
int num_vertices() const
The total number of vertices in the mesh.

-mingfx::Mesh::SetColors
void SetColors(const std::vector< Color > &colors)
Sets the per-vertex colors array for the mesh directly.

-mingfx::Mesh::SetTexCoords
void SetTexCoords(int texture_unit, const std::vector< Point2 > &tex_coords)
Sets a texture coordinates array for the mesh directly.

-mingfx::Mesh::read_color_data
Color read_color_data(int vertex_id) const
Read only access to per-vertex color data. Data are returned as a Color. Indexed by vertex number....

-mingfx::Mesh::UpdateGPUMemory
void UpdateGPUMemory()
This copies the entire mesh data structure to a vertex array in GPU memory, which must happen before ...

-mingfx::Mesh::SetTexCoords
void SetTexCoords(int texture_unit, float *tex_coords_array, int num_tex_coords)
Sets a texture coordinates array for the mesh directly. Tex coords are stored as (u,...

-mingfx::Mesh::CalcPerVertexNormals
void CalcPerVertexNormals()
This (re)calculates the normals for the mesh and stores them with the mesh data structure.

-mingfx::Mesh::~Mesh
virtual ~Mesh()

-mingfx::Mesh::SetNormals
void SetNormals(const std::vector< Vector3 > &norms)
Sets the normal array for the mesh directly.

-mingfx::Mesh::read_vertex_data
Point3 read_vertex_data(int vertex_id) const
Read only access to the vertex position data. Data are returned as a Point3. Indexed by vertex number...

-mingfx::Mesh::SetColors
void SetColors(float *colors_array, int num_colors)
Sets the per-vertex colors array for the mesh directly. Colors are stored as (r,g,...

-mingfx::Point2
A 2D Point with floating point coordinates, used for storing 2D texture coordinates,...
Definition: point2.h:28

-mingfx::Point3
A 3D Point with floating point coordinates, used for storing vertices and all sorts of other 3D graph...
Definition: point3.h:52

-mingfx::Vector3
A 3D Vector with floating point coordinates, used for storing normals and all sorts of other 3D graph...
Definition: vector3.h:62

-color.h

-mingfx
Namespace for the MinGfx Toolkit.
Definition: aabb.h:21

-opengl_headers.h

-point2.h

-point3.h

-vector3.h

-