                               OGF Tool                    
                       by Chris Ledwith aka Gwar
          ------------------------------------------------
                                 v0.7

                             README file

OGF Tool is a utility for converting textures in Descent 3 (.OGF 
files) to .TGA and other formats.


Current features include:
- OGF to TGA, full mipmap support (output 5-mipmap OGF to 5 separate TGAs)
- TGA to OGF, full mipmap support (automatic mipmap generation)
- OAF to TGA/OGF

Features planned for next version:
- TGA/OGF to OAF (choose frames to store in animation, and size)

Note on mipmaps:
Mipmaps are textures stored at a number of different resolutions. In 
Descent 3, each mipmap level is 1/4 the size of the preceding level. 
For example, a 128x128 texture with 5 mipmaps will look like this:

-----------------     ---------     -----     ---     --
|               |     |       |     |   |     | |     --
|               |     |       |     |   |     ---     8x8
|               |     |       |     -----    16x16
|               |     |       |     32x32
|               |     ---------
|               |       64x64
|               |
|               |
-----------------
    128x128

mipmap level 1: 128x128 (the original texture)
mipmap level 2: 64x64 (lower resolution, used by the game for somewhat 
                  a distant object)
mipmap level 3: 32x32 (smaller still, used for a more distant object)
mipmap level 4: 16x16 (for an object even further away)
mipmap level 5: 8x8 (an object on the very edge of vision)

All mipmaps for a given texture are stored in the same .OGF file. When 
converting from the .OGF format to a standard image format 
(like .TGA), OGF Tool gives you the option of saving the extra 
mipmaps, if any exist, to separate files.

Thank you for using OGF Tool.

-Gwar

Feedback:
I'd like to know who is using this program, and in what way. So if 
it's at all useful to you, please drop me an email, and let me know 
what you like about it, what you're using it for, and possibly 
suggest something you'd like to see in the next version.

Email: gwar@descent.org -OR- syrinx1@mindspring.com

URL: http://www.descent.org/descentia/


Special thanks:
Thanks to Parallax Software for the Descent series and especially 
Outrage Entertainment for making Descent 3.