PRVIEW v2.3
May 5, 1997 Release

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


What's New:
-----------
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)



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


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.

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.


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 = [GIF, 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 -s 1
- Loads the duck model and uses VESA or 3Dfx

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

prview a_moves.3ds -s 1 -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 -s 1 -t gif
- Loads a model called space, which uses GIF 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)



General Controls:
-----------------
Once you have the program running, you can use the following controls:

Action:                         Effect:
-------                         -------
Move mouse                      Tilt camera
A                               Move camera forward
Z                               Move camera backward
+ (keypad)                      Increase movement speed
- (keypad)                      Decrease movement speed
Left Mouse Button + move mouse  Spin the model
Quickly let go while moving     Keeps the model spinning
                                (This is quite sensitive and hard to do
                                 if the model is simple)
Spacebar                        Toggle MDL animation on/off
F1                              Cycles through VESA video modes
ESC                             Quits
[                               Slows down animation
]                               Speed up animation
;                               Decrease gamma correction
'                               Increase gamma correction
<                               Decrease ambient lighting
>                               Increase ambient lighting


You can use PRVIEW to view models off the Web by setting up a file assocation
between PRVIEW and 3DS, PRO, or LWO files.   Not all files will work however
because some are not designed for realtime viewing.  





