xenocara/dist/Mesa/docs
2008-11-02 14:58:06 +00:00
..
OLD Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
autoconf.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
banner.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
bugs.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
cell.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
conform.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
contents.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
COPYING Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
debugging.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
demos.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
developers.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
devinfo.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
dispatch.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
download.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
enums.txt Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
envvars.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
extensions.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
faq.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
fbdev-dri.html Update to Mesa 7.0.3. tested my oga@ and johan@ 2008-05-31 16:36:47 +00:00
games.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
gears.png Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
glfbdev-driver.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
glu.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
helpwanted.html Update to Mesa 7.0.2. Tested by naddy@ (full ports build), simon@ 2008-02-12 21:09:25 +00:00
index.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
install.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
intro.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
libraries.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
license.html Update to Mesa 7.0.2. Tested by naddy@ (full ports build), simon@ 2008-02-12 21:09:25 +00:00
lists.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
mangling.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
MESA_agp_offset.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_copy_sub_buffer.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_pack_invert.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_pixmap_colormap.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_release_buffers.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_resize_buffers.spec Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
MESA_set_3dfx_mode.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_shader_debug.spec Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
MESA_swap_control.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_swap_frame_usage.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
MESA_texture_array.spec Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
MESA_window_pos.spec Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
MESA_ycbcr_texture.spec Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
mesa.css Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
MiniGLX.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
modelers.html Update to Mesa 7.0.2. Tested by naddy@ (full ports build), simon@ 2008-02-12 21:09:25 +00:00
news.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
osmesa.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
pbuffers.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
perf.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
precompiled.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.3DFX Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.AMIWIN Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.BEOS Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
README.CYGWIN Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.D3D Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.directfb import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
README.DJ Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.GGI Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.LYNXOS Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.MINGW32 Mesa 7.0.1 2007-11-24 17:25:28 +00:00
README.MITS Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.NeXT Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.OpenStep Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.OS2 Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.QUAKE Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
README.THREADS Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.VMS Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
README.WIN32 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
README.WINDML Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
relnotes-6.4.1.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
relnotes-6.4.2.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
relnotes-6.4.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
relnotes-6.5.1.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
relnotes-6.5.2.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
relnotes-6.5.3.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
relnotes-6.5.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
relnotes-7.0.1.html Update to Mesa 7.0.2. Tested by naddy@ (full ports build), simon@ 2008-02-12 21:09:25 +00:00
relnotes-7.0.2.html Update to Mesa 7.0.3. tested my oga@ and johan@ 2008-05-31 16:36:47 +00:00
relnotes-7.0.3.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
relnotes-7.0.4.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
relnotes-7.0.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
relnotes-7.1.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
relnotes-7.2.1.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
relnotes-7.2.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.2 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.2.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.3 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.4 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.4.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.4.2 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-3.5 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-4.0 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-4.0.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-4.0.2 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-4.0.3 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-4.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-5.0 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-5.0.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-5.0.2 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-5.1 Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
RELNOTES-6.0 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.0.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.2 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.2.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.3 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.3.1 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.3.2 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
RELNOTES-6.4 Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
relnotes.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
repository.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
science.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
shading.html Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
sourcedocs.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
subset-A.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
subset.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
systems.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
thanks.html Mesa 7.0.1 2007-11-24 17:25:28 +00:00
utilities.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
utility.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
VERSIONS Mesa 7.2, Tested by ckuethe@, naddy@, oga@, and others. 2008-11-02 14:58:06 +00:00
versions.html import MesaLibs version 6.5.2 2007-03-03 11:56:24 +00:00
webmaster.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00
xlibdriver.html Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib 2006-11-25 18:49:17 +00:00

                        WindML Driver for Mesa 4.0


Requirements
------------

Tornado 2 + WindML, Cumulative Patchs are recommended. 
  
I suppose you have a valid WindML installation. Double buffer hardware
gives better performance than double buffer software so if you can
compile your WindML driver with this option, just do it. I/O
redirection is adviced in target server.


Tested on
---------

During the development, my main target was a CoolMonster:
- Video card: CT69000
- CPU: PENTIUM 266MHz

and my host a Windows NT + Tornado 2.


Installation
------------

1. Mesa sources must be in root directory (C:\)

2. Add the following line to your torVars.bat:
set MESA_BASE=C:\Mesa

OR copy the new torVars.bat in your bin path:
c:/Mesa/src/ugl/tornado/torVars.sample -> 
/mnt/nt/Tornado/host/x86-win32/bin/torVars (for example)

3. In a command prompt:
$ torVars
$ cd c:\Mesa
$ make -f Makefile.ugl CPU=PENTIUM

Take a long while...

5. Include all the files from ugldemos folder to build some downloadable
   application modules

4. Download UGL/Mesa object files on target

For example via the WindShell:
ld < c:\Tornado\target\lib\objMesaGL.o
ld < c:\Tornado\target\lib\objMesaUGL.o
ld < c:\Tornado\target\lib\objMesaGLU.o
ld < c:\Tornado\target\lib\objGLUTshapes.o
ld < c:\Tornado\target\lib\objMesaOS.o

You can put the previous lines in a file and use:
< filename

6. Download the application modules.

7. In WindShell, run:
-> uglalldemos

During the show some messages will appear, it provides some useful
information on key management.


Coding
------

Sample Usage:

In addition to the usual ugl calls to initialize UGL, (may be find an
input driver), you must do the following to use the UGL/Mesa interface:

1. Call uglMesaCreateContext() to create a UGL/Mesa rendering context,
   given the display format.

2. Call uglMesaMakeCurrent() to bind the UGL/Mesa buffers to an
   UGL/Mesa Context and to make the context the current one.

3. Make gl* calls to render your graphics.

4. Use uglMesaSwapBuffers() when double buffering to swap front/back buffers.

5. Before the UGL is destroyed, call MesaDestroyContext().

6. Before exiting, call if required uglEventQDestroy and then
   uglDeinitialize();

Limitations
-----------

I found the following limitations in my driver :
 - Color Indexed management is only in 8 bits
 - It's possible to mix UGL/OpenGL application with a software
   double buffer

Modifications
------------

New files in Mesa:
- Makefile.ugl
- rules.windmlmesa
- docs/README.UGL
- include/GL/uglmesa.h
- si-glu/Makefile.ugl
- src/Makefile.ugl
- src/ugl/torGLUTShapesInit.c
- src/ugl/torMesaUGLInit.c
- src/ugl/ugl_api.c
- src/ugl/ugl_dd.c
- src/ugl/ugl_glutshapes.c
- src/ugl/ugl_line.c
- src/ugl/ugl_span.c
- src/ugl/ugl_tri.c
- src/ugl/uglmesaP.h
- ugldemos/*

Modified files in Tornado 2.0:
- c:\Tornado\host\x86-win32\bin\torVars.bat
rem Command line build environments
set WIND_HOST_TYPE=x86-win32
set WIND_BASE=C:\Tornado
set MESA_BASE=C:\Mesa
set PATH=%WIND_BASE%\host\%WIND_HOST_TYPE%\bin;%PATH%
- c:\Tornado\target\config\comps\VxWorks\01uglmesa.cdf
- c:\Tornado\target\h\GL\*

Todo
----
- GCC 2.96, ASM compilation

Thanks to:
----------

Precision Insight team for their great job around Mesa, XFree, and DRI.
Wind River Systems to take me as an intern.


Stephane Raimbault
<stephane.raimbault@windriver.com>
<stephane.raimbault@deesse.univ-lemans.fr>

July 24, 2001