fdo-mirrors/cairo
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/cairo/cairo.git synced 2026-05-01 06:48:01 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
cairo/util/Makefile.am

103 lines
2.4 KiB
Text
Raw Normal View History

Makefile.am cleanup Use a common build/Makefile.am.common file.
2008-09-11 15:49:09 -04:00
include $(top_srcdir)/build/Makefile.am.common
Add util/ to distribution We already reference an script in util/ in PORTING_GUIDE, but was not shipping it!
2007-04-21 07:48:10 -04:00
Introduce the cairo-missing library The cairo-missing library provides the functions which are needed in order to correctly compile cairo (or its utilities) and which were not found during configuration. Fixes the build on MacOS X Lion, which failed because of collisons between the cairo internal getline and strndup and those in libc: cairo-analyse-trace.c:282: error: static declaration of ‘getline’ follows non-static declaration /usr/include/stdio.h:449: error: previous declaration of ‘getline’ was here cairo-analyse-trace.c:307: error: static declaration of ‘strndup’ follows non-static declaration ...
2011-08-30 16:16:04 +02:00
SUBDIRS = . cairo-missing
[script] Conditionalise the build Allow the interpreter to be disabled if we can not satisfy its dependencies.
2009-08-22 22:20:35 +01:00
Add cairo-gobject library This library is supposed to contain GType declarations for Cairo types. It is also meant to support gobject-introspection binding creation.
2010-08-07 20:05:42 +02:00
if CAIRO_HAS_GOBJECT_FUNCTIONS
SUBDIRS += cairo-gobject
endif
[build] Improve handling of missing test apparatus Improve detection, reporting and disabling of test backends when we lack the required libraries and utilities.
2009-09-08 17:51:33 +01:00
if CAIRO_HAS_INTERPRETER
[script] Conditionalise the build Allow the interpreter to be disabled if we can not satisfy its dependencies.
2009-08-22 22:20:35 +01:00
SUBDIRS += cairo-script
endif
[util] Add 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. After make install, cairo-trace program arguments, will print out all the cairo calls to the terminal and also capture theme in ./program.$pid.trace The format of the output is CairoScript, watch this space for more cairo-script tools!
2008-10-31 15:37:58 +00:00
[configure] Add option to disable trace. Some environments may be broken beyond our capabilities to detect, or maybe the user is just insane and doesn't want to build my nice shiny cairo-trace. Whatever, give them the option to choose: $ ./configure --disable-trace
2009-09-05 15:21:50 +01:00
if CAIRO_HAS_TRACE
[util] Add 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. After make install, cairo-trace program arguments, will print out all the cairo calls to the terminal and also capture theme in ./program.$pid.trace The format of the output is CairoScript, watch this space for more cairo-script tools!
2008-10-31 15:37:58 +00:00
SUBDIRS += cairo-trace
Protect code using dlfcn.h with CAIRO_HAS_DLSYM
2012-04-09 21:33:50 +02:00
if CAIRO_HAS_DLSYM
Add 'flight-data-recorder' utility. This is a simple variation on cairo-trace that wraps records the last 16 contexts by wrapping the target surface inside a tee surface, along with a meta/recording surface. Then on receipt of a SIGUSR1, those last 16 contexts are played via a script-surface into /tmp/fdr.trace. Mostly proof-of-concept, it seems to be causing a number of rendering glitches whilst testing with firefox -- otherwise, it seems to works.
2009-08-16 21:08:22 +01:00
if CAIRO_HAS_SCRIPT_SURFACE
build: Don't build cairo-fdr when the tee surface is off
2010-10-28 13:57:05 +02:00
if CAIRO_HAS_TEE_SURFACE
Add 'flight-data-recorder' utility. This is a simple variation on cairo-trace that wraps records the last 16 contexts by wrapping the target surface inside a tee surface, along with a meta/recording surface. Then on receipt of a SIGUSR1, those last 16 contexts are played via a script-surface into /tmp/fdr.trace. Mostly proof-of-concept, it seems to be causing a number of rendering glitches whilst testing with firefox -- otherwise, it seems to works.
2009-08-16 21:08:22 +01:00
SUBDIRS += cairo-fdr
endif
[util] Add 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. After make install, cairo-trace program arguments, will print out all the cairo calls to the terminal and also capture theme in ./program.$pid.trace The format of the output is CairoScript, watch this space for more cairo-script tools!
2008-10-31 15:37:58 +00:00
endif
build: Don't build cairo-fdr when the tee surface is off
2010-10-28 13:57:05 +02:00
endif
Protect code using dlfcn.h with CAIRO_HAS_DLSYM
2012-04-09 21:33:50 +02:00
endif
[util] Add 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. After make install, cairo-trace program arguments, will print out all the cairo calls to the terminal and also capture theme in ./program.$pid.trace The format of the output is CairoScript, watch this space for more cairo-script tools!
2008-10-31 15:37:58 +00:00
Add cairo-sphinx utility for regression analysis sphinx is an alternate version of the current cairo-test-trace. It's purpose is to replay a live application (which may just be a replay of a trace) against a backend and its reference. The improvement over the original cairo-test-trace is that the reference backend may be from an older version of cairo.
2009-08-18 10:55:54 +01:00
if BUILD_SPHINX
Protect code using dlfcn.h with CAIRO_HAS_DLSYM
2012-04-09 21:33:50 +02:00
if CAIRO_HAS_DLSYM
Add cairo-sphinx utility for regression analysis sphinx is an alternate version of the current cairo-test-trace. It's purpose is to replay a live application (which may just be a replay of a trace) against a backend and its reference. The improvement over the original cairo-test-trace is that the reference backend may be from an older version of cairo.
2009-08-18 10:55:54 +01:00
if CAIRO_HAS_SCRIPT_SURFACE
build: Don't build cairo-sphinx when the tee surface is off cairo-sphinx depends on cairo-tee, which is not always enabled. Reported-by: James Cloos <cloos@jhcloos.com>
2011-06-16 09:22:54 +02:00
if CAIRO_HAS_TEE_SURFACE
Add cairo-sphinx utility for regression analysis sphinx is an alternate version of the current cairo-test-trace. It's purpose is to replay a live application (which may just be a replay of a trace) against a backend and its reference. The improvement over the original cairo-test-trace is that the reference backend may be from an older version of cairo.
2009-08-18 10:55:54 +01:00
SUBDIRS += cairo-sphinx
endif
endif
build: Don't build cairo-sphinx when the tee surface is off cairo-sphinx depends on cairo-tee, which is not always enabled. Reported-by: James Cloos <cloos@jhcloos.com>
2011-06-16 09:22:54 +02:00
endif
Protect code using dlfcn.h with CAIRO_HAS_DLSYM
2012-04-09 21:33:50 +02:00
endif
Add cairo-sphinx utility for regression analysis sphinx is an alternate version of the current cairo-test-trace. It's purpose is to replay a live application (which may just be a replay of a trace) against a backend and its reference. The improvement over the original cairo-test-trace is that the reference backend may be from an older version of cairo.
2009-08-18 10:55:54 +01:00
Add xml surface A very simple surface that produces a hierarchical DAG in a simple XML format. It is intended to be used whilst debugging, for example with the automatic regression finding tools of cairo-sphinx, and with test suites that just want to verify that their code made a particular Cairo call.
2009-08-18 14:25:25 +01:00
AM_CPPFLAGS = -I$(top_srcdir)/src \
-I$(top_builddir)/src \
-I$(top_srcdir)/util/cairo-script \
$(CAIRO_CFLAGS)
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. ...
2008-12-17 09:32:16 +00:00
stroke: Convert the outlines into contour and then into a polygon In step 1 of speeding up stroking, we introduce contours as a means for tracking the connected edges around the stroke. By keeping track of these chains, we can analyse the edges as we proceed and eliminate redundant vertices speeding up rasterisation. Coincidentally fixes line-width-tolerance (looks like a combination of using spline tangent vectors and tolerance). Signed-off-by: Chris Wilson <chris@chris-wilson.co.uk>
2011-08-15 09:44:03 +01:00
EXTRA_PROGRAMS += show-contour show-traps show-edges show-polygon show-events
[build] Improve handling of missing test apparatus Improve detection, reporting and disabling of test backends when we lack the required libraries and utilities.
2009-09-08 17:51:33 +01:00
if CAIRO_HAS_INTERPRETER
[script] Conditionalise the build Allow the interpreter to be disabled if we can not satisfy its dependencies.
2009-08-22 22:20:35 +01:00
EXTRA_PROGRAMS += trace-to-xml xml-to-trace
endif
Add xml surface A very simple surface that produces a hierarchical DAG in a simple XML format. It is intended to be used whilst debugging, for example with the automatic regression finding tools of cairo-sphinx, and with test suites that just want to verify that their code made a particular Cairo call.
2009-08-18 14:25:25 +01:00
trace_to_xml_LDADD = cairo-script/libcairo-script-interpreter.la $(top_builddir)/src/libcairo.la $(CAIRO_LDADD)
xml_to_trace_LDADD = -lexpat
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. ...
2008-12-17 09:32:16 +00:00
show_traps_SOURCES = show-traps.c
show_traps_CFLAGS = $(gtk_CFLAGS)
#show_traps_LDADD = $(top_builddir)/src/libcairo.la $(gtk_LIBS)
show_traps_LDADD = $(gtk_LIBS)
util: Add show-polygons Another variant of the utility apps that understand the output of _cairo_debug_print_polygon(). Signed-off-by: Chris Wilson <chris@chris-wilson.co.uk>
2011-08-07 09:00:56 +01:00
show_polygon_SOURCES = show-polygon.c
show_polygon_CFLAGS = $(gtk_CFLAGS)
#show_polygon_LDADD = $(top_builddir)/src/libcairo.la $(gtk_LIBS)
show_polygon_LDADD = $(gtk_LIBS)
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. ...
2008-12-17 09:32:16 +00:00
show_edges_SOURCES = show-edges.c
show_edges_CFLAGS = $(gtk_CFLAGS)
#show_edges_LDADD = $(top_builddir)/src/libcairo.la $(gtk_LIBS)
show_edges_LDADD = $(gtk_LIBS)
stroke: Convert the outlines into contour and then into a polygon In step 1 of speeding up stroking, we introduce contours as a means for tracking the connected edges around the stroke. By keeping track of these chains, we can analyse the edges as we proceed and eliminate redundant vertices speeding up rasterisation. Coincidentally fixes line-width-tolerance (looks like a combination of using spline tangent vectors and tolerance). Signed-off-by: Chris Wilson <chris@chris-wilson.co.uk>
2011-08-15 09:44:03 +01:00
show_contour_SOURCES = show-contour.c
show_contour_CFLAGS = $(gtk_CFLAGS)
#show_contour_LDADD = $(top_builddir)/src/libcairo.la $(gtk_LIBS)
show_contour_LDADD = $(gtk_LIBS)
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. ...
2008-12-17 09:32:16 +00:00
show_events_SOURCES = show-events.c
show_events_CFLAGS = $(gtk_CFLAGS)
#show_events_LDADD = $(top_builddir)/src/libcairo.la $(gtk_LIBS)
show_events_LDADD = $(gtk_LIBS)
[util/Makefile.am] Cleanup
2008-09-16 23:16:21 -04:00
util: malloc-stats.so backtrace-symbols.so
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
[util] Fix an automake warning
2008-09-04 23:25:57 -04:00
.la.so:
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
$(RM) $@
$(LN_S) .libs/$*.so $@
[Makefile.am.common] Unify more common rules
2008-09-11 18:06:57 -04:00
CLEANFILES += *.so
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
[util/Makefile.am] Cleanup
2008-09-16 23:16:21 -04:00
# The -rpath is needed to build shared objects that are not installed,
# ie. with EXTRA_LTLIBRARIES
AM_LDFLAGS = -module -avoid-version -export-dynamic -rpath /dev/null
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
Makefile.am cleanup Use a common build/Makefile.am.common file.
2008-09-11 15:49:09 -04:00
EXTRA_LTLIBRARIES += malloc-stats.la backtrace-symbols.la
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
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. ...
2008-12-17 09:32:16 +00:00
backtrace_symbols_la_LIBADD = -lbfd -liberty
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
[util] Don't link backtrace-symbols into malloc-stats On my rawhide machine, seems like the glibc backgrace-symbols is now as good as our private backtrace-symbols.
2009-01-31 21:33:42 -05:00
#malloc_stats_la_LIBADD = $(backtrace_symbols_la_LIBADD) backtrace-symbols.lo
[util] Import my malloc wrapper that prints simple statistics To build, do: make malloc-stats.so inside util/, and to use, run: LD_PRELOAD=malloc-stats.so some-program For binaries managed by libtool, eg, cairo-perf, do: ../libtool --mode=execute /bin/true ./cairo-perf LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf The code also includes Jeff Muizelaar's libbacktracesymbols that is a much better implementation of backtrace_symbols() than what is provided by glibc. That can be built by: make backtrace-symbols.so
2007-04-21 08:21:01 -04:00
[configure] Don't attempt to build GTK+ utilities on system without GTK+
2009-06-06 14:58:46 +01:00
if HAVE_GTK
[util] Disable default build of font-view It's only a demonstration utility after a all and we do not need to incur the cost of relinking it everytime we modify the main library.
2009-06-13 18:31:35 +01:00
EXTRA_PROGRAMS += font-view
[util] Add font-view A C variant of Behdad's python example font viewer.
2009-01-02 14:25:04 +00:00
font_view_CFLAGS = $(gtk_CFLAGS)
font_view_LDADD = ../src/libcairo.la $(gtk_LIBS)
[configure] Don't attempt to build GTK+ utilities on system without GTK+
2009-06-06 14:58:46 +01:00
endif
[util] Add font-view A C variant of Behdad's python example font viewer.
2009-01-02 14:25:04 +00:00
Makefile.am cleanup Use a common build/Makefile.am.common file.
2008-09-11 15:49:09 -04:00
EXTRA_DIST += \
Add a COPYING file to each aux. source directory Include a COPYING inside perf/, test/, util/ to clarify the licensing conditions beneath the respective directories. This is because cairo itself (libcairo.so) is LGPL-2.1/MPL-1.1 but that only relates to src/. The auxiliary source files are under a mix of free licenses and we wish to be clear just what license applies to each file. In particular, cairo-trace needs to include the GPL terms and conditions.
2008-10-31 16:09:13 +00:00
COPYING \
Add util/ to distribution We already reference an script in util/ in PORTING_GUIDE, but was not shipping it!
2007-04-21 07:48:10 -04:00
xr2cairo \
[util] Add cairo-view
2008-12-23 13:48:52 -05:00
cairo-api-update \
[util] Add waterfall
2008-12-26 16:38:04 -05:00
cairo-view \
waterfall
Reference in a new issue Copy permalink