6 This directory contains a Gallium3D pipe driver which traces all incoming calls.
11 To build, invoke scons on the top dir as
13 scons statetrackers=mesa drivers=softpipe,i965simple,trace winsys=xlib
20 ln -s libGL.so build/linux-x86-debug/gallium/winsys/xlib/libGL.so.1
21 export LD_LIBRARY_PATH=$PWD/build/linux-x86-debug/gallium/winsys/xlib
23 ensure the right libGL.so is being picked by doing
29 GALLIUM_TRACE=tri.trace progs/trivial/tri
31 which should create a tri.trace file, which is an XML file. You can view copying
32 trace.xsl to the same directory, and opening with a XSLT capable browser such as
33 Firefox or Internet Explorer.
38 You can integrate the trace pipe driver either inside the state tracker or the
39 winsys. The procedure on both cases is the same. Let's assume you have a
40 pipe_screen and a pipe_context pair obtained by the usual means (variable and
41 function names are just for illustration purposes):
43 real_screen = real_screen_create(...);
45 real_context = real_context_create(...);
47 The trace screen and pipe_context is then created by doing
49 trace_screen = trace_screen_create(real_screen);
51 trace_context = trace_context_create(trace_screen, real_context);
53 You can then simply use trace_screen and trace_context instead of real_screen
56 Do not call trace_winsys_create. Simply pass trace_screen->winsys or
57 trace_context->winsys in places you would pass winsys.
59 You can create as many contexts you wish. Just ensure that you don't mistake
60 trace_screen with real_screen when creating them.
64 Jose Fonseca <jrfonseca@tungstengraphics.com>