mesa/docs
Erik Faye-Lund 12760d0480 docs: show 'Edit on GitLab'-link
It's easier to contribute to the documentation if we have links to the
document on GitLab. This will allow people to easily edit docs, or to
realize where in the source-tree they are without having to search.

Reviewed-by: Eric Engestrom <eric@engestrom.ch>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/6742>
2020-09-28 07:46:33 +00:00
..
_extra/specs
_exts docs: fixup envvar output 2020-07-07 10:22:08 +00:00
ci docs: Explain how to set up a personal gitlab runner. 2020-07-31 09:17:02 +00:00
gallium gallium: rename PIPE_TRANSFER_* -> PIPE_MAP_* 2020-09-22 03:20:54 +00:00
relnotes docs: escape backquote character 2020-09-28 07:43:28 +00:00
application-issues.rst
ARB_color_buffer_float.txt
bugs.rst
codingstyle.rst
conf.py docs: show 'Edit on GitLab'-link 2020-09-28 07:46:33 +00:00
conform.rst
contents.rst docs: Move the conformance and the CI docs to a top level Testing section. 2020-07-08 20:13:11 +00:00
debugging.rst
developers.rst
devinfo.rst
dispatch.rst docs: use ref-links for internal references 2020-06-28 09:06:57 +00:00
download.rst docs/download: mention tarball GPG signatures and link to the keys 2020-09-16 06:33:36 +00:00
egl.rst egl: document which driver hooks are only required by extensions 2020-08-27 23:06:55 +02:00
envvars.rst aco: add ACO_DEBUG=novn,noopt,nosched for debugging purposes 2020-08-27 10:23:51 +00:00
extensions.rst
faq.rst
favicon.ico docs: update favicon 2020-06-26 12:09:22 +00:00
favicon.svg docs: update favicon 2020-06-26 12:09:22 +00:00
features.txt zink: implement ARB_instanced_arrays 2020-09-24 20:40:39 +00:00
helpwanted.rst
index.rst
install.rst
libGL.txt
license.rst
lists.rst
meson.rst docs: fix a bunch of typos 2020-07-09 14:06:34 +00:00
opengles.rst
osmesa.rst
perf.rst
precompiled.rst
README.UVD
README.VCE
README.WIN32
release-calendar.rst docs: update calendar and link releases notes for 20.1.8 2020-09-16 19:43:27 +02:00
release-maintainers-keys.asc
releasing.rst docs/releasing: improve wording 2020-07-22 21:55:58 +00:00
relnotes.rst docs: update calendar and link releases notes for 20.1.8 2020-09-16 19:43:27 +02:00
repository.rst docs: use ref-links for internal references 2020-06-28 09:06:57 +00:00
shading.rst
sourcedocs.rst
sourcetree.rst docs: add some missing stuff to sourcetree.rst 2020-07-09 09:18:14 +00:00
submittingpatches.rst docs: change "Fixes:" tag example to match git fixes output 2020-07-29 15:25:24 +00:00
systems.rst docs: Stop claiming to implement OpenVG 2020-09-01 07:50:21 +00:00
thanks.rst docs: fix a bunch of typos 2020-07-09 14:06:34 +00:00
utilities.rst
versions.rst docs: fix internal references 2020-06-28 09:06:57 +00:00
viewperf.rst
vmware-guest.rst
webmaster.rst
xlibdriver.rst

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 https://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.