mesa/docs
Erik Faye-Lund b416ae2023 docs: simplify format requirements
When I initially started writing these lists, I expected the lists to be
much less uniform in what bits were required. Turns out I was wrong, and
this ended up really neat and orderly.

I'm sure we're missing some defacto requirements here and there,
especially for the early versions. This list is based on what we check
for in version.c, and it's better than nothing.

Suggested by Mike Blumenkrantz.

Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602>
2021-03-19 14:07:42 +00:00
..
_extra/specs docs: Update Mesa GL enum allocations for EGL_MESA_platform_xcb 2020-11-19 21:07:12 +00:00
_exts docs: specify redirects in conf.py instead 2020-10-21 18:11:39 +00:00
ci docs: fix invalid rst syntax 2021-02-04 13:38:40 +00:00
drivers docs: simplify format requirements 2021-03-19 14:07:42 +00:00
gallium gallium: add a sampler reduction cap + settings 2021-03-12 00:05:24 +00:00
relnotes lavapipe: support VK_KHR_copy_commands2 2021-03-18 17:14:58 -04:00
ARB_color_buffer_float.txt
README.UVD
README.VCE
README.WIN32 docs: https all the links \o/ 2017-02-09 11:28:15 +00:00
android.rst ci: Fix selection of linker in Android builds 2021-02-08 14:19:06 +00:00
application-issues.rst docs: update internal references 2020-06-16 20:36:38 +00:00
bugs.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
codingstyle.rst docs: gallium -> Gallium 2020-09-29 09:00:36 +00:00
conf.py docs: inline contents.rst into index.rst 2020-12-01 18:32:31 +00:00
conform.rst docs: Replace ancient swrast conformance docs with more current information. 2020-06-16 20:54:44 +00:00
debugging.rst docs: scons -> SCons 2020-09-30 08:18:21 +00:00
developers.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
devinfo.rst docs: drop open-coded toc for articles 2020-06-13 10:42:01 +00:00
dispatch.rst docs: Document USE_ELF_TLS can work on Windows too 2021-02-23 17:06:48 +00:00
download.rst docs: git -> Git 2020-09-30 08:18:21 +00:00
egl.rst docs/egl.rst: switch true→enabled 2020-12-22 17:02:28 +00:00
envvars.rst aco: add ACO_DEBUG=liveinfo 2021-03-19 11:27:05 +00:00
extensions.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
faq.rst docs: s3tc -> S3TC 2020-10-28 10:27:51 +00:00
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 lavapipe: support VK_KHR_copy_commands2 2021-03-18 17:14:58 -04:00
helpwanted.rst docs: gcc -> GCC 2020-10-28 10:27:51 +00:00
history.rst docs: break project history out of front-page 2020-12-01 18:32:31 +00:00
index.rst docs: Add a stub page for Panfrost 2020-12-17 01:07:54 +00:00
install.rst docs: clang -> Clang 2020-10-28 10:27:51 +00:00
libGL.txt
license.rst docs: reformat license table as rst table 2020-06-13 10:42:01 +00:00
lists.rst docs: git -> Git 2020-09-30 08:18:21 +00:00
meson.rst docs: clang -> Clang 2020-10-28 10:27:51 +00:00
opengles.rst docs: update internal references 2020-06-16 20:36:38 +00:00
osmesa.rst mesa: Retire classic OSMesa. 2020-12-10 18:38:13 +00:00
perf.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
precompiled.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
release-calendar.csv docs: Add calendar entries for 21.0 release. 2021-03-11 16:43:46 -08:00
release-calendar.rst docs: store the release-calendar information in csv (and fix tests) 2021-01-07 00:07:56 +00:00
release-maintainers-keys.asc docs: cat maintainer keys to a single file 2020-06-22 23:07:16 +00:00
releasing.rst docs: store the release-calendar information in csv (and fix tests) 2021-01-07 00:07:56 +00:00
relnotes.rst docs: update calendar and link releases notes for 21.0.0 2021-03-11 16:43:46 -08:00
repository.rst docs: grammar fixes 2020-11-27 19:06:01 +00:00
shading.rst docs: drop open-coded toc for articles 2020-06-13 10:42:01 +00:00
sourcedocs.rst docs: git -> Git 2020-09-30 08:18:21 +00:00
sourcetree.rst docs: Update Panfrost in the source tree 2020-12-19 14:29:44 +00:00
submittingpatches.rst docs: quote "git log" 2020-09-30 08:18:21 +00:00
systems.rst docs/systems: Update Panfrost link 2020-12-19 14:29:44 +00:00
thanks.rst docs: git -> Git 2020-09-30 08:18:21 +00:00
utilities.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
versions.rst docs: move major versions history out of front-page 2020-12-01 18:32:31 +00:00
viewperf.rst docs: gallium -> Gallium 2020-09-29 09:00:36 +00:00
xlibdriver.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00

README.WIN32

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.