changelog

按照官方的说法：Cairo is a vector graphics library with cross-device output support. 翻译过来

commit 0e30fc44363435c52c762fa8a353de43fe087822
Author: Carl Worth <[e-mail]>
Date:	Mon Jun 12 08:45:58 2006 -0700

    Add aliases for deprecated cairo_{pdf,ps,svg}_surface_set_dpi

    The aliases should allow binaries with the old symbols to continue
    to run.

    Meanwhile, the macros in cairo.h prevent any code from being compiled
    without
    using the new, future-proof function names.

    This is a temporary, transition strategy and the aliases will
    be dropped
    before the next major release.

commit 7015cc0b90f99898852ca276368854f9465f4c82
Author: Carl Worth <[e-mail]>
Date:	Mon Jun 12 08:18:09 2006 -0700

    Add cairo-ps-test.h and cairo-svg-test.h to Makefile.am

commit 8581447e7b26f34c7be43fef7dfa5458f2278556
Author: Kristian Høgsberg <[e-mail]>
Date:	Mon Jun 12 03:15:33 2006 -0400

    Add an in-memory output-stream implementation.

commit d43321066081eacca2e0c86258c68bae49036087
Author: Kristian Høgsberg <[e-mail]>
Date:	Mon Jun 12 03:10:40 2006 -0400

    Convert the word wrap stream, the base85 stream and the ps string
    stream.

commit 45cbe055d9cf4ac2cf2fbcd21b020c8f869a0380
Author: Kristian Høgsberg <[e-mail]>
Date:	Mon Jun 12 03:08:51 2006 -0400

    Convert the stdio output stream to use the new output stream
    interface.

commit 3575c942f81d54c88fd48aee2352ecd29406e711
Author: Kristian Høgsberg <[e-mail]>
Date:	Mon Jun 12 03:07:19 2006 -0400

    Make cairo_output_stream_t an embeddable type.

    Most internal cairo types are transparent within cairo and have init
    and fini
    functions to intialize and finialize them in place.  This way they
    can be
    easily be embedded in other structs or derived from.  Initially, the
    cairo_output_stream_t type was proposed as a publically visible
    type and
    thus kept opaque.  However, now it's only used internally and
    derived from
    in a number of places so let's make it an embeddable type for
    consistency
    and ease of use.

    The patch keeps _cairo_output_stream_create() and
    _cairo_output_stream_close()
    around for (internal) backwards compatibility by deriving a
    cairo_output_stream_with_closure_t stream type.

    The patch also moves all cairo_output_stream_t functions out of
    cairoint.h
    and into new file cairo-output-stream-private.h, thus chipping away
    at the
    monolithic cairoint.h.

commit 9d3443e86ab32711d332b1474bc2fe23f9796723
Author: Jinghua Luo <[e-mail]>
Date:	Mon Jun 12 14:18:25 2006 +0800

    xlib: bugfix for #7172.

    When the glyph format does not match the font format, the glyph will
    be rendered incorrectly. Setting the {x, y}_offset correctly when
    converting glyph format fix that.

commit 79928101352a84af1884e993fd06bf6cd44f2af3
Author: Emmanuel Pacaud <[e-mail]>
Date:	Sun Jun 11 20:56:09 2006 +0200

    SVG: Sets fallback resolution when compositing a meta surface.

    For doing so, I've changed document owner to be the paginated surface,
    instead of the svg surface like previously. That's because fallback
    resolution is stored in paginated surface.

commit 7e1a01092c94c7b67e95f4f4ff27c76fb5b21295
Author: Jinghua Luo <[e-mail]>
Date:	Sun Jun 11 18:37:59 2006 +0800

    freetype: build fix for _transform_glyph_bitmap.

    I sorry for this noise, I didn't notice cworth's device_{x, y}_offset
    changes. Now cairo builds again.
    paths...

