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