blob: e0e5b9b2ddf798c47152817521f669eb4a56b0d0 [file] [log] [blame]
José Fonseca60159c12008-02-28 16:34:32 +09001File: docs/README.WIN32
2
Bill York191795e2013-06-19 10:18:00 -06003Last updated: 21 June 2013
Brian Paulaf4e2f42011-01-20 18:52:39 -07004
José Fonseca60159c12008-02-28 16:34:32 +09005
6Quick Start
7----- -----
8
José Fonsecac2c44f22011-04-23 13:18:45 +01009Windows drivers are build with SCons. Makefiles or Visual Studio projects are
10no longer shipped or supported.
José Fonseca60159c12008-02-28 16:34:32 +090011
José Fonsecac2c44f22011-04-23 13:18:45 +010012Run
José Fonseca60159c12008-02-28 16:34:32 +090013
Jose Fonseca17b28252015-03-03 14:52:15 +000014 scons osmesa
José Fonseca60159c12008-02-28 16:34:32 +090015
Jose Fonseca17b28252015-03-03 14:52:15 +000016to build classic osmesa driver; or
José Fonseca60159c12008-02-28 16:34:32 +090017
José Fonsecac2c44f22011-04-23 13:18:45 +010018 scons libgl-gdi
José Fonseca60159c12008-02-28 16:34:32 +090019
José Fonsecac2c44f22011-04-23 13:18:45 +010020to build gallium based GDI driver.
José Fonseca60159c12008-02-28 16:34:32 +090021
José Fonseca3ab19bf2011-08-29 13:35:49 +010022This will work both with MSVS or Mingw.
23
José Fonseca60159c12008-02-28 16:34:32 +090024
25Windows Drivers
26------- -------
27
José Fonsecac2c44f22011-04-23 13:18:45 +010028At this time, only the gallium GDI driver is known to work.
José Fonseca60159c12008-02-28 16:34:32 +090029
30Source code also exists in the tree for other drivers in
31src/mesa/drivers/windows, but the status of this code is unknown.
32
Bill York191795e2013-06-19 10:18:00 -060033Recipe
34------
35
36Building on windows requires several open-source packages. These are
37steps that work as of this writing.
38
José Fonseca2de70fe2014-03-24 15:41:08 +000039- 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 York191795e2013-06-19 10:18:00 -060043 get pywin32-218.4.win-amd64-py2.7.exe
José Fonseca2de70fe2014-03-24 15:41:08 +000044- install git
45- download mesa from git
Bill York191795e2013-06-19 10:18:00 -060046 see http://www.mesa3d.org/repository.html
José Fonseca2de70fe2014-03-24 15:41:08 +000047- run scons
José Fonseca60159c12008-02-28 16:34:32 +090048
49General
50-------
51
52After building, you can copy the above DLL files to a place in your
53PATH such as $SystemRoot/SYSTEM32. If you don't like putting things
54in a system directory, place them in the same directory as the
55executable(s). Be careful about accidentially overwriting files of
56the same name in the SYSTEM32 directory.
57
58The DLL files are built so that the external entry points use the
59stdcall calling convention.
60
61Static LIB files are not built. The LIB files that are built with are
62the linker import files associated with the DLL files.
63
64The si-glu sources are used to build the GLU libs. This was done
65mainly to get the better tessellator code.
66
Brian Paulaf4e2f42011-01-20 18:52:39 -070067If you have a Windows-related build problem or question, please post
68to the mesa-dev or mesa-users list.