mesa/docs
John Bates 5de56937a3 disk_cache: build option for disabled-by-default
On some systems it is problematic to have the shader cache enabled
by default. This adds a build option to support the disk cache but
keep it disabled unless the environment variable
MESA_GLSL_CACHE_DISABLE=false.

For example, on Chrome OS, Chrome already has it's own shader
disk cache implementation so it disables the mesa feature. Tests
do not want the shader disk cache enabled because it can cause
inconsistent performance results and the default 1GB for the
disk cache could lead to problems that require more effort to
work around. The Mesa shader disk cache is useful for VMs though,
where it is easy to configure the feature with environment
variables. With the current version of Mesa, Chrome OS would need
to have a system-wide environment variable to disable the disk
cache everywhere except where needed. More elegant to just build
Mesa with the cache feature disabled by default.

Reviewed-by: Rob Clark <robdclark@chromium.org>
Reviewed-by: Eric Anholt <eric@anholt.net>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/6967>
2020-10-09 16:52:49 +00:00
..
_extra/specs docs: include specs into the generated docs 2020-06-13 10:42:01 +00:00
_exts docs: remove webmaster article 2020-09-28 07:51:31 +00:00
ci docs: Sandybridge -> Sandy Bridge 2020-09-30 08:18:21 +00:00
gallium gallium: add pipe_context::set_inlinable_constants 2020-10-07 17:30:12 +00:00
relnotes radv/aco: Enable NGG GS by default. 2020-10-09 15:26:15 +02: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
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: show 'Edit on GitLab'-link 2020-09-28 07:46:33 +00:00
conform.rst docs: Replace ancient swrast conformance docs with more current information. 2020-06-16 20:54:44 +00:00
contents.rst docs: remove webmaster article 2020-09-28 07:51:31 +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: use ref-links for internal references 2020-06-28 09:06:57 +00:00
download.rst docs: git -> Git 2020-09-30 08:18:21 +00:00
egl.rst docs: initialisation -> initialization 2020-09-28 07:54:25 +00:00
envvars.rst disk_cache: build option for disabled-by-default 2020-10-09 16:52:49 +00:00
extensions.rst docs: convert articles to reructuredtext 2020-06-13 10:42:00 +00:00
faq.rst docs: update internal references 2020-06-16 20:36:38 +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 zink: enable pipe caps for ARB_timer_query 2020-10-06 12:17:31 +00:00
helpwanted.rst docs: git -> Git 2020-09-30 08:18:21 +00:00
index.rst docs: gallium -> Gallium 2020-09-29 09:00:36 +00:00
install.rst docs: visual studio -> Visual Studio 2020-09-30 08:18:21 +00:00
libGL.txt glx: turn LIBGL_ALWAYS_INDIRECT into a boolean 2017-09-12 13:53:12 +01:00
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: cmake -> CMake 2020-09-30 08:18:21 +00:00
opengles.rst docs: update internal references 2020-06-16 20:36:38 +00:00
osmesa.rst docs: gallium -> Gallium 2020-09-29 09:00:36 +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.rst add one last 20.1 release to coincide with expected 20.2.1 2020-09-30 20:20:40 +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: git -> Git 2020-09-30 08:18:21 +00:00
relnotes.rst docs: update calendar and link releases notes for 20.1.9 2020-09-30 20:20:40 +00:00
repository.rst docs: git -> Git 2020-09-30 08:18:21 +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: gallium -> Gallium 2020-09-29 09:00:36 +00:00
submittingpatches.rst docs: quote "git log" 2020-09-30 08:18:21 +00:00
systems.rst docs: vmware -> VMWare 2020-09-30 08:18:21 +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: bpp -> BPP 2020-09-30 08:18:20 +00:00
viewperf.rst docs: gallium -> Gallium 2020-09-29 09:00:36 +00:00
vmware-guest.rst docs: ubuntu -> Ubuntu 2020-09-30 08:18:21 +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.