Find a file
Carl Worth fbb8a62797 Reviewed by keithp
Implement copy_page for paginated surface. Fix show_page to destroy the meta-surface and create a new one.
Change these functions to advertise when they are not supported, so that _cairo_paginated_copy_page can implement things differently depending on whether or not it is personal.
Check return values from _cairo_surface_show/copy_page.
2006-01-06 14:11:07 +00:00
doc Doc churn 2005-10-12 13:24:35 +00:00
pixman 2005-10-10 David Reveman <davidr@novell.com> 2006-01-04 16:39:23 +00:00
src Reviewed by keithp 2006-01-06 14:11:07 +00:00
test 2005-10-10 David Reveman <davidr@novell.com> 2006-01-04 17:59:03 +00:00
util Remove #ifdef munging since we once again support either #if or #ifdef. 2005-05-17 09:13:02 +00:00
.cvsignore Increment CAIRO_VERSION to 0.2.0. 2004-10-27 13:13:39 +00:00
acinclude.m4 configure.in Makefile.am docs/Makefile.am docs/public/*: Add framework for doing docs via gtk-doc. 2005-01-27 11:35:25 +00:00
AUTHORS Put win32 mutex locking on the 1.2.0 roadmap. 2005-09-07 16:57:59 +00:00
autogen.sh Set LC_ALL=C rather than LANG and LC_NUMERIC to be robust against whatever settings the user has. (Martin Dobias) 2005-08-22 08:33:54 +00:00
BUGS Add mention of suspected bug in PS backend. 2005-10-25 15:55:57 +00:00
cairo.pc.in Try to use pkg-config to detect freetype2, then fall back to the existing freetype-config based check. 2005-08-17 15:57:45 +00:00
ChangeLog Reviewed by keithp 2006-01-06 14:11:07 +00:00
CODING_STYLE Globally rename "operator" to "op", to allow writing backends in C++ 2005-12-16 03:02:35 +00:00
configure.in New directfb backend for cairo includes test suite and example to run the test is in the comment at the top of cairo-test-directfb.c enable with 2005-12-29 07:17:01 +00:00
COPYING Fix typo: LPGL->LGPL. 2004-11-29 18:25:23 +00:00
COPYING-LGPL-2.1 Add the MPL as a new license option, in addition to the LGPL. 2004-09-04 06:38:34 +00:00
COPYING-MPL-1.1 Add the MPL as a new license option, in addition to the LGPL. 2004-09-04 06:38:34 +00:00
gtk-doc.make When invoked as, say, ../autogen.sh, switch to the sourcedir to run the auto*. Based on corresponding code in GTK+'s autogen.sh. (#3402, Thomas Fitzsimmons) 2005-08-21 09:57:19 +00:00
INSTALL Mention new --enable-svg option 2005-12-18 17:20:06 +00:00
Makefile.am Increment libtool versioning to 5:0:3 in anticipation of 1.2.0 which will add interfaces. The motivation for this is to make the 1.1.1 release install a library which will be considered newer than 1.0.2. 2005-10-13 07:30:15 +00:00
NEWS Add notes for the 1.0.2 release. 2005-10-03 17:49:25 +00:00
PORTING_GUIDE Update name from "0.5 porting guide" to "1.0 porting guide." 2005-08-24 08:46:02 +00:00
README Mention new --enable-svg option 2005-12-18 17:20:06 +00:00
RELEASING Fix typo. 2005-08-24 08:07:24 +00:00
ROADMAP Slip 1.2.0 projected data (again) out to 2006-01-13. Note that win32 is now incorporated into the test suite and is only failing two tests (self-copy and trap-clip). Note new progress on cairo_push/pop_group. Add item to support pango's hex-box drawing. Note that gradient computation performance has been improved. Note that experimental SVG backend has been added. 2006-01-05 15:17:02 +00:00
TODO Add a new API for disabling antialiasing of shapes drawn by cairo. This is a hint and is not supported by all backends. 2005-08-08 18:35:22 +00:00

Cairo - Multi-platform 2D graphics library
http://cairographics.org

What is cairo
=============
Cairo is a 2D graphics library with support for multiple output
devices. Currently supported output targets include the X Window
System, win32, and image buffers. Experimental backends include OpenGL
(through glitz), Quartz, XCB, PostScript and PDF file output.

Cairo is designed to produce consistent output on all output media
while taking advantage of display hardware acceleration when available
(for example, through the X Render Extension).

The cairo API provides operations similar to the drawing operators of
PostScript and PDF. Operations in cairo including stroking and filling
cubic Bézier splines, transforming and compositing translucent images,
and antialiased text rendering. All drawing operations can be
transformed by any affine transformation (scale, rotation, shear,
etc.).

Cairo has been designed to let you draw anything you want in a modern
2D graphical user interface.  At the same time, the cairo API has been
designed to be as fun and easy to learn as possible. If you're not
having fun while programming with cairo, then we have failed
somewhere---let us know and we'll try to fix it next time around.

Cairo is free software and is available to be redistributed and/or
modified under the terms of either the GNU Lesser General Public
License (LGPL) version 2.1 or the Mozilla Public License (MPL) version
1.1.

Where to get more information about cairo
=========================================
The primary source of information about cairo is:

	http://cairographics.org/

The latest releases of cairo can be found at:

	http://cairographics.org/releases

Snapshots of in-development versions of cairo:

	http://cairographics.org/snapshots

The programming manual for using cairo:

	http://cairographics.org/manual

Mailing lists for contacting cairo users and developers:

	http://cairographics.org/lists

Answers to some frequently asked questions about cairo:

	http://cairographics.org/FAQ

Dependencies
============
The set of libraries needed to compile cairo depends on which backends
are enabled when cairo is configured. Here are the dependencies for
each backend:

Surface backends:

	image backend
	-------------
	no dependencies

	glitz backend
	-------------
	glitz >= 0.4.4 		http://freedesktop.org/Software/glitz

	pdf backend
	-----------
	freetype >= 2.1.4	http://freetype.org
	zlib			http://www.gzip.org/zlib

	postscript backend
	------------------
	freetype >= 2.1.4	http://freetype.org
	zlib			http://www.gzip.org/zlib

	quartz backend
	--------------
	[*]

	win32 backend
	-------------
	[*]

	xcb backend
	-----------
	XCB			http://xcb.freedesktop.org

	xlib backend
	------------
	Xrender >= 0.6		http://freedesktop.org/Software/xlibs

	beos backend
	------------
	No dependencies in itself other than an installed BeOS system, but cairo
	requires a font backend. See the freetype dependency list.

Font backends:

	freetype font backend
	---------------------
	freetype >= 2.1.4	http://freetype.org
	fontconfig		http://fontconfig.org

	win32 font backend
	------------------
	[*]

	atsui font backend
	------------------
	[*]

	[*] I don't know specifically what packages might need to be
	    installed on a Mac OS X system to use the Quartz and ATSUI
	    backends. As far as win32, the situation is rather complex:

	    The Win32 backend should work on Windows 2000 and newer
	    (excluding Windows Me.) Most testing has been done on
	    Windows XP. While some portions of the code have been
	    adapted to work on older versions of Windows, considerable
	    work still needs to done to get cairo running in these
	    environments.

	    Cairo can be compiled on Windows either with the GCC
	    toolchain (see http://www.mingw.org) or with Microsoft
	    Visual C++. Makefiles or project files for compiling with
	    MSVC are however not provided as of this release. We have
	    received reports that MSVC 6.0 compiles parts of cairo
	    incorrectly, (leading to incorrect color). MSVC 7.0 is
	    known to work.

Compiling
=========
See the INSTALL document for build instructions.

History
=======
Cairo was originally developed by Carl Worth <cworth@cworth.org> and
Keith Packard <keithp@keithp.com>. Many thanks are due to Lyle Ramshaw
without whose patient help our ignorance would be much more apparent.

Since the original development, many more people have contributed to
cairo. See the AUTHORS files for as complete a list as we've been able
to compile so far.