PRVIEW v2.5c
January 27, 1998 Release
Written by Chris Egerter

Copyright 1998 Egerter Software
WEB:   http://www.egerter.com
EMAIL: egerter@egerter.com


Overview:
---------
PRVIEW is a 3D object viewer which can load 3D Studio, Lightwave,
Quake/Quake2 models, and PRO files (our proprietary format).  


Disclaimer of Warranty
----------------------
PRView PRO is provided AS IS without warranty of any kind, either express 
or implied, including but not limited to the implied warranties of
merchantability and fitness for a particular purpose. In no event shall
the author be liable for any damages whatsoever including direct, indirect, 
incidental, consequential, loss of business profits or special damages, 
even if the author is notified of such actions.  If you do not agree to
this policy, DESTROY all copies of PRView PRO NOW.

PRView Pro is protected by Canadian and foreign Copyright laws.  Modifying, 
reverse engineering, or disassembling of this product (including the program
and all documentation) is strictly prohibited.

-----------------------------------------------------------------------------



General Controls:
-----------------
Press F1 and F2 while running PRVIEW to see the controls available.
They are also listed below.

Click on the slider to move quickly through the animation.
Spacebar    : Toggles between VCR and
              Inspect mode (hidden cursor)
TAB         : Cycles through SVGA modes
ESC         : Quits

Inspection Mode:
Move mouse  : Tilt camera
A           : Move camera forward
Z           : Move camera backward
C           : Toggle animation/user camera

+ (keypad)  : Increase movement speed
- (keypad)  : Decrease movement speed
LMB + move  : Spins around x/y axis
RMB + move  : Spins around z axis
MB + release: Auto-spin mode
,           : Decrease Ambient light
.           : Increase Ambient light
;           : Decrease Gamma (3Dfx only)
"           : Increase Gamma (3Dfx only)



What's New:
-----------
2.5c
- Added Quake2 (.MD2) model support
- Added VCR controls and a user interface
- Added various new command line switches

2.5b
- Fixed 3DS dummy objects
- Added subtexel precision to perspective rendering (looks much cleaner)
- Fixed some bugs in the animation player


2.4
- Added camera keyframing (only works for PRO files imported from Lightwave)
- Fixed the Voodoo Rush LFB writes so the frame rate prints correctly

2.3
- Added LWO support
- Added Glide 2.3 support
- Fixed gouraud clipping bug


2.2
- Fixed up the problem with the Shambler textures
- Added ambient lighting, animation speed, and gamma correction controls
- Compiled with Watcom 11.0 (you need DOS4GW.EXE to run it now, since
  Causeway doesn't seem to like Watcom 11)



Installation:
-------------
There are two ways you can install PRVIEW.

1) Unzip the archive to a directory, and copy the models to this directory
   when you want to view them.  This can get messy because you will have
   a lot of files in the same directory.

or

2) Unzip the archive to a directory, add the directory to the path statement
   in your autoexex.bat, and reboot.  Now you can run PRVIEW from any
   directory.  This is nicer because you can keep the models in their
   own directories.


Usage:
------
Running prview without parameters will display these options:
PRVIEW filename.[PRO/3DS/MDL] [options]

Options:
-s scale      Changes scaling factor (3DS only)
-t ext        Imports textures from 3DS, using extension
              ext = [PCX, 3DF, IFF, BLK, PAK]
              (3DF only works with 3Dfx cards)
-m pakfile    Specifies a PAK file for Quake models (ie pak1.pak)
              If none specified, it tries to load from the file directly
              if you have the .mdl file unpacked.
-v            Uses standard 320x200 VGA mode instead of VESA

Examples:

prview duck.3ds 
- Loads the duck model and uses VESA or 3Dfx

prview duck.3ds -v
- Loads the duck model and uses VGA or 3Dfx

prview a_moves.3ds -t 3df
- Loads the Anubis model (from the atsflip technology demo) and uses 3DF files
  for textures assuming they are in the same directory.

prview space.3ds -t pcx
- Loads a model called space, which uses PCX files for textures,
  assuming they are in the same directory.

prview dog.mdl -m pak0.pak
- Loads and animates the dog model from Quake, using the pak0.pak file.

prview dog.mdl
- Loads and animates the dog model from Quake, loading from dog.mdl directly
  (if you have unpacked the .PAK files)

prview models/monsters/brain/tris.md2 -m h:\install\data\baseq2\pak0.pak -g
- Loads and animates the brain mode from Quake2, and uses Gouraud shading


Quake 1
-------
To use the Quake MDL viewing capabilities, copy the quake.pal and quake.tab
files to the directory where the PAK or MDL files exist.


Quake 2
-------
To view a model in a pak file, following this example:
prview models/monsters/brain/tris.md2 -m h:\install\data\baseq2\pak0.pak

Assuming H: was your CD drive and you have the Quake2 CD inserted.

To view a separate .md2 file such as the player models, copy it and the
textures needed to the prview directory and use:

prview tris.md2 -p flak.pcx


