cairo/util
Chris Wilson 9099c7e730 [trace] Disable mark dirty tracing.
Applications like firefox have a very conservative approach and mark
surfaces dirty before every render. As we record the image data every
time, firefox traces can grow very large with redundant data - so allow
the user to disable mark dirty tracing.
2009-03-04 09:26:17 +00:00
..
cairo-script [script] Expose a normal xlib window for replay 2009-02-12 18:27:51 +00:00
cairo-trace [trace] Disable mark dirty tracing. 2009-03-04 09:26:17 +00:00
.gitignore [util] Import my malloc wrapper that prints simple statistics 2007-04-21 08:23:15 -04:00
backtrace-symbols.c [util/backtrace-symbols] Implement backtrace_symbols_fd() 2008-05-27 04:45:37 -04:00
cairo-api-update Remove #ifdef munging since we once again support either #if or #ifdef. 2005-05-17 09:13:02 +00:00
cairo-view [util] Fix pangram 2008-12-24 22:29:59 -05:00
COPYING Add a COPYING file to each aux. source directory 2008-10-31 16:14:14 +00:00
Makefile.am [util] Don't link backtrace-symbols into malloc-stats 2009-01-31 21:33:42 -05:00
malloc-stats.c [util/malloc-stats] Do a single backtrace_symbols() call 2009-01-31 22:10:57 -05:00
README Fix various README typos 2009-01-02 02:56:38 -05:00
waterfall [util] Add waterfall 2008-12-26 16:38:26 -05:00
xr2cairo Fixed to not munge some internal cairot names, (such as cairo_traps_*) 2003-07-26 20:38:58 +00:00

Cairo Utilities
===============

There are a varieties of utilities we use with cairo.


backtrace-symbols
-----------------

This is a small shared library designed to be preloaded by the
linker and its purpose is to make the backtrace_symbols() function
of glibc produce more useful source reference information.

Build by:

	make backtrace-symbols.so

and use by:

	LD_PRELOAD=$PWD/backtrace-symbols.so app-to-run

This code should be contributed back to glibc at some point.


malloc-stats
------------

This is a small shared library designed to be preloaded by the
linker and its purpose is to make the malloc_stats() function
of glibc produce more useful information.

Build by:

	make malloc-stats.so

and use by:

	LD_PRELOAD=$PWD/malloc-stats.so app-to-run

This works best when backtrace-symbols is in use.  That is:

	LD_PRELOAD="$PWD/backtrace-symbols.so $PWD/malloc-stats.so" app-to-run


cairo-trace
-----------

This tool can be used to trace all the cairo function calls made by an
applications.  This is useful for either extracting a test case triggering
a bug from an application, or simply to get a general idea of how an
application is using cairo.


cairo-api-update and xr2cairo
-----------------------------

These two scripts were used to convert source code written for pre-1.0
cairo to newer API.  See $(top_srcdir)/PORTING_GUIDE for more information.

These files are obsolete now and may be removed in a future version.


cairo-view and waterfall
------------------------

These are two pycairo scripts useful for testing the toy font backend.