José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 1 | File: docs/README.WIN32 |
| 2 | |
Bill York | 191795e | 2013-06-19 10:18:00 -0600 | [diff] [blame] | 3 | Last updated: 21 June 2013 |
Brian Paul | af4e2f4 | 2011-01-20 18:52:39 -0700 | [diff] [blame] | 4 | |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 5 | |
| 6 | Quick Start |
| 7 | ----- ----- |
| 8 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 9 | Windows drivers are build with SCons. Makefiles or Visual Studio projects are |
| 10 | no longer shipped or supported. |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 11 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 12 | Run |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 13 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 14 | scons osmesa mesagdi |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 15 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 16 | to build classic mesa Windows GDI drivers; or |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 17 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 18 | scons libgl-gdi |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 19 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 20 | to build gallium based GDI driver. |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 21 | |
José Fonseca | 3ab19bf | 2011-08-29 13:35:49 +0100 | [diff] [blame] | 22 | This will work both with MSVS or Mingw. |
| 23 | |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 24 | |
| 25 | Windows Drivers |
| 26 | ------- ------- |
| 27 | |
José Fonseca | c2c44f2 | 2011-04-23 13:18:45 +0100 | [diff] [blame] | 28 | At this time, only the gallium GDI driver is known to work. |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 29 | |
| 30 | Source code also exists in the tree for other drivers in |
| 31 | src/mesa/drivers/windows, but the status of this code is unknown. |
| 32 | |
Bill York | 191795e | 2013-06-19 10:18:00 -0600 | [diff] [blame] | 33 | Recipe |
| 34 | ------ |
| 35 | |
| 36 | Building on windows requires several open-source packages. These are |
| 37 | steps that work as of this writing. |
| 38 | |
José Fonseca | 2de70fe | 2014-03-24 15:41:08 +0000 | [diff] [blame] | 39 | - install python 2.7 |
| 40 | - install scons (latest) |
| 41 | - install mingw, flex, and bison |
| 42 | - install pywin32 from here: http://www.lfd.uci.edu/~gohlke/pythonlibs |
Bill York | 191795e | 2013-06-19 10:18:00 -0600 | [diff] [blame] | 43 | get pywin32-218.4.win-amd64-py2.7.exe |
José Fonseca | 2de70fe | 2014-03-24 15:41:08 +0000 | [diff] [blame] | 44 | - install git |
| 45 | - download mesa from git |
Bill York | 191795e | 2013-06-19 10:18:00 -0600 | [diff] [blame] | 46 | see http://www.mesa3d.org/repository.html |
José Fonseca | 2de70fe | 2014-03-24 15:41:08 +0000 | [diff] [blame] | 47 | - run scons |
José Fonseca | 60159c1 | 2008-02-28 16:34:32 +0900 | [diff] [blame] | 48 | |
| 49 | General |
| 50 | ------- |
| 51 | |
| 52 | After building, you can copy the above DLL files to a place in your |
| 53 | PATH such as $SystemRoot/SYSTEM32. If you don't like putting things |
| 54 | in a system directory, place them in the same directory as the |
| 55 | executable(s). Be careful about accidentially overwriting files of |
| 56 | the same name in the SYSTEM32 directory. |
| 57 | |
| 58 | The DLL files are built so that the external entry points use the |
| 59 | stdcall calling convention. |
| 60 | |
| 61 | Static LIB files are not built. The LIB files that are built with are |
| 62 | the linker import files associated with the DLL files. |
| 63 | |
| 64 | The si-glu sources are used to build the GLU libs. This was done |
| 65 | mainly to get the better tessellator code. |
| 66 | |
Brian Paul | af4e2f4 | 2011-01-20 18:52:39 -0700 | [diff] [blame] | 67 | If you have a Windows-related build problem or question, please post |
| 68 | to the mesa-dev or mesa-users list. |