~ubuntu-branches/ubuntu/natty/mesa/natty-proposed

« back to all changes in this revision

Viewing changes to src/gallium/drivers/rbug/README

  • Committer: Bazaar Package Importer
  • Author(s): Robert Hooker, Robert Hooker, Christopher James Halse Rogers
  • Date: 2010-09-14 08:55:40 UTC
  • mfrom: (1.2.28 upstream)
  • Revision ID: james.westby@ubuntu.com-20100914085540-m4fpl0hdjlfd4jgz
Tags: 7.9~git20100909-0ubuntu1
[ Robert Hooker ]
* New upstream git snapshot up to commit 94118fe2d4b1e5 (LP: #631413)
* New features include ATI HD5xxx series support in r600, and a vastly
  improved glsl compiler.
* Remove pre-generated .pc's, use the ones generated at build time
  instead.
* Remove all references to mesa-utils now that its no longer shipped
  with the mesa source.
* Disable the experimental ARB_fragment_shader option by default on
  i915, it exposes incomplete functionality that breaks KDE compositing
  among other things. It can be enabled via driconf still. (LP: #628930).

[ Christopher James Halse Rogers ]
* debian/patches/04_osmesa_version.diff:
  - Refresh for new upstream
* Bugs fixed in this release:
  - Fixes severe rendering corruption in Unity on radeon (LP: #628727,
    LP: #596292, LP: #599741, LP: #630315, LP: #613694, LP: #599741).
  - Also fixes rendering in gnome-shell (LP: #578619).
  - Flickering in OpenGL apps on radeon (LP: #626943, LP: #610541).
  - Provides preliminary support for new intel chips (LP: #601052).
* debian/rules:
  - Update configure flags to match upstream reshuffling.
  - Explicitly remove gallium DRI drivers that we don't want to ship.
* Update debian/gbp.conf for this Maverick-specific packaging
* libegl1-mesa-dri-x11,kms: There are no longer separate kms or x11 drivers
  for EGL, libegl1-mesa-drivers now contains a single driver that provides
  both backends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
                              RBUG PIPE DRIVER
 
2
 
 
3
 
 
4
= About =
 
5
 
 
6
This directory contains a Gallium3D remote debugger pipe driver.
 
7
It provides remote debugging functionality.
 
8
 
 
9
 
 
10
= Build Instructions =
 
11
 
 
12
To build, invoke scons on the top dir as
 
13
 
 
14
 scons dri=no statetrackers=mesa winsys=xlib
 
15
 
 
16
 
 
17
= Usage =
 
18
 
 
19
To use do
 
20
 
 
21
   export LD_LIBRARY_PATH=$PWD/build/linux-x86-debug/lib
 
22
 
 
23
ensure the right libGL.so is being picked by doing
 
24
 
 
25
   ldd progs/trivial/tri 
 
26
 
 
27
   export XMESA_TRACE=y
 
28
   GALLIUM_RBUG=true progs/trivial/tri
 
29
 
 
30
which should open gallium remote debugging session. While the program is running
 
31
you can launch the small remote debugging application from progs/rbug. More
 
32
information is in that directory. Also for a gui see:
 
33
 
 
34
   http://cgit.freedesktop.org/mesa/rbug-gui
 
35
 
 
36
 
 
37
= Integrating =
 
38
 
 
39
You can integrate the rbug pipe driver either inside the state tracker or the 
 
40
target. The procedure on both cases is the same. Let's assume you have a 
 
41
pipe_screen obtained by the usual means (variable and function names are just
 
42
for illustration purposes):
 
43
 
 
44
  real_screen = real_screen_create(...);
 
45
 
 
46
The rbug screen is then created by doing
 
47
 
 
48
  rbug_screen = rbug_screen_create(real_screen);
 
49
 
 
50
You can then simply use rbug_screen instead of real_screen.
 
51
 
 
52
You can create as many contexts you wish from rbug_screen::context_create they
 
53
are automatically wrapped by rbug_screen.
 
54
 
 
55
 
 
56
--
 
57
Jose Fonseca <jrfonseca@tungstengraphics.com>
 
58
Jakob Bornecrantz <jakob@vmware.com>