cairo/util
Chris Wilson f8bb3617c3 Eliminate self-intersecting strokes.
We refactor the surface fallbacks to convert full strokes and fills to the
intermediate polygon representation (as opposed to before where we
returned the trapezoidal representation). This allow greater flexibility
to choose how then to rasterize the polygon. Where possible we use the
local spans rasteriser for its increased performance, but still have the
option to use the tessellator instead (for example, with the current
Render protocol which does not yet have a polygon image).

In order to accommodate this, the spans interface is tweaked to accept
whole polygons instead of a path and the tessellator is tweaked for speed.

Performance Impact
==================

...
Still measuring, expecting some severe regressions.
...
2009-08-29 08:08:28 +01:00
..
cairo-script [script] Handle translation of compressed strings. 2009-08-10 17:19:34 +01:00
cairo-trace [trace] Close the dictionary before font 2009-08-06 10:55:18 +01:00
.gitignore Eliminate self-intersecting strokes. 2009-08-29 08:08:28 +01: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
cairo.modules Add a jhbuild moduleset. 2009-07-20 18:56:10 +01:00
COPYING Add a COPYING file to each aux. source directory 2008-10-31 16:14:14 +00:00
font-view.c [util] Add font-view 2009-06-02 18:16:48 +01:00
Makefile.am Eliminate self-intersecting strokes. 2009-08-29 08:08:28 +01:00
malloc-stats.c [utils] Remove unused code 2009-08-10 12:47:37 -04:00
README Fix various README typos 2009-01-02 02:56:38 -05:00
show-edges.c Eliminate self-intersecting strokes. 2009-08-29 08:08:28 +01:00
show-events.c Eliminate self-intersecting strokes. 2009-08-29 08:08:28 +01:00
show-traps.c Eliminate self-intersecting strokes. 2009-08-29 08:08:28 +01: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.