1 Usage 2 ===== 3 4 Requirements 5 ^^^^^^^^^^^^ 6 7 * An x86 processor with AVX or above 8 * LLVM version 3.9 or later 9 * C++14 capable compiler 10 11 Building 12 ^^^^^^^^ 13 14 To build with GNU automake, select building the swr driver at 15 configure time, for example: :: 16 17 configure --with-gallium-drivers=swrast,swr 18 19 Using 20 ^^^^^ 21 22 On Linux, building with autotools will create a drop-in alternative 23 for libGL.so into:: 24 25 lib/gallium/libGL.so 26 lib/gallium/libswrAVX.so 27 lib/gallium/libswrAVX2.so 28 29 Alternatively, 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 35 To 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 41 To 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
