mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2026-02-18 00:10:37 +01:00
411c09eed7
Real applications that control their Drawable externally to Cairo are 'disadvantaged' by cairo-perf-trace when it creates a similar surface for each new instance of the same Drawable. The difficulty in maintaining one perf surface for every application surface is that the traces do not track lifetimes for the application surfaces, so we would just accumulate stale surfaces. The surface cache takes a different approach and returns the same surface for each active Drawable, and maintains a hold-over of the MRU 16 surfaces. This achieves 60-80% hit rate with firefox, which is probably as good as can be expected. Obviously for double-buffered applications we only every draw to freshly created surfaces (and Gtk+ bypasses cairo to do the final copy -- the ideal application would just use a push-group for double buffering, in which case we would capture and replay the entire expose event). To enable use of the surface cache whilst replaying use -c: ./cairo-perf-trace -c firefox-talos-gfx |
||
|---|---|---|
| .. | ||
| cairo-fdr | ||
| cairo-script | ||
| cairo-sphinx | ||
| cairo-trace | ||
| .gitignore | ||
| backtrace-symbols.c | ||
| cairo-api-update | ||
| cairo-view | ||
| cairo.modules | ||
| COPYING | ||
| font-view.c | ||
| Makefile.am | ||
| malloc-stats.c | ||
| README | ||
| show-edges.c | ||
| show-events.c | ||
| show-traps.c | ||
| trace-to-xml.c | ||
| waterfall | ||
| xml-to-trace.c | ||
| xr2cairo | ||
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.