1 README for port of Mesa 3.x to XFree86 on OS/2 (X/2) 2 (as of 19990514) 3 4 5 Contents: 6 7 1) Binary release 8 2) Building from sources 9 3) History 10 4) Todo 11 5) Mesa Home Page 12 13 141) Binary release 15 16 Though the Mesa sources should build in a quite reasonable time even on 17 a 585 class machine a binary relase is available (check topic 4) for an URL) 18 This package includes: 19 20 - lib/MesaGL.dll, MesaGL.a 21 - lib/MesaGLU.dll, MesaGLU.a 22 - lib/glut.dll, glut.a 23 - include/GL/*.h 24 25 Installing this in your XFree86 tree will enable you to build and 26 run all applications compatible with Mesa (and the current DLL 27 interface, of course ;-) 28 As usual the OMF-style libraries can be created using emxomf. 29 (e.g. "emxomf foo.a" creates the foo.lib omf-style library). 30 The static libraries are rarely used and you have to rebuild 31 Mesa to get them. They're a supported target, so you get 32 them in a straightforward way (see below). 33 34 The testing of these libraries was limited to the supplied 35 demos/examples and a quite small number of third-party apps. 36 No warranty ... as usual ... ;-) 37 38 392) Instructions to build Mesa 3.x for XFree86/OS2 from sources: 40 41 Except the official Mesa source distribution you need: 42 - a recent version of XFree86 (3.3.x or above) including 43 the programming libraries 44 - EMX 0.9c (0.9d might work, never checked) 45 - GNU make 46 - REXX (!) 47 48 The creation of the DLLs as well as of the static libraries 49 (if you want to have them) is handled in "mklib-emx.cmd", 50 a small REXX script. Perhaps not the best idea, but this 51 way it fits best in the scheme used to build libraries 52 on all platforms in Mesa 3.x. 53 54 To actually build the libraries and demos, check mklib-emx.cmd 55 and modify it as desired. Then type 56 make os2-x11 57 and wait for completion ;-) 58 59 603) History 61 62 Initially Darren Abbott (abbott@hiwaay.net) ported Mesa versions 2.x 63 to XFree86 OS/2. This port might still be available from 64 http://fly.HiWAAY.net/~abbott/xfree86-os2/xfree86.html 65 66 The current port picked up things during the beta test for 3.0. 67 No major changes in the source were done. The build mechanism under OS/2 68 has been made very similar to other platforms (if you treat mklib-emx.cmd 69 as a "black box"). 70 Advantage is that X/2 is now a valid target and all files are 71 integrated in the official source distribution. 72 Disadvantage is that this port (i.e. the DLLs' interface itself) is 73 definitly NOT COMPATIBLE to those of version 2.x. 74 It's uncertain whether this would be at all possible but since there 75 a _very_ few those apps it's not worth to find out anyway. 76 Also some libs (MesaTK, MesaAUX) are withdrawn from the Mesa distribution, 77 and accordingly from the OS/2 port. 78 794) Todo 80 81 By now binary compatiblity is ensured by using the function names 82 as entry points instead of ordinals. This might cost performance and 83 is subject to change in future. In addition the supplied X86 assembler 84 source is not used yet. 85 865) Mesa Home Page 87 88 You can get the source code and more information about Mesa from 89 http://www.mesa3d.org/ 90 91 The OS/2 ports should be available from 92 http://r350.ee.ntu.edu.tw/~hcchu/os2/ports 93 94-- 95Alexander Mai 96st002279@hrzpub.tu-darmstadt.de 97