Mesa 4.0.1 DOS/DJGPP Port version 0.1
		    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~



First of all...
~~~~~~~~~~~~~~~

This is a DOS port for MESA 4.0.1. I didn't bother to consider any DOS C
compiler other than gcc, so this port was written using DJGPP v2. To be more
precise:
	djdev 2.03
	gcc v3.0.3
	make v3.79

Almost all demos were compiled and ran succesfully on my system:
	CPU:		Intel Pentium w/ MMX @166 MHz
	Mainboard:	ViA Apollo VP2 w/ 128 MB SDRAM
	Video card:	Matrox Millenium I w/ 4096 kB WRAM, Matrox BIOS v3.0

Since I don't have access to any accelerated video hardware, this port is
entirely based on VESA/SuperVGA. My little attempt to use FreeBE/AF ended in
a failure, but that's another story: it seemed to work fine with my older
Matrox Millenium w/ 2MB, and then I got another Matrox Millenium w/ 4MB. The
problem with latter was it had a dead BIOS; I hot-flashed it and made it work
in all environments (Windows 95, VESA, etc) but FreeBE/AF.



Legal:
~~~~~~

This software is distributed under the terms of the GNU Lesser General Public
License.

Source code written by others is subject to its respective copyright.



libGL (the core):
~~~~~~~~~~~~~~~~~

Of course, MESA 4.0.1 core sources are required. It will probably work with
MESA 3.5, but not a chance with earlier versions due to major changes to the
MESA driver interface and the directory tree. All should compile succesfully.

The driver has its origins in ddsample.c, written by Brian Paul and found by
me in MESA 3.4.2. I touched almost all the functions, changing the coding
style ;-( Sorry!

Pitfalls:
1. The current version supports only RGB[A] modes, for it made no sense to me
   to endorse color-index (aka palette) modes.
2. Only double-buffered is allowed because it was simpler to implement at
   that moment. Single-buffered will appear soon, especially if I can find a
   way to use hardware acceleration.
3. Another weird "feature" is that buffer width & height must be multiple of
   4 (I'm a lazy programmer and I found that the easiest way to keep buffer
   handling at peak performance ;-).
4. The video mode selector is tricky: it searches for the smallest mode which
   will entirely contain the buffer at its current position. If you want a
   small buffer in a high-res mode, try to position it very far to the right
   (or down). I'd really use some ideas here!!!



libGLU:
~~~~~~~

Mesa GLU sources are required. Everything should run smooth.



libGLUT (the toolkit):
~~~~~~~~~~~~~~~~~~~~~~

Well, this "skeletal" GLUT implementation is not mine. Thanks should go to
Bernhard Tschirren, Mark Kilgard, Brian Paul and probably others (or probably
not ;-). I only changed it to be self-standing (Allegro-free). The keyboard,
mouse and timer drivers were inspired from an old project of mine (D3Xl) and
fixed with some Allegro "infusions"; my deeply thanks to Shawn Hargreaves and
co.

My keyboard driver used only scancodes, but since GLUT requires ASCII values
for keys, I borrowed the translation tables (and maybe more) from Allegro.
Ctrl-Alt-Del (plus Ctrl-Alt-End, for Windows users) will shut down the GLUT
engine unconditionally: it will raise SIGINT, which in turn will call the
destructors (let's hope), thus cleaning up your/my mess ;-)

The mouse driver is far from complete (lack of positioning, drawing, etc),
but is enough to make almost all the demos work.

The timer is pretty versatile for it supports multiple timers with different
frequencies. It may not be the most accurate timer in the known universe, but
I think it's OK. Take this example: you have timer A with a very high rate,
and then you have timer B with very low rate compared to A; now, A ticks OK,
but timer B will probably loose precision!

As an addition, stdout and stderr are redirected and dumped upon exit. This
means that printf can be safely called during graphics, but all messages come
in bulk! A bit of a hack, I know, but I think it's better than to miss them
at all.

Window creating defaults: 640x480x16 at (0,0), 8-bit stencil, 16-bit accum.



Installation:
~~~~~~~~~~~~~

Unzip into the MESA directory, and type "make -f Makefile.DJ" to compile all
libraries. Long filename support is required during compilation. The examples
are not built automagically (see Pitfalls above).



History:
~~~~~~~~

v0.1	feb-2002	initial release
v0.2	..soon..



Contact:
~~~~~~~~

Name:   Borca Daniel
E-mail: dborca@yahoo.com
WWW:    http://www.geocities.com/dborca/