gallium/docs - add OpenSWR documentation

Acked-by: Jose Fonseca <jfonseca@vmware.com>
This commit is contained in:
Tim Rowley
2016-02-24 18:28:13 -06:00
parent da4f95d168
commit d003be2a30
5 changed files with 381 additions and 0 deletions

View File

@@ -0,0 +1,38 @@
Usage
=====
Requirements
^^^^^^^^^^^^
* An x86 processor with AVX or AVX2
* LLVM version 3.6 or later
Building
^^^^^^^^
To build with GNU automake, select building the swr driver at
configure time, for example: ::
configure --with-gallium-drivers=swrast,swr
Using
^^^^^
On Linux, building will create a drop-in alternative for libGL.so into::
lib/gallium/libGL.so
or::
build/foo/gallium/targets/libgl-xlib/libGL.so
To use it set the LD_LIBRARY_PATH environment variable accordingly.
**IMPORTANT:** Mesa will default to using llvmpipe or softpipe as the default software renderer. To select the OpenSWR driver, set the GALLIUM_DRIVER environment variable appropriately: ::
GALLIUM_DRIVER=swr
To verify OpenSWR is being used, check to see if a message like the following is printed when the application is started: ::
SWR detected AVX2