commit 4af28e639dcf7fe3332c0302295e6d590a505af7
Author: Jinghua Luo <[e-mail]>
Date:	Sun Jun 11 18:16:46 2006 +0800

    ignore FC_MATRIX in font pattern.

    With previous commit, freetype font backend is able to transform
    both bitmap and outline glyphs, so ignores FC_MATRIX from now,
    cairo doesn't need this for artificial oblique. And cairo doesn't
    use FC_MATRIX direct anyway, it has its own font matrix that may
    be not
    equal to FC_MATRIX in the font pattern! You should pass the matrix
    (usually the matrix is multiplied by font's pixel size) to cairo when
    creating scaled font.

commit f5bc26b75dd030ada70f87113e2d132dfcb0b0f3
Author: Jinghua Luo <[e-mail]>
Date:	Sun Jun 11 18:09:05 2006 +0800

    freetype: rework _transform_glyph_bitmap.

    This function is used to shape bitmap glyphs(outline glyphs are
    transformed by freetype). That means freetype backend is able to
    tranform both bitmap & outline glyphs now. This is needed for glyph
    rotating, artificial oblique etc.

commit da9cd55afbb55ae70991e3f5b4c0dc5b9a58e0d6
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 16:31:05 2006 -0700

    ROADMAP: Note that cairo_surface_set_fallback_resolution is in
    place now.

commit 2f4210d346d10a2bff9a1ba74e6e9279cd4dddc3
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 11:20:21 2006 -0700

    Change _cairo_meta_surface_get_extents to return a bounded size.

    The old behavior of returning "infinite" extents is inconsistent with
    the current usage of meta-surface where it is always created for
    replay against a particular (sized) target surface and that size is
    passed to _cairo_meta_surface_create.

    Also clarify documentation of _cairo_surface_get_extents to eliminate
    the possibility of inifinite extents.

commit d758d5104a09019b65c1b2e93fd5ab80b0e4d056
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 10:42:32 2006 -0700

    Don't create a new scaled_font if there's a device_offset but no
    device_scale.

    (This is covering up my mistake from the last batch of 12 commits
    which
    wasn't ready to be pushed yet. This fixes some of the crashes which
    were introduced, and is a good thing to do regardless.)

commit 0662928e4fd7bd432fdd815b95271d5c74eaba70
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 09:44:30 2006 -0700

    Clarify that fallback_resolution acts on a per-page granularity.

    This explains why the SVG result from the fallback-resolution test
    doesn't actually show multiple resolutions in effect at the same time.

commit 13ba5316fbc4b9d2aac13da644f4c87069447246
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 09:15:31 2006 -0700

    Test PS and SVG backends in addition to PDF in
    test/fallback-resolution.

commit 6ca30e108f32862948fa332b31f60fa79b566d77
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 09:14:47 2006 -0700

    Add cairo_{ps,svg}_test_force_fallbacks so tests can force fallbacks.

commit 100b30d1c09cb7fe73414c4d3466032a8c99b088
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 08:35:01 2006 -0700

    Fix font size when drawing text with a device_scale.

    The trick is to create a new scaled_font with the device_transform
    multiplied into the CTM within _cairo_surface_show_glyphs before
    calling into the backend. The fallback-resolution test shows that
    the font size is now correct.

commit 74857181c96c734d7e735cfc9862e22b01599913
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 08:29:14 2006 -0700

    Fix line width for stroking with a device_scale.

    The trick is to simply multiply the device_transform into the CTM
    within _cairo_surface_stroke before passing the CTM down to the
    backend. The fallback-resolution test shows that the stroke width is
    now correct.

commit ebb53b2572cc74f90d2afd03807b7d4f41a4965a
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 08:21:18 2006 -0700

    Add text and stroke to falback-resolution test (showing bugs in each).

commit 6efeb1e19b4c30d6a88bd9248a1d67b791b8df0d
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 08:19:41 2006 -0700

    Hook up device scaling so fallback_resolution starts working.

    Add new, private _cairo_surface_set_device_scale for getting at the
    scaling components of device_transform. Use this in paginated surface
    when replaying to an image surface. The fallback-resolution test now
    clearly shows that image fallback resolution can be controlled by the
    user. Hurrah!

commit b129f747c5c7edc37982f286940d3583c74cfee9
Author: Carl Worth <[e-mail]>
Date:	Sat Jun 10 00:12:51 2006 -0700

    Change {x,y}_device_offset values to a device_transform matrix.

    This is a step toward allowing device scaling in addition to device
    offsets.
    So far, the scale values are still always 1.0 so only the translation
    is
    actually being used. But most of the code is in place for doing
    scaling as
    well and it just needs to be hooked up.

    There are some fragile parts in this code, all of which involve
    using the
    translation without the scale, (so grep for device_transform.x0 or
    device_transform->x0). Some of these are likely bugs that will
    hopefully
    be obvious once we start using the scale. Others are OK if only
    because
    we 'know' that we aren't ever setting device scaling on a surface that
    has a device offset (we only set device scaling on surfaces we create
    internally and we don't export device scaling to the user).

    All of these fragile parts in the code have been marked with
    comments of
    the form: XXX: FRAGILE.

commit 24da744d03e961078e68691225fb1363e47b2b22
Author: Carl Worth <[e-mail]>
Date:	Fri Jun 9 23:59:24 2006 -0700

    doc: SGML template churn

commit 999315cc0ad326d31c66f2e6fa1ae72dfb9bb57e
Author: Carl Worth <[e-mail]>
Date:	Fri Jun 9 21:12:44 2006 -0700

    Rename device_{x,y}_offset to {x,y}_device_offset for better
    consitency/grepability

commit 6f6bdb6663fc439387db6b410bf742de6b501015
Author: Carl Worth <[e-mail]>
Date:	Fri Jun 9 16:54:09 2006 -0700

    Add REPLACED_BY macros to help porting to new set_fallback_resolution

commit b2f274b3e86983b312ec19e33b3a1231bd3e51d0
Author: Carl Worth <[e-mail]>
Date:	Fri Jun 9 16:52:17 2006 -0700

    New API: Replace cairo_{ps,pdf,svg}_set_dpi with new
    cairo_surface_set_fallback_resolution.

    This just provides the mechanics for storing the value and removing
    the old
    function calls. The new value is still not used anywhere (though
    nor where
    the old values), so there should be no functional change (other
    than forcing
    any programs calling the old API to be updated).

commit a812b3c4908ff296877a648915d5f06696eebe9e
Author: Carl Worth <[e-mail]>
Date:	Fri Jun 9 15:37:50 2006 -0700

    Ignore ft-text-vertical-layout binary

commit ac20c80960ccf233f9582da88f0d7aa4a181099e
Author: Jinghua Luo <[e-mail]>
Date:	Fri Jun 9 07:06:51 2006 +0800

    freetype: Ignore global advance unconditionally.

    Global advance exists for historical reasons. Nowadays, most of fonts
    support unicode, means it's no guaranteed to every glyphs in the font
    has the same advance.Sometimes it maybe is biger/smaller then
    the global
    advance even for monospace fonts!So forcing their advance to global
    advance, it's obviously wrong.

commit d3c782320a76d8e79099e5c5dc03c7dd819573d7
Author: Carl Worth <[e-mail]>
Date:	Wed Jun 7 17:38:09 2006 -0700

    Rename ft-text-vertical-layout reference image according to standard
    convention.

    The standard convention is that the ARGB32 reference image has no
    -argb32- component in its name (no real important reason, just
    historical). So let's be consist and rename:
    test/ft-text-vertical-layout-argb32-ref.png ->
    test/ft-text-vertical-layout-ref.png

commit b7b3d05d78f22b6b45c6a54f2647dbdaeb034d37
Author: Carl Worth <[e-mail]>
Date:	Wed Jun 7 13:51:58 2006 -0700

    Fix bug in get-group-target (in the test itself) letting it now pass.

commit 45ca22e5e1a177a4dc9854cd310e5c683df058cb
Author: Jinghua Luo <[e-mail]>
Date:	Thu Jun 8 04:06:30 2006 +0800

    Make image-*-ref.png image as reference image.

commit 5ae2a78a297730cd9d2f45be9f23fbf6e2bffe7d
Author: Jinghua Luo <[e-mail]>
Date:	Thu Jun 8 03:45:38 2006 +0800

    freetype: Fix for test case ft-text-vertial-layout.

    Fix scaled font metrics and glyph metrics calculation for vertical
    layout. Test case ft-text-vertial-layout passes now.

commit 6b5be506ed160675232bea31b17f458040f6b2d8
Author: Jinghua Luo <[e-mail]>
Date:	Thu Jun 8 03:33:38 2006 +0800

    Add ft-text-vertical-layout test case for vertical layout.

commit bb66d15a7998740b6ce2525ab5d852fb2966f8f8
Merge: 3594fd2... b7c7d2e...
Author: Jinghua Luo <[e-mail]>
Date:	Thu Jun 8 02:38:17 2006 +0800

    Merge branch 'master' of
    git+ssh://[e-mail]/git/cairo

commit 3594fd2d273398b10748c8ed03c7a9da7af377fa
Author: Jinghua Luo <[e-mail]>
Date:	Thu Jun 8 02:35:42 2006 +0800

    glitz: Don't hardcode content type when initializing cairo surface
    since we can compute it from glitz format.

commit b7c7d2e57c2721c3a900694d5620b3f45f495233
Author: Carl Worth <[e-mail]>
Date:	Wed Jun 7 10:37:29 2006 -0700

    Add new test get-group-target (currently failing with paginated).

    This test exercises the combination of cairo_get_group_target along
    with cairo_surface_get_device_offset. Something funny is currently
    going on with the surfaces based on the paginated surface.

commit 53bf2f8d5dd82e9cff0960ebec536597bc7701e9
Author: Carl Worth <[e-mail]>
Date:	Wed Jun 7 10:29:33 2006 -0700

    Remove debugging "prints" of images from test/device-offset.c

commit 32c0e85d45ee26c34ba1af0e4ba6ced044e469cc
Author: Zakharov Mikhail <[e-mail]>
Date:	Wed Jun 7 18:32:16 2006 +0400

    pixman: fix compilation on HP-UX 11.11

commit 3690eeb44cd86ac02eb21163d9a5e84784f6417d
Author: Carl Worth <[e-mail]>
Date:	Wed Jun 7 02:59:51 2006 -0700

    Change all instances of UINT16_MAX to INT16_MAX to avoid new bug.

    A recent renaming from CAIRO_MAXSHORT also changed the range of some
    values from INT16_MAX to UINT16_MAX. The test suite shows one case
    where this introduces a bug, (push/pop_group with SVG and RGB24
    surfaces).

    I haven't tracked the bug down, (presumably there's overflow of the
    unsigned value at some point), but I'm now reverting this to avoid
    triggering the bug.

commit 7f2cf378d595fa559401c76f051ca9b5e6809763
Author: Carl Worth <[e-mail]>
Date:	Wed Jun 7 01:17:53 2006 -0700

    Fix MAX vs. MIN bug introduced with rename away from CAIRO_MINSHORT