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 osmesa mesagdi
  15
  16 to build classic mesa Windows GDI drivers; or
  17
  18   scons libgl-gdi
  19
  20 to build gallium based GDI driver.
  21
  22 This will work both with MSVS or Mingw.
  23
  24
  25 Windows Drivers
  26 ------- -------
  27
  28 At this time, only the gallium GDI driver is known to work.
  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
  33 Recipe
  34 ------
  35
  36 Building on windows requires several open-source packages. These are
  37 steps that work as of this writing.
  38
  39 1) install python 2.7
  40 2) install scons (latest)
  41 3) install mingw, flex, and bison
  42 4) install libxml2 from here: http://www.lfd.uci.edu/~gohlke/pythonlibs
  43   get libxml2-python-2.9.1.win-amd64-py2.7.exe
  44 5) install pywin32 from here: http://www.lfd.uci.edu/~gohlke/pythonlibs
  45   get pywin32-218.4.win-amd64-py2.7.exe
  46 6) install git
  47 7) download mesa from git
  48   see http://www.mesa3d.org/repository.html
  49 8) run scons
  50
  51 General
  52 -------
  53
  54 After building, you can copy the above DLL files to a place in your
  55 PATH such as $SystemRoot/SYSTEM32.  If you don't like putting things
  56 in a system directory, place them in the same directory as the
  57 executable(s).  Be careful about accidentially overwriting files of
  58 the same name in the SYSTEM32 directory.
  59
  60 The DLL files are built so that the external entry points use the
  61 stdcall calling convention.
  62
  63 Static LIB files are not built.  The LIB files that are built with are
  64 the linker import files associated with the DLL files.
  65
  66 The si-glu sources are used to build the GLU libs.  This was done
  67 mainly to get the better tessellator code.
  68
  69 If you have a Windows-related build problem or question, please post
  70 to the mesa-dev or mesa-users list.