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 - 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
  43   get pywin32-218.4.win-amd64-py2.7.exe
  44 - install git
  45 - download mesa from git
  46   see http://www.mesa3d.org/repository.html
  47 - run scons
  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
  67 If you have a Windows-related build problem or question, please post
  68 to the mesa-dev or mesa-users list.