CSCI441::MD5Model Class Reference

stores a Doom3 MD5 Mesh + Animation More...

#include <MD5Model.hpp>

Classes
class	MD5Animation
	stores an entire animation sequence for a given MD5 Model More...
struct	MD5AnimationState
	stores state of current animation frame More...
struct	MD5BaseFrameJoint
	base frame joint More...
struct	MD5BoundingBox
	bounding box containing the model during animation More...
struct	MD5Joint
	a joint of the MD5 Skeleton More...
struct	MD5JointInfo
	information pertaining to each animation joint More...
struct	MD5Mesh
	mesh that comprises the model's skin More...
struct	MD5Texture
	texture handle for the model More...
struct	MD5Triangle
	a triangle on the mesh More...
struct	MD5Vertex
	a vertex on the mesh More...
struct	MD5Weight
	the weight for a mesh vertex More...

Public Member Functions
	MD5Model ()
	initializes an empty MD5 Model
	~MD5Model ()
	deallocates any used memory on the CPU and GPU
	MD5Model (const MD5Model &)=delete
	do not allow MD5 models to be copied
MD5Model &	operator= (const MD5Model &)=delete
	do not allow MD5 models to be copied
	MD5Model (MD5Model &&src) noexcept
	do not allow MD5 models to be moved
MD5Model &	operator= (MD5Model &&src) noexcept
	do not allow MD5 models to be moved
bool	loadMD5Model (const char *MD5_MESH_FILE, const char *MD5_ANIM_FILE="")
	loads a corresponding md5mesh and md5anim file to the object
bool	isAnimated () const
	returns if the MD5 Model has an accompanying animation
bool	readMD5Model (const char *FILENAME)
	parses md5mesh file and allocates corresponding mesh data
void	allocVertexArrays (GLuint vPosAttribLoc, GLuint vColorAttribLoc, GLuint vTexCoordAttribLoc)
	binds model VBOs to attribute pointer locations
void	setActiveTextures (GLint diffuseMapActiveTexture, GLint specularMapActiveTexture, GLint normalMapActiveTexture, GLint heightMapActiveTexture)
	specify which texture targets each texture map should be bound to when rendering
void	draw () const
	draws all the meshes that make up the model
void	drawSkeleton () const
	draws the skeleton joints (as points) and bones (as lines)
bool	readMD5Anim (const char *filename, GLushort targetAnimationIndex=0)
	reads in an animation sequence from an external file
bool	addMD5Anim (const char *filename)
	adds another MD5 Animation sequence to the model's set of animation
GLushort	getNumberOfAnimations () const
	returns the number of animations that were successfully loaded against the model
void	useTargetAnimationIndex (GLushort targetAnimationIndex)
	update current animation to be running through
void	animate (GLfloat dt)
	advances the model forward in its animation sequence the corresponding amount of time based on frame rate

Detailed Description

stores a Doom3 MD5 Mesh + Animation

Constructor & Destructor Documentation

MD5Model()

CSCI441::MD5Model::MD5Model ( )

inline

initializes an empty MD5 Model

Note

need to call loadMD5Model() or readMD5Model() after construction to actually load in a mesh file

Member Function Documentation

addMD5Anim()

bool CSCI441::MD5Model::addMD5Anim ( const char *  filename )

inline

adds another MD5 Animation sequence to the model's set of animation

Parameters

filename

*.md5anim file to open add to animation list

Returns

true iff mesh and animation are compatible

allocVertexArrays()

void CSCI441::MD5Model::allocVertexArrays ( GLuint  vPosAttribLoc, GLuint  vColorAttribLoc, GLuint  vTexCoordAttribLoc  )

inline

binds model VBOs to attribute pointer locations

Parameters

vPosAttribLoc	location of vertex position attribute
vColorAttribLoc	location of vertex color attribute
vTexCoordAttribLoc	location of vertex texture coordinate attribute

Note

color attribute used when drawing the skeleton

texCoord attribute used when drawing the mesh

animate()

void CSCI441::MD5Model::animate ( GLfloat  dt )

inline

advances the model forward in its animation sequence the corresponding amount of time based on frame rate

Parameters

dt	delta time since last frame

getNumberOfAnimations()

GLushort CSCI441::MD5Model::getNumberOfAnimations ( ) const

inline

returns the number of animations that were successfully loaded against the model

Returns

number of animations loaded against the mesh

Note

if model is not animated, will return 0

calling addMD5Anim() increments this number when successfully loaded

isAnimated()

bool CSCI441::MD5Model::isAnimated ( ) const

inline

returns if the MD5 Model has an accompanying animation

Returns

true if animation exists for model

loadMD5Model()

bool CSCI441::MD5Model::loadMD5Model ( const char *  MD5_MESH_FILE, const char *  MD5_ANIM_FILE = ""  )

inline

loads a corresponding md5mesh and md5anim file to the object

Parameters

MD5_MESH_FILE	name of file to load mesh from
MD5_ANIM_FILE	name of file to load animation from

Returns

true if both mesh and animation loaded successfully and are compatible

readMD5Anim()

bool CSCI441::MD5Model::readMD5Anim ( const char *  filename, GLushort  targetAnimationIndex = 0  )

inline

reads in an animation sequence from an external file

Parameters

filename	*.md5anim file to open
targetAnimationIndex	animation index sequence to read into (defaults to first)

Returns

true iff mesh and animation are compatible

readMD5Model()

bool CSCI441::MD5Model::readMD5Model ( const char *  FILENAME )

inline

parses md5mesh file and allocates corresponding mesh data

Parameters

FILENAME

*.md5mesh file to load

Returns

true if file parsed successfully

setActiveTextures()

void CSCI441::MD5Model::setActiveTextures ( GLint  diffuseMapActiveTexture = GL_TEXTURE0, GLint  specularMapActiveTexture = GL_TEXTURE1, GLint  normalMapActiveTexture = GL_TEXTURE2, GLint  heightMapActiveTexture = GL_TEXTURE3  )

inline

specify which texture targets each texture map should be bound to when rendering

Parameters

diffuseMapActiveTexture	active texture to bind the diffuse map to (default GL_TEXTURE0)
specularMapActiveTexture	active texture to bind the specular map to (default GL_TEXTURE1)
normalMapActiveTexture	active texture to bind the normal map to (default GL_TEXTURE2)
heightMapActiveTexture	active texture to bind the height map to (default GL_TEXTURE3)

useTargetAnimationIndex()

void CSCI441::MD5Model::useTargetAnimationIndex ( GLushort  targetAnimationIndex )

inline

update current animation to be running through

Parameters

targetAnimationIndex

animation index to animate model through

Note

targetAnimationIndex must be within the range [0, getNumberOfAnimations()]

---

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

• MD5Model.hpp