Vega FEM Library (v1.1) User's Manual - University of Southern ...

Writes to *numVertices and *numTriangles the number of vertices and triangles in the mesh, and writes
to *vertices and *triangles pointers to newly-allocated (malloc) arrays of the three coordinates of each
vertex and the three vertex indices of each triangle, respectively.
virtual int GetClosestVertex(Vec3d & queryPos, double * distance=NULL,
double * auxVertexBuffer = NULL)
Returns the index of the mesh vertex closest to the specified query location. The auxVertexBuffer option
is only need for derived classes; you may pass NULL when using GetClosestVertex with SceneObject. To
find the nearest vertex in a mesh that has been deformed, you need to use the SceneObjectDeformable
subclass.
int SetUpTextures(LightingModulationType lightingModulation, MipmapType mipmap)
Initializes any textures specified by the .obj file, and enables texture rendering. Calling this function
is mandatory for texture mapping to work. Must be called after OpenGL has been initialized. The
lightingModulation parameter selects either MODULATE or REPLACE for the texture blend mode, and the
mipmap parameter selects either USEMIPMAP or NOMIPMAP for whether to use mip-mapping. Returns 0 iff
successful.
bool hasTextures()
After SetUpTextures has been called, returns whether the model has textures.
void EnableTextures()
void DisableTextures()
Enables or disables textures for rendering. Does not check whether textures have been set up.
void BuildFaceNormals()
Calculates the normals of the mesh faces.
void BuildNeighboringStructure()
Must be called before any of the three vertex normal methods below. Creates a data structure to optimize
finding neighboring faces of mesh vertices.
void BuildVertexNormals(double thresholdAngle=85.0)
Must be called after BuildNeighboringStructure. Calculates smooth normals for each vertex by averaging
the face normals of each incident triangle. The thresholdAngle parameter preserves sharp angles in
the mesh; for a given vertex, if a triangle incident to it has angle greater than thresholdAngle between its
normal and the normal of the first triangle incident to the vertex, then this triangle does not contribute to
or use the smooth normal at the vertex.
void BuildNormals(double thresholdAngle=85.0)
Must be called after BuildNeighboringStructure. Builds face and vertex normals for the mesh.
void BuildNormalsFancy(double thresholdAngle=85.0)
Must be called after BuildNeighboringStructure. Sets mesh normals, handling sharp edges in a more
precise way.
void ShowPointLabels(int k, int l)
Renders vertex indices alongside the vertices of indices k through l. These values are zero-indexed, but
they are written as one-indexed.
void ShowPointLabels()
Renders all vertex indices.
29