mesa/docs
Vedran Miletić 2fba72046d clover: Introduce CLOVER_EXTRA_*_OPTIONS environment variables
The options specified in the CLOVER_EXTRA_BUILD_OPTIONS shell
variable are appended to the options specified by the OpenCL program
in the clBuildProgram function call, if any.
Analogously, the options specified in the CLOVER_EXTRA_COMPILE_OPTIONS
and CLOVER_EXTRA_LINK_OPTIONS variables are appended to the options
specified in clCompileProgram and clLinkProgram function calls,
respectively.

v2:
 * rename to CLOVER_EXTRA_COMPILER_OPTIONS
 * use debug_get_option
 * append to linker options as well

v3: code cleanups

v4: separate CLOVER_EXTRA_LINKER_OPTIONS options

v5:
 * fix documentation typo
 * use CLOVER_EXTRA_COMPILER_OPTIONS in link stage

v6:
 * separate in CLOVER_EXTRA_{BUILD,COMPILE,LINK}_OPTIONS
 * append options in cl{Build,Compile,Link}Program

Signed-off-by: Vedran Miletić <vedran@miletic.net>
Reviewed-by[v1]: Edward O'Callaghan <funfunctor@folklore1984.net>

v7 [Francisco Jerez]: Slight simplification.

Reviewed-by: Francisco Jerez <currojerez@riseup.net>
2016-10-30 12:45:26 -07:00
..
relnotes docs: add 13.1.0-devel release notes template, bump version 2016-10-19 19:10:16 +01:00
specs docs/specs: Update allocated EGL enum values 2016-10-14 11:19:41 -07:00
application-issues.html
ARB_color_buffer_float.txt
autoconf.html
bugs.html
conform.html
contents.html
debugging.html
developers.html i965/docs: update Intel Linux Graphics URLs 2016-07-06 13:18:23 -07:00
devinfo.html docs: add links to clarify patch mailing section 2016-08-26 14:54:26 -07:00
dispatch.html
download.html docs: add HTTP link for Mesa downloads 2016-03-29 18:13:46 -06:00
egl.html docs/egl: Android platform can also be build using autotools 2016-05-24 16:24:54 +01:00
envvars.html clover: Introduce CLOVER_EXTRA_*_OPTIONS environment variables 2016-10-30 12:45:26 -07:00
extensions.html
faq.html i965/docs: update Intel Linux Graphics URLs 2016-07-06 13:18:23 -07:00
features.txt gallium: add PIPE_CAP_STREAM_OUTPUT_INTERLEAVE_BUFFERS 2016-10-22 12:02:35 -04:00
gears.png
helpwanted.html docs/helpwanted: fix GL3.txt/features.txt link 2016-08-30 14:38:57 -07:00
index.html docs: add news item and link release notes for 12.0.3 2016-09-15 11:31:06 +01:00
install.html docs: use latest libDRM version 2016-03-23 12:56:32 -06:00
intro.html docs: update the list of Mesa major versions and API support 2016-09-30 09:17:33 -06:00
libGL.txt
license.html docs: minor updates to license.html file 2016-04-01 09:50:08 -06:00
lists.html
llvmpipe.html
mangling.html
mesa.css
opengles.html
osmesa.html
patents.txt
perf.html
postprocess.html
precompiled.html
README.UVD
README.VCE
README.WIN32
relnotes.html docs: add news item and link release notes for 12.0.3 2016-09-15 11:31:06 +01:00
repository.html docs: update the instructions for getting a git account 2016-04-25 14:10:40 -06:00
shading.html
sourcedocs.html
sourcetree.html
systems.html docs: update link to Intel's graphics website 2016-04-25 14:10:40 -06:00
thanks.html
utilities.html docs: fix Coverity URL 2016-04-11 09:10:39 -06:00
VERSIONS
versions.html
viewperf.html
vmware-guest.html
webmaster.html
xlibdriver.html mesa: standardize naming Mesa3D, MESA -> Mesa 2016-07-26 13:28:01 -07:00

File: docs/README.WIN32

Last updated: 21 June 2013


Quick Start
----- -----

Windows drivers are build with SCons.  Makefiles or Visual Studio projects are
no longer shipped or supported.

Run

  scons libgl-gdi

to build gallium based GDI driver.

This will work both with MSVS or Mingw.


Windows Drivers
------- -------

At this time, only the gallium GDI driver is known to work.

Source code also exists in the tree for other drivers in
src/mesa/drivers/windows, but the status of this code is unknown.

Recipe
------

Building on windows requires several open-source packages. These are
steps that work as of this writing.

- install python 2.7
- install scons (latest)
- install mingw, flex, and bison
- install pywin32 from here: http://www.lfd.uci.edu/~gohlke/pythonlibs
  get pywin32-218.4.win-amd64-py2.7.exe
- install git
- download mesa from git
  see http://www.mesa3d.org/repository.html
- run scons

General
-------

After building, you can copy the above DLL files to a place in your
PATH such as $SystemRoot/SYSTEM32.  If you don't like putting things
in a system directory, place them in the same directory as the
executable(s).  Be careful about accidentially overwriting files of
the same name in the SYSTEM32 directory.

The DLL files are built so that the external entry points use the
stdcall calling convention.

Static LIB files are not built.  The LIB files that are built with are
the linker import files associated with the DLL files.

The si-glu sources are used to build the GLU libs.  This was done
mainly to get the better tessellator code.

If you have a Windows-related build problem or question, please post
to the mesa-dev or mesa-users list.