
	 - Hard RoX - v1.0. - (C) Copyright 1996 by Skal
	--------------------------------------------------
		       Released at Wired'96

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

Requirements:
-------------
	CPU: >=486 (P120 recommended). 
	RAM: 8Megs
	Sound Card: GUS or SB.
	OS: DOS 6.x (+Himem) 
	    or PC-Linux [>=X11R5] (tested: 1.3.58 -> 2.0.21) 
  
	files            Size
	-----            ----
	rox.exe      272484 bytes  (DOS executable)
	rox	     745552 bytes  (Linux executable)
	rox.dat      979150 bytes
	rox.s3m      780849 bytes
	cwsdpmi.exe  25920  bytes  (DPMI)
	
Usage:
------
	usage: rox.exe [-M|+M|+M2] [-h] [+/-S] [+/-A] [Sequence number]
	  +/-S: turn sound on/off (default: on)
	  +/-A: sound device autodetection on/off (default: on)
	Pre-calc level (not including the ~800K Mikmod needs):
	  +M2: Use 4.31 Megs of pre-calc  (default).
	  +M:  Use 3.22 Megs of pre-calc.
	  -M:  No pre-calc (minimal malloc() of 1.85 Megs).

Credits:
--------
	GFX/Music/Code.............. Skal

   additionnal credits:

	Mikmod 2.10................. MikMak (JP Mikker)
	CWSDPMI.EXE DPMI ........... CW Sandmann
	SVGA lib ................... Harm Hanemaayer
	Couples of samples from Tek/Otm and Yolk+Legend/CNCD

DOS version:
------------
	. coded/tested on a P120. Seems to work fine on a P70...
        Slow on 486s. Heavily relies on the FPU.

	. Compiled with DJGPP v2.0. CWSDPMI.EXE is here to provide
	DPMI. You can load your own instead, before running the demo.
	As configuration, just use HIMEM... 

PC-Linux version:	(rather experimental. Please report weird bugs )
-----------------
	The code is the same, apart from some DOS ...hum...
	'specificities', being emulated.

	Installation: 
           * be sure that you have the correct rights
	   over the /dev/dsp. If not, ask root to `chmod +rw`
	   this /dev/dsp for you.

           * if you want to use the SVGA_LIB facilities,
            (running the demo in a Linux console), then
	    the Linux executable 'rox' must be s-bit'ed by
	    root. Namely:
	    	chown root ./rox
		chmod u+s ./rox
            Otherwise, you'll get: 'svgalib: Cannot get I/O permissions.'

            WARNING: I'm not responsible of possible *exploitation*
	     of sec. holes and bugs, if any, in this demo (just
             responsible for the bugs :). Beware when chown'ing it !

	   * If you're running the demo with a redirected DISPLAY
             ( export DISPLAY=target.machine.somewhere:0.0 ), don't
             forget the `xhost +` on this target machine. Note that
             in this case, the frame rate will be low and that you 
	     won't hear the music...

	Some problems with sound: As the sound is handled
	separately by the kernel, the demo does not run the same
	way the usual (sequential) DOS one does. Main process
	is slowed accordingly. Moreover, music update procedure
	must be called at bpm (and not between each frame, as for
	the DOS version), so that synchronized effects won't run
	smoothly. The delays/interpolation I added on were designed 
	for the demo to run smoothly on a P120 with mixing at 22Khz.
	On other computers/rate, you'll be Scavenging the Unknown :)

	[ Maybe you should try playing with env. variables MM_FRAGSIZE
	  and MM_NUMFRAGS as described in Mikmod's 'drv_vox.c' file or
          in the 'experimental.txt' text within the VoxWare package...]

	The demo can either be run with XWindows (R5 or R6. Does
	not matter), or throught Harm Hanemaayer's svgalib. First,
	the demo will attempt opening the DISPLAY, and if it fails, 
	will use svgalib, thus assuming it has been launched
	from a Linux console.
	Althought not required, the latest version of svgalib can be found
        on sunsite.unc.edu and mirrors as svgalibXXX.tgz in the directory
        /pub/Linux/libs/graphics.

	If you feel like starting coding demos under Linux, just
	get this svgalib, a good text editor (joe! :), Mikmod's Linux port,
	the lastest gcc/gas version, and... go for it ! Everything you were
	used to with DOS can be done with these tools, and much much more... 
	Fight moneymaker$ with your Hacker's Spirit ! LINUX RULES !

	[ If you're searching a C template to start with, you may
          find interesting looking at an old code I once wrote:
            http://www.eleves.ens.fr:8080/home/massimin/creature
          (it's the C file 'creature.c' ). It's far from being bug-
          proof, but provides, under both X11 and DOS, what
          a demomaker is longing for: a window, a bitmap, and 256
          colors :) Just a thought. ]
	  
Features:
---------
	. UV/refraction/transparency/reflection/blur/larsen/bump mapping
	. particles
	. Spherical perspective
	. some ray-tracing made my way  %^D
	. on-the-fly Floyd-Steinberg dithering
	. some ODE
	. caustics (well, an attempt, actually :)
	. raytraced Julia fractal set (w/ POV3.x)
	. ...

Contact:
--------
	Send a GUS to:

	Pascal Massimino
	3, rue Sainte Isaure
	75018 Paris
	France

	e-mail: Pascal.Massimino@ens.fr
	WWW:	http://www.eleves.ens.fr:8080/home/massimin/
	IRC:    often on #demofr
	voice:	+33 1 46 06 53 53

Legal stuff:
------------
  This material is not freeware. You are allowed to copy it without
  restrictions for non-commercial use.

  This program or the data files contained therein may not be altered or
  modified without the permission of the author.

  No payment of any kind may be charged for this product or any combination
  of products or services including this product without our authorization.

  [ NB: You'll have to register MikMod's license anyway. See below. ]

  You take full responsibility for the operation of this software and any
  consequences thereof. We the creator can not accept liability for damages
  or failures arising from the use of this software.

  All product names, trademarks and registered trademarks contained in this
  document are the property of their respective holders.

  Wired'96 organizers are hereby given the right to use this product
  on the party's CD-Rom. 

  * CWSDPMI.EXE is Copyright (C) 1995 Charles W Sandmann (sandmann@clio.rice.edu)
    Latest source code and/or binaries can be received by writing to:
	102 Hurst Ct, Destrehan, LA 70047

  * DJGPP V2 is Copyright (C) 1995 by DJ Delorie.
    To retreive lastest versions of this package, check the WWW pages: 
	http://www.delorie.com/

  * MikMod is SHAREWARE. To get a register form (for commercial use), 
    write to MikMak (Jean-Paul Mikkers): mikmak@via.nl.

    The lastest versions of these products can be downloaded from the
    FTP site: x2ftp.oulu.fi

(Im-)moral support while coding:
--------------------------------
Red Hot Chili Pepper (Catholic school girls rule !), Living Color
(Elvis is dead !), Ugly Kid Joe (Everything about you !), Testament
(Practice what you preach !), Steve Morse (Cut to the chase !), etc...

----------------------------------------- Skal, November 1996. -------------


