llvmpipe: Simple description/instructions.
[mesa.git] / src / gallium / drivers / llvmpipe / README
1 LLVMPIPE -- a fork of softpipe that employs LLVM for code generation.
2
3
4 Requirements
5 ============
6
7 - Linux
8
9 - LLVM. On Debian based distributions do:
10
11 aptitude install llvm-dev
12
13 - A x86 or amd64 processor with support for sse2, sse3, and sse4.1 SIMD
14 instructions. This is necessary because we emit several SSE intrinsics for
15 convenience. See /proc/cpuinfo to know what your CPU supports.
16
17 - scons (although it should be straightforward to fix the Makefiles as well)
18
19
20 Building
21 ========
22
23 To build everything invoke scons as:
24
25 scons debug=yes statetrackers=mesa drivers=llvmpipe winsys=xlib dri=false -k
26
27
28 Using
29 =====
30
31 Building will create a drop-in alternative for libGL.so. To use it set the
32 environment variables:
33
34 export LD_LIRBARY_PATH=$PWD/build/linux-x86-debug/lib:$LD_LIRBARY_PATH
35 export LD_LIRBARY_PATH=$PWD/build/linux-x86_64-debug/lib:$LD_LIRBARY_PATH
36
37
38 Unit testing
39 ============
40
41 Building will also create several unit tests in
42 build/linux-???-debug/gallium/drivers/llvmpipe:
43
44 - lp_test_blend: blending
45 - lp_test_conv: SIMD vector conversion
46 - lp_test_format: pixel unpacking/packing
47
48