KeyGrip 1.0.5b README
By David 'crt' Wright
Assistance and Original Concept by Chris 'Drastic_Man' Sykes
___________________

     I    Info and Disclaimer

     II   INSTALLATION INSTRUCTIONS *IMPORTANT*
     
     III  Starting and running KeyGrip

     IV   Misc Important info

     V    Website and contact information
______________________________________
Please read this Entire File BEFORE running KeyGrip
Failure to do so may result in incorrect program operation.
It is also a good idea to read the keygrip.txt file so you will
understand how to USE the program.
This IS A BETA.

The following is from the GNU Public license, and is a general
disclaimer for KeyGrip. This does not mean that KeyGrip is
distributed under GPL. See keygrip.txt for commercial
use/distribution info.
          BECAUSE THE PROGRAM IS LICENSED FREE OF
     CHARGE, THERE IS NO WARRANTY  FOR THE
     PROGRAM, TO THE EXTENT PERMITTED BY
     APPLICABLE LAW.  EXCEPT WHEN  OTHERWISE
     STATED IN WRITING THE COPYRIGHT HOLDERS
     AND/OR OTHER PARTIES  PROVIDE THE PROGRAM
     "AS IS" WITHOUT WARRANTY OF ANY KIND,
     EITHER EXPRESSED  OR IMPLIED, INCLUDING, BUT
     NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
     MERCHANTABILITY AND FITNESS FOR A
     PARTICULAR PURPOSE.  THE ENTIRE RISK AS  TO
     THE QUALITY AND PERFORMANCE OF THE
     PROGRAM IS WITH YOU.  SHOULD THE  PROGRAM
     PROVE DEFECTIVE, YOU ASSUME THE COST OF
     ALL NECESSARY SERVICING,  REPAIR OR
     CORRECTION.
Thanks to id for Quake, Uwe Girlick for LMPC, Eric Stern for his
Film at 11 source, Basty and the PlanetQuake crew for their
support, Lonnie Foster for the KeyGrip icon, and Steve Fukuda for
being the MVP beta tester.
                   

II.     INSTALLATION INSTRUCTIONS *IMPORTANT*
_____________________________________________
Please follow these directions exactly.
Do not just extract all the files into a directory and run.

1.  Make a directory for the files, and extract the ZIP to it.
    (e.g. c:\games\quake\keygrip)

2.  Keep
        keygrip.exe
        nviewlib.dll
        *.txt
    in that directory

3.  Move
        keygrip.dem
        example.dem
        qlmm.dem
    to your id1 directory
(e.g. c:\games\quake\id1)
You MUST overwrite the keygrip.dem that was included in the 0.7
beta with this one. Failure to do so will result in improper
operation.

III.    Starting and running KeyGrip
_____________________________________________

1.  KeyGrip 1.0 runs much faster and is much more efficient with
memory than the 0.7 beta. However, for best performance, you
may want to shut down other running applications (Netscape,
MSIE, and MS Outlook are huge memory hogs). Also, if buttons
start showing up without glyphs (icons/pictures) on them, you are
running out of resources. Try quitting and restarting KeyGrip.

2.  KeyGrip 1.0 is resolution independent, and should work fine as
low as 640x480. However, for best performance, at least 1024x768
is recommended. 16-bit (or higher) Color is require for proper
image display. Large fonts should work OK, but are not
recommended. If status bars are being cut off, or things look out of
place, try small fonts.

3.  Run keygrip.exe

4.  You will need to configure the WinQuake directory in the
dialog box. For a description of the many other options, see
keygrip.doc.

5.  After you have done this, you should be left with the program
open, a bunch of grayed out icons (and some enabled) and a big
open workspace. I recommend resizing the main window so that it
covers the top half or so of your screen. Running maximized is not
recommended.


IV. Misc Important Info
_____________________________________________

Based on feedback from the first KeyGrip 1.0 private beta, here are
some tips and problems we ran into:
If you are getting a GPF in your display driver, try getting an
updated driver. If that doesn't work, get DirectX5 drivers.

You should not run KeyGrip fullscreen. If you run it half-screen,
you can put WinQuake in the bottom left corner, and still have
room for the Block Tree and other dialogs on the bottom right
corner of the screen.

Currently KeyGrip has a 32,500 block limit. While this should be
enough for most projects, you may need to split larger demos up
using Film at 11 first.

Will KeyGrip work with normal quake/GL Quake?
No, Regular quake runs slower, and has more trouble running in a
window than WinQuake. GLQuake does not run windowed on
most systems, generates screenshots slowly, and in an incompatible
format.

V. Website and contact information
_____________________________________________

KeyGrip is generously hosted by PlanetQuake
(www.planetquake.com). The official homepage is:
http://www.planetquake.com/keygrip
The Author is David 'crt' Wright and may be contacted at:
wrightd@stanford.edu
For demo related questions, you may wish to speak with Chris
'Drastic_Man' Sykes:
dmp@dc.jones.com

Please report any bugs to crt at the above address. Features that are
not currently functional (such as File-New) are not considered bugs
and should not be reported. Please check the KeyGrip page for bug
reports/fixes before sending anything in. Be as descriptive as
possible, and include any relevant screenshots/demos with your
bug report.


crt is also the programmer of Rocket Arena for Quake
http://www.planetquake.com/servers/arena
