cairo/README

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

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

Description
-----------
Cairo is a vector graphics library with cross-device output
support. Currently supported output targets include the X Window
System and in-memory image buffers. PostScript and PDF file output is
planned. Cairo is designed to produce identical output on all output
media while taking advantage of display hardware acceleration when
available (eg. through the X Render Extension).

Cairo provides a stateful user-level API with capabilities similar to
the PDF 1.4 imaging model. Cairo provides operations including
stroking and filling Bezier cubic splines, transforming and
compositing translucent images, and antialiased text rendering.

Cairo was once named Xr, (or Xr/Xc), so if you came looking for that
software, you've found it.

Dependencies
------------
Cairo currently requires the following supporting libraries:

	libpixman
	Xft2
	fontconfig
	freetype2

Documentation
-------------
There's not much documentation yet apart from the cairo.h header
file. We'll be correcting that shortly.

In the meantime, the cairo-demo module in CVS provides a few example
programs using cairo. These may be helpful to a programmer just
beginning with cairo. Also, familiarity with the PostScript imaging
model will help in understanding cairo.

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.

Mailing List
------------
If you have trouble with cairo or you have some ideas for how it could be
improved, please feel free to send a message to cairo@cairographics.org

Cairo is still under active development and all discussion happens on
that list. So if you want to lurk or, (even better), take part in the
development, take a look. Subscription information and archives are
available:

	http://cairographics.org/cgi-bin/mailman/listinfo/cairo
Renamed everything from Xr* to cairo_* 2003-07-18 11:34:19 +00:00			`Cairo - Multi-platform 2D graphics library`
Add attribution for many people who have made generous contributions to cairo. This list was generated by sifting through the ChangeLog. Please let me know if I have missed anyone. Add some historical notes on cairo development, prior to when we began to maintain this NEWS file. Add pointer to cairographics.org. Fix to use cairo rather than Cairo when not at the beginning of a sentence. Remove cairo_current_path, cairo_current_path_flat, cairo_text_extents, cairo_glyph_extents, cairo_text_path, and cairo_glyph_path from the TODO list as they have all been implemented now. 2004-02-24 10:45:26 +00:00			`http://cairographics.org`
Added toplevel functions for setting surface matrix, filter. Introduced new XrMatrix object. Fixed to properly hint scaled fonts. 2003-05-14 18:30:57 +00:00
			`Compiling`
			`---------`
			`See the INSTALL document for build instructions.`
Added TODO, README, and .cvsignore 2002-10-26 08:00:39 +00:00
			`Description`
			`-----------`
Updated stale text in README 2003-10-28 17:32:44 +00:00			`Cairo is a vector graphics library with cross-device output`
			`support. Currently supported output targets include the X Window`
			`System and in-memory image buffers. PostScript and PDF file output is`
			`planned. Cairo is designed to produce identical output on all output`
			`media while taking advantage of display hardware acceleration when`
			`available (eg. through the X Render Extension).`

			`Cairo provides a stateful user-level API with capabilities similar to`
			`the PDF 1.4 imaging model. Cairo provides operations including`
			`stroking and filling Bezier cubic splines, transforming and`
			`compositing translucent images, and antialiased text rendering.`

			`Cairo was once named Xr, (or Xr/Xc), so if you came looking for that`
			`software, you've found it.`
Added toplevel functions for setting surface matrix, filter. Introduced new XrMatrix object. Fixed to properly hint scaled fonts. 2003-05-14 18:30:57 +00:00
Added TODO, README, and .cvsignore 2002-10-26 08:00:39 +00:00			`Dependencies`
			`------------`
Renamed everything from Xr* to cairo_* 2003-07-18 11:34:19 +00:00			`Cairo currently requires the following supporting libraries:`
Fixed miter limit handling. Added local.def 2003-01-24 13:52:01 +00:00
Replace requiring libpixregion, libic with libpixman. 2003-12-16 09:42:19 +00:00			`libpixman`
Updated stale text in README 2003-10-28 17:32:44 +00:00			`Xft2`
			`fontconfig`
			`freetype2`
Added TODO, README, and .cvsignore 2002-10-26 08:00:39 +00:00
			`Documentation`
			`-------------`
Renamed everything from Xr* to cairo_* 2003-07-18 11:34:19 +00:00			`There's not much documentation yet apart from the cairo.h header`
Added toplevel functions for setting surface matrix, filter. Introduced new XrMatrix object. Fixed to properly hint scaled fonts. 2003-05-14 18:30:57 +00:00			`file. We'll be correcting that shortly.`
Added TODO, README, and .cvsignore 2002-10-26 08:00:39 +00:00
Updated stale text in README 2003-10-28 17:32:44 +00:00			`In the meantime, the cairo-demo module in CVS provides a few example`
Remove trailing commas from enums, (some compilers like to complain about them). 2003-12-17 12:59:37 +00:00			`programs using cairo. These may be helpful to a programmer just`
			`beginning with cairo. Also, familiarity with the PostScript imaging`
			`model will help in understanding cairo.`
Added TODO, README, and .cvsignore 2002-10-26 08:00:39 +00:00
			`History`
			`-------`
Switch from broken cworth@isi.edu address to canonical cworth@cworth.org address. 2005-02-22 11:35:03 +00:00			`Cairo was originally developed by Carl Worth <cworth@cworth.org> and`
Remove trailing commas from enums, (some compilers like to complain about them). 2003-12-17 12:59:37 +00:00			`Keith Packard <keithp@keithp.com>. Many thanks are due to Lyle Ramshaw`
			`without whose patient help our ignorance would be much more apparent.`
Added TODO, README, and .cvsignore 2002-10-26 08:00:39 +00:00
Added toplevel functions for setting surface matrix, filter. Introduced new XrMatrix object. Fixed to properly hint scaled fonts. 2003-05-14 18:30:57 +00:00			`Mailing List`
			`------------`
Add attribution for many people who have made generous contributions to cairo. This list was generated by sifting through the ChangeLog. Please let me know if I have missed anyone. Add some historical notes on cairo development, prior to when we began to maintain this NEWS file. Add pointer to cairographics.org. Fix to use cairo rather than Cairo when not at the beginning of a sentence. Remove cairo_current_path, cairo_current_path_flat, cairo_text_extents, cairo_glyph_extents, cairo_text_path, and cairo_glyph_path from the TODO list as they have all been implemented now. 2004-02-24 10:45:26 +00:00			`If you have trouble with cairo or you have some ideas for how it could be`
Renamed everything from Xr* to cairo_* 2003-07-18 11:34:19 +00:00			`improved, please feel free to send a message to cairo@cairographics.org`
Added toplevel functions for setting surface matrix, filter. Introduced new XrMatrix object. Fixed to properly hint scaled fonts. 2003-05-14 18:30:57 +00:00
Renamed everything from Xr* to cairo_* 2003-07-18 11:34:19 +00:00			`Cairo is still under active development and all discussion happens on`
Added toplevel functions for setting surface matrix, filter. Introduced new XrMatrix object. Fixed to properly hint scaled fonts. 2003-05-14 18:30:57 +00:00			`that list. So if you want to lurk or, (even better), take part in the`
			`development, take a look. Subscription information and archives are`
			`available:`

Renamed everything from Xr* to cairo_* 2003-07-18 11:34:19 +00:00			`http://cairographics.org/cgi-bin/mailman/listinfo/cairo`