Basic Concepts

Let's start

We can first declare a new Triangle Mesh and load a ply file:

#include <vclib/meshes.h>
#include <vclib/load_save.h>
 
vcl::TriMesh myTriMesh;
 
vcl::load(myTriMesh, "bunny.ply");

Or:

vcl::TriMesh myTriMesh = vcl::load<vcl::TriMesh>("bunny.ply");

The TriMesh data structure has containers of Vertices and Faces, plus some other info like Bounding Box, Transform Matrix, ...

We can, for example, print some statistics and update the bounding box component of the mesh after has been loaded:

#include <vclib/algorithms.h>
 
vcl::updateBoundingBox(myTriMesh);
 
std::cout << "Min bb: " << myTriMesh.boundingBox().min() << "; "
          << "Max bb: " << myTriMesh.boundingBox().max() << "\n";
std::cout << "Vertex number: " << myTriMesh.vertexNumber() "; "
          << "Face number: "<< myTriMesh.faceNumber() "\n";

We can iterate over Vertices and over Faces of the mesh:

// compute barycenter of the Mesh
 
vcl::Point3d bar;
bar.setZero();
 
for (const vcl::TriMesh::Vertex& v : myTriMesh.vertices()) {
    bar += v.coord();
}
bar /= myTriMesh.vertexNumber();
 
// print all the faces id with all vertices with y > barycenter.y()
 
for (const vcl::TriMesh::Face& f : myTriMesh.faces()) {
    bool up = true;
    for (const vcl::TriMesh::Vertex* v : f.vertices()) { // iterate over verts of f
        if (v->coord().y() < bar.y())
            up = false;
    }
    if (up) {
        std::cout << myTriMesh.index(f) << " is above the y barycenter\n";
    }
}

Note that iterating over the vertices of the faces of the Mesh returns the vertices/faces/elements objects by reference, while iterating over the vertices of the face (or, in general, adjacencies of a specific element) returns the pointer to an element that is stored inside the same Mesh. Note also that this pointer may be nullptr: in this small example we assume that the mesh is consistent meaning that this cannot happen.

Add, set and delete Elements

We can create from scratch a mesh:

vcl::TriMesh mesh;
 
mesh.addVertex(vcl::Point3d(0,0,0)); // add a vertex with pos 0,0,0
mesh.addVertices(2); // add another two vertices to the mesh
mesh.vertex(1).coord() = vcl::Point3d(1,0,0);
mesh.vertex(2).coord() = vcl::Point3d(0,1,0);
 
vcl::Point3d p0, p1, p2, p3, p4;
 
// add other 5 vertices to the mesh:
mesh.addVertices(p0, p1, p2, p3, p4);
 
// add a face
mesh.addFace(0, 1, 2);
 
// add another face but initialize vertices later:
uint fid = mesh.addFace(); // each add returns an id telling the first added element
mesh.face(fid).setVertices(&mesh.vertex(2), &mesh.vertex(1), &mesh.vertex(3));