17ec681f3SmrgUsage
27ec681f3Smrg=====
37ec681f3Smrg
47ec681f3SmrgRequirements
57ec681f3Smrg^^^^^^^^^^^^
67ec681f3Smrg
77ec681f3Smrg* An x86 processor with AVX or above
87ec681f3Smrg* LLVM version 3.9 or later
97ec681f3Smrg* C++14 capable compiler
107ec681f3Smrg
117ec681f3SmrgBuilding
127ec681f3Smrg^^^^^^^^
137ec681f3Smrg
147ec681f3SmrgTo build with GNU automake, select building the swr driver at
157ec681f3Smrgconfigure time, for example: ::
167ec681f3Smrg
177ec681f3Smrg  configure --with-gallium-drivers=swrast,swr
187ec681f3Smrg
197ec681f3SmrgUsing
207ec681f3Smrg^^^^^
217ec681f3Smrg
227ec681f3SmrgOn Linux, building with autotools will create a drop-in alternative
237ec681f3Smrgfor libGL.so into::
247ec681f3Smrg
257ec681f3Smrg  lib/gallium/libGL.so
267ec681f3Smrg  lib/gallium/libswrAVX.so
277ec681f3Smrg  lib/gallium/libswrAVX2.so
287ec681f3Smrg
297ec681f3SmrgTo use it set the LD_LIBRARY_PATH environment variable accordingly.
307ec681f3Smrg
317ec681f3Smrg**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: ::
327ec681f3Smrg
337ec681f3Smrg  GALLIUM_DRIVER=swr
347ec681f3Smrg
357ec681f3SmrgTo verify OpenSWR is being used, check to see if a message like the following is printed when the application is started: ::
367ec681f3Smrg
377ec681f3Smrg  SWR detected AVX2
387ec681f3Smrg
39