summaryrefslogtreecommitdiffstats
path: root/src/gallium/docs/source/drivers/openswr/usage.rst
blob: e55b4211a54d77b14f6eb87b16a0ffac99ada0f1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
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