[cairo-commit] cairo README,1.11,1.12 ChangeLog,1.977,1.978
Carl Worth
commit at pdx.freedesktop.org
Tue Aug 23 19:31:12 PDT 2005
Committed by: cworth
Update of /cvs/cairo/cairo
In directory gabe:/tmp/cvs-serv18640
Modified Files:
README ChangeLog
Log Message:
2005-08-23 Carl Worth <cworth at cworth.org>
* README: Big update in preparation for 1.0.
Index: README
===================================================================
RCS file: /cvs/cairo/cairo/README,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- README 23 Jul 2005 17:05:54 -0000 1.11
+++ README 24 Aug 2005 02:31:10 -0000 1.12
@@ -1,60 +1,123 @@
Cairo - Multi-platform 2D graphics library
http://cairographics.org
-Compiling
----------
-See the INSTALL document for build instructions.
+What is cairo
+=============
+Cairo is a 2D graphics library with support for multiple output
+devices. Currently supported output targets include the X Window
+System, OpenGL, and win32 as well as image buffers and PostScript and
+PDF files.
-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 is designed to produce consistent 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.
+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 scaled,
+rotated, or transformed through any other affine transformation.
-Cairo was once named Xr, (or Xr/Xc), so if you came looking for that
-software, you've found it.
+Cairo has been designed to let you draw anything you might want to
+have in a modern 2D graphical user interface. At the same time, the
+cairo API has been designed to be as easy to learn and fun to use 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-developmenent 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
-------------
-Cairo currently requires the following supporting libraries:
+============
+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:
- libpixman
- Xft2
- fontconfig
- freetype2
+Surface backends:
-Documentation
--------------
-There's not much documentation yet apart from the cairo.h header
-file. We'll be correcting that shortly.
+ image backend
+ -------------
+ no dependencies
-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.
+ glitz backend
+ -------------
+ glitz >= 0.4.4 http://freedesktop.org/Software/glitz)
+
+ pdf backend
+ -----------
+ freetype >= 2.1.4 http://freetype.org
+
+ postscript backend
+ ------------------
+ 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
+
+Font backends:
+
+ freetype font backend
+ ---------------------
+ freetype >= 2.1.4 http://freetype.org
+ fontconfig http://fontconfig.org
+
+ win32 font backend
+ ------------------
+
+ atsui font backend
+ ------------------
+
+Compiling
+=========
+See the INSTALL document for build instructions.
History
--------
+=======
Cairo was originally developed by Carl Worth <cworth at cworth.org> and
Keith Packard <keithp at 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 at 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
+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.
Index: ChangeLog
===================================================================
RCS file: /cvs/cairo/cairo/ChangeLog,v
retrieving revision 1.977
retrieving revision 1.978
diff -u -d -r1.977 -r1.978
--- ChangeLog 24 Aug 2005 00:36:20 -0000 1.977
+++ ChangeLog 24 Aug 2005 02:31:10 -0000 1.978
@@ -1,5 +1,9 @@
2005-08-23 Carl Worth <cworth at cworth.org>
+ * README: Big update in preparation for 1.0.
+
+2005-08-23 Carl Worth <cworth at cworth.org>
+
* AUTHORS: Added several names to the AUTHORS file (since
2005-01-24):
More information about the cairo-commit
mailing list