docs/README.WIN32

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