Quake Miscellaneous Utilities

The info here is taken from the README written by John Carmack, and the Makefile. There are four tools:

qlumpy: mipmap and colormap generation
sprgen: billboard generation
texmake: MDL skin generation
modelgen: MDL file generation

Two additional tools illustrate the way Quake accesses its resource files. The majority of files provide commonly used functions.

"qlumpy"

Grabs graphics off of lbm screens. Has the colormap calculation code and the error-diffused mip map generation code. It generates either individual files, or a combined wad file (barely used at all in Quake now).

The sources qlumpy.h / qlumpy.c are linked with the LBM library (lbmlib.h / lbmlib.c), script handling functions (scriplib.h / scriplib.c), code for WAD2 creation (wadlib.h / wadlib.c), the common command library (cmdlib.h / cmdlib.c), and screen grab functions (in quakegrb.c).

"sprgen"

Grabs sprite data. We coded lots of ways for sprites to behave (allways perpendicular, pivot along Z to face origin, pivot on Z to be parallel to view plane, fixed orientation), but we wound up only having three sprites in the entire game: explosions, drowning bubble, and a gold ball light in the registered version....

The sources spritegn.h / sprgen.c are linked with the LBM library (lbmlib.h / lbmlib.c), script handling functions (scriplib.h / scriplib.c), and the common command library (cmdlib.h / cmdlib.c).

"texmake"

Takes an alias/wavefront .tri file and generates a wireframe outline on an lbm page for artists to draw in. This one will ease creation of skins for MDL objects a lot.

The source texmake.c is linked with the LBM library (lbmlib.h / lbmlib.c), math functions (mathlib.h / mathlib.c), code for WAD2 creation (wadlib.h / wadlib.c), and the common command library (cmdlib.h / cmdlib.c).

"modelgen"

Takes a directory of alias/wavefront .tri files for all of the animations of a character, combines with one or more skins colored over texmake frames, and outputs a .mdl file. Modelgen parses the same script source as qcc, so frame indexes keep their symbolic names when compiled into prog code.

The sources modelgen.h / modelgen.c are linked with the LBM library (lbmlib.h / lbmlib.c), Alias triangle file I/O (trilib.h / trilib.c), script handling functions (scriplib.h / scriplib.c), math functions (mathlib.h / mathlib.c), and the common command library (cmdlib.h / cmdlib.c).

Additional tools

Two other tools have been included that relate to the way Quake accesses its data.

dirpack.c: This collapses a directory hierarchy into a pak file. We don't really use this anymore after the functionality was built into qcc.
unpack.c: Unpacks a pak file into a directory tree. I don't think I ever used this, so I'm not even sure it works. Trivial code, in any case.

Both are simply linked against the common command library (cmdlib.h / cmdlib.c).

Common Code

The common code files, as already listed above, in overview, are:

LBM library (lbmlib.h / lbmlib.c)
Alias triangle I/O (trilib.h / trilib.c)
QuakeC script handling (scriplib.h / scriplib.c)
WAD2 I/O (wadlib.h / wadlib.c)
math functions (mathlib.h / mathlib.c)
common commands (cmdlib.h / cmdlib.c)
screen grab (in quakegrb.c).

Note that some of these are shared with qbsp, vis and light, and even QuakeEd sources.

home dEr95 r3D dread netrsc quake doom legal web