Grim Fandango model viewer file

Created by cplhenshaw on the International House of Mojo forums. Mirrored here for archival purposes.

Grim Fandango Model Viewer cplhenshaw@hotmail.com

AQUIRING THE MODELS:

DATA000.LAB DATA001.LAB DATA002.LAB DATA003.LAB DATA004.LAB
Copy the above files into the "gfmv" folder ( where this readme is ).
Then go into the "models" folder and run "extractModels.exe". This shouldmake its way through the .LAB files and extract the .3do's .mat's and .cmp'sthat the viewer needs to run. Once this is done and the models folder ispopulated the .LAB files are no longer needed in the "gfmv" folder.

USING THE VIEWER:

To begin, run "gfmv.exe".
Right clicking in the OpenGL window will bring up the menu.
To exit the program choose EXIT at the bottom of the menu.To change the background color used the "Background Color" menu just above exit.
The rest of the menu choices are all subcategories for selecting the charactermodels to view. There are roughly 550 .3do files in the game, but only the character models were added to the menu. To view other model files you can use command line arguments, by specifying both a .3do file and a .cmp file.
i.e > gfmv dogtags.3do dogtag.cmp
Note that the .cmp file will rarely share the same name as the .3do and I do notknow how to automatically determine which .cmp each material uses.

CONTROLS:

The left mouse button can be used to rotate models left/right and up/down. Using 'A' and 'D' on the keyboard will also rotate the models left / right.
Holding the middle mouse button while moving back and forth, or pressing '1' and '2' on the keyboard adjusts the distance to the model.
Using 'W' and 'S' on the keyboard shift the models vertically to center them in the frame or get a better view. The spacebar will reset to the default height.

NOTES:

A handful of the .3do files are in the original ASCII format, and attempting to load these willcause the viewer to fail and exit.
activate_salnotes.3dobetting_stub.3dosignpost.3dorope_scale.3dosignpost_adjust.3dobone_big.3dofridge_door.3doca_pass_skrts.3docoffee_medium.3douni_skirt.3d
CREDITS:The writeup of the MODL format by Cyril Zorin at Wiki.multimedia.cx the knowledge to read the .3do files from the game.
Additionally Jeffz.name allowed .MAT and .CMP files to be read.
The writeup of the .LAB format by Benjamin Haisch ( John Doe ) allowed all the filesto be extracted from the .LAB archives.
Finally the order in which to apply the yaw, pitch and roll rotations to the nodes in the .3do fileswas found by looking through the code for Residual ( Residual.sourceforge.net ).
QUESTIONS / COMMENTS?
cplhenshaw@hotmail.com