[cairo-commit] 3 commits - doc/public Makefile.am NEWS
Carl Worth
cworth at kemper.freedesktop.org
Thu Feb 28 14:37:24 PST 2008
Makefile.am | 1
NEWS | 94 +++++++++++++++++++++++++++++++++++++
doc/public/Makefile.am | 1
doc/public/cairo-docs.xml | 2
doc/public/cairo-sections.txt | 11 ++++
doc/public/tmpl/cairo-quartz.sgml | 49 +++++++++++++++++++
doc/public/tmpl/cairo-surface.sgml | 1
7 files changed, 157 insertions(+), 2 deletions(-)
New commits:
commit 81175110ab44e74fe04f2bc8ed3c9983e23a82c6
Author: Carl Worth <cworth at cworth.org>
Date: Thu Feb 28 14:36:47 2008 -0800
NEWS: Add notes for cairo 1.5.12
diff --git a/NEWS b/NEWS
index f7bf502..b23e530 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,97 @@
+Snapshot 1.5.12 (2008-02-28 Carl Worth <cworth at cworth.org>)
+===========================================================
+This is the sixth snapshot in cairo's unstable 1.6 series. It comes 1
+week after the 1.5.10 snapshot. This snapshot includes the
+long-awaited change from 16.16 to 24.8 fixed-point values, (see below
+for why you should care). It also includes several backend-specific
+bug fixes.
+
+24.8 fixed-point format
+-----------------------
+Cairo has always converted path coordinates to a fixed-point
+representation very early in its processing. Historically, this has
+been a 32-bit representation with 16 bits of integer for the
+device-pixel grid and 16 bits of sub-pixel positioning. The choice of
+16 bits for the integer coordinate space was based on the 16-bit limit
+for X Window drawables.
+
+This 16-bit limit has proven problematic for many applications. It's
+an especially vexing problem when targeting non-X backends that don't
+have any 16-bit restriction. But even when targeting cairo-xlib, it's
+often desirable to draw a large shape, (say a background rectangle),
+that extends beyond the surface bounds and expect it to fill the
+surface completely, (rather than overflowing and triggering random
+behavior).
+
+Meanwhile, nobody has ever really needed 16 bits of sub-pixel precision.
+
+With this snapshot, the fixed-point system is still in place and is
+still using a 32-bit representation, (future versions of cairo might
+move entirely to floating-point when targeting PDF output for
+example). But the representation now provides 24 bits of pixel
+addressing and only 8 bits of sub-pixel positioning. It is hoped that
+this larger space is adequate to avoid pain for many application
+developers.
+
+Note that the 24-bit limitation is only on the range of the allowable
+device space. It is still legitimate to arrange a transformation
+matrix that provides an arbitrarily large user-space, (the space in
+which floating-point values are provided to cairo), as long as the
+post-transformed values fit within the 24.8 representation.
+
+generic fixes
+-------------
+Add a few tests to the test suite to increase coverage.
+
+Cleanup a few error-handling paths, (propagate error correctly).
+
+cairo-ft
+--------
+Fix handling of font sizes smaller than 1 device pixel.
+
+cairo-pdf
+---------
+Fix to properly save/restore clip when analyzing meta-surface
+patterns, (fixing a couple of test-suite failures).
+
+Implement native support for CAIRO_OPERATOR_SOURCE when the source
+pattern is opaque.
+
+Emit rectangles as PDF rectangles ("re" operator) rather than as
+general paths.
+
+cairo-ps
+--------
+Fix to work properly with the 16.16->24.8 change.
+
+cairo-svg
+---------
+Fix CAIRO_EXTEND_REFLECT by using an image fallback, (there's no
+direct SVG support for reflected patterns).
+
+Fix the use of alpha-only masks, (such as CAIRO_FORMAT_A8).
+
+cairo-quartz
+------------
+Add new API for efficiently using image data as a source:
+
+ cairo_surface_t *
+ cairo_quartz_image_surface_create (cairo_surface_t *image_surface);
+
+ cairo_surface_t *
+ cairo_quartz_image_surface_get_image (cairo_surface_t *surface);
+
+For full documentation, see:
+
+ http://cairographics.org/manual/cairo-Quartz-Surfaces.html#cairo-quartz-image-surface-create
+
+Several fixes for cairo_mask().
+
+cairo-atsui
+-----------
+Change default from from Monaco to Helvetica to be more consistent
+with other font backends.
+
Snapshot 1.5.10 (2008-02-20 Carl Worth <cworth at cworth.org>)
===========================================================
This is the fifth snapshot in cairo's unstable 1.5 series. It comes 3
commit fbd29a4025fc3bca3812d205230151e8c6e80f49
Author: Carl Worth <cworth at cworth.org>
Date: Thu Feb 28 14:36:32 2008 -0800
Fix 'make doc-publish' for when run twice on the same day
diff --git a/Makefile.am b/Makefile.am
index 481d1c1..0458998 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -236,6 +236,7 @@ release-publish-message: releases/$(sha1_file)
release-publish: release-upload release-publish-message
doc-publish: doc
+ rm -rf ./$(MANUAL_DATED)
cp -a doc/public/html $(MANUAL_DATED)
tar czf $(MANUAL_TAR_FILE) $(MANUAL_DATED)
scp $(MANUAL_TAR_FILE) $(RELEASE_UPLOAD_HOST):$(MANUAL_UPLOAD_DIR)
commit 8d515344c4ecded58566b704a740766f85359876
Author: Carl Worth <cworth at cworth.org>
Date: Thu Feb 28 14:35:57 2008 -0800
Add cairo-quartz to the manual
diff --git a/doc/public/Makefile.am b/doc/public/Makefile.am
index bd5036e..0a570ad 100644
--- a/doc/public/Makefile.am
+++ b/doc/public/Makefile.am
@@ -24,7 +24,6 @@ UNSUPPORTED_HFILES= \
cairo-directfb.h \
cairo-glitz.h \
cairo-os2.h \
- cairo-quartz.h \
cairo-xcb.h \
cairo-xcb-xrender.h
diff --git a/doc/public/cairo-docs.xml b/doc/public/cairo-docs.xml
index f504fb3..9eb9b32 100644
--- a/doc/public/cairo-docs.xml
+++ b/doc/public/cairo-docs.xml
@@ -36,7 +36,7 @@
<xi:include href="xml/cairo-win32.xml"/>
<!--xi:include href="xml/cairo-beos.xml"/-->
<xi:include href="xml/cairo-svg.xml"/>
- <!--xi:include href="xml/cairo-quartz.xml"-->
+ <xi:include href="xml/cairo-quartz.xml" />
<!--xi:include href="xml/cairo-xcb.xml"/-->
<xi:include href="xml/cairo-xlib.xml"/>
</chapter>
diff --git a/doc/public/cairo-sections.txt b/doc/public/cairo-sections.txt
index abfda0e..8abd2c6 100644
--- a/doc/public/cairo-sections.txt
+++ b/doc/public/cairo-sections.txt
@@ -89,6 +89,17 @@ cairo_win32_surface_get_image
</SECTION>
<SECTION>
+<FILE>cairo-quartz</FILE>
+<TITLE>Quartz Surfaces</TITLE>
+CAIRO_HAS_QUARTZ_SURFACE
+cairo_quartz_surface_create
+cairo_quartz_surface_create_for_cg_context
+cairo_quartz_surface_get_cg_context
+cairo_quartz_image_surface_create
+cairo_quartz_image_surface_get_image
+</SECTION>
+
+<SECTION>
<FILE>cairo-xlib</FILE>
<TITLE>XLib Surfaces</TITLE>
CAIRO_HAS_XLIB_SURFACE
diff --git a/doc/public/tmpl/cairo-quartz.sgml b/doc/public/tmpl/cairo-quartz.sgml
index 1c5e71f..56f4c8b 100644
--- a/doc/public/tmpl/cairo-quartz.sgml
+++ b/doc/public/tmpl/cairo-quartz.sgml
@@ -20,3 +20,52 @@ Apple OS X Quartz rendering system.
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### FUNCTION cairo_quartz_surface_create ##### -->
+<para>
+
+</para>
+
+ at format:
+ at width:
+ at height:
+ at Returns:
+
+
+<!-- ##### FUNCTION cairo_quartz_surface_create_for_cg_context ##### -->
+<para>
+
+</para>
+
+ at cgContext:
+ at width:
+ at height:
+ at Returns:
+
+
+<!-- ##### FUNCTION cairo_quartz_surface_get_cg_context ##### -->
+<para>
+
+</para>
+
+ at surface:
+ at Returns:
+
+
+<!-- ##### FUNCTION cairo_quartz_image_surface_create ##### -->
+<para>
+
+</para>
+
+ at image_surface:
+ at Returns:
+
+
+<!-- ##### FUNCTION cairo_quartz_image_surface_get_image ##### -->
+<para>
+
+</para>
+
+ at surface:
+ at Returns:
+
+
diff --git a/doc/public/tmpl/cairo-surface.sgml b/doc/public/tmpl/cairo-surface.sgml
index 20d8569..07acd37 100644
--- a/doc/public/tmpl/cairo-surface.sgml
+++ b/doc/public/tmpl/cairo-surface.sgml
@@ -182,6 +182,7 @@ cairo_<emphasis>backend</emphasis>_surface_create().
@CAIRO_SURFACE_TYPE_SVG:
@CAIRO_SURFACE_TYPE_OS2:
@CAIRO_SURFACE_TYPE_WIN32_PRINTING:
+ at CAIRO_SURFACE_TYPE_QUARTZ_IMAGE:
<!-- ##### FUNCTION cairo_surface_get_type ##### -->
<para>
More information about the cairo-commit
mailing list