
	-----------------------------------------------------------
	Chipset-specific SVGA video drivers for the Allegro library
	-----------------------------------------------------------


			Version 1.0, December 1998
			--------------------------



#include <std_disclaimer.h>

   "I do not accept responsibility for any effects, adverse or otherwise, 
    that this code may have on you, your computer, your sanity, your dog, 
    and anything else that you can think of. Use it at your own risk."



======================================
============ Introduction ============
======================================

   This package contains the graphics hardware drivers that used to be a 
   part of the Allegro library (http://www.talula.demon.co.uk/allegro). They 
   are now obsolete, having been replaced by the drivers from the FreeBE/AF 
   project (http://www.talula.demon.co.uk/freebe/). This package only exists 
   in case anyone still wants to have all their hardware drivers linked 
   directly into the executable. It is dead code, not being actively 
   maintained any more, and unless you have some specific need for it I 
   would strongly advise you to use the FreeBE/AF drivers instead.



===================================
============ Copyright ============
===================================

   Like Allegro, these drivers are gift-ware. They were created by a number 
   of people working in cooperation, and are given to you freely as a gift. 
   You may use, modify, redistribute, and generally hack them about in any 
   way you like, and you do not have to give us anything in return. However, 
   if you like this product you are encouraged to thank us by making a 
   return gift to the Allegro community (since this is a dead project, the 
   best way to do that is probably by getting involved with writing some new 
   FreeBE/AF drivers instead). If you redistribute parts of this code or 
   make a game using it, it would be nice if you mentioned this package 
   somewhere in the credits, but you are not required to do this. We trust 
   you not to abuse our generosity.



============================================
============ Supported hardware ============
============================================

   - driver ID -        - name -             - config file code -

   GFX_ATI              ATI 18800/28800         ATI
   GFX_MACH64           ATI mach64              MA64
   GFX_CIRRUS64         Cirrus 64xx             CI64
   GFX_CIRRUS54         Cirrus 54xx             CI64
   GFX_PARADISE         Paradise                PARA
   GFX_S3               S3                      S3
   GFX_TRIDENT          Trident                 TRID
   GFX_ET3000           Tseng ET3000            ET30
   GFX_ET4000           Tseng ET4000            ET40
   GFX_ET6000           Tseng ET6000            ET60
   GFX_VIDEO7           Video-7                 VID7



======================================
============ Installation ============
======================================

   Assuming that you have already installed Allegro (which you must do 
   first), you shouldn't have any trouble building this package. It works in 
   exactly the same way: just go to your vdrv/ directory and run make.

   Normally the vdrv/ directory will be unzipped as a subdirectory of the 
   main Allegro tree. If you want to put it somewhere else, you must set the 
   ALLEGRO environment variable to indicate where the Allegro headers can be 
   found.

   The makefile works similarly to the main Allegro one, using the PGCC 
   environment variable to select Pentium optimisations, and the DEBUGMODE 
   variable to build a debugging version of the library.

   To use these drivers in your programs you should:

   - Put the following line at the start of your main program source file:

	 #include <vdrv.h>

   - Call the function vdrv_init() from your main initialisation routine, 
     right after your call to allegro_init().

   - If you compile from the command line or with a makefile, add '-lvdrv' 
     to the gcc command, just before the usual -lalleg, eg:

	 gcc foo.c -o foo.exe -lvdrv -lalleg

   - If you are using Rhide, go to the Options/Libraries menu, type 'vdrv' 
     into the empty space one before the 'alleg' entry, and make sure the 
     box next to it is checked.

   IMPORTANT: this library must be linked _before_ the main Allegro one in 
   your linker command line!

   Once you've done this, the additional video drivers will be available 
   both for autodetection and by using the values like GFX_S3 and GFX_ET4000 
   as parameters to set_gfx_mode(). They will also show up in the Allegro 
   gfx_mode_select() dialog, and can be manually selected by setting the 
   gfx_card= line in your allegro.cfg file.



=================================
============ Authors ============
=================================

   Ben Chauveau (bendomc@worldnet.fr).
   Added support for Tseng ET6000 cards.

   Francois Charton (deef@pobox.oleane.com).
   Wrote the Paradise graphics driver.

   Marco Campinoti (marco@etruscan.li.it).
   Added 15 and 24 bit support to the native Tseng ET4000 driver.

   Mark Habersack (grendel@ananke.amu.edu.pl).
   Added support for the more recent Trident chipsets.

   Markus F.X.J. Oberhumer (markus.oberhumer@jk.uni-linz.ac.at).
   Fixed the Video-7 scrolling function.

   Ove Kaaven (ovek@arcticnet.no).
   Fixed a bug in the ATI mach64 driver, and added native truecolor and 
   linear framebuffer support to it.

   Peter Monks (Peter_Monks@australia.notes.pw.com).
   Wrote the Video-7 graphics driver.

   Shawn Hargreaves (shawn@talula.demon.co.uk).
   Wrote everything not attributed to one of the above contributors.



=================================
============ History ============
=================================

   December 1998 - version 1.0
   First and probably final release (I don't plan to maintain this package). 
   This code was simply copied from the main Allegro source tree as it stood 
   just before the release of Allegro 3.1, prior to these files being 
   deleted from the main Allegro distribution.

