
		     Queue Members Group presents

	      Queue Members Group Art Division production

			    - Q R A S H -

==========================================================================

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

    Note: files contained in 'mikmod' subdirectory are modified part 
	  of MikMod soundsystem which is distributed under SHAREWARE
	  license (not GPL) and free ONLY for non-commersial use. see
	  mikmod/mikmod.txt and mikmod/register.frm for details.

==========================================================================

table of contents:

1. platforms supported
2. hardware requirements (x86 only)
2. running the demo
3. compiling (unix only)
4. troubleshooting
5. comments
6. credits
7. thanks
8. how to contact us


1. platforms supported

- UNIX

	* CPU
	  - i386 compatible (hand optimized p5 asm) 
	  - other (pure c++ version)

	* sound support
	  - no sound (not recommended)
	  - Linux (VoxWare/Ultrasound Project)
	  - SunOS 4.1.x
	  - Solaris 2.x
	  - DEC Alpha / AudioFile
	  - IBM AIX
	  - HP-9000 series
	  - SGI Irix
	  (unix sound support other than Linux VoxWare is not 
	   tested. please write me if some problems occur)

	* graphics support
	  - Svgalib 1.2.10+ (must be run with suid root)
	  - X11

- DOS

	* graphics support
	  - vga
	  - x-modes
	  - svga (640x480 with LFB is the best)

	* sound support
	  - no sound (not recommended)
	  - sb
	  - sb pro
	  - gus
	  - ensoniq soundscape

- Windows NT / Windows'95

	* DirectX 2+ required
	* binary release only
	* but all needed sources (Watcom 10.6+) included

- OS/2

	* DART required for sound
	* binary release only 
	* but all needed sources (Watcom 10.6+) included


2. hardware requirements (x86 only)

this demo *requires* 486dx or better cpu (won't run on 386 or 486sx).
but i strongly recommend to run it on pentium machine because demo
code is heavily p5-optimized and contains intensive use of floating
point. 


3. running

simply type 'qrash' and press <enter> (don't type quotes). then
answer some questions about graphics/sound (if any). if your monitor 
seems too dark then try to press famous F11 key (or 'G' in linux
svgalib version) during demonstration to adjust gamma correction level. 
you can also use '+' and '-' to adjust music volume. executing 
'qrash -nosound' will disable sound at all. executing 'qrash -saveconfig'
will force sound and video configuration to be saved and setup screen 
will no longer bother you until you delete 'qrash.cfg' (dos/unix only). 
enjoy.


3. compiling (unix only)

run 'sh configure' to select cpu type, graphics and sound support. then
type 'make'. note: svgalib executables must be owned by root and have
suid bit. if any error occurred then hack around yourself or write
me (i hacked some sound drivers but wasn't able even compile it;).
if source file mikmod/drv_nos.c doesn't compile properly or if demo
stops shortly after beginning then look at lines 22..24 of 
mikmod/drv_nos.c and try uncomment one of them. if no errors then just
type 'qrash' to run the demo. the demo requires file 'qrash.dat' to be
in current directory. old snapshots of pgcc may produce broken code with
-O6 optimization enabled. if you run into it then try to replace -O6 
with -O4 (-O3 (-O2)) in Makefile.in and/or remove -funroll-loops switch.
eg. pgcc snapshot 970821 (which i used to precompile linux/svgalib 
executable) require source file parts.cc to be compiled with 
-fno-runtime-lift-stores (or just with -O4 instead of -O6) option due 
to bug in optimization.


4. troubleshooting

* linux/svgalib version prints 'svgalib: Cannot get I/O permissions.'
  or 'svgalib: Cannot open /dev/console'
  
  - run it with suid root

* if fps (frames per second) is too low or music gets garbled

  - try to lower sound quality (eg. 8bit/mono instead of 16bit/stereo)
  - try to stop concurrent processes
  - try to compile demo with pgcc instead of gcc (on x86 machines)
  - and finally, try to comment line 50 in vid_vga.cc (Svgalib) 
    or line 115 in vid_x11.cc (X11) to enable resolution choice 
    (but i personally don't like it)

* if music seems unsynchronized with screen events then
  write me please what sound driver in what mode you're using.


5. comments

the demo (dos version) is developed under os/2 warp 4.0 and then 
ported to linux/svgalib, unix/x11, win32/ddraw, os/2/dive (not 
released) and os/2/full screen. if you want me to port the demo 
to any operating system of your choice then just send me cd with
it (do not forget to include computer to run it if it's not 
x86-compatible;). any commercial offers will be appreciated.


6. credits (because the demo itself hasn't them)

Mad Max / QMG (Mike Shirobokov)  : code, gfx, photos, lyrics
Rogers / QMG (Vladimir Rodionov) : music, gfx


7. thanks (in alphabetical order) to

Daredevil and Tran	for excellent pmode/w dos extender
GNU and Linux community	for giving us freedom
Jeffrey Lim		for Impulse Tracker
MikMak of HaRDCoDE	for portable MikMod player
Pentium Compiler Group	for pgcc
Powersoft		for Watcom C++ 32-bit optimizing compiler
Queue Members Group	for the fact of still existence
Various 3d artists	for their 3ds objects
Vip / QMG		for Internet support
Zub			for the cooler


8. how to contact us

Mad Max : mad_max@qmg.rising.ru
	  2:5057/14@fidonet

Rogers :  rogers@qmg.rising.ru
	  2:5057/18.6@fidonet

also visit our www and ftp site at qmg.rising.ru maintained by
ViP/QMG (root@qmg.rising.ru).


				Signed, Mad Max / Queue Members Group
