← Back to branch summary

~ubuntu-branches/ubuntu/quantal/mesa-glw/quantal

« back to all changes in this revision

Viewing changes to docs/README.WINDML

  • Committer: Bazaar Package Importer
  • Author(s): Morten Kjeldgaard
  • Date: 2008-05-06 16:19:15 UTC
  • Revision ID: james.westby@ubuntu.com-20080506161915-uynz7nftmfixu6bq
Tags: upstream-7.0.3
Import upstream version 7.0.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/README.WINDML
 
1
 
 
2
                        WindML Driver for Mesa 4.0
 
3
 
 
4
 
 
5
Requirements
 
6
------------
 
7
 
 
8
Tornado 2 + WindML, Cumulative Patchs are recommended. 
 
9
  
 
10
I suppose you have a valid WindML installation. Double buffer hardware
 
11
gives better performance than double buffer software so if you can
 
12
compile your WindML driver with this option, just do it. I/O
 
13
redirection is adviced in target server.
 
14
 
 
15
 
 
16
Tested on
 
17
---------
 
18
 
 
19
During the development, my main target was a CoolMonster:
 
20
- Video card: CT69000
 
21
- CPU: PENTIUM 266MHz
 
22
 
 
23
and my host a Windows NT + Tornado 2.
 
24
 
 
25
 
 
26
Installation
 
27
------------
 
28
 
 
29
1. Mesa sources must be in root directory (C:\)
 
30
 
 
31
2. Add the following line to your torVars.bat:
 
32
set MESA_BASE=C:\Mesa
 
33
 
 
34
OR copy the new torVars.bat in your bin path:
 
35
c:/Mesa/src/ugl/tornado/torVars.sample -> 
 
36
/mnt/nt/Tornado/host/x86-win32/bin/torVars (for example)
 
37
 
 
38
3. In a command prompt:
 
39
$ torVars
 
40
$ cd c:\Mesa
 
41
$ make -f Makefile.ugl CPU=PENTIUM
 
42
 
 
43
Take a long while...
 
44
 
 
45
5. Include all the files from ugldemos folder to build some downloadable
 
46
   application modules
 
47
 
 
48
4. Download UGL/Mesa object files on target
 
49
 
 
50
For example via the WindShell:
 
51
ld < c:\Tornado\target\lib\objMesaGL.o
 
52
ld < c:\Tornado\target\lib\objMesaUGL.o
 
53
ld < c:\Tornado\target\lib\objMesaGLU.o
 
54
ld < c:\Tornado\target\lib\objGLUTshapes.o
 
55
ld < c:\Tornado\target\lib\objMesaOS.o
 
56
 
 
57
You can put the previous lines in a file and use:
 
58
< filename
 
59
 
 
60
6. Download the application modules.
 
61
 
 
62
7. In WindShell, run:
 
63
-> uglalldemos
 
64
 
 
65
During the show some messages will appear, it provides some useful
 
66
information on key management.
 
67
 
 
68
 
 
69
Coding
 
70
------
 
71
 
 
72
Sample Usage:
 
73
 
 
74
In addition to the usual ugl calls to initialize UGL, (may be find an
 
75
input driver), you must do the following to use the UGL/Mesa interface:
 
76
 
 
77
1. Call uglMesaCreateContext() to create a UGL/Mesa rendering context,
 
78
   given the display format.
 
79
 
 
80
2. Call uglMesaMakeCurrent() to bind the UGL/Mesa buffers to an
 
81
   UGL/Mesa Context and to make the context the current one.
 
82
 
 
83
3. Make gl* calls to render your graphics.
 
84
 
 
85
4. Use uglMesaSwapBuffers() when double buffering to swap front/back buffers.
 
86
 
 
87
5. Before the UGL is destroyed, call MesaDestroyContext().
 
88
 
 
89
6. Before exiting, call if required uglEventQDestroy and then
 
90
   uglDeinitialize();
 
91
 
 
92
Limitations
 
93
-----------
 
94
 
 
95
I found the following limitations in my driver :
 
96
 - Color Indexed management is only in 8 bits
 
97
 - It's possible to mix UGL/OpenGL application with a software
 
98
   double buffer
 
99
 
 
100
Modifications
 
101
------------
 
102
 
 
103
New files in Mesa:
 
104
- Makefile.ugl
 
105
- rules.windmlmesa
 
106
- docs/README.UGL
 
107
- include/GL/uglmesa.h
 
108
- si-glu/Makefile.ugl
 
109
- src/Makefile.ugl
 
110
- src/ugl/torGLUTShapesInit.c
 
111
- src/ugl/torMesaUGLInit.c
 
112
- src/ugl/ugl_api.c
 
113
- src/ugl/ugl_dd.c
 
114
- src/ugl/ugl_glutshapes.c
 
115
- src/ugl/ugl_line.c
 
116
- src/ugl/ugl_span.c
 
117
- src/ugl/ugl_tri.c
 
118
- src/ugl/uglmesaP.h
 
119
- ugldemos/*
 
120
 
 
121
Modified files in Tornado 2.0:
 
122
- c:\Tornado\host\x86-win32\bin\torVars.bat
 
123
rem Command line build environments
 
124
set WIND_HOST_TYPE=x86-win32
 
125
set WIND_BASE=C:\Tornado
 
126
set MESA_BASE=C:\Mesa
 
127
set PATH=%WIND_BASE%\host\%WIND_HOST_TYPE%\bin;%PATH%
 
128
- c:\Tornado\target\config\comps\VxWorks\01uglmesa.cdf
 
129
- c:\Tornado\target\h\GL\*
 
130
 
 
131
Todo
 
132
----
 
133
- GCC 2.96, ASM compilation
 
134
 
 
135
Thanks to:
 
136
----------
 
137
 
 
138
Precision Insight team for their great job around Mesa, XFree, and DRI.
 
139
Wind River Systems to take me as an intern.
 
140
 
 
141
 
 
142
Stephane Raimbault
 
143
<stephane.raimbault@windriver.com>
 
144
<stephane.raimbault@deesse.univ-lemans.fr>
 
145
 
 
146
July 24, 2001