usage.rst 902 Bytes
Newer Older
1 2 3 4 5 6
Usage
=====

Requirements
^^^^^^^^^^^^

Tim Rowley's avatar
Tim Rowley committed
7 8 9
* An x86 processor with AVX or above
* LLVM version 3.9 or later
* C++14 capable compiler
10 11 12 13 14 15 16 17 18 19 20 21

Building
^^^^^^^^

To build with GNU automake, select building the swr driver at
configure time, for example: ::

  configure --with-gallium-drivers=swrast,swr

Using
^^^^^

Tim Rowley's avatar
Tim Rowley committed
22 23
On Linux, building with autotools will create a drop-in alternative
for libGL.so into::
24 25

  lib/gallium/libGL.so
Tim Rowley's avatar
Tim Rowley committed
26 27
  lib/gallium/libswrAVX.so
  lib/gallium/libswrAVX2.so
28 29 30 31 32 33 34 35 36 37 38

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