bsp2wrl V1.4 - Quake BSP to VRML Converter
------------------------------------------

By Patrick McCormick (patrick.mccormick@alum.mit.edu) 
and Anthony Accardi (accardi@alum.mit.edu)

INTRODUCTION
------------

This is a Quake BSP to VRML (and OpenInventor) conversion utility. It
should work for most Quake levels. It outputs conformant VRML 1.0, VRML
2.0, and OpenInventor files.

USAGE
-----

Syntax: bsp2wrl [options] bspfile <wrlfile>
        -h      Help Screen
        -d      Dump Texture Files in PPM format
        -b x0 y0 z0 x1 y1 z1    Only convert polygons inside bounding box
        -i      Write OpenInventor File
        -1      Write VRML 1.0 File
        -n      No textures
        -m      No materials
        -l      No lights
        -x      Include textured Trigger boxes
        -e <extension>  Specify extension for textures (default "gif")

Options have to come before the filenames. If a wrlfile is not given, the
default is the same as bspfile with the BSP extension replaced by WRL (or
IV).

-d	Dump all textures in PPM format. Use a batch conversion utility
	like the PBMTOOLS or JASC Batchmaster (http://www.jasc.com/) to
	convert them to the GIF format.

-b	Only output nodes in the given bounding box. Useful for making
	(slightly) smaller VRML files. The coordinates are in Quake
	worldspace.

-i	Write OpenInventor output.

-1	Write VRML 1.0 output.

-n	No textures. If you specify -d, it will still dump the textures 
	anyway.

-m	No materials added.

-l	No lights added.

-x	Include textured Trigger boxes. The default is to leave
	the triggers out entirely.

-e	Specify extension for textures. This is for those who want to
	convert the PPM files to a different format instead of the 
	usual GIF for VRML and RGB for Inventor. It DOES NOT convert
	the PPM files to that particular format, however.

EXAMPLE
-------

For example, to convert e1m1.bsp to e1m1.iv (Inventor output)
and dump all the textures to disk, type:

bsp2wrl -d -i e1m1.bsp e1m1.iv

NOTES
-----

The file "palette.lmp" must be in the current directory if you want to dump
textures. One is included with the distribution. It came from the "gfx.wad"
file in the standard Quake ID0.PAK file.
