1Usage
2=====
3
4Requirements
5^^^^^^^^^^^^
6
7* An x86 processor with AVX or above
8* LLVM version 3.9 or later
9* C++14 capable compiler
10
11Building
12^^^^^^^^
13
14To build with GNU automake, select building the swr driver at
15configure time, for example: ::
16
17  configure --with-gallium-drivers=swrast,swr
18
19Using
20^^^^^
21
22On Linux, building with autotools will create a drop-in alternative
23for libGL.so into::
24
25  lib/gallium/libGL.so
26  lib/gallium/libswrAVX.so
27  lib/gallium/libswrAVX2.so
28
29Alternatively, building with SCons will produce::
30
31  build/linux-x86_64/gallium/targets/libgl-xlib/libGL.so
32  build/linux-x86_64/gallium/drivers/swr/libswrAVX.so
33  build/linux-x86_64/gallium/drivers/swr/libswrAVX2.so
34
35To use it set the LD_LIBRARY_PATH environment variable accordingly.
36
37**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: ::
38
39  GALLIUM_DRIVER=swr
40
41To verify OpenSWR is being used, check to see if a message like the following is printed when the application is started: ::
42
43  SWR detected AVX2
44
45