| Usage |
| ===== |
| |
| Requirements |
| ^^^^^^^^^^^^ |
| |
| * An x86 processor with AVX or above |
| * LLVM version 3.9 or later |
| * C++14 capable compiler |
| |
| 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 with autotools will create a drop-in alternative |
| for libGL.so into:: |
| |
| lib/gallium/libGL.so |
| lib/gallium/libswrAVX.so |
| lib/gallium/libswrAVX2.so |
| |
| Alternatively, building with SCons will produce:: |
| |
| build/linux-x86_64/gallium/targets/libgl-xlib/libGL.so |
| build/linux-x86_64/gallium/drivers/swr/libswrAVX.so |
| build/linux-x86_64/gallium/drivers/swr/libswrAVX2.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 |
| |
