1 Release 1.14.6 (2015-12-09 Bryce Harrington <bryce@osg.samsung.com>)
2 ========================================================================
3 Simple bugfix release to fix one Windows issue.
5 For a complete log of changes since 1.14.4, please see:
7 http://cairographics.org/releases/ChangeLog.1.14.6
21 Performance Optimizations
22 -------------------------
27 * Fix failure on Windows due to reference of the function
28 cairo_win32_surface_create_with_format(), which isn't included in the
29 1.14.4 release. (Bug #92771)
32 Release 1.14.4 (2015-10-28 Bryce Harrington <bryce@osg.samsung.com>)
33 ========================================================================
34 Just in time for Halloween we see another bug-fix release for Cairo.
35 This brings a few dozen straightforward bug fixes with no API changes.
37 In addition, this includes a typical assortment of fixes to tests,
38 cleanup of warnings and memory leaks, correction of misspellings,
39 updates to documentation, etc.
41 For a complete log of changes since 1.14.2, please see:
43 http://cairographics.org/releases/ChangeLog.cairo-1.14.4
58 Performance Optimizations
59 -------------------------
64 * Avoid appending empty slots to user data arrays. Fixes a memory
65 consumption regression since commit 9341c254a.
67 * Return a better error (file-not-found) when setting up pango on
68 devices where the font files don't have read permissions.
70 * Fix regression in the font size of canvas text in Inkscape when
71 compiled with the Quartz backend. (Bug #84324)
73 * Fix _cairo_gl_shader_bind_matrix() to maintain compatibility with
74 OpenGL ES 2.0. Manually transpose the matrix.
76 * Fix incorrect font descriptor conversion when the font matrix yy is
77 negative. (Bug #90538)
79 * Fix crash when using a complex path for clip and stroke due to
80 discarding the intersection exactly at the top edge.
83 * Fix cairo_get_locale_decimal_point() on Android
85 * Fix compilation problem on AIX due to conflicting usage of symbol
86 'jmpbuf'. (Bug #89339)
88 * Fix broken rendering with XCB due to snapshotting of uploaded part of
89 surfaces. (Bug #67505)
91 * Fix loss of alpha when copying a mask for a cairo recording surface,
92 resulting in a double copy. (Bugs #73038, #73901)
94 * Fix incorrect recording of certain paths with script surfaces.
97 * Fix typo in definition of MAYBE_WARN in configure script.
100 * Fix use of filename variable after it's been freed.
103 * Fix out of bounds access when printing pattern.
106 * Fix incorrect size calculation in glyph cache unlocking for Cairo GL
110 * Fix memory leak in _cairo_gl_pattern_texture_setup()
113 * Fix transparent images in win32-print.
116 * Fix _put_shm_image_boxes and _put_image_boxes when no SHM available
120 Release 1.14.2 (2014-03-09 Bryce Harrington <bryce@osg.samsung.com>)
121 ====================================================================
122 This release provides collected bug fixes, along with one feature
123 enhancement for the xcb backend, and a small performance improvement for
126 The running theme of the bug fixes is platform-specific issues, both
127 build and run-time. Platforms with fixes include Sparc, AIX, Windows
128 (mingw), and Windows (MSVC8). Memory leaks, valgrind issues, and PDF
129 issues round out our list.
131 It's come to light that changes in cairo 1.14 resulted in breakage on
132 MacOS X 10.4. We've not yet determined whether to fix up the support,
133 or excise the 10.4-specific code and support only OS X 10.5 or newer.
134 Meantime, we'll only advertise cairo as working on OS X 10.5.
138 * Improve xcb's handling of per-screen subpixel ordering. If no
139 Xft.rgba property is specified, default to the screen's subpixel
150 Performance Optimizations
151 -------------------------
152 * Improve performance of cpu_to_be32 and be32_to_cpu, making truetype
153 subsetting of large fonts run about 15% faster.
157 * Fix unaligned access on sparc with the compact font format (CFF).
158 Unlike truetype, all data in CFF is not aligned.
160 * Fix unaligned access on sparc with tor-scan-converter's memory pool.
161 * Fix crash when loading a PDF with a transformed image.
163 * Fix regression on mingw for bigendian test due to removal of file
164 extension for executables.
166 * Fix handling of backslash in PDF interpreter
168 * Fix crash in xlib and xcb renderers when swapping a 0-sized glyph
169 * Fix bug with RTL text in PDF operators
171 * Fix compilation 'cairo-path-stroke-traps.c' with MSVC8
173 * Fix crash in _fill_xrgb32_lerp_opaque_spans when a span length is
175 * Fix valgrind error by releasing pattern created by
176 cairo_pattern_create_rgb().
177 * Fix valgrind errors when running cairo-test-suite.
178 * Fix memory leak in recording surface replays
180 * Fix destruction of fonts in api-special-cases test.
182 * Fix duplicated surface push on similar-image, preventing trivial GTK3
183 program traces from being replayable, with an error message about
184 invalid values for the size of the input.
186 * Fix crash when win32 surface's image size does not cover the entire
189 * Fix crash due to obsolete CGFontGetGlyphPath call
191 * Fix several build issues on AIX
192 (fdo bugs #89338, #89340, #89356, #89354)
193 * Fix various documentation warnings and errors
195 Release 1.14.0 (2014-10-13 Bryce Harrington <bryce@osg.samsung.com>)
196 ====================================================================
197 Hard to believe it's been over a year since our last release, but it's
198 not for lack of activity. This release includes contributions of a wide
199 assortment of bug fixes, build system improvements, warnings cleanups,
200 codebase refactoring, test suite repairs, and static analysis work.
202 This release is lighter on features (compared with 1.12.10) but includes
203 a highly demanded rehaul of our image downscaling functionality, which
204 solves a serious problem experienced by Inkscape users when shrinking
205 embedded bitmaps in SVG files. The new scaling algorithms are used by
206 the image backend and by other backends as needed for fallbacks.
212 Filtering improvements for the image backend, in particular
213 down-scaling of images produces filtered images that depend on all the
214 pixels of the source. When using the image backend you get the
217 CAIRO_FILTER_GOOD: uses a box filter for scales less than .75 in
218 either direction. For scales larger than this, the same filter as
219 CAIRO_FILTER_BILINEAR is used.
221 CAIRO_FILTER_BEST: uses a Catmull-Rom filter always. When upscaling
222 more than 2x this will produce anti-aliased square pixels, similar
225 CAIRO_FILTER_GAUSSIAN: uses PIXMAN_FILTER_BEST, which in current
226 pixman is the same as BILINEAR. (This is subject to change in the
229 xlib and xcb also use the image fallback for GOOD/BEST filters, but
230 note that other backends do not implement these filtering fixes yet,
231 however other actions may cause them to use an image fallback which
232 will cause these filters to be used.
234 Improve handling of device transformation and scaling, allowing Cairo
235 to now support scaling at a device level, permitting easier, more
236 transparent HiDPI support.
238 Support JBIG2 mime data in PDF. This allows embedding of more
239 compressed JPEG formats within PDF, rather than including the full
240 uncompressed image. Also, reduce the number of transparency groups
241 used by PDF to keep the file size small and viewing/printing of the
244 Expand the embedding section to include stencil mask support.
246 Reorder font declarations to be in natural order.
248 Update the Skia backend to build against current Skia (as of June
251 Drop Link-Time Optimization (LTO) support from build system. This
252 seems to have caused much trouble for unclear benefit, and most
253 distros are reverting or disabling it anyway.
255 Optimize VBO size on GL to 1M and to 16k for EGL. This improves
256 (theoretical) performance for desktop GLX use cases while avoiding
257 hitting VBO memory size limitations on embedded devices.
262 cairo_surface_set_device_scale, cairo_surface_get_device_scale:
264 Sets a scale that is multiplied to the device coordinates
265 determined by the CTM when drawing to @surface. One common use for
266 this is to render to very high resolution display devices at a scale
267 factor, so that code that assumes 1 pixel will be a certain size
270 cairo_egl_device_get_display, cairo_egl_device_get_context:
272 Support get/set of EGLContext and EGLDisplay for egl-based cairo
273 devices, similar to GLX.
278 Cairo now requires glib 2.14 for its gobject helper functions,
279 and pixman 0.30 for downscaling.
285 Don't embed CMYK Jpeg images in svg.
287 Fix tests to place output in proper location.
289 Fix determination of alpha for all surfaces when recording.
291 Extend oversize check to cairo_gl_surface_create_for_texture, so an
292 error surface is returned if the texture is too large to render to.
294 Fix embedding of mime data in PDF and PS files.
296 Remove useless error handling in *_reply() functions in XCB.
298 Fix a double-free exposed by multithreaded apps creating and
299 destroying the same font concurrently.
300 https://bugs.freedesktop.org/show_bug.cgi?id=69470
302 Fix corrupt stacks produced by bugs in operand emission for trace.
304 Fix out of bounds array access in format cache for xlib
306 Don't rename glyphs used by seac operator. This can cause certain
307 combined characters to use their decorations (e.g. umlauts on ö) to be
308 lost during printing of PDFs using evince.
309 https://bugs.freedesktop.org/show_bug.cgi?id=70364
311 Fix crash on calling cairo_create with a finished surface
313 Fix SSIZE_T definition problem when making with MSYS on Windows7
315 Fix one off issue in gl context cleanup
317 Fix usage of CAIRO_STACK_ARRAY_LENGTH
319 Fix rectangle stroke with non rectilinear pen
321 Fix imagemask with pattern source failure on some printers. This bug
322 could cause files converted using pdftops to fail for example on Ricoh
323 printers, or opening in Adobe Distiller on Windows.
324 https://bugs.freedesktop.org/show_bug.cgi?id=69485
326 Fix whitespace in font names
328 Fix page size in generated PDFs. When printing using pdftocairo on
329 larger page sizes, such as 11x17, the image would be cropped to letter
331 https://bugs.freedesktop.org/show_bug.cgi?id=73452
333 Fix path-currentpoint test by preserving current-point in
334 copy_path()/append_path() sequence
336 Fix generation of HTML in code docs for
337 cairo-format-stride-for-width. Raw HTML code was being passed
338 to the browser, instead of displaying normally.
339 https://bugs.freedesktop.org/show_bug.cgi?id=63257
341 Fix spelling of "tessellator" throughout code. We're using the
342 American rather than British spelling of this word.
343 https://bugs.freedesktop.org/show_bug.cgi?id=50411
345 Fix crash in pixman_image_composite32
347 Fix crash when trying to modify a (const) all-clipped cairo_clip_t
348 https://bugs.freedesktop.org/show_bug.cgi?id=75819
350 Add check_composite method to all compositors, to fix crashes in the
353 Fix crash in Firefox when scrolling on certain pages.
355 Fix memory leaks found by static analysis.
357 Fix build of any2ppm if fork is not available.
359 Fix broken build for Qt backend, due to missing libstdc++.
361 Fix typo in two cairo_uint128 functions. Fixes potential build issues
362 on systems without a uint128 type.
364 Fix build when --enable-pdf=no
366 Fix cache_frozen assertions for Win32 print.
368 Correctly check for xcb image surface for inplace upload
370 Fix webkit-based web browser crashes due to empty boxes by skipping
371 over them when tesselating.
373 Make pixman, libpng, and zlib paths commandline configurable for win32
376 Fix image scale on Win32 when GDI scale is not identity.
378 Fix float endian configure test when using clang -O4
380 Fix compilation with Android bionic libc
382 Don't try to build util/sphinx on Windows
384 Fix loss of precision when emitting joins. This was caused by
385 discrepancies in line gradients when passing trapezoids around.
387 Fix loss of precision and associated rendering issues in
388 cairo-tor-scan-converter from projection onto sample grid.
390 Fix pixman oversampling of neighbouring edges within a cell by
391 eliminating self-intersections for the pixman traps compositor.
393 Fix multi-line string splitting in PDFs
395 Various cleanups and fixes to warnings, documentation, tests, and
396 build system. Improve error handling and return value checks.
397 Cleanup XFAIL tests and reference images. Cover recently added
401 Release 1.12.16 (2013-08-21 Chris Wilson <chris@chris-wilson.co.uk>)
402 ===================================================================
403 Thanks to everybody who reported a bug and helped us develop a fix,
404 we have amassed quite a few bug fixes. There are still more outstanding
405 bugs that seek attention and a little bit of TLC, but this release has
406 been delayed long enough...
411 Set the correct orientation for simple boxes with a negative scale
414 Fix the creation of the shading dictionary in PDF.
416 Fix a crash in PDF when incorporating an image with CAIRO_EXTEND_PAD.
417 https://bugs.freedesktop.org/show_bug.cgi?id=61451
419 Avoid upscaling bitmap fonts if possible.
421 Fix an assertion failure within the mempool allocator for shared memory.
423 Fix allocation size for CFF subsets.
425 Export cairo_matrix_t for GObject bindings.
427 Fix a double free in the Quartz backend.
428 https://bugs.freedesktop.org/show_bug.cgi?id=62885
430 Fix origin of GDI StretchBlits for the Windows backend
431 https://bugs.freedesktop.org/show_bug.cgi?id=61876
433 Fix error propagation for requests to create a similar surface with
435 https://bugs.freedesktop.org/show_bug.cgi?id=63196
437 Fix complex clipping of trapezoids with regions
438 https://bugzilla.gnome.org/show_bug.cgi?id=697357
440 Stop leaking the image data when loading PNGs
442 Fix unbounded operations with a clip mask through the span compositor
443 https://bugs.freedesktop.org/show_bug.cgi?id=61592
445 Add missing checks before rendering to a finished surface - so we return
446 an error rather than hit an assert.
447 https://bugs.freedesktop.org/show_bug.cgi?id=68014
449 Prevent an assertion failure when creating similar GL surfaces larger
450 than supported by hardware.
452 Prevent a double free of a similar image under Windows.
453 https://bugs.freedesktop.org/show_bug.cgi?id=63787
456 Release 1.12.14 (2013-02-10 Chris Wilson <chris@chris-wilson.co.uk>)
457 ===================================================================
458 In the last week we had a few more bugs reported and promptly resolved.
459 As these are a combination of regressions and stability issues, it is
460 time for a prompt update and release. Many thanks to everyone for
461 testing and reporting issues, and helping to make Cairo better.
466 Prevent user callbacks accessing user-data during destroy to prevent
468 https://bugzilla.mozilla.org/show_bug.cgi?id=722975
470 Use standard names for glyphs in subset fonts (PDF).
471 https://bugs.freedesktop.org/show_bug.cgi?id=60248
473 Fix detection of Win98. The logic for detecting Win98 (and its broken
474 AlphaBlend()) was inverted, disabling AlphaBlend() for everyone.
476 Prevent numeric overflow from extrapolating polygon edges to the clip
477 boundary and causing severe render artifacts.
478 https://bugs.freedesktop.org/show_bug.cgi?id=60489
480 Fix computation of glyph string coordinates when breaking up runs
483 Fix an assertion in the win32 backend for failing to clear its
485 https://bugs.freedesktop.org/show_bug.cgi?id=60519
488 Release 1.12.12 (2013-01-31 Chris Wilson <chris@chris-wilson.co.uk>)
489 ===================================================================
490 The goal of this release is to fix the synchronisation problems that
491 were exhibited in the SHM transport for cairo-xlib. This cropped up
492 any place that tried to rapidly push fresh pixel data to the X server
493 through an ordinary image surface, such as gimp-2.9 and evince.
498 Avoid replacing the entire image when uploading subimages
499 https://bugs.freedesktop.org/show_bug.cgi?id=59635
501 Force synchronisation for scratch SHM image buffers, so that we do
502 not overwrite data as it is being read by X.
503 https://bugs.freedesktop.org/show_bug.cgi?id=59635 (also)
505 Fix typos in detecting multisampling for the GL (MSAA) backend.
507 Fix a memory leak in the GL (MSAA) backend.
509 Fix a reference counting bug when mapping a GL surface to an image.
512 Release 1.12.10 (2013-01-16 Chris Wilson <chris@chris-wilson.co.uk>)
513 ===================================================================
514 A heap of bug fixes everywhere, and the gradual completion of the MSAA
515 backend for cairo-gl. Perhaps the most noteworthy set of the bugfixes
516 was the crusage lead by Behdad Eshfabod to make font handling by
517 pango/cairo/fontconfig fully threadsafe. This testing revealed a couple
518 of races that needed fixing in Cairo's scaled-font and glyph cache.
523 Append coincident elements to the recording's surface bbtree so that
524 the list is not corrupted and the overlapping elements lost.
526 Fix cairo-trace to correctly record map-to-image/unmap-image and then
529 Ignore MappingNotifies when running the XCB testsuite as they are sent
530 to all clients when the keyboard changes. The testsuite would detect
531 the unexpected event and complain.
533 Handle very large images in the XCB backend.
535 Fix a memory leak in the xlib/shm layer, and prevent use of the SHM
536 surfaces after the display is closed.
537 https://bugs.freedesktop.org/show_bug.cgi?id=58253
539 Handle resizing of bitmap fonts, in preparation for a fix to
540 fontconfig to correctly pass on the user request for scaling.
542 Always include subroutine 4 (hint replacement idion) when subsetting
543 type 1 fonts in order to prevent a crash in cgpdftops on Mac OS/X
545 Fix a couple of typos in the cairo-gobject.h header files for
548 Prevent a mutex deadlock when freeing a scaled-glyph containing a
549 recording-surface that itself references another scaled-glyph.
550 https://bugs.freedesktop.org/show_bug.cgi?id=54950
552 Make scaled-font cache actually thread-safe and prevent
555 Restore support for older versions of XRender. A couple of typos and a
556 few forgotten chunks prevented the xlib compositor from running
557 correctly with XRender < 0.10. Note that there are still a few
558 regressions remaining.
561 Release 1.12.8 (2012-11-24 Chris Wilson <chris@chris-wilson.co.uk>)
562 ===================================================================
563 Another couple of weeks and a few more bugs have been found and fixed,
564 it is time to push the next point release. Many thanks to everyone who
565 reported their issues and helped us track down the bugs and helped
571 Expand the sanity checking for broken combinations of XSendEvent and
574 Notice that "The X.Org Foundation" sometimes also identifies itself
575 as "The Xorg Foundation".
577 Handle various ages of libXext and its Shm headers.
579 Fix the invalid clipping of the source drawable when using SHM
580 transport to upload images.
581 https://bugs.freedesktop.org/show_bug.cgi?id=56547
583 Handle all Type1 postscript operators for better font compatibility.
584 https://bugs.freedesktop.org/show_bug.cgi?id=56265
586 Fix a couple of memory leaks in Type1 font subsetting
587 https://bugs.freedesktop.org/show_bug.cgi?id=56566
589 Tighten the evaluation of the start/stop pen vertices, and catch a few
590 instances where we would use a fan instead of a bevel.
591 https://bugs.freedesktop.org/show_bug.cgi?id=56432
593 Fix assumption that geometric clipping always succeeds with the
595 https://bugs.freedesktop.org/show_bug.cgi?id=56574
597 Fix call to spline intersection when evaluating whether a stoke is
600 Remember to copy inferior sources when using SHM to readback the
601 surface for use as a source.
603 Release 1.12.6 (2012-10-22 Chris Wilson <chris@chris-wilson.co.uk>)
604 ===================================================================
605 Thanks to everyone who download cairo-1.12.4 and gave us their feedback.
606 It truly was invaluable and has helped us to fix many portability issues
607 that crept in with some of the new features. This release aims to fix
608 those stability issues and run on a wider range of systems.
613 Fix the recording surface to actually snapshot the source and so fix
616 Calling XSendEvent with an XShmCompletionEvent is incompatabile with
619 Reorder CloseDisplay chain so that XShm is not reinstantiated after
620 shutdown, causing a potential crash if the Display was immediately
621 recreated using the same memory address.
623 Make sure that the Xserver has attached to the SHM segment before
624 deleting it from the global namespace on systems that do not support
627 Type1 subsetting support for PDF (and PS) was once again improved to
628 work with a larger number of PDF readers.
630 GLESv2 build fixes and improved support for embedded GPUs.
632 Tweak the invisible pen detection for applications that are currently
633 using too large values for geometric tolerance.
635 A build fix for older freetype libraries.
638 Release 1.12.4 (2012-10-05 Chris Wilson <chris@chris-wilson.co.uk>)
639 ===================================================================
640 More bugs, and more importantly, more fixes. On the cairo-gl side, we
641 have refinements to the MSAA compositor which enables hardware
642 acceleration of comparatively low-quality antialiasing - which is useful
643 in animations and on very high density screens. For cairo-xlib, we have
644 finally enabled SHM transport for image transfers to and from the X
645 server. A long standing required feature, SHM transport offers a notable
646 reduction in rendering latency by reducing the number of copies
647 required to upload image data - given hardware and driver support,
648 cairo-xlib can now perform zero copy uploads onto the GPU. And as usual
649 Adrian Johnson has been very busy fixing many different corner cases in
650 cairo-pdf, impoving opacity groups and font subsetting. Last, but not
651 least, for cairo-image Søren Sandmann Pedersen added support for
652 rendering glyphs to pixman and using that from within cairo. The new
653 glyph rendering facility reduces the overhead for setting up the
654 compositing operation, improving glyph thoughput for the image backend
655 by a factor of about 4. And before he did so, he also fixed up a few
656 bugs in the existing glyph rendering code. So many thanks to Andrea
657 Canciani, Adrian Johnson, Chuanbo Weng, Dongyeon Kim, Henry Song, Martin
658 Robinson, Søren Sandmann Pedersen and Uli Schlachter for their
659 contributions, finding and fixing bugs.
664 Interior boxes were being dropped when amalgamating regions during
666 https://bugs.freedesktop.org/show_bug.cgi?id=49446
668 Allow building without gtk-doc installed
670 Invalid edge generation whilst reducing complex polygons.
671 https://bugs.freedesktop.org/show_bug.cgi?id=50852
673 Stroking around tight cusps
675 Use locale correct formats for reading font subsetting and valid
677 https://bugs.freedesktop.org/show_bug.cgi?id=51443
679 Ensure that the type1 subset includes all the glyph encodings
680 https://bugs.freedesktop.org/show_bug.cgi?id=53040
682 Upload the whole source for a repeating pattern.
683 https://bugs.freedesktop.org/show_bug.cgi?id=51910
685 Fix damage tracking to handle continuation chunks corectly and so
686 prevent crashes on win32.
687 https://bugs.freedesktop.org/show_bug.cgi?id=53384
689 Avoid emitting miter joins for degenerate line segments
690 https://bugzilla.mozilla.org/show_bug.cgi?id=407107
692 Convert the relative path semgents into the backend coordinates
693 and then back again to user coordinates (cairo_copy_path,
695 https://bugs.freedesktop.org/show_bug.cgi?id=54732
697 Fix extents computations for a degenerate path consisting only of a
699 https://bugs.freedesktop.org/show_bug.cgi?id=54549
701 Prevent crashing on a degenerate project edge after polygon
703 https://bugs.freedesktop.org/show_bug.cgi?id=54822
707 Release 1.12.2 (2012-04-29 Chris Wilson <chris@chris-wilson.co.uk>)
708 ===================================================================
709 After such a long gestation period for the release of Cairo 1.12, we
710 inevitably accumulated a few bugs that were flushed out by broadening the
711 test base. Thanks to everybody who tried the release, apologies to any one
712 unfortunate enough to encounter a bug and many thanks for reporting it. As
713 a result Adrian Johnson, Alexandros Frantzis, Andrea Canciani, Kalev
714 Lember, Maarten Bosman, Marcus Meissner, Nis Martensen and Uli Schlachter
715 have squashed many more bugs and improved the documentation. I would
716 strongly recommend everyone to upgrade to cairo-1.12.2.
722 Allow applications to create 0x0 xlib surfaces, such as used by LibreOffice.
723 https://bugs.freedesktop.org/show_bug.cgi?id=49118
725 Trim composite extents for SOURCE/CLEAR operators to the mask.
727 Use fallback fonts in PDF for unhandled computed glyph widths
728 https://bugs.freedesktop.org/show_bug.cgi?id=48349
730 Handle snapshots of recording surfaces for analysing pattern extents.
731 Fixes a regression of reporting the PDF bounding box as being the page size.
733 Fix allocation size for PDF pattern ids.
734 Bugzilla: https://bugs.freedesktop.org/show_bug.cgi?id=49089
736 Fix emission of rectilinear dashed segments, with and without scaling, and
737 application of degenerate line joins.
739 Clamp unbounded fixup polygons to the clip extents.
741 Prevent infinite loop due to rounding errors whilst incrementing along dashes.
743 Prevent overflow for inline a8 span filling.
745 Miscellaneous build fixes for Cygwin on Windows and Solaris.
747 Release 1.12.0 (2012-03-23 Chris Wilson <chris@chris-wilson.co.uk>)
748 ===================================================================
749 It's taken over 18 months, but the wait is finally over. A new cairo release!
750 We are pleased to annouce a new stable release of Cairo that brings many
751 new features and performance improvements, all whilst maintaining
752 compatibility with cairo-1.0 and all releases since. We recommend anyone
753 using a previous release of Cairo to upgrade to 1.12.0.
755 The major feature of this release is the introduction of a new procedural
756 pattern; the mesh gradient. This, albeit complex, gradient is constructed
757 from a set of cubic Bezier patches and is a superset of all other gradient
758 surfaces which allows for the construction of incredibily detailed patterns.
759 In PDF parlance, the mesh gradient corresponds with type 7 patterns. Many
760 thanks to Andrea Canciani for bringing this to Cairo, and for his work on
761 making gradient handling robust.
763 Not content with just adding another procedural pattern, Cairo 1.12 also
764 adds new API to create a callback pattern,
765 cairo_pattern_create_raster_source, that allows the application to
766 provide the pixel data for the region of interest at the time of
767 rendering. This can be used for instance, by an application to decode
768 compressed images on demand and to keep a cache of those decompressed
769 images, independently of Cairo. When combined with the recording
770 surface, it should form a useful basis for a deferred renderer.
772 With the release of cairo-1.12, we also introduce a new supported
773 backend for interoperating with X using XCB. Uli Schlachter, also
774 maintainer of awesome and contributor to libxcb, has volunteered to
775 maintain cairo-xcb for us. Thanks Uli!
777 For cairo-1.12, we have also added some common API to address any
778 surface as an image and so allow direct modification of the raster data.
779 Previously, only the Quartz and Win32 backends supported a very narrow
780 interface to allow for efficient pixel upload. Now with
781 cairo_surface_create_similar_image, cairo_surface_map_to_image, and
782 cairo_surface_unmap_image, Cairo exports a consistent method for
783 treating those surfaces as an image and so allow modification inplace.
784 These are the same routines used internally, and should support
785 efficient transfer or direct mapping of the target surfaces as
788 Another focus over the past year has been to address many performance
789 issues, without sacrificing the composition model. To accomplish the
790 goal, once again the rasterisation pipeline was overhauled and made
791 explicit, giving the backends the freedom to implement their own
792 specific pipeline whilst also providing a library of common routines
793 from which to build the pipeline. For instance, this allows the image
794 backend and the gl backend to composite scan line primitives inplace,
795 and to then implement custom fallbacks to catch the corner cases that do
796 not map onto their fastest paths. Similarly, this allows for the Xlib
797 backend to implement trapezoidation without compromising the other
798 backends, yet still allow for the pipeline to be used elsewhere for
799 testing and fallbacks. Clipping was once again overhauled, so that the
800 common cases for the raster pipelines could be captured and processed
801 with fast paths with the emphasis on performing geometric clipping to
802 reduce the frequency of using multi-pass clipmasks. Stroking was made
803 faster, both by providing specialised fast-paths for simple, yet frequent,
804 cases (such as stroking around a rectangle) and by reducing the number
805 of edges generated by the general stroker.
807 As part of the focus on performance, Cairo 1.12 introduces some
808 antialias hints (NONE, FAST, GOOD, BEST) that are interpolated by the
809 rasterisers to fine tune their performance versus quality. Cairo 1.12
810 also introduces a new observation architecture,
811 cairo_surface_observer_t, which can be used to analyse the amount of
812 time consumed by drawing commands and help identify inefficiencies in
813 both Cairo and the application.
815 Last, but by no means least, the OpenGL backend has seen significant
816 work including the port to GLESv2 and the exploitation of advanced
817 hardware features. Interesting times.
819 As always, I would like to thank everyone who contributed to Cairo,
820 not only through writing code, but also submitting documentation, bug
821 reports, suggestions and generally having fun with Cairo! In particular
822 though this release could not have happened without the efforts of
823 Adrian Johnson, Alexandros Frantiz, Andrea Canicani, Martin Robinson,
824 Nis Martensen, and Uli Schlachter. Thanks.
827 Snapshot 1.11.4 (2012-13-12)
828 ============================
829 The cairo community is pleased to finally announce the long aniticpated
830 release candidate for 1.12, 1.11.4, of the cairo graphics library. This
831 is the first major update to cairo in over a year and brings a large
832 number of new features; undoubtably a few bugs as well.
834 While many people have contributed and have helped to test the release,
835 providing feedback on 1.10 and suggesting improvements, this release
836 is the result of a few persevering souls who deserve recognition for their
837 outstanding contributions: Andrea Canciani (all round bug fixing,
838 performance tuning and master of the gradients), Adrian Johnson (PDF
839 supremo) and Uli Schlachter (who stepped forward as maintainer for the
842 Major additions since 1.11.2:
844 * cairo_surface_map_to_image API for pixel level access to any surface
846 * New antialias hints to control the trade-off between speed and quality
848 * A callback pattern, cairo_pattern_create_raster_source, for lazy
849 decoding of image data.
851 * cairo_surface_observer_t, a new type of surface to gather performance
854 * XCB as a supported backend
856 * A rewritten compositor pipeline for performance improvements for, but not
857 limited to, the xlib and image backends.
858 From ION and PineView through to SandyBridge, every machine I have shows
859 across the board performance improvement on the cairo-traces:
861 i5-2520m gnome-system-monitor: 5.97x speedup
862 pnv gnome-system-monitor: 4.86x speedup
863 i5-2520m firefox-asteroids: 4.66x speedup
864 pnv firefox-asteroids: 4.43x speedup
865 image firefox-canvas: 3.82x speedup
866 i5-2520m firefox-canvas-alpha: 3.49x speedup
867 image firefox-asteroids: 2.87x speedup
868 pnv firefox-talos-svg: 2.83x speedup
869 ion grads-heat-map: 2.75x speedup
870 pnv firefox-canvas-alpha: 2.66x speedup
871 image gnome-system-monitor: 2.66x speedup
872 image swfdec-giant-steps: 2.46x speedup
873 image firefox-canvas-alpha: 2.14x speedup
874 i5-2520m firefox-talos-svg: 2.03x speedup
875 image grads-heat-map: 2.02x speedup
876 ion gnome-system-monitor: 2.00x speedup
877 pnv firefox-particles: 1.99x speedup
878 i5-2520m grads-heat-map: 1.96x speedup
879 pnv firefox-canvas: 1.92x speedup
880 ion firefox-particles: 1.80x speedup
881 image poppler-reseau: 1.77x speedup
882 pnv xfce4-terminal-a1: 1.72x speedup
883 image firefox-talos-svg: 1.65x speedup
884 pnv grads-heat-map: 1.63x speedup
885 i5-2520m firefox-canvas: 1.63x speedup
886 pnv swfdec-youtube: 1.62x speedup
887 image ocitysmap: 1.59x speedup
888 i5-2520m firefox-fishbowl: 1.56x speedup
889 i5-2520m poppler-reseau: 1.50x speedup
890 i5-2520m evolution: 1.50x speedup
891 i5-2520m midori-zoomed: 1.43x speedup
892 pnv firefox-planet-gnome: 1.42x speedup
893 i5-2520m firefox-talos-gfx: 1.41x speedup
894 i5-2520m gvim: 1.41x speedup
895 pnv ocitysmap: 1.37x speedup
896 image poppler: 1.31x speedup
897 ion firefox-canvas-alpha: 1.35x speedup
898 ion firefox-talos-svg: 1.34x speedup
899 i5-2520m ocitysmap: 1.32x speedup
900 pnv poppler-reseau: 1.31x speedup
901 i5-2520m firefox-planet-gnome: 1.31x speedup
902 pnv firefox-fishbowl: 1.30x speedup
903 pnv evolution: 1.28x speedup
904 image gvim: 1.27x speedup
905 i5-2520m swfdec-youtube: 1.25x speedup
906 pnv gnome-terminal-vim: 1.27x speedup
907 pnv gvim: 1.25x speedup
908 image firefox-planet-gnome: 1.25x speedup
909 image swfdec-youtube: 1.25x speedup
912 And a plethora of minor improvements everywhere!
915 Snapshot 1.11.2 (2011-01-23)
916 ===========================
918 In this first snapshot along the way to cairo-1.12.0, we are very excited
919 to announce the introduction of Bezier surface gradients, known as type
920 6/7 gradients in PS/PDF parlance. This is the culmination of much work by
921 the dynamic duo: Adrian Johnson and Andrea Canciani. Thanks guys!
923 Also, I want to warmly welcome Uli Schlachter who recently joined the
924 Cairo community on a mission. That mission is to make cairo-xcb a
925 supported backend for 1.12. And for this snapshot he has made great
926 strides in fixing all the bugs I had left behind. Thanks Uli!
928 And we have also seen a new contributor, Alexandros Frantzis, who has
929 begun bringing up cairo-gl for GLESv2 devices. Thanks Alex!
931 And lastly, I must also thank Adrian and Andrea for the vast numbers of
932 bugs that they have tackled between them, fixing all those little corner
933 cases that lie hidden until too late.
937 The ability to construct piece-wise Bezier surface gradients:
939 cairo_pattern_create_mesh
941 constructs a pattern of type CAIRO_PATTERN_TYPE_MESH using
943 cairo_pattern_mesh_begin_patch
944 cairo_pattern_mesh_end_patch
945 cairo_pattern_mesh_curve_to
946 cairo_pattern_mesh_line_to
947 cairo_pattern_mesh_move_to
948 cairo_pattern_mesh_set_control_point
949 cairo_pattern_mesh_set_corner_color_rgb
950 cairo_pattern_mesh_set_corner_color_rgba
951 cairo_pattern_mesh_get_patch_count
952 cairo_pattern_mesh_get_path
953 cairo_pattern_mesh_get_corner_color_rgba
954 cairo_pattern_mesh_get_control_point
956 The introduction of a unique ID accessible via the mime data type:
957 CAIRO_MIME_TYPE_UNIQUE_ID
963 Release 1.10.2 (2010-12-25 Chris Wilson <chris@chris-wilson.co.uk>)
964 ===================================================================
965 The cairo community is pleased to announce the 1.10.2 release of the
966 cairo graphics library. This is the first update to cairo's stable 1.10
967 series and contains a large number of bug fixes.
969 While many people have contributed and have help to test the release,
970 2 people deserve special recognition for their efforts in tracking down
971 and fixing bugs, Andrea Canciani and Adrian Johnson. Thanks to their
972 tremendous efforts, and of all cairo contributors, it is much
975 We recommend everyone upgrade to cairo 1.10.2 and hope that everyone
976 will continue to have lots of fun with cairo!
983 Fix embedding of grayscale jpegs in PS.
984 https://bugs.freedesktop.org/show_bug.cgi?id=31632
986 Fix the reported path of extents containing a curve.
988 Fix the compositing of unaligned boxes.
990 Reset the clipper in PDF upon finish.
992 Fix degenerates arcs to become a degenerate line.
994 Build support for autoconf 2.67
996 Fix painting of transformed patterns in PS
998 Fix the EPS bounding box for PS
999 https://bugs.freedesktop.org/show_bug.cgi?id=24688
1001 Fix the missing content for EPS
1002 https://bugs.freedesktop.org/show_bug.cgi?id=24688
1004 Fix regression upon changing page size in PS/PDF
1005 https://bugs.freedesktop.org/show_bug.cgi?id=24691
1007 Only use ActualText with PDF-1.5 documents
1009 Fix the bbox for type1 fallbacks.
1011 Reset the color after ending the context in PDF
1012 https://bugs.freedesktop.org/show_bug.cgi?id=31140
1014 Fix the advance of subsetted type1 fonts
1015 https://bugs.freedesktop.org/show_bug.cgi?id=31062
1017 Fix handling of EXTEND_NONE gradients for PDF
1019 Restrict in-place optimisation for a8 image masks with SOURCE
1022 Release 1.10.0 (2010-09-06 Chris Wilson <chris@chris-wilson.co.uk>)
1023 ===================================================================
1024 The cairo community is astounded (and flabbergast) to finally announce
1025 the 1.10.0 release of the cairo graphics library. This is a major update
1026 to cairo, with new features and enhanced functionality which maintains
1027 compatibility for applications written using any previous major cairo
1028 release, (1.8, 1.6, 1.4, 1.2, or 1.0). We recommend that anybody using
1029 a previous version of cairo upgrade to cairo 1.10.0.
1031 One of the more interesting departures for cairo for this release is the
1032 inclusion of a tracing utility, cairo-trace. cairo-trace generates a
1033 human-readable, replayable, compact representation of the sequences of
1034 drawing commands made by an application. This can be used to inspecting
1035 applications to understand issues and as a means for profiling
1036 real-world usage of cairo.
1038 The traces generated by cairo-trace have been collected in
1040 git://git.cairographics.org/git/cairo-traces
1042 and have driven the performance tuning of cairo over the last couple of
1043 years. In particular, the image backend is much faster with a new
1044 polygon rasterisation and a complete overhaul of the tessellator. Not
1045 only is this faster, but also eliminates visual artifacts from
1046 self-intersecting strokes. Not only has cairo-trace been driving
1047 performance improvements within cairo, but as a repeatable means of
1048 driving complex graphics it has been used to tune OpenGL, DDX, and
1051 Cairo's API has been extended to better support printing, notably
1052 through the ability to include a single compressed representation of an
1053 image for patterns used throughout a document, leading to dramatic file
1054 size reductions. Also the meta-surface used to record the vector
1055 commands compromising a drawing sequence is now exposed as a
1056 CAIRO_SURFACE_TYPE_RECORDING, along with a new surface that is a child of a
1057 larger surface, CAIRO_SURFACE_TYPE_SUBSURFACE. One typical usage of a
1058 subsurface would be as a source glyph in a texture atlas, or as a
1059 restricted subwindow within a canvas.
1061 Cairo's API has also resurrected the RGB16 format from the past as
1062 the prevalence of 16-bit framebuffers has not diminished and is a
1063 fore-taste of the extended format support we anticipate in the future.
1064 Increasing cairo's utility, we introduce the cairo_region_t for handling
1065 sets of pixel aligned rectangles commonly used in graphics applications.
1066 This is a merger of the GdkRegion and the pixman_region_t, hopefully
1067 providing the utility of the former with the speed of the latter.
1069 Furthermore cairo has been reworked to interoperate more closely with
1070 various acceleration architectures, gaining the ability to share
1071 those hardware resources through the new cairo_device_t. For instance,
1072 with the new OpenGL backend that supersedes the Glitz backend, hardware
1073 and rendering operations can be shared between a classic OpenGL
1074 application mixing libVA for the hardware assisted video decode with
1075 cairo for high quality overlays all within the same OpenGL canvas.
1077 Many thanks for the hard work of Adrian Johnson, Andrea Canciani, Behdad
1078 Esfahbod, Benjamin Otte, Carl Worth, Carlos Garcia Campos, Chris Wilson,
1079 Eric Anholt, Jeff Muizelaar, Karl Tomlinson, M Joonas Pihlaja, Søren
1080 Sandmann Pedersen and many others that have contributed over the last
1081 couple of years to cairo. Thank you all!
1083 Snapshot 1.9.14 (2010-07-26)
1084 ============================
1086 A quiet couple of weeks, hopefully Cairo is seeing widescale deployment and
1087 we are being to see the results of the stabilisation effort. Clipping bugs
1088 seems to have been the order of the last couple of weeks, with a couple
1089 reported and duly fixed. Thank you Igor Nikitin and Karl Tomlinsion for
1090 finding those regressions. At this point all that seems to remain to do is
1091 to fix the outstanding regressions in the PDF backend...
1096 Clip doesn't work for text on the image backend
1097 https://bugs.freedesktop.org/show_bug.cgi?id=29008
1099 Add explicit dependency for cxx
1100 https://bugs.freedesktop.org/show_bug.cgi?id=29114
1102 Fix regressions in reporting clip extents
1103 https://bugs.freedesktop.org/show_bug.cgi?id=29120
1104 https://bugs.freedesktop.org/show_bug.cgi?id=29121
1105 https://bugs.freedesktop.org/show_bug.cgi?id=29122
1106 https://bugs.freedesktop.org/show_bug.cgi?id=29124
1107 https://bugs.freedesktop.org/show_bug.cgi?id=29125
1110 Snapshot 1.9.12 (2010-07-12)
1111 ============================
1113 A couple of weeks spent fixing those annoying bugs and cleaning up the build
1114 system; the list of outstanding tasks to complete for the stable release is
1115 finally shrinking. The chief bug fixer has been Benjamin Otte who not only
1116 made sure that the public API is consistent and being tested for its
1117 consistency, but also ensured that the documentation was up-to-date and
1118 spent time clarifying cases where even the Cairo developers have come
1119 unstuck in the past. Many thanks, Benjamin. However, he was not alone,
1120 as Andrea Canciani continued his fine work in isolating broken corner cases
1121 and proceeding to fix them, and tidying up the quartz backend. And last, but
1122 definitely not least, M Joonas Pihlaja tried building Cairo across a
1123 perverse range of systems and fixed up all the loose bits of code that came
1124 unravelled. Thanks everybody!
1129 cairo_surface_set_mime_data, cairo_surface_get_mime_data:
1131 The length parameter is now an unsigned long (as opposed to an unsigned
1132 int). The parameter is intended to be an equivalent to a size_t without
1133 requiring POSIX types and be large enough to store the size of the
1134 largest possible allocation.
1136 cairo_gl_surface_create_for_texture:
1138 This a new surface constructor for cairo-gl that explicitly enables
1139 render-to-texture for foreign, i.e. application, textures.
1141 cairo_region_xor, cairo_region_xor_rectangle
1143 A couple of utility routines add to the region handling interface for
1144 the purpose of replacing existing GdkRegion functionality.
1149 https://bugs.launchpad.net/ubuntu/+source/cairo/+bug/600622
1151 Inkscape was caught in the act of attempting to modify a finished surface.
1152 Unfortunately, we had the ordering of our guards and assertions wrong and
1153 so an ordinary application error was triggering an assert in Cairo. This
1154 lead Benjamin to add a test case to ensure that the entire public API
1155 could handle erroneous input and then proceeded to fix a whole slew of
1159 https://bugs.freedesktop.org/show_bug.cgi?id=28888
1161 A regression introduced by the special casing of uploading images to an
1162 xlib surface in-place which was ignoring the translation applied to the
1166 Snapshot 1.9.10 (2010-06-26)
1167 ============================
1169 The first "quick" snapshot in the run up to the stable release. The
1170 last snapshot was picked up by the bleeding edge distributions and so the
1171 bug reports have to started to roll in. The most frequent of these are the
1172 introduction of rendering errors by applications that modify a surface
1173 without subsequently calling cairo_surface_mark_dirty(). Make sure the
1174 application developers are aware of increased reliance on strict use of the
1175 Cairo API before 1.10 is released!
1177 The usual slew of bugs reported and we would like to thank Zoxc for
1178 contributing the WGL interface for cairo-gl, and finding more build
1179 failures on win32. And it just wouldn't be a 1.9 snapshot unless
1180 Benjamin Otte improved the error handling within cairo-gl, as well as
1181 isolating and fixing some more errors in the test suite. The biggest bug of
1182 the snapshot turned out to be a major sign extension issue that had lain
1183 hidden for many years and was suddenly exposed by incorrectly rounding
1184 rectangles when performing non-antialiased rendering. Also to the relief
1185 of many we have included the downstream patch to honour the user's LCD
1186 filtering preferences for subpixel rendering of fonts. The interface
1187 remains private for the time being, whilst the proposed public API is
1194 Snapshot 1.9.8 (2010-06-12)
1195 ===========================
1197 One major API changes since the last snapshot, and a whole slew of bugs
1198 fixed and inconsistencies eliminated. Far too many bugs fixed to
1199 individually identify. We need to thank Benjamin Otte for his fantastic
1200 work on the cairo-gl backend making it faster and more robust, Andrea
1201 Canciani for finding so many bugs and developing test cases for them, as
1202 well fixing them. And last but not least we must all thank Adrian Johnson for
1203 continuing to eliminate bugs and improving the PostScript and PDF backends.
1205 This snapshot represents almost 4 months of bug fixing, bringing Cairo to
1206 a point where we consider it almost ready to be a candidate for release.
1207 There are a few known bugs left to be fixed, being tracked in
1208 https://bugs.freedesktop.org/show_bug.cgi?id=24384, so please give Cairo a
1209 whirl and report any regressions. The plan is to release a new snapshot
1210 every other week leading to a 1.10 release with a target date of
1215 CAIRO_FORMAT_RGB16_565
1217 16 bit devices still remain popular, and so with great demand,
1218 CAIRO_FORMAT_RGB16_565 has been restored enabling applications to create
1219 and use 16 bit images as sources and render targets.
1221 cairo_surface_create_for_rectangle()
1223 It is common practice to cut an image up into many smaller pieces and use
1224 each of those as a source - a technique called texture atlasing.
1225 cairo_surface_create_for_rectangle() extends Cairo to directly support use
1226 of these subregions of another cairo_surface_t both as a source and as a
1229 cairo_region_create()
1230 cairo_region_create_rectangle()
1231 cairo_region_create_rectangles()
1233 cairo_region_reference()
1234 cairo_region_destroy()
1235 cairo_region_equal()
1236 cairo_region_status()
1237 cairo_region_get_extents()
1238 cairo_region_num_rectangles()
1239 cairo_region_get_rectangle()
1240 cairo_region_is_empty()
1241 cairo_region_contains_rectangle()
1242 cairo_region_contains_point()
1243 cairo_region_translate()
1244 cairo_region_subtract()
1245 cairo_region_subtract_rectangle()
1246 cairo_region_intersect()
1247 cairo_region_intersect_rectangle()
1248 cairo_region_union()
1249 cairo_region_union_rectangle()
1251 The Cairo region API was actually added a couple of snapshots ago, but we
1252 forgot to mention it at the time. A simple API for the handling of
1253 rectangular pixel-aligned regions by Soeren Sandmann.
1256 Backend-specific improvements
1257 -----------------------------
1260 Benjamin Otte made more than 200 commits in which he refactored the cairo-gl
1261 backend, reducing a lot of code duplication and enabled him to begin working
1262 on improving performance by reducing state changes and associated overhead.
1266 Access to the underlying connection to the Display is now thread-safe
1267 enabling cairo-xlib to be used in a multi-threaded application without fear
1268 of random corruption. Thanks Benjamin Otte!
1270 cairo-xlib will now attempt to use PolyModeImprecise when compositing
1271 trapezoids (i.e. a fill or a stroke operation with a non-trivial path) which
1272 should allow hardware drivers more scope for accelerating the operation at
1273 the cost of potentially incurring minute rendering errors. The mode can be
1274 forced back to PolyModePrecise by setting the antialias parameter to
1275 CAIRO_ANTIALIAS_SUBPIXEL.
1279 A notable improvement was contributed by Alexander Shulgin to enable SVG to
1280 reference external image through the use an extended MIME data type.
1282 Snapshot 1.9.6 (2010-02-19)
1283 ===========================
1288 The device is a generic method for accessing the underlying interface
1289 with the native graphics subsystem, typically the X connection or
1290 perhaps the GL context. By exposing a cairo_device_t on a surface and
1291 its various methods we enable finer control over interoperability with
1292 external interactions of the device by applications. The use case in
1293 mind is, for example, a multi-threaded gstreamer which needs to serialise
1294 its own direct access to the device along with Cairo's across many
1297 Secondly, the cairo_device_t is a unifying API for the mismash of
1298 backend specific methods for controlling creation of surfaces with
1299 explicit devices and a convenient hook for debugging and introspection.
1301 The principal components of the API are the memory management of:
1303 cairo_device_reference(),
1304 cairo_device_finish() and
1305 cairo_device_destroy();
1307 along with a pair of routines for serialising interaction:
1309 cairo_device_acquire() and
1310 cairo_device_release()
1312 and a method to flush any outstanding accesses:
1314 cairo_device_flush().
1316 The device for a particular surface may be retrieved using:
1318 cairo_surface_get_device().
1320 The device returned is owned by the surface.
1322 API changes (to API new in the cairo 1.9.x series)
1323 --------------------------------------------------
1324 cairo_recording_surface_create()
1325 cairo_recording_surface_ink_extents()
1327 These are the replacement names for the functions previously named
1328 cairo_meta_surface_create and cairo_meta_surface_ink_extents.
1330 cairo_surface_set_mime_data
1332 This interface is now changed such that the MIME data will be
1333 detached if the surface is modified at all. This guarantees that
1334 the MIME data will not become out of synch due to surface
1335 modifications, and also means that for the MIME data to be useful,
1336 it must be set after all modifications to the surface are
1339 API removal (of experiment API)
1340 -------------------------------
1341 The cairo-glitz backend is removed entirely, (in favor of the new
1342 cairo-gl backend). See below for more on cairo-gl.
1347 Many improvements for drawing of dashed strokes
1349 Fix incorrect handling of negative offset
1350 Faster computation of first dash (avoids near-infinite looping)
1351 Approximate extremely fine dash patterns with appropriate alpha value
1353 Optimize spans-based renderers for repeated rows, (such as in a rounded rectangle)
1355 Backend-specific improvements
1356 -----------------------------
1359 This is a new, direct-rendering backend that supports Intel graphics
1360 chipsets in the i915 and i965 families. It's still experimental and
1361 will likely remain that way for a while. It's already got extremely
1362 good performance on the hardware it supports, so if nothing else
1363 provides a working proof and performance target for the cairo-gl
1364 work for Intel graphics.
1368 Start using GLSL to accelerate many operations. Many thanks to Eric
1369 Anholt and T. Zachary Laine for this work. For the first time, we
1370 have what looks like what will be a very compelling OpenGL-based
1371 backend for cairo (in terms of both quality and performance).
1373 See this writeup from Eric for more details on recent progress of
1374 cairo-gl (which he presented at FOSDEM 2010):
1376 http://anholt.livejournal.com/42146.html
1380 The image backend is made dramatically faster (3-5 times faster for
1381 benchmarks consisting primarily of glyph rendering).
1385 Many fixes from Robert O'Callahan and Andrea Canciani including:
1387 Fixed gradient pattern painting
1388 Improved A8 image handling
1389 Fixes for "unbounded" and other compositing operators
1393 Improvements to embedding of JPEG and JPEG2000 data.
1397 Fix printing of rotated user fonts.
1399 Snapshot 1.9.4 (2009-10-15)
1400 ===========================
1403 cairo_meta_surface_create()
1404 cairo_meta_surface_ink_extents()
1406 Finally exporting the internal meta-surface so that applications
1407 have a method to record and replay a sequence of drawing commands.
1411 Determines whether a given point is inside the current clip.
1412 ??? Should this be called cairo_in_paint() instead? in-clip is the test
1413 that is performed, but in-paint would be similar to in-fill and in-stroke.
1419 A companion to cairo-perf-trace, this utility replays a trace against
1420 multiple targets in parallel and looks for differences in the output,
1421 and then records any drawing commands that cause a failure.
1423 Further minimisation of the fail trace using "delta debugging".
1424 More control over test/reference targets.
1426 Backend improvements:
1430 Server-side gradients. The theory is that we can offload computation
1431 of gradients to the GPU and avoid pushing large images over the
1432 connection. Even if the driver has to fallback and use pixman to render
1433 a temporary source, it should be able to do so in a more efficient manner
1434 than Cairo itself. However, cairo-perf suggests otherwise:
1436 On tiny, Celeron/i915:
1438 before: firefox-20090601 211.585
1439 after: firefox-20090601 270.939
1441 and on tiger, CoreDuo/nvidia:
1443 before: firefox-20090601 70.143
1444 after: firefox-20090601 87.326
1446 In particular, looking at tiny:
1448 xlib-rgba paint-with-alpha_linear-rgba_over-512 47.11 (47.16 0.05%) -> 123.42 (123.72 0.13%): 2.62x slowdown
1450 xlib-rgba paint-with-alpha_linear3-rgba_over-512 47.27 (47.32 0.04%) -> 123.78 (124.04 0.13%): 2.62x slowdown
1454 New experimental backends:
1458 OpenVG - The initial work was done by Øyvind Kolås, and made ready for
1459 inclusion by Pierre Tardy.
1461 OpenGL - An advanced OpenGL compositor. The aim is to write a integrate
1462 directed rendering using OpenGL at a high-level into Cairo. In
1463 contrast to the previous attempt using Glitz which tried to
1464 implement the RENDER protocol on top of OpenGL, using the
1465 high-level interface should permit greater flexibility and
1466 more offloading onto the GPU.
1467 The initial work on the backend was performed by Eric Anholt.
1469 Long standing bugs fixed:
1471 Self-intersecting strokes.
1473 A long standing bug where the coverage from overlapping semi-opaque
1474 strokes (including neighbouring edges) was simply summed in lieu of
1475 a costly global calculation has been fixed (by performing the costly
1476 global calculation!) In order to mitigate the extra cost, the
1477 tessellator has been overhauled and tune, which handles the fallback
1478 for when we are unable to use the new span rasteriser on the stroke
1479 (e.g. when using the current RENDER protocol). The large number of
1480 pixel artefacts that implementing self-intersection elimination
1481 removes is ample justification for the potential performance
1482 regression. If you unfortunately do suffer a substantial performance
1483 regression in your application, please consider obtaining a
1484 cairo-trace and submitting it to us for analysis and inclusion into
1485 our performance suite.
1489 To the AuroraUX team for providing access to one of their OpenSolaris
1490 machines for cairo and pixman development. http://www.auroraux.org/
1492 Snapshot 1.9.2 (2009-06-12)
1493 ===========================
1496 cairo_surface_set_mime_data()
1497 cairo_surface_get_mime_data()
1499 Should this take unsigned int, unsigned long or size_t for the length
1500 parameter? (Some datasets may be >4GiB in size.)
1502 Associate an alternate, compressed, representation for a surface.
1504 "image/jp2" (JPEG2000) is understood by PDF >= 1.5
1505 "image/jpeg" is understood by PDF,PS,SVG,win32-printing.
1506 "image/png" is understood by SVG.
1509 cairo_pdf_surface_restrict_to_version()
1510 cairo_pdf_get_versions()
1511 cairo_pdf_version_to_string()
1513 Similar to restrict to version and level found in SVG and PS,
1514 these limit the features used in the output to comply with the PDF
1515 specification for that version.
1517 CAIRO_STATUS_INVALID_SIZE
1518 Indicates that the request surface size is not supported by the
1519 backend. This generally indicates that the request is too large.
1521 CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED
1522 Indicates that a required callback for a user-font was not implemented.
1524 CAIRO_STATUS_LAST_STATUS
1525 This is a special value to indicate the number of status values enumerated
1526 at compile time. (This may differ to the number known at run-time.)
1528 The built-in twin font is now called "@cairo:" and supports a limited set
1529 of options like "@cairo:mono". Where are these specified?
1531 cairo_in_fill() now uses HTML Canvas semantics, all edges are inside.
1533 New experimental backends:
1539 cairo-trace and cairo-perf-trace
1541 cairo-trace generates a human-readable, replayable, compact(-ish!)
1542 representation of the sequences of drawing commands made by an
1545 Under the util/cairo-script directory is a library to replay traces.
1547 perf/cairo-perf-trace replays traces against multiple backends
1548 and makes useful benchmark reports. This is integrated with
1549 'make perf'. You may collect your own traces or take advantage
1550 of traces collected by the community:
1552 git://git.cairographics.org/git/cairo-traces
1554 (Put this into perf/cairo-traces to run these as part of "make perf".)
1556 There is additional WIP in building a debugging tool for cairo applications
1557 based on CairoScript (currently very preliminary, mostly serves to show
1558 that GtkSourceView is too slow) :
1560 people.freedesktop.org:~ickle/sphinx
1562 Test suite overhaul:
1564 The test suite is undergoing an overhaul, primarily to improve its speed
1565 and utility. (Expect more changes in the near future to improve XFAIL
1569 polygon rasterisation! Joonas implemented the Tor polygon scan converter,
1570 on typical geometry is about 30% faster for the image backend.
1572 Bovine Polaroids! For those not in on the joke, this is the long
1573 awaited "copy-on-write snapshot" or "COW snapshot" support. The
1574 user-visible feature is that including the same image multiple times
1575 into a PDF file should result in only a single instance of that
1576 image in the final output. This is unlike previous versions of cairo
1577 which would generate very large PDF files with multiple copies of
1578 the same image. Adrian says that the PDF is not quite working as
1579 well as it should yet, so we hope for further improvements before
1586 Better handling of large scale-factors on image patterns.
1588 Emit /Interpolate for PS,PDF images.
1590 Global glyph cache - cap on the total number of inactive glyphs,
1591 should prove fairer for fonts with larger glyph sets.
1593 Compilation without fontconfig
1595 Improved handling of low-bitdepth sources (e.g. copying the contents
1596 of 16-bit xserver windows)
1600 cairo_traps_extract_region >10x slower. Fix pending.
1604 Region tracking API (ssp) for damage tracking, hit testing etc
1607 An expiremental OpenGL backend?
1609 Tweaks to tessellator, allocations of patterns, delayed
1610 initialisation of the xlib backend (reduce the cairo overhead of
1611 render_bench by ~80%).
1614 Release 1.8.8 (2009-06-16 Chris Wilson <chris@chris-wilson.co.uk>)
1615 ==================================================================
1616 The cairo community is pleased to announce the 1.8.8 release of the
1617 cairo graphics library. This is the fourth update to cairo's stable
1618 1.8 series and contains a small number of bug fixes (in particular a
1619 few corrections to the documentation and a few fixes in the FreeType font
1620 backend). This is being released just over six months after cairo 1.8.6.
1622 We recommend that everyone using cairo upgrade to 1.8.8.
1628 There were reports of incompatibilities with the autotools bundled in with
1629 the 1.8.6 tarball. This release has been built with automake-1.10.2 and
1632 The configure check for FreeType has been improved:
1634 typo in check for version of freetype in configure script
1635 https://bugs.freedesktop.org/show_bug.cgi?id=19283
1637 Compilation on 64-bit MacOS/X fixes:
1639 Cannot build cairo_quartz_font_face_create_for_atsu_font_id on 64-bit Mac OS X
1640 https://bugs.freedesktop.org/show_bug.cgi?id=15702
1644 Uninitialised status return within _cairo_clip_intersect_mask(). This caused
1645 random crashes and general mayhem as an error could be generated causing all
1646 rendering to the context to stop.
1648 Avoid transforming nearly-degenerate matrices into degenerate matrices:
1650 Painting stops in this case, using -moz-transform: scale, rotate and video
1651 https://bugzilla.mozilla.org/show_bug.cgi?id=467423
1653 A few FreeType font handling bugs were fixed:
1655 Rendering with PANGO_GRAVITY_EAST leads to different results with image and pdf
1656 https://bugs.freedesktop.org/show_bug.cgi?id=21985
1658 Don't call FT_Done_Face() on faces we did not create
1660 zombie ft_font_face / ft_unscaled_font mutual referencing problems
1661 http://bugs.freedesktop.org/show_bug.cgi?id=21706
1663 Ensure win32 font backend sets the return value to -1 (indicating the absent
1664 glyph) if the font index lookup for the unicode character fails. And
1665 similarly fix a bug where a fatal error was raised for an invalid glyph.
1667 cairo_scaled_font_glyph_extents breaks with invalid glyph id
1668 http://bugs.freedesktop.org/show_bug.cgi?id=20255
1670 Various improvements to the documentation, reported by Truc Troung:
1672 https://bugs.freedesktop.org/show_bug.cgi?id=20095
1673 https://bugs.freedesktop.org/show_bug.cgi?id=20154
1674 https://bugs.freedesktop.org/show_bug.cgi?id=20180
1675 https://bugs.freedesktop.org/show_bug.cgi?id=20183
1676 https://bugs.freedesktop.org/show_bug.cgi?id=20182
1677 https://bugs.freedesktop.org/show_bug.cgi?id=20441
1680 Release 1.8.6 (2008-12-13 Chris Wilson <chris@chris-wilson.co.uk>)
1681 ==================================================================
1682 The cairo community is pleased to announce the 1.8.6 release of the
1683 cairo graphics library. This is the third update to cairo's stable
1684 1.8 series and contains a small number of bug fixes (in particular a
1685 few fixes for failures of cairo 1.8.4 on Quartz and PDF, and build fixes for
1686 a couple of backends). This is being released just under a month after
1689 We recommend that everyone using cairo upgrade to 1.8.6.
1695 Fix build of DirectFB backend with debugging enabled:
1697 Bug in _cairo_directfb_surface_release_source_image function
1698 http://bugs.freedesktop.org/show_bug.cgi?id=18322
1704 Workaround a mis-compilation of cairo_matrix_invert() that generated invalid
1705 matrices and triggered assertion failures later. The issue was reported by
1708 Invalid computation of the modulus:
1710 https://bugzilla.mozilla.org/show_bug.cgi?id=466258
1712 Invalid referencing of patterns in the Quartz backend:
1714 Failed assertion `CAIRO_REFERENCE_COUNT_HAS_REFERENCE
1715 (&pattern->ref_count)' when using cairo quartz backend
1716 http://bugs.freedesktop.org/show_bug.cgi?id=18632
1718 Invalid references to glyphs after early culling, causing segmentation faults
1721 http://lists.cairographics.org/archives/cairo/2008-December/015976.html
1723 Check for XRender in the XCB backend, or else we may attempt an invalid memory
1726 XCB backend fails with missing render.
1727 https://bugs.freedesktop.org/show_bug.cgi?id=18588
1729 Release 1.8.4 (2008-11-14 Carl Worth <cworth@cworth.org>)
1730 =========================================================
1731 The cairo community is pleased to announce the 1.8.4 release of the
1732 cairo graphics library. This is the second update to cairo's stable
1733 1.8 series and contains a small number of bug fixes, (in particular a
1734 few fixes for build failures of cairo 1.8.2 on various systems). This
1735 is being released just over two weeks after cairo 1.8.2.
1737 We recommend that everyone using cairo upgrade to 1.8.4.
1743 Fix build with older XRender that doesn't define RepeatNone:
1745 Build of xlib backend fails against old XRender (RepeatNone undeclared)
1746 https://bugs.freedesktop.org/show_bug.cgi?id=18385
1748 Fix build with bash version <= 3.0:
1750 doltlibtool broken on linux with bash 3.00.0
1751 https://bugs.freedesktop.org/show_bug.cgi?id=18363
1755 Avoid triggering a bug in X.org server 6.9 resulting in a hung machine
1758 https://bugs.freedesktop.org/show_bug.cgi?id=15628#c2
1760 Fix display of user fonts as exercised by proposed support for type3
1761 fonts in poppler (unsigned promotion fixes):
1763 Use cairo user-font for Type 3 fonts
1764 http://lists.freedesktop.org/archives/poppler/2008-October/004181.html
1766 Avoid miscomputing size of fallback images required when rendering
1767 with CLEAR, IN, or SOURCE operator to vector surfaces, (PS, PDF, SVG,
1770 Be more tolerant of broken fonts when subsetting type1 fonts:
1772 Error handling in cairo_type1_font_subset_get_glyph_names_and_widths
1773 http://lists.cairographics.org/archives/cairo/2008-October/015569.html
1775 Fix cairo_fill_extents, cairo_stroke_extents, cairo_path_extents, to
1776 correctly allow NULL parameters as documented.
1778 Fix potential crash on emitting a type3 glyph after having drawn text
1779 paths from the same font, (for example with cairo_text_path).
1781 Release 1.8.2 (2008-10-29 Carl Worth <cworth@cworth.org>)
1782 =========================================================
1783 The cairo community is pleased to announce the 1.8.2 release of the
1784 cairo graphics library. This is the first update to cairo's stable 1.8
1785 series and contains a large number of bug fixes. It is being released
1786 just over one month since cairo 1.8.0.
1788 This release consists primarily of bug fixes, but there is one notable
1789 new feature, (the ability to build cairo without an external font
1790 backend), and there are a few optimizations as well. See below for
1791 details on these changes and the most important bug fixes.
1793 While many people have contributed to this release, Chris Wilson
1794 deserves particular mention. He has contributed well over twice as
1795 many changes to cairo since 1.8.0 than everyone else combined. We
1796 greatly appreciate the tremendous efforts of Chris and all cairo
1799 We recommend everyone upgrade to cairo 1.8.2 and hope that everyone
1800 will have lots of fun with cairo!
1806 It is now possible to build cairo without any font backend, (such as
1807 freetype, win32 or quartz). This is most useful when the application
1808 provides custom font rendering through the user-font API. But in the
1809 case where no external font backend is available, and no user-font is
1810 provided, cairo will render with a failsafe font, (a stroked font
1811 covering visible ASCII character). (Behdad Esfahbod)
1815 Dramatically speed up compilation with dolt (removes much of the
1816 libtool overhead) (Behdad Esfahbod with thanks to Josh Triplett).
1818 Several minor optimizations to tessellator (special-cased comparisons,
1819 faster insert for skiplist, etc.) (Chris Wilson).
1821 Optimize away fractional translation component when doing
1822 EXTEND_NEAREST filtering, (for better performance).
1826 Allow cloning sub-regions of similar surfaces to fix this bug
1829 Crafted gif file will crash firefox
1830 [XError: 'BadAlloc (insufficient resources for operation)']
1831 https://bugzilla.mozilla.org/show_bug.cgi?id=424333
1833 Fix some matrix confusion to fix this regression (Chris Wilson):
1835 Translucent star exports in a wrong way to PDF
1836 https://bugs.launchpad.net/inkscape/+bug/234546
1838 Fix some long-standing bugs with respect to properly computing the
1839 extents of transformed, filtered surfaces (Owen Taylor, Carl Worth,
1842 Bad clipping with EXTEND_NONE
1843 http://bugs.freedesktop.org/show_bug.cgi?id=15349
1845 Improve filtering handling in cairo-pattern.c
1846 http://bugs.freedesktop.org/show_bug.cgi?id=15367
1848 Many thanks to Chris Wilson for digging out and cleaning up
1851 Fix compilation on Solaris 10 (Chris Wilson):
1853 Cairo requires -DREENTRANT (along with -D_POSIX_THREAD_SEMANTICS)
1854 to compile on Solaris 10 with pthreads
1855 https://bugs.freedesktop.org/show_bug.cgi?id=18010
1857 Fix very old bug causing dashes to be rendered at the wrong length in
1858 fallback images (Adrian Johnson)
1860 Dashed strokes too long in fallback images
1861 https://bugs.freedesktop.org/show_bug.cgi?id=9189
1863 Fix broken dashing when a dashed path starts outside the clip region
1866 Avoid range overflow when computing large patterns (Benjamin Otte and
1869 Avoid crashing due to an invalid font with an incorrect entry in its
1870 CMAP table (Adrian Johnson).
1872 Fix bugs in computing maximum size of text requests that can be sent
1873 with the Render extension, (avoiding potential crashes when rendering
1874 large amounts of text) (Behdad Esfahbod and Chris Wilson).
1876 Fix rendering of operators unbounded by the mask (Chris Wilson).
1878 Fix compilation on systems without compiler support for a native
1879 64-bit type (Chris Wilson).
1881 Fix several cases of missing error-status propagation. (Chris Wilson,
1882 doing the work he seems to never tire of).
1884 Fix several locking issues found with the lockdep valgrind skin (Chris
1887 Backend-specific bug fixes
1888 --------------------------
1889 xlib: Avoid crash due to attempting XRender calls on pixmaps with
1890 formats not supported by the Render extension (Chris Wilson):
1892 XRender crashes due to NULL pointer from Cairo on SGI O2
1893 https://bugs.freedesktop.org/show_bug.cgi?id=11734
1895 xlib: Add support for XImages with depth of 4, 20, 24, or 28 bits
1898 cairo doesn't support 24 bits per pixel mode on X11
1899 https://bugs.freedesktop.org/show_bug.cgi?id=9102
1901 xlib: Avoid mistakenly considering two surfaces as similar just
1902 because their depths match (while their Render formats do not) (Karl
1905 ps: Fix slight mis-scaling of bitmapped fonts (Adrian Johnson)
1907 svg: Correctly emit comp-op for paint, mask, and show_glyphs
1908 operations (Emmanuel Pacaud).
1910 svg: Use finer-grained fallbacks for SVG 1.2 (as PS and PDF backends
1911 have been doing since 1.6.0) (Chris Wilson).
1913 win32: Fallback to DIB if DDB create fails for
1914 cairo_surface_create_similar (Vladimir Vukicevic).
1916 win32: Fix compatibility with Windows Mobile (Vladimir Vukicevic).
1918 win32: Fix static builds to not do __declspec(dllimport) on public
1919 functions. This requires the user to set a CAIRO_WIN32_STATIC_BUILD
1920 environment variable when compiling (Behdad Esfahbod).
1922 Release 1.8.0 (2008-09-25 Carl Worth <cworth@cworth.org>)
1923 =========================================================
1924 The cairo community is happy (and relieved) to announce the 1.8.0
1925 release of the cairo graphics library. This is a major update to
1926 cairo, with new features and enhanced functionality which maintains
1927 compatibility for applications written using any previous major cairo
1928 release, (1.6, 1.4, 1.2, or 1.0). We recommend that anybody using a
1929 previous version of cairo upgrade to cairo 1.8.0.
1931 The dominant theme of this release is improvements to cairo's ability
1932 to handle text. The highlights include a new "user fonts" feature as
1933 well as a new cairo_show_text_glyphs API which allows glyphs to be
1934 embedded in PDF output along with their original text, (for searching,
1935 selection, and copy-and-paste). Another major feature is a revamp of
1936 cairo's build system making it much easier to build cairo on various
1939 See below for more details.
1943 This new API allows the user of cairo API to provide drawings for
1944 glyphs in a font. A common use for this is implementing fonts in
1945 non-standard formats, like SVG fonts and Flash fonts. This API can
1946 also be used by applications to provide custom glyph shapes for fonts
1947 while still getting access to cairo's glyph caches. See
1948 test/user-font.c and test/user-font-proxy.c for usage examples. This
1949 is based on early work by Kristian Høgsberg. Thanks Kristian!
1951 This new API consists of the following functions (and corresponding
1954 cairo_user_font_face_create
1956 cairo_user_font_face_set_init_func
1957 cairo_user_font_face_set_render_glyph_func
1958 cairo_user_font_face_set_text_to_glyphs_func
1959 cairo_user_font_face_set_unicode_to_glyph_func
1961 An additional, new API is
1963 cairo_scaled_font_text_to_glyphs
1965 We were previously reluctant to provide this function as
1966 text-to-glyphs support in cairo was limited to "toy" font
1967 functionality, not really interesting for real-world text
1968 processing. However, with user fonts landing, this API is needed to
1969 expose full access to how user fonts convert text to glyphs. This is
1970 expected to be used by text toolkits like Pango, as well as "proxy"
1971 user-font implementations.
1973 cairo_show_text_glyphs
1974 ----------------------
1975 This new API allows the caller of cairo to provide text data
1976 corresponding to glyphs being drawn. The PDF backend implements this
1977 new API so that complex text can be copied out of cairo's PDF output
1978 correctly and reliably, (assuming the user of cairo calls
1979 cairo_show_text_glyphs). The cairo_show_text_glyphs API is definitely
1980 the most daunting API to debut in cairo. It is anticipated that pango
1981 (and similar high-level text libraries) will be the primary users of
1982 this API. In fact, pango 1.22 already uses cairo_show_text_glyphs.
1983 Behdad was the architect and implementor of this effort. Thanks,
1986 The cairo_show_text_glyphs API includes the following new functions:
1988 cairo_show_text_glyphs
1990 cairo_glyph_allocate
1993 cairo_text_cluster_allocate
1994 cairo_text_cluster_free
1996 cairo_surface_has_show_text_glyphs
2000 The primary goal of the revamp is to make the build system less
2001 fragile, (particularly for non-Linux platforms). For example, now
2002 people building on win32 will no longer need to maintain a
2003 platform-specific list of files to be built. See the new README.win32
2004 for details. Also, the .so file will now be installed with a different
2005 naming scheme, (for example, 1.7.6 will install with a .10800
2006 suffix). Many thanks to Behdad and his small army of helpers!
2008 Assorted API additions
2009 ----------------------
2010 For API completeness, several missing "getter" functions were added:
2012 cairo_scaled_font_get_scale_matrix
2014 cairo_surface_get_fallback_resolution
2016 cairo_toy_font_face_create
2017 cairo_toy_font_face_get_family
2018 cairo_toy_font_face_get_slant
2019 cairo_toy_font_face_get_weight
2021 The new cairo_toy_font_face functions provide access to functionality
2022 and settings provided by cairo_select_font_face(). Thanks Behdad!
2024 cairo-ps/cairo-pdf: More efficient output
2025 -----------------------------------------
2026 Adrian Johnson has been busy fixing all kinds of bugs in PS and PDF
2027 backends, as well making them generate much more compact output by
2028 avoiding things like re-emitting the color or linestyle on every
2029 drawing operation. Thanks Adrian!
2031 cairo-xlib: dithering
2032 ---------------------
2033 Dithering: Cairo now does simple dithering when rendering to legacy X
2034 servers. This is most visible with 8-bit visuals. Thanks Behdad!
2036 cairo-xlib: Avoid rendering glyphs out of surface bounds
2037 --------------------------------------------------------
2038 This seemingly harmless optimization exposed a bug in OpenOffice.org 3
2039 versions where OO.o was passing bogus surface extents to cairo,
2040 resulting in no text rendered in OO.o. Please contact your
2041 distribution's OO.o maintainers if you see this bug and point them to
2044 https://bugs.freedesktop.org/show_bug.cgi?id=16209
2046 cairo-xlib: Improved performance with X server without Render
2047 -------------------------------------------------------------
2048 Cairo now performs better on remote X servers that lack the Render
2049 extension by being smarter about using X core protocol facilities
2050 instead of falling back to doing all rendering on the client side.
2052 cairo-ft: respecting FC_FT_FACE
2053 -------------------------------
2054 Previously it was impossible to instruct cairo to do emboldening on a
2055 font face object created from an FT_Face. Cairo now respects and uses
2056 the FC_FT_FACE fontconfig pattern element, so emboldening can be
2057 achieved by using cairo_ft_font_face_create_for_pattern() and a
2058 carefully crafted pattern using FC_FT_FACE and FC_EMBOLDEN. Thanks
2061 cairo-directfb: backend improvements
2062 ------------------------------------
2063 The directfb backend, though still unsupported, has seen a good deal
2064 of improvements. Thanks Vlad!
2066 Bug fixing and optimizations
2067 ----------------------------
2068 xlib: Faster bookkeeping (Karl Tomlinson)
2069 https://bugzilla.mozilla.org/show_bug.cgi?id=453199#c5
2071 PS: Fix gradients with non-constant alpha (Chris Wilson)
2073 Fix deadlock in user-font code (Richard Hughes and Behdad Esfahbod)
2074 http://bugs.freedesktop.org/show_bug.cgi?id=16819
2076 Countless other bugs have been fixed and optimizations made, many of
2077 them thanks to Chris Wilson. Thanks Chris and others!
2079 Note also that the code that had been in cairo 1.7.x calling into
2080 freetype's optional lcd_filter function was removed from cairo before
2081 the 1.8.0 release. We do expect this code to come back in some form in
2084 Snapshot 1.7.6 (2008-09-17 Carl Worth <cworth@cworth.org>)
2085 ==========================================================
2086 The cairo community is happy to announce the 1.7.6 snapshot of the
2087 cairo graphics library. This is a "release candidate" for the upcoming
2088 1.8.0 release, so we will greatly appreciate any reports of problems
2089 in this release, and no major changes are currently planned before
2092 Notable changes in 1.7.6
2093 ------------------------
2094 The largest number of changes since 1.7.4 did not change the
2095 implementation of cairo itself, but instead revamped cairo's build
2096 system. The primary goal of the revamp is to make the build system
2097 less fragile, (particularly for non-Linux platforms). For example, now
2098 people building on win32 will no longer need to maintain a
2099 platform-specific list of files to be built. Also, the .so file will
2100 now be installed with a different naming scheme, (for example, 1.7.6
2101 will install with a .10706 suffix). Much thanks, Behdad!
2103 And, as usual, Chris Wilson has made another large round of robustness
2104 improvements, (eliminating dead code, fixing propagation of error
2105 status values, test suite improvements, etc. etc.). Thanks as always,
2108 API changes since 1.7.4
2109 -----------------------
2110 There have been a few changes of API that was new during the 1.7
2113 * Remove cairo_font_options_set_lcd_filter
2114 and cairo_font_options_get_lcd_filter
2116 Motivation: At the Cairo Summit, this API was determined to be too
2117 specific to the freetype font backend to be in the general
2118 API. A similar API with a cairo_ft prefix might be introduced
2119 in the future. Note that cairo will still respect the
2120 corresponding fontconfig settings for these options.
2122 * Replace cairo_has_show_glyphs
2123 with cairo_surface_has_show_glyphs
2125 Motivation: This really is a surface-specific interface, and the
2126 convenience function on the cairo_t is not obviously
2127 necessary. An application can easily call:
2129 cairo_surface_has_show_glyphs (cairo_get_target (cr));
2133 * Add cairo_text_cluster_flags_t
2134 to cairo_show_text_glyphs
2135 cairo_scaled_font_text_to_glyphs
2136 cairo_user_scaled_font_text_to_glyphs_func_t
2138 Motivation: This flag, (and specifically the
2139 CAIRO_TEXT_CLUSTER_FLAG_BACKWARD value), replaces the
2140 cairo_bool_t backward argument in each of the above
2141 interfaces. This leads to more readable user code, and also
2142 allows future extensibility.
2144 As always, there are no changes to any API from any major cairo
2145 release, (1.0.x, 1.2.x, 1.4.x, 1.6.x). Cairo maintains the same
2146 compatibility promise it always has.
2148 Bug fixes since 1.7.4
2149 ---------------------
2150 xlib: Faster bookkeeping (Karl Tomlinson)
2151 https://bugzilla.mozilla.org/show_bug.cgi?id=453199#c5
2153 PS: Fix gradients with non-constant alpha (Chris Wilson)
2155 Fix deadlock in user-font code (Richard Hughes and Behdad Esfahbod)
2156 http://bugs.freedesktop.org/show_bug.cgi?id=16819
2158 Several other minor fixes.
2160 Snapshot 1.7.4 (2008-08-11 Behdad Esfahbod <behdad@behdad.org>)
2161 ===============================================================
2162 The cairo community is embarrassed to announce availability of the 1.7.4
2163 snapshot of the cairo graphics library. This is a followup release to the
2164 1.7.2 snapshot to ship a tarball that can actually be built. The only
2165 change since 1.7.4 is including the missing header file
2166 cairo-user-font-private.h in the distribution.
2168 Snapshot 1.7.2 (2008-08-11 Behdad Esfahbod <behdad@behdad.org>)
2169 ===============================================================
2170 The cairo community is finally ready to announce availability of the 1.7.2
2171 snapshot of the cairo graphics library. This is embarrassingly the first
2172 snapshot in the 1.7 unstable series of cairo, leading to the eventual release
2173 of cairo 1.8, currently planned for late September.
2175 This snapshot comes four months after the 1.6.4 release. We have done a
2176 really bad job on getting development snapshots out this cycle, but
2177 hopefully all the API changes for 1.8 are now finished and the remaining
2178 weeks will be spent on bug-fixing. There is more than 400 commits worth
2179 of changes in this snapshot, and those can use some testing. Read on!
2181 Text, text, and more text!
2182 --------------------------
2183 The dominant theme of this release, and 1.8 in general, is improvements
2184 around cairo text API. Here is a high-level list of changes with text
2189 This is new API allowing the user of cairo API to provide drawings for glyphs
2190 in a font. This is most useful in implementing fonts in non-standard formats,
2191 like SVG fonts and Flash fonts, but can also be used by games and other
2192 applications to draw "funky" fonts. See test/user-font.c and
2193 test/user-font-proxy.c for usage examples. This is based on early work by
2194 Kristian Høgsberg. Thanks Kristian!
2198 This new API allows the caller of cairo to mark text glyphs with their
2199 original text. The PDF backend implements this new API and latest Pango
2200 master uses it. The result is (when bugs are fixed) that complex text can be
2201 copied out of pangocairo's PDF output correctly and reliably. There are bugs
2202 to fix though. A few poppler bugs, and some more in cairo and pango.
2204 To test show_text_glyph, just grab pango master and this cairo snapshot and
2205 print text in gedit. Open in acroread or evince, select all, copy, paste
2206 in gedit and compare. The Arabic text with diacritic marks is particularly
2207 showing bad. Try with pango/pango-view/HELLO.txt if you are brave
2208 enough. The Indic text is showing improvements, but is still coming out
2211 LCD subpixel filtering using FreeType
2212 -------------------------------------
2213 FreeType 2.3.5 added support for various LCD subpixel filtering, and
2214 fontconfig 2.6.0 added support for configuring LCD filter on a font by font
2215 basis. Cairo now relies on FreeType and fontconfig for subpixel filtering.
2216 This work is based on David Turner's original patch to cairo, maintained
2217 and tested by Sylvain Pasche and others. Thanks all!
2219 Toy font face constructor and getter
2220 ------------------------------------
2221 Mostly for API completion, but also useful for higher level (like Pango) to
2222 hook into what the user has set using cairo_select_font_face(), making that
2223 toy API a bit more useful.
2225 FreeType: respecting FC_FT_FACE
2226 -------------------------------
2227 Previously it was impossible to instruct cairo to do emboldening on a font
2228 face object created from an FT_Face. Cairo now respects and uses the
2229 FC_FT_FACE fontconfig pattern element, so emboldening can be achieved by
2230 using cairo_ft_font_face_create_for_pattern() and a carefully crafted pattern
2231 using FC_FT_FACE and FC_EMBOLDEN.
2234 PS/PDF: More efficient output
2235 -----------------------------
2236 Adrian Johnson has been busy fixing all kinds of bugs in PS and PDF
2237 backends, as well making them generate much more compact output by avoiding
2238 things like re-emitting the color or linestyle on every drawing operation.
2244 Cairo now does simple dithering when rendering to legacy X servers. This is
2245 mostly visible with 8-bit visuals.
2247 Xlib: Avoid rendering glyphs out of surface bounds
2248 --------------------------------------------------
2249 This seemingly harmless change manifested a bug with OpenOffice.org 3 versions
2250 where OO.o was passing bogus surface extents to cairo, resulting in no text
2251 rendered in OO.o. Please contact your distro's OO.o maintainers if you see
2252 this bug and point them to the following URL:
2254 https://bugs.freedesktop.org/show_bug.cgi?id=16209
2256 Xlib: Improved performance with Xrender-less X servers
2257 ------------------------------------------------------
2258 Cairo now performs better on remote, Xrender-less X servers by being smarter
2259 about using X core protocol facilities instead of falling back to doing all
2260 rendering on the client side.
2263 Directfb: backend improvements
2264 ------------------------------
2265 The directfb backend, though still unsupported, has seen a good deal of
2266 improvements. Thanks Vlad!
2269 Bug fixing and optimizations
2270 ----------------------------
2271 Countless bugs have been fixed and optimizations made, many of them thanks to
2272 Chris Wilson. Thanks Chris!
2278 cairo_show_text_glyphs
2280 This is a new text rendering API. Being a more advanced version of
2281 cairo_show_glyphs(), it is aimed for use by higher-level text toolkits like
2282 Pango, and enables better text extraction from output generated by backends
2283 like PDF and SVG. The PDF backend already implements it, and the upcoming
2284 Pango release will use it.
2286 To make that API work, a bunch of other additions were made:
2288 cairo_glyph_allocate
2290 cairo_text_cluster_t
2291 cairo_text_cluster_allocate
2292 cairo_text_cluster_free
2293 cairo_surface_has_show_text_glyphs
2296 cairo_user_font_face_create
2298 This is the "user" font face constructor, accompanied by a variety of method
2299 signatures, getters, and setters for a callback-based font backend:
2301 CAIRO_FONT_TYPE_USER
2302 cairo_user_scaled_font_init_func_t
2303 cairo_user_scaled_font_render_glyph_func_t
2304 cairo_user_scaled_font_text_to_glyphs_func_t
2305 cairo_user_scaled_font_unicode_to_glyph_func_t
2306 cairo_user_font_face_set_init_func
2307 cairo_user_font_face_set_render_glyph_func
2308 cairo_user_font_face_set_text_to_glyphs_func
2309 cairo_user_font_face_set_unicode_to_glyph_func
2310 cairo_user_font_face_get_init_func
2311 cairo_user_font_face_get_render_glyph_func
2312 cairo_user_font_face_get_text_to_glyphs_func
2313 cairo_user_font_face_get_unicode_to_glyph_func
2316 cairo_scaled_font_text_to_glyphs
2318 We were previously reluctant to provide this function as text-to-glyphs
2319 support in cairo was limited to "toy" font functionality, not really
2320 interesting for real-world text processing. However, with user-fonts
2321 landing, this API is needed to expose full access to how user-fonts
2322 convert text to glyphs. This is expected to be used by text toolkits like
2323 Pango, as well as "proxy" user-font implementations.
2327 cairo_font_options_set_lcd_filter
2328 cairo_font_options_get_lcd_filter
2330 These add the possibility to choose between various available LCD subpixel
2331 filters. The available filter values are modelled after what FreeType
2335 cairo_toy_font_face_create
2336 cairo_toy_font_face_get_family
2337 cairo_toy_font_face_get_slant
2338 cairo_toy_font_face_get_weight
2340 These provide access to functionality and settings provided by
2341 cairo_select_font_face().
2344 cairo_scaled_font_get_scale_matrix
2345 cairo_surface_get_fallback_resolution
2347 For API completeness.
2350 Various new values for cairo_status_t enum
2355 - Type3 fonts generated by cairo's PDF backend may show up in poppler/Evince
2356 in a different color than expected. This is fixed in poppler master branch.
2357 This mostly affects cairo user fonts. The test case test/user-font.c
2360 - User fonts using other fonts in their rendering are currently embedded in
2361 PDF as fallback bitmap glyphs. This will be (hopefully) fixed before 1.8.
2362 The test case test/user-font-proxy.c demonstrates this.
2365 Release 1.6.4 (2008-04-11 Carl Worth <cworth@cworth.org>)
2366 =========================================================
2367 The cairo community is wildly embarrassed to announce the 1.6.4
2368 release of the cairo graphics library. This release reverts the xlib
2369 locking change introduced in 1.6.4, (and the application crashes that
2370 it caused). The community would be glad to sack its current release
2371 manager and is accepting applications for someone who could do the job
2372 with more discipline.
2374 Revert 'add missing locking in cairo-xlib'
2375 ------------------------------------------
2376 This change was introduced in cairo 1.6.2, but also introduced a bug
2377 which causes many cairo-xlib applications to crash, (with a
2378 segmentation fault inside of XSetClipMask). Instead of attempting
2379 another fix for the broken fix, the change in 1.6.2 has been
2380 reverted. The original bug which the change was addressing has been
2381 present since at least cairo 1.4, so it is not expected that leaving
2382 this bug unfixed will cause any new problems for applications moving
2383 from cairo 1.4 to cairo 1.6.
2385 At this point, the code of cairo 1.6.4 differs from cairo 1.6.0 only
2386 in the fix for the PostScript-printer crashes.
2388 Tweak build to avoid linking with g++
2389 -------------------------------------
2390 Cairo 1.6.4 avoids a quirk in automake that was causing the cairo
2391 library to be linked with g++ and linked against libstdc++ even when
2392 only C source files were compiled for the library.
2394 Release 1.6.2 (2008-04-11 Carl Worth <cworth@cworth.org>)
2395 =========================================================
2396 The cairo community is pleased (but somewhat sheepish) to announce the
2397 1.6.2 release of the cairo graphics library. This is an update to
2398 yesterday's 1.6.0 release with an important fix to prevent cairo's
2399 PostScript output from crashing some printers. This release also
2400 includes a locking fix for cairo's xlib backend to improve thread
2401 safety. There are no changes beyond these two fixes.
2403 Fix for PostScript printer crash
2404 --------------------------------
2405 Adrian Johnson discovered that cairo 1.6.0 was being a bit hard on
2406 PostScript printers, by changing the font matrix very frequently. This
2407 causes some PostScript interpreters to allocate new font objects every
2408 few glyphs, eventually exhausting available resources. The fix
2409 involves leaving translational components of the font matrix as zero,
2410 so that the PostScript interpreter sees an identical font matrix
2411 repeatedly, and can more easily share internal font object resources.
2413 This fix has been tested to resolve the bugs posted here, (for both
2414 Xerox and Dell printers):
2416 Printing some PDFs from evince is crashing our Xerox printer
2417 http://bugs.freedesktop.org/show_bug.cgi?id=15348
2419 Cairo-generated postscript blocks Dell 5100cn
2420 http://bugs.freedesktop.org/show_bug.cgi?id=15445
2422 Add missing locking in cairo-xlib
2423 ---------------------------------
2424 Chris Wilson noticed that cairo 1.6.0 was manipulating an internal
2425 cache of GC object within cairo's Xlib backend without proper
2426 locking. The missing locking could cause failures for multi-threaded
2427 applications. He fixed this in 1.6.2 by adding the missing locks.
2429 Release 1.6.0 (2008-04-10 Carl Worth <cworth@cworth.org>)
2430 =========================================================
2431 The cairo community is quite pleased to announce the 1.6.0 release of
2432 the cairo graphics library. This is a major update to cairo, with new
2433 features and enhanced functionality which maintains compatibility for
2434 applications written using cairo 1.4, 1.2, or 1.0. We recommend that
2435 anybody using a previous version of cairo upgrade to cairo 1.6.0.
2437 The most significant new features in this release are dramatically
2438 improved PDF and PostScript[*] output, support for arbitrary X server
2439 visuals (including PseudoColor), a new Quartz backend, and and a new
2440 "win32 printing" backend. See below for more details on these and
2443 New dependency on external pixman library (Thanks, Søren!)
2444 ----------------------------------------------------------
2445 As of cairo 1.6, cairo now depends on the pixman library, for which
2446 the latest release can be obtained alongside cairo:
2448 http://cairographics.org/releases/pixman-0.10.0.tar.gz
2450 This library provides all software rendering for cairo, (the
2451 implementation of the image backend as well as any image fallbacks
2452 required for other backends). This is the same code that was
2453 previously included as part of cairo itself, but is now an external
2454 library so that it can be shared by both cairo and by the X server,
2455 (which is where the code originated).
2457 Improved PDF, PostScript, and SVG output (Thanks, Adrian!)
2458 ----------------------------------------------------------
2459 Users of the cairo-pdf, cairo-ps, and cairo-svg should see a dramatic
2460 improvement from cairo 1.2/1.4 to 1.6. With this release there are now
2461 almost no operations that will result in unnecessary rasterization in
2462 the PDF and PostScript. Rasterized "image fallbacks" are restricted
2463 only to minimal portions of the document where something is being
2464 drawn with cairo that is beyond the native capabilities of the
2465 document, (this is rare for PDF or SVG, but occurs when blending
2466 translucent objects for PostScript).
2468 This means that the final output will be of higher quality, and will
2469 also be much smaller, and therefore will print more quickly. The
2470 machinery for doing analysis and minimal fallbacks also benefits the
2471 win32-printing surface described below.
2473 In addition to doing less rasterization, the PostScript and PDF output
2474 also has several other improvements to make the output more efficient
2475 and more compatible with specifications.
2477 [*] Note: Just before this release, a bug has been reported that the
2478 PostScript output from cairo can crash some printers, (so far the
2479 following models have been reported as problematic Xerox Workcentre
2480 7228 or 7328 and Dell 5100cn). We will implement a workaround as soon
2481 as we can learn exactly what in cairo's output these printers object
2482 to, (and we could use help from users that have access to misbehaving
2483 printers). This bug is being tracked here:
2485 Printing some PDFs from evince is crashing our Xerox printer
2486 http://bugs.freedesktop.org/show_bug.cgi?id=15348
2488 New support for arbitrary X server visuals (Thanks, Keith and Behdad!)
2489 ----------------------------------------------------------------------
2490 As of cairo 1.6, cairo should now work with an arbitrary TrueColor or
2491 8-bit PseudoColor X server visual. Previous versions of cairo did not
2492 support these X servers and refused to draw anything. We're pleased to
2493 announce that this limitation has been lifted and people stuck with
2494 ancient display systems need no longer be stuck with ancient software
2495 just because of cairo.
2497 New, supported Quartz backend for Mac OS X (Thanks, Brian and Vladimir!)
2498 ------------------------------------------------------------------------
2499 As of cairo 1.6, the cairo-quartz backend is now marked as "supported"
2500 rather than "experimental" as in previous cairo releases. Its API now
2501 has guarantees of API stability into future cairo releases, and its
2502 output quality is comparable to other backends. There have been
2503 significant improvements to cairo-quartz since 1.4. It now uses many
2504 fewer image fallbacks, (meaning better performance), and has greatly
2505 improved text rendering.
2507 New, "win32 printing" backend (Thanks, Adrian and Vladimir!)
2508 ------------------------------------------------------------
2509 A new win32-printing surface has been added with an interface very
2510 similar to the original win32 surface, (both accept an HDC
2511 parameter). But this new surface should only be called with a printing
2512 DC, and will result in all drawing commands being stored into a
2513 meta-surface and emitted after each page is complete. This allows
2514 cairo to analyze the contents, (as it does with PDF, PostScript, and
2515 SVG backends), and to do minimal image-based fallbacks as
2516 necessary. The analysis keeps things as efficient as possible, while
2517 the presence of fallbacks, (when necessary), ensure the consistent,
2518 high-quality output expected from cairo.
2520 Robustness fixes (Thanks, Chris!)
2521 ---------------------------------
2522 There has been a tremendous number of improvements to cairo's
2523 robustness. Areas that have been improved include:
2525 * Proper reporting of errors
2527 * Responding correctly to invalid input
2529 * Avoiding integer overflows
2531 * Avoiding memory leaks on error-recovery paths
2533 * Making reference counting thread safe
2535 * Exhaustive testing of memory allocation points
2537 Other fixes (Thanks, everybody!)
2538 --------------------------------
2539 Cairo's internal fixed-point representation has been changed from
2540 16.16 to 24.8. This has a direct impact on applications as it allows
2541 much larger objects to be drawn before internal limits in cairo make
2542 the drawing not work.
2544 The CAIRO_EXTEND_PAD mode is now fully supported by surface
2545 patterns. This mode allows applications to use cairo_rectangle and
2546 cairo_fill to draw scaled images with high-quality bilinear filtering
2547 for the internal of the image, but without any objectionably blurry
2548 edges, (as would happen with the default EXTEND_NONE and cairo_paint).
2550 Rendering with CAIRO_ANTIALIAS_NONE has been fixed to be more
2551 predictable, (previously image rendering and geometry rendering would
2552 be slightly misaligned with respect to each other).
2554 The reference manual at http://cairographics.org/manual now documents
2555 100% of the functions and types in cairo's public API.
2559 Several small features have been added to cairo with new API functions:
2561 cairo_format_stride_for_width
2563 Must be called to compute a properly aligned stride value before
2564 calling cairo_image_surface_create_for_data.
2566 cairo_has_current_point
2568 Allows querying if there is a current point defined for the
2573 Allows querying for path extents, (independent of any fill or
2576 cairo_surface_copy_page
2577 cairo_surface_show_page
2579 Allow beginning a new document page without requiring a cairo_t
2582 cairo_ps_surface_restrict_to_level
2584 cairo_ps_level_to_string
2585 cairo_ps_surface_set_eps
2587 Allow controlling the Post PostScript level, (2 or 3), to
2588 target, as well as to generate Encapsulated PostScript (EPS).
2590 cairo_quartz_font_face_create_for_cgfont
2592 Create a quartz-specific cairo_font_face_t from a CGFontRef.
2594 cairo_win32_font_face_create_for_logfontw_hfont
2596 Create a win32-specific cairo_font_face from a LOGFONTW and an
2601 I've accounted for 32 distinct people with attributed code added to
2602 cairo between 1.4.14 and 1.6.0, (their names are below). That's an
2603 impressive number, but there are certainly dozens more that
2604 contributed with testing, suggestions, clarifying questions, and
2605 encouragement. I'm grateful for the friendships that have developed as
2606 we have worked on cairo together. Thanks to everyone for making this
2609 Adrian Johnson, Alp Toker, Antoine Azar, Behdad Esfahbod,
2610 Benjamin Otte, Bernardo Innocenti, Bertram Felgenhauer,
2611 Boying Lu, Brian Ewins, Carl Worth, Chris Heath, Chris Wilson,
2612 Claudio Ciccani, Emmanuel Pacaud, Jeff Muizelaar, Jeremy Huddleston,
2613 Jim Meyering, Jinghua Luo, Jody Goldberg, Jonathan Gramain,
2614 Keith Packard, Ken Herron, Kouhei Sutou, Kristian Høgsberg,
2615 Larry Ewing, Martin Ejdestig, Nis Martensen, Peter Weilbacher,
2616 Richard Hult, Shailendra Jain, Søren Sandmann Pedersen,
2619 Snapshot 1.5.20 (2008-04-04 Carl Worth <cworth@cworth.org>)
2620 ===========================================================
2621 This is the tenth snapshot in cairo's unstable 1.5 series. It comes
2622 just two days (and only one working day) after the 1.5.18
2623 snapshot. The quick snapshot is due to two embarrassing bugs (both
2624 affecting cairo-xlib) that had been introduced in the 1.5.18
2625 snapshot. The fixes for these are described below along with a few
2626 other fixes, (which hopefully aren't introducing new bugs this time).
2630 Revert fix from 1.5.18 to allow pattern expansion based on the filter
2631 mode. This fix seemed so boring, (the use case it addresses is almost
2632 never used in practice), that it didn't even get mentioned in the
2633 1.5.18 release notes. However, the "fix" happened to break rendering
2634 that is always used resulting in corrupt image rendering in mozilla,
2635 evolution, and probably everything else that uses cairo.
2637 Fix to avoid BadMatch errors in cairo_surface_create_similar. These
2638 were introduced, (inadvertently, of course), as part of the fix in
2639 1.5.18 for creating similar surfaces without the Render
2640 extension. Again, thanks to mozilla, (and Vladimir Vukicevic in
2641 particular), for noticing our mistake.
2645 Correctly handle an in-error surface in
2646 cairo_surface_write_to_png. Previously this function would cause an
2647 assertion failure if you gave it a finished surface. Now it cleanly
2648 returns a CAIRO_STATUS_SURFACE_FINISHED result instead.
2650 Avoid potentially infinite wandering through memory inside
2651 _cairo_hull_prev_valid. Thanks to Jonathan Watt for noticing this
2654 https://bugzilla.mozilla.org/show_bug.cgi?id=306649#c21
2658 Fix generation of "soft" masks made by drawing to a similar surface
2659 and then calling cairo_mask_surface() with it.
2663 Fix for code that uses cairo_mask() on an intermediate surface which
2664 is later passed to cairo_mask_surface().
2666 Snapshot 1.5.18 (2008-04-05 Carl Worth <cworth@cworth.org>)
2667 ===========================================================
2668 This is the ninth snapshot in cairo's unstable 1.5 series. It comes
2669 just 4 days after the 1.5.16 snapshot. We had hoped to not need
2670 another snapshot before the final 1.6.0 release, but several critical
2671 bugs were found and fixed in the last few days, so we thought it
2672 important to let people test the fixes with this snapshot. See below
2677 The README now lists necessary dependencies.
2679 Various graphics state defaults are now documented, (source pattern is
2680 opaque black, line width is 2.0, line join is miter, line cap is butt,
2681 miter limit is 10.0, etc.).
2685 Several cleanups have been made along many error-path returns,
2686 (carefully propagating up the original error status values, cleaning
2687 up memory leaks during error recovery, etc.). This is yet another in
2688 Chris "ickle" Wilson's long series of error-handling cleanups during
2691 Avoid undesired clipping when drawing scaled surface patterns with
2696 Fix emission of 1-bit alpha masks in PDF output.
2698 Fix a bug that would cause glyphs to be misplaced along the Y axis:
2700 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=%23474136
2702 Originally, an issue about a crash, but later leading to the
2703 misplaced glyphs issue being discovered.
2707 Fix misplaced glyphs in cairo's PostScript output.
2709 This issue occurs when consecutive glyphs are placed far
2710 apart. This case is exercised by the new ft-show-glyphs-table test
2711 case, which was originally inspired by the Debian bug #23474136
2714 Fix more misplaced glyphs in cairo's PostScript output:
2716 The issue here showed up under very particular circumstance, (when
2717 converting a PDF file with a CFF font with CID Identity-H encoding
2718 and using glyph 0, (defined by the CFF specification as .notdef)
2719 as a space instead). More concretely, this problem appeared when
2720 converting the UbuntuDesktop.pdf file mentioned in this bug
2723 https://bugs.freedesktop.org/show_bug.cgi?id=15348#c3
2725 As usual with arcane font-encoding-specific bugs like this, many
2726 thanks to Adrian Johnson for his magical ability to dive into
2727 specifications and emerge almost instantaneously with fixes. And
2728 thanks to Sebastien Bacher for bringing the bug to our attention.
2732 Fix serious failure on X servers without the Render extension.
2734 Since the 1.5.14 snapshot (with support for PseudoColor visuals),
2735 any application attempting to create a "similar" xlib surface would
2736 fail on an X server without the Render extension. Thanks to
2737 Frederic Crozat for pointing out that cairo's test suite was
2738 entirely failing when run against Xvfb.
2740 Avoid crashing cairo-xlib applications for too-large glyphs
2742 Naively sending glyphs of any size to the X server will eventually
2743 violate the X limit on maximum request sizes. We now properly
2744 detect when a glyph would be too large and use existing fallbacks
2745 to render the glyph rather than trying to send it to the X server.
2747 Enable the buggy_repeat workaround for Xorg servers < 1.4
2749 We have determined that Xorg 1.3.0 (as packaged in Fedora 8 at
2750 least) has a bug that can result in an X server crash when cairo
2751 uses certain X Render repeat operations, (as exercised by cairo's
2752 extend-reflect test). We avoid this crash by using fallbacks
2753 whenever a repeating surface is needed for any Xorg server with a
2754 version less than 1.4. This is slower, but should prevent the
2757 (Meanwhile, there appears to be a separate bug where some X
2758 servers or specific X-server drivers will use random pixmap data
2759 when asked to draw a repeating surface. The buggy_repeat
2760 workaround would also avoid those problems, but we have not yet
2761 characterized whether the new "version < 1.4" is a good
2762 characterization of those problems or not.)
2766 Implement cairo_font_extents for this backend.
2768 The cairo-quartz-font implementation added in the 1.5.14 snapshot was
2769 entirely missing support for the cairo_font_extents function. Thanks to
2770 Richard Hult for pointing out this obvious shortcoming, (and obvious
2771 lack of coverage in our test suite):
2773 CGFont backend returns 0 font extents
2774 https://bugs.freedesktop.org/show_bug.cgi?id=15319
2776 Snapshot 1.5.16 (2008-04-01 Carl Worth <cworth@cworth.org>)
2777 ===========================================================
2778 This is the eighth snapshot in cairo's unstable 1.5 series. It comes
2779 less than two weeks after the 1.5.14 snapshot and it really is a
2780 legitimate snapshot, (in spite of sharing this date with that of many
2781 bogus announcements). The major change in this snapshot is that the
2782 cairo-quartz backend is now officially "supported", including new API
2783 to construct a font face from a CGFontRef . Also several bug fixes
2784 have been fixed in many backends. See below for details.
2788 Cairo now depends on pixman 0.10.0 which was recently released. The
2789 latest pixman release can always be found alongside cairo releases at:
2791 http://cairographics.org/releases
2793 Increase the precision of color stops for gradients. This fixes a
2794 regression in gradient rendering that had been present since the
2797 paginated (all of ps, pdf, svg, and win32-printing)
2798 ---------------------------------------------------
2799 Fix assertion failure when some drawing elements are outside the page
2800 boundaries, (this bug was noticed when using Inkscape to print a
2801 drawing with landscape orientation to a portrait-oriented piece of
2806 Fix of bug causing incorrect glyph positioning.
2808 Fix handling of CAIRO_OPERATOR_SOURCE.
2812 More reduction of unnecessary digits of precision in PDF output.
2814 Fix handling of CAIRO_OPERATOR_SOURCE.
2818 Fix bug in usage of libpng that was preventing cairo_mask from working
2819 with the svg backend.
2821 Fix transformation of source pattern for cairo_stroke().
2823 cairo-win32-printing
2824 --------------------
2825 Fix fallback resolution, (thanks again to inkscape users/developers
2826 for helping us find this one).
2830 Mark the cairo-quartz backend as "supported" rather than
2831 "experimental". This means the following:
2833 * The backend will now be built by default (if possible).
2835 * We are committing that the backend-specific API (as published in
2836 cairo-quartz.h) are stable and will be supported in all future
2839 * We are committing that the output quality of this backend
2840 compares favorably with other cairo backends, (and that quality
2841 is ensured by good results from the cairo test suite).
2843 * We recommend that distributions build and distribute this
2844 backend when possible.
2846 Note that the cairo_quartz_image API (in cairo-quartz-image.h) is
2847 still experimental, will not build by default, (pass
2848 --enable-quartz-image to configure to build it), and may see API
2849 changes before it is marked as "supported" in a future release.
2851 Put the CAIRO_FONT_TYPE_ATSUI name back into
2852 cairo-deprecated.h. Without this, the cairo 1.5.14 snapshot broke all
2853 builds for applications using the C++ cairomm bindings (and perhaps
2854 others) which have the CAIRO_FONT_TYPE_ATSUI name in their header
2855 files. This breakage happened even for applications not using
2856 cairo-quartz at all.
2858 Note: Even though the CAIRO_FONT_TYPE_ATSUI name is provided to
2859 avoid this build breakage, we still recommend that bindings and
2860 applications move to the new, and more accurate,
2861 CAIRO_FONT_TYPE_QUARTZ name.
2863 Replace the implementation of cairo-quartz-font to use CFFont instead
2864 of ATSUI. The CGFont API is a better fit than ATSUI, and this new
2865 implementation is also more correct than the old one as well.
2867 This also adds the following new API call:
2869 cairo_public cairo_font_face_t *
2870 cairo_quartz_font_face_create_for_cgfont (CGFontRef font);
2872 The previous cairo_quartz_font_face_create_for_atsu_font_id function
2873 continues to exist and is part of the supported API going
2874 forward. (However, the old name of that same function, which was
2875 cairo_atsui_font_face_create_for_atsu_font_id is officially
2876 deprecated. Any source code using the old name should be updated to
2879 Fix transformation of source pattern for cairo_stroke().
2883 Avoid crash in create_similar is cairo_win32_surface_create fails.
2885 Snapshot 1.5.14 (2008-03-20 Carl Worth <cworth@cworth.org>)
2886 ===========================================================
2887 This is the seventh snapshot in cairo's unstable 1.5 series. It comes
2888 3 weeks after the 1.5.12 snapshot. This snapshot includes support for
2889 arbitrary X server visuals, (including PseudoColor), which was the
2890 final remaining cairo-specific item on the cairo 1.6 roadmap. It also
2891 includes a huge number of improvements to the cairo-quartz backend. So
2892 this is effectively a cairo 1.6 release candidate. We expect very few
2893 changes from now until 1.6 and only for specific bug fixes.
2897 Rename ATSUI font backend to Quartz font backend. This affects the
2900 --enable-atsui -> --enable-quartz-font
2901 CAIRO_HAS_ATSUI_FONT -> CAIRO_HAS_QUARTZ_FONT
2902 CAIRO_FONT_TYPE_ATSUI -> CAIRO_FONT_TYPE_QUARTZ
2904 cairo_atsui_font_face_create_for_atsu_font_id ->
2905 cairo_quartz_font_font_create_for_atsu_font_id
2907 This API change is justified by the cairo-quartz backend still be
2908 marked as "experimental" rather than "supported", (though this is one
2909 step toward making the change to "supported" before 1.6). Cairo will
2910 still provide ABI compatibility with the old symbol name, however.
2912 paginated (all of ps, pdf, svg, and win32-printing)
2913 ---------------------------------------------------
2914 Optimize by not analyzing an image surface for transparency more than
2915 once, (previously all images were analyzed twice).
2917 cairo-ps and cairo-pdf
2918 ----------------------
2919 Avoiding emitting a matrix into the stroke output when unnecessary,
2920 (making output size more efficient).
2922 Reduce rounding error of path shapes by factoring large scale factors
2923 out of the path matrix, (ensuring that a fixed-number of printed
2924 digits for path coordinates contains as much information as possible).
2926 Reduce excess digits for text position coordinates. This makes the
2927 output file size much smaller without making the result any less
2932 Eliminate bug causing extraneous text repetition on Linux PostScript
2933 output in some cases.
2935 See: Mozilla Bug 419917 – Printed page contents are reflected
2936 inside bordered tables (Linux-only)
2938 https://bugzilla.mozilla.org/show_bug.cgi?id=419917
2940 Optimize output when EXTEND_PAD is used.
2944 Fix to not use fill-stroke operator with transparent fill, (else PDF
2945 output doesn't match the cairo-defined correct result). See:
2947 https://bugs.launchpad.net/inkscape/+bug/202096
2951 Fix stroke of path with a non-solid-color source pattern:
2953 http://bugs.freedesktop.org/show_bug.cgi?id=14556
2957 Fix text rendering with gradient or image source pattern.
2959 Handling antialiasing correctly for cairo_stroke(), cairo_clip(), and
2960 cairo_show_text()/cairo_show_glyphs().
2962 Correctly handle gradients with non-identity transformations:
2964 Fixes http://bugs.freedesktop.org/show_bug.cgi?id=14248
2966 Add native implementation of REPEAT and REFLECT extend modes for
2969 Fix implementation for the "unbounded" operators, (CAIRO_OPERATOR_OUT,
2970 _IN, _DEST_IN, and _DEST_ATOP).
2972 Correctly handle endiannees in multi-architecture compiles on Mac OS
2975 Avoid behavior which would cause Core Graphics to print warnings to
2976 the console in some cases.
2980 Fix handling of miter limit.
2982 cairo-win32-printing
2983 --------------------
2984 Fix to not use a 1bpp temporary surface in some cases while printing,
2985 (so grayscale data is preserved rather than just becoming black and
2990 Add support for rendering to arbitrary TrueColor X server
2991 visuals. This fixes at least the following bugs:
2993 cairo doesn't support 8-bit truecolor visuals
2994 https://bugs.freedesktop.org/show_bug.cgi?id=7735
2996 cairo doesn't support 655 xlib format
2997 https://bugs.freedesktop.org/show_bug.cgi?id=9719
2999 Add support for rendering to 8-bit PseudoColor X server visuals. This
3000 fixes the following bug:
3002 Cairo doesn't support 8-bit pseudocolor visuals
3003 https://bugs.freedesktop.org/show_bug.cgi?id=4945
3005 Snapshot 1.5.12 (2008-02-28 Carl Worth <cworth@cworth.org>)
3006 ===========================================================
3007 This is the sixth snapshot in cairo's unstable 1.5 series. It comes 1
3008 week after the 1.5.10 snapshot. This snapshot includes the
3009 long-awaited change from 16.16 to 24.8 fixed-point values, (see below
3010 for why you should care). It also includes several backend-specific
3013 24.8 fixed-point format
3014 -----------------------
3015 Cairo has always converted path coordinates to a fixed-point
3016 representation very early in its processing. Historically, this has
3017 been a 32-bit representation with 16 bits of integer for the
3018 device-pixel grid and 16 bits of sub-pixel positioning. The choice of
3019 16 bits for the integer coordinate space was based on the 16-bit limit
3020 for X Window drawables.
3022 This 16-bit limit has proven problematic for many applications. It's
3023 an especially vexing problem when targeting non-X backends that don't
3024 have any 16-bit restriction. But even when targeting cairo-xlib, it's
3025 often desirable to draw a large shape, (say a background rectangle),
3026 that extends beyond the surface bounds and expect it to fill the
3027 surface completely, (rather than overflowing and triggering random
3030 Meanwhile, nobody has ever really needed 16 bits of sub-pixel
3033 With this snapshot, the fixed-point system is still in place and is
3034 still using a 32-bit representation, (future versions of cairo might
3035 move entirely to floating-point when targeting PDF output for
3036 example). But the representation now provides 24 bits of pixel
3037 addressing and only 8 bits of sub-pixel positioning. This should give
3038 a much less stifling space to many applications.
3040 However, the underlying pixman library still has 16-bit limitations in
3041 many places, (it has its roots in the X server as well). Until those
3042 are also fixed, applications targeting cairo image surfaces, or
3043 hitting software fallbacks when targeting other surfaces will still
3044 encounter problems with device-space values needing more than 16
3049 Add a few tests to the test suite to increase coverage.
3051 Cleanup a few error-handling paths, (propagate error correctly).
3055 Fix handling of font sizes smaller than 1 device pixel.
3059 Fix to properly save/restore clip when analyzing meta-surface
3060 patterns, (fixing a couple of test-suite failures).
3062 Implement native support for CAIRO_OPERATOR_SOURCE when the source
3065 Emit rectangles as PDF rectangles ("re" operator) rather than as
3070 Fix to work properly with the 16.16->24.8 change.
3074 Fix CAIRO_EXTEND_REFLECT by using an image fallback, (there's no
3075 direct SVG support for reflected patterns).
3077 Fix the use of alpha-only masks, (such as CAIRO_FORMAT_A8).
3081 Add new API for efficiently using image data as a source:
3084 cairo_quartz_image_surface_create (cairo_surface_t *image_surface);
3087 cairo_quartz_image_surface_get_image (cairo_surface_t *surface);
3089 For full documentation, see:
3091 http://cairographics.org/manual/cairo-Quartz-Surfaces.html#cairo-quartz-image-surface-create
3093 Several fixes for cairo_mask().
3097 Change default from from Monaco to Helvetica to be more consistent
3098 with other font backends.
3100 Snapshot 1.5.10 (2008-02-20 Carl Worth <cworth@cworth.org>)
3101 ===========================================================
3102 This is the fifth snapshot in cairo's unstable 1.5 series. It comes 3
3103 weeks after the 1.5.8 snapshot. This snapshot adds one new API
3104 function, (cairo_has_current_point), and the usual mix of
3105 improvements, (more efficient PostScript/PDF output, optimized
3106 stroking), and fixes (more robust error-handling, etc.). See below for
3111 Add a new function to query if there is a current point:
3114 cairo_has_current_point (cairo_t *cr);
3116 There is no current point immediately after cairo_create(), nor after
3117 cairo_new_path() or cairo_new_sub_path(). There is a current point
3118 after any of the path-creation functions, (cairo_move_to,
3119 cairo_line_to, cairo_curve_to, etc.).
3121 With this new function, we also revert the change of the return type
3122 of cairo_get_current_point from cairo 1.5.8, (it's now a void function
3127 Optimize stroking code to avoid repeated calculation of redundant
3128 values, (particularly significant for very large, offscreen paths).
3132 Patch a few more potential buffer overruns, (due to integer
3135 Many fixes and improvements to cairo's error-handling, (ensure that
3136 correct error values are returned, clean up memory leaks on
3137 error-handling paths, etc.).
3139 Fix a potential infinite loop when stroking a spline with a pen that
3140 has been transformed to a line segment.
3142 Remove treating NULL as a synonym for a valid cairo_font_options_t*
3143 with default values, (a change that had been introduced as of cairo
3146 Remove the altered handling of tolerance and fallback-resolution that
3147 had been introduced as of cairo 1.5.4.
3151 Pass the original Drawable, (as opposed to the root window), to
3152 XCreatePixmap when creating a similar surface. This gives the X server
3153 more information so that it can be clever and efficient.
3157 Fix the rendering of repeating and reflecting patterns.
3159 Ensure miter limit is always >= 1, (smaller limits are not meaningful,
3160 but they can cause some PDF viewers to fail to display pages).
3162 Generate more efficient output when the same path is used for both
3167 Start sharing much of the cairo-pdf code rather than implementing very
3168 similar code in cairo-ps.
3170 Implement native support for repeating and reflecting linear
3173 Implement reflected surface patterns.
3175 Ensure miter limit is always >= 1, (smaller limits are not meaningful,
3176 but they can cause some PostScript viewers to crash).
3178 Generate PostScript that will perform more efficiently and use less
3179 memory on printers, (use currentfile instead of a giant string array
3180 for image data, and avoid using PostScript patterns for paint() and
3181 fill() when possible).
3185 Avoid unnecessary rasterization when copying a "similar" surface to
3186 another svg surface, (allow the SOURCE operator to be implemented with
3187 all-vector operations if there are no underlying objects).
3191 Eliminate infinite loop when attempting to render an empty string.
3193 Snapshot 1.5.8 (2008-01-30 Carl Worth <cworth@cworth.org>)
3194 ==========================================================
3195 This is the fourth snapshot in cairo's unstable 1.5 series. It comes 2
3196 weeks after the 1.5.6 snapshot. It adds a few new API functions. Most
3197 notably all callers of cairo_image_surface_create_for_data should now
3198 be calling cairo_format_stride_for_width to compute a legal stride
3199 value. See below for more details.
3201 New API in cairo 1.5.8
3202 ----------------------
3203 We've added a new function that should be called to compute a legal
3204 stride value before allocating data to be used with
3205 cairo_image_surface_create_for_data:
3208 cairo_format_stride_for_width (cairo_format_t format,
3211 We've also added a new cairo_path_extents function that can be used to
3212 compute a bounding box for geometry such as a single line segment,
3213 (contrast with cairo_path_extents and cairo_stroke_extents):
3216 cairo_path_extents (cairo_t *cr,
3217 double *x1, double *y1,
3218 double *x2, double *y2);
3220 And finally, we've added a function to allow for querying the
3221 XRenderPictFormat of a cairo-xlib surface:
3224 cairo_xlib_surface_get_xrender_format (cairo_surface_t *surface);
3228 Fix return types of cairo_surface_show_page and
3229 cairo_surface_copy_page. This is an API change to functions that are
3230 new in the 1.5 series, so not an API break compared to any stable
3231 cairo release, (1.0.x, 1.2.x, 1.4.x).
3233 Change the return type of cairo_get_current_point() from void to
3234 cairo_status_t. This allows the caller to receive a
3235 CAIRO_STATUS_NO_CURRENT_POINT value to distinguish the a current point
3236 at the origin from no current point existing.
3238 Performance improvement
3239 -----------------------
3240 Improve performance of clipping by using an optimized code path
3241 internally, (with the ADD operator instead of IN).
3245 Fix various cairo_*_extents functions to initialize the return-value
3246 variables even in the case of a cairo_t in error.
3248 Treat NULL as a legitimate value for cairo_font_options_t*. [NOTE:
3249 On discussion afterwards, we decided against this change so it has
3250 been removed as of cairo 1.5.10.]
3252 Fix rendering with CAIRO_ANTIALIAS_NONE to be more predictable, (that
3253 is, to avoid seams appearing when geometry and imagery share an
3254 identical edge). Portions of this fix are in the pixman library and
3255 will appear in a future release of that library.
3257 Avoid triggering an error for a font size of 0.
3259 Miscellaneous changes
3260 ---------------------
3261 Require pixman >= 0.9.6.
3263 There has been a tremendous amount improvement to cairo's
3264 documentation. We're delighted that 100% of the public API has at
3265 least some documentation in the API reference manual. Many thanks to
3266 Behdad Esfahbod and Nis Martensen for leading this effort.
3268 cairo-pdf and cairo-ps
3269 ----------------------
3270 Eliminate failure when a Type 1 font is embedded with an explicit
3275 Implement a more correct and more efficient approach for patterns with
3276 an extend mode of CAIRO_EXTEND_REFLECT.
3280 Fix image masks to properly pack and pad mask bits.
3284 Take care to only use DrawTiledImage for integer-aligned images, (and
3285 use slower paths to get the correct result in other cases).
3289 Fix for older versions of mingw.
3291 Improve the handling of the clipping with the win32 and win32-printing
3294 Fix rendering of non black/white text.
3296 Snapshot 1.5.6 (2008-01-15 Carl Worth <cworth@cworth.org>)
3297 ==========================================================
3298 This is the third snapshot in cairo's unstable 1.5 series. It comes
3299 about 6 weeks after the 1.5.4 snapshot. The only API addition compared
3300 to 1.5.4 is very minor, (a new value CAIRO_STATUS_TEMP_FILE_ERROR).
3301 The remainder of the changes are the usual accumulation of bug fixes
3302 and improvements. See below for details.
3306 Fix handling of fonts that contain a mixture of outline and bitmapped
3307 glyphs. There was a change in this handling in 1.5.4 that improved
3308 some cases and also regressed other cases. Now, all cases should be
3311 Fix alignment issues that were causing SIGBUS failures on SPARC.
3313 Fix a regression (which first appeared in 1.5.2) where stroking under
3314 a large scale would sometimes incorrectly replace a miter join with a
3315 bevel join. (Thanks to Keith Packard.)
3317 Fix reporting of zero-sized extents to be {0,0} rather than
3318 {INT_MAX,INT_MIN}. This avoids several integer overflow and
3319 allocations of massive regions in some cases.
3321 Fix failures of gradients with no stops, (quartz, ps, and pdf).
3323 Fix handling of Type 1 fonts on Windows platforms.
3325 Fix handling of Type 1 fonts with no specific family name in the font
3326 itself, (generate a CairoFont-x-y name).
3328 Handle NULL string values in cairo_show_text, cairo_show_glyphs, and
3331 Many robustness improvements along error-handling paths, (thanks as
3332 always, to Chris "ickle" Wilson).
3334 Various other minor fixes.
3336 Paginated backends (PDF/PostScript/win32-printing)
3337 --------------------------------------------------
3338 Avoid unnecessary rasterization when using a paginated surface as a
3339 source, (such as drawing from one pdf surface to another).
3341 Fix replaying of paginated surface with more than one level of push/pop
3346 Fix xlib backend to not consider recent X server release as having a
3347 buggy repeat implementation in the Render extension.
3351 Fix PDF output to avoid triggering very slow rendering in PDF viewers,
3352 (avoid starting and stopping the content stream for each pattern
3355 Support CAIRO_OPERATOR_SOURCE in cases where there is nothing below
3356 the object being drawn.
3358 Fix to avoid seams appearing between multiple fallback regions.
3360 cairo-ps (PostScript)
3361 ---------------------
3362 Use correct bounding box in Type 3 fonts.
3364 Fix several bugs in cairo's PostScript output. These include making
3365 the PostScript output more compatible with recent versions of
3366 ghostscript that are more strict about Type 3 fonts, for
3369 Fix for win32 to not attempt to create temporary files in the root
3370 directory, (where the user may not have write permission).
3372 Avoid generating Level 3 PostScript if Level 2 is sufficient. Also,
3373 add code in output documents to alert the user if Level 3 PostScript
3374 is handed to a device that cannot handle PostScript beyond Level
3379 Various performance optimizations.
3381 Fixed support for small surfaces (less than 8x8).
3383 Provide support for environment variables CAIRO_DIRECTFB_NO_ACCEL to
3384 disable acceleration and CAIRO_DIRECTFB_ARGB_FONT to enable ARGB fonts
3389 Allow OS/2 APIs instead of C library allocation functions.
3391 Snapshot 1.5.4 (2007-12-05 Carl Worth <cworth@cworth.org>)
3392 ==========================================================
3393 This is the second snapshot in cairo's unstable 1.5 series. It comes
3394 just over 1 month after the 1.5.2 snapshot. There are no API changes
3395 or additions in 1.5.4 compared to 1.5.2, but there are several bug
3396 fixes, and some optimizations. Most of these apply to particular
3397 backends. See below for details.
3399 General improvements
3400 --------------------
3401 Use less memory for spline approximation calculations.
3403 Change how the tolerance value is interpreted with regard to
3404 fallback-resolution. [Note: On further discussion, we decided against
3405 this change for now. It is removed as of cairo 1.5.10.]
3407 Fix precision of floating-point values in vector-output backends to
3408 avoid rounding errors with very small numbers.
3412 Fix bug in glyph rendering with xlib, (due to everything being clipped
3413 out). This was a regression in the 1.5.2 snapshot that was visible in
3414 the GIMP, for example. See:
3416 cairo 1.5.2 causes font problems in GIMP 2.4 status bar and evolution 2.12.1
3417 https://bugs.freedesktop.org/show_bug.cgi?id=13084
3419 PostScript improvements
3420 -----------------------
3421 Fix bug leading to invalid PostScript files when rendering
3422 text, (need "0 0 xyshow" instead of "0 xyshow").
3424 Fix many issues with Type 3 fonts, including making the resulting text
3429 Fix font metrics height value for ATSUI, (helps webkit on GTK+ OS X
3434 Fix EXTEND_NONE mode for patterns.
3436 Fix cairo_quartz_surface_create to properly clear the new surface
3437 in cairo_quartz_surface_create.
3439 Fix to correctly handle 0x0 sized surfaces.
3441 Optimize drawing of EXTEND_REPEAT patterns for OS X 10.5.
3443 Snapshot 1.5.2 (2007-10-30 Carl Worth <cworth@cworth.org>)
3444 ==========================================================
3445 This is the first snapshot in cairo's unstable 1.5 series. It comes 4
3446 months after the 1.4.10 release. This snapshot includes significant
3447 improvements to PDF and PostScript output, which is one of the things
3448 in which we're most interested in getting feedback. There are a couple
3449 of minor API additions, and several optimizations, (primarily in the
3450 "print/vector" backends). And there are dozens of bug fixes and
3451 robustness improvements.
3453 New dependency on external pixman library
3454 -----------------------------------------
3455 A significant change in this snapshot compared to all previous cairo
3456 releases is that cairo now depends on an external "pixman" library for
3457 its software rendering. Previously this same code was compiled
3458 internally as part of cairo, but now the code is separate so that both
3459 cairo and the X server can now share common code, (thanks very much to
3460 Søren Sandmann for his work on separating pixman and maintaining it).
3462 So users will need to acquire and build pixman before being able to
3463 build cairo. The current release is 0.9.6 and can be obtained from
3466 http://cairographics.org/releases/pixman-0.9.6.tar.gz
3468 which can be verified with:
3470 http://cairographics.org/releases/pixman-0.9.6.tar.gz.sha1
3471 66f01a682c64403a3d7a855ba5aa609ed93bcb9e pixman-0.9.6.tar.gz
3473 http://cairographics.org/releases/pixman-0.9.6.tar.gz.sha1.asc
3474 (signed by Carl Worth)
3476 Major PDF/PostScript improvements
3477 ---------------------------------
3478 Adrian Johnson has done some long-awaited work to make cairo's PDF and
3479 PostScript output more interesting than ever before. First, many
3480 operations that previously triggered image fallbacks will now be
3481 rendered as native vectors. These operations include:
3483 PDF: cairo_push_group, cairo_surface_create_similar,
3484 cairo_mask, A8/A1 surface sources, repeating/reflecting linear
3487 PostScript: cairo_push_group, cairo_surface_create_similar,
3488 gradients, bilevel alpha masks, (for example, all values either 0 or
3489 255 for an A8 mask).
3491 Not only that, but when an image fallback is required, it will now be
3492 limited to only the necessary region. For example, a tiny translucent
3493 image overlaying a small portion of text would previously caused an
3494 entire PostScript page to be rendered as a giant image. Now, the
3495 majority of that page will be nice text, and there will only be a tiny
3496 image in the output.
3498 Additionally, the PostScript output now carefully encodes text so that
3499 if it is subsequently converted to PDF, the text will be
3502 This is very exciting progress, and we're hoping to hear from users
3503 during the 1.5 series about how things have improved, (for example,
3504 inkscape users doing cairo-based PDF export: please let us know how
3505 things look). And feel free to pass your thanks along to Adrian for his excellent work.
3507 NOTE: This much improved PDF output makes more sophisticated use of
3508 functionality in the PDF specification. This means that cairo's output
3509 will sometimes expose bugs in some free software PDF viewers, (evince,
3510 poppler, and xpdf, for example), that are not yet ready for such PDF
3511 files. We're working with the poppler maintainers to get these bugs
3512 fixed as quickly as possible. In the meantime, please double-check
3513 with other PDF viewers if cairo-generated PDF files are not being
3514 rendered correctly. It may be due to a bug in the viewer rather than
3515 in the PDF file that cairo has created.
3517 Robustness improvements
3518 -----------------------
3519 Chris Wilson has made the largest contribution by far to cairo 1.5.2,
3520 (in number of commits). His more than 150 commits include a huge
3521 number of fixes to increase cairo's robustness. These fixes make cairo
3522 more robust against invalid and degenerate input, (NaN, empty path,
3523 etc.), against size-0 malloc calls, against memory leaks on
3524 error-recovery paths, and against other failures during error
3525 handling. He also implemented atomic operations to cairo, and used
3526 them to fix cairo's previously non-thread-safe reference counting,
3527 again improving robustness.
3529 Chris has put a tremendous amount of time and effort into writing
3530 analysis tools for this work, and in running those tools and fixing
3531 the problems they report. We're very grateful for this work, and hope
3532 that all cairo users appreciate the more robust implementation that
3535 This work is largely thankless, so it might make sense to notice
3536 sometime that cairo has been running quite smoothly for you, and when
3537 you do, send a quick "thank you" off to Chris Wilson, since it
3538 is all definitely running smoother thanks to his work.
3542 There are no major additions to cairo's core API. The only new,
3543 generic functions are:
3546 cairo_surface_copy_page (cairo_surface_t *surface);
3549 cairo_surface_show_page (cairo_surface_t *surface);
3551 which can now be used much more conveniently than the existing
3552 cairo_copy_page and cairo_show_page functions in some
3553 situations. These functions act identically, but require only a
3554 cairo_surface_t* and not a cairo_t*.
3556 All other API additions are specific to particular backends.
3558 New cairo-win32 API (new font face function and "win32 printing" surface)
3559 -------------------------------------------------------------------------
3560 There is a new function for creating a win32 font face for both a
3561 logfontw and an hfont together. This complements the existing
3562 functions for creating a font face from one or the other:
3565 cairo_win32_font_face_create_for_logfontw_hfont (LOGFONTW *logfont,
3568 There is also a new "win32 printing" surface:
3571 cairo_win32_printing_surface_create (HDC hdc);
3573 This interface looks identical to the original
3574 cairo_win32_surface_create, (both accept and HDC), but the behavior of
3575 this new surface is very different. It should only be called with a
3576 printing DC, and will result in all drawing commands being stored into
3577 a meta-surface and emitted after each page is complete, with analysis
3578 to do as minimal image-based fallbacks as necessary. The behavior and
3579 implementation shares much with the PDF and PostScript backends.
3581 New cairo-ps API (EPS and PostScript level control)
3582 ---------------------------------------------------
3583 An often requested feature has been the ability to generate
3584 Encapsulated PostScript (EPS) with cairo. We have that now with the
3585 following very simple API. Just do cairo_ps_surface_create as usual
3586 then call this function with a true value:
3589 cairo_ps_surface_set_eps (cairo_surface_t *surface,
3592 [NOTE: As always with snapshots, it's possible---though not very
3593 likely---that the API could still be modified before a final
3594 release. For example, this is the first public cairo function that
3595 accepts a Boolean parameter. I'm generally opposed to Boolean
3596 parameters, but this is probably the one case where I'm willing to
3597 accept one, (namely a "set" function that accepts a single Boolean).]
3599 Also, it is now possible to control what PostScript level to target,
3600 (either level 2 or level 3), with the following new API:
3602 typedef enum _cairo_ps_level {
3608 cairo_ps_surface_restrict_to_level (cairo_surface_t *surface,
3609 cairo_ps_level_t level);
3612 cairo_ps_get_levels (cairo_ps_level_t const **levels,
3616 cairo_ps_level_to_string (cairo_ps_level_t level);
3618 Improvement for cairo-quartz
3619 ----------------------------
3620 Brian Ewins had contributed several improvements to cairo-quartz. These
3621 include an implementation of EXTEND_NONE for linear and radial
3622 gradients, (so this extend mode will no longer trigger image fallbacks
3623 for these gradients), as well as native surface-mask clipping, (only
3624 on OS X 10.4+ where the CGContextClipToMask function is available).
3626 He also fixed a semantic mismatch between cairo and quartz for dashing
3627 with an odd number of entries in the dash array.
3629 We're grateful for Brian since not many quartz-specific improvements
3630 to cairo would be happening without him.
3634 Optimize SVG output for when the same path is both filled and stroked,
3635 and avoid unnecessary identity matrix in SVG output. (Emmanuel Pacaud).
3637 Optimize PS output to take less space (Ken Herron).
3639 Make PS output more compliant with DSC recommendations (avoid initclip
3640 and copy_page) (Adrian Johnson).
3642 Make PDF output more compact (Adrian Johnson).
3644 Release glyph surfaces after uploading them to the X server, (should
3645 save some memory for many xlib-using cairo application). (Behdad
3648 Optimize cairo-win32 to use fewer GDI objects (Vladimir Vukicevic).
3650 win32-printing: Avoid falling back to images when alpha == 255
3651 everywhere. (Adrian Johnson).
3653 win32-printing: Avoid falling back for cairo_push_group and
3654 cairo_surface_create_similar. (Adrian Johnson)
3658 Avoid potential integer overflows when allocating large buffers
3659 (Vladimir Vukicevic).
3661 Preparations to allow the 16.16 fixed-point format to change to
3662 24.8 (Vladimir Vukicevic).
3664 Fix bugs for unsupported X server visuals (rgb565, rgb555, bgr888, and
3665 abgr8888). (Carl Worth and Vladimir Vukicevic)
3667 Fix bugs in PDF gradients (Adrian Johnson).
3669 Fix cairo-xlib to build without requiring Xrender header
3670 files (Behdad Esfahbod).
3672 Make cairo more resilient in the case of glyphs not being available in
3673 the current font. (Behdad Esfahbod)
3675 Prevent crashes when both atsui and ft font backends are compiled in
3678 Make font subsetting code more robust against fonts that don't include
3679 optional tables (Adrian Johnson).
3681 Fix CFF subsetting bug, (which manifested by generating PDF files that
3682 Apple's Preview viewer could not read) (Adrian Johnson).
3684 Fixed error handling for quartz and ATSUI backends (Brian Ewins).
3686 Avoid rounding problems by pre-transforming to avoid integer-only
3687 restrictions on transformation in GDI (Adrian Johnson).
3689 Fixed an obscure bug (#7245) computing extents for some stroked
3692 Fix crashes due to extreme transformation of the pen, (seems to show
3693 up in many .swf files for some reason) (Carl Worth).
3695 Release 1.4.10 (2007-06-27 Carl Worth <cworth@cworth.org>)
3696 ==========================================================
3697 This is the fifth update in cairo's stable 1.4 series. It comes
3698 roughly three weeks after the 1.4.8 release. The most significant
3699 change in this release is a fix to avoid an X error in certain cases,
3700 (that were causing OpenOffice.org to crash in Fedora). There is also a
3701 semantic change to include child window contents when using an xlib
3702 surface as a source, an optimization when drawing many rectangles, and
3703 several minor fixes.
3705 Eliminate X errors that were killing OO.o (Chris Wilson)
3706 --------------------------------------------------------
3707 Cairo is fixed to avoid the X errors propagated when cleaning up
3708 Render Pictures after the application had already destroyed the
3709 Drawable they reference. (It would be nice if the X server wouldn't
3710 complain that some cleanup work is already done, but there you have
3711 it.) This fixes the bug causing OpenOffice.org to crash as described
3714 XError on right click menus in OOo.
3715 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=243811
3717 Use IncludeInferiors when using xlib surface as a source (Ryan Lortie)
3718 ----------------------------------------------------------------------
3719 When an xlib surface is used as the source of a draw operation the
3720 contents of child windows are now included in the source data. The
3721 semantics of drawing to xlib surfaces are unchanged (ie: draws are
3722 still clipped by child windows overlapping the destination window).
3724 Optimize drawing of many rectangles (Vladimir Vukicevic)
3725 --------------------------------------------------------
3726 Avoid O(N*N) loop when filling many axis-aligned rectangles, (either
3727 many rectangles as separate sub-paths or due to dashing).
3731 Fix cairo-perf on Solaris by linking to librt. (Behdad Esfahbod)
3733 Fix make check for systems that require executable files to have a
3734 particular extension. (Behdad Esfahbod)
3736 Eliminate some warnings in cairo-quartz. (Brian Ewins)
3738 Fix build-breaking typo for cairo-directfb. (Chris Wilson)
3740 Release 1.4.8 (2007-06-07 Carl Worth <cworth@cworth.org>)
3741 =========================================================
3742 This is the fourth update in cairo's stable 1.4 series. It comes just
3743 over five weeks after the 1.4.6 release. This release includes a
3744 thread-safe surface-cache for solid patterns which significantly
3745 improves text rendering with the xlib backend. Also, dozens of error
3746 paths in cairo have been fixed thanks to extensive fault-injection
3747 testing by Chris Wilson.
3749 Surface cache for solid patterns
3750 --------------------------------
3751 Originally written by Jorn Baayen, the introduction of a small cache
3752 for surfaces created for solid patterns improves performance
3753 dramatically. For example, this reduces the volume of X requests
3754 during text rendering to the same level as Xft.
3756 This cache first made its appearance in a 1.3.x snapshot, but was
3757 removed before appearing in any previous major release due to
3758 complications with multi-threaded programs. For example, programs like
3759 evince that would carefully restrict usage of cairo-xlib to a single
3760 thread were unpleasantly surprised to find that using cairo-image in a
3761 separate thread could trigger X requests.
3763 Behdad Esfahbod designed a fix which was implemented by Chris
3764 Wilson. Now, the necessary X requests are queued up until the next
3765 time the application directly operates on an xlib surface.
3767 Improved error handling paths
3768 ------------------------------
3769 Chris Wilson continued the excellent work he started in cairo 1.4.4 to
3770 make cairo much more robust against out-of-memory and other errors. He
3771 applied his memory allocation fault injection cairo's main test suite,
3772 (previously he had applied it to cairo's performance suite).
3774 Chris's testing found dozens of bugs which he fixed. Many of these
3775 bugs had perhaps never been hit by any users. But at least one was
3776 hit by the gnome-about program which resulted in dozens of duplicated
3777 bug reports against that program:
3779 http://bugzilla.gnome.org/show_bug.cgi?id=431990
3781 We were very pleasantly surprised to see this bug get fixed as a
3782 side-effect of Chris's work. Well done, Chris!
3786 Cleanup of mutex declarations (Behdad Esfahbod)
3788 Remove unnecessary clip region from SVG output (Emmanuel Pacaud)
3790 Remove Xsun from the buggy_repeat blacklist (Elaine Xiong)
3792 ATSUI: Fix glyph measurement: faster and more correct (Brian Ewins)
3794 Quartz: fixed 'extend' behaviour for patterns, improved pattern performance,
3795 and a few smaller correctness fixes. (Brian Ewins, Vladimir Vukicevic)
3797 Release 1.4.6 (2007-05-01 Carl Worth <cworth@cworth.org>)
3798 =========================================================
3799 This is the third update in cairo's stable 1.4 series. It comes a
3800 little less than three weeks since the 1.4.4 release. This release
3801 fixes the broken mutex initialization that made cairo 1.4.4 unusable
3802 on win32, OS/2, and BeOS systems. This release also adds significant
3803 improvements to cairo's PDF backend, (native gradients!), and a couple
3804 of performance optimizations, (one of which is very significant for
3805 users of the xlib backend). See below for more details.
3807 Repaired mutex initialization
3808 -----------------------------
3809 We apologize that cairo 1.4.4 did little more than crash on many
3810 platforms which are less-frequently used by the most regular cairo
3811 maintainers, (win32, OS/2, and BeOS). The mutex initialization
3812 problems that caused those crashes should be fixed now. And to avoid
3813 similar problems in the future, we've now started posting pre-release
3814 snapshots to get better testing, (subscribe to cairo@cairographics.org
3815 if you're interested in getting notified of those and testing them).
3819 Thanks to Adrian Johnson, (cairo PDF hacker extraordinaire), we have
3820 several improvements to cairo's PDF backend to announce:
3824 As of cairo 1.4.6, cairo will now generate native PDF gradients in
3825 many cases, (previously, the presence of a gradient on any page
3826 would force rasterized output for that page). Currently, only
3827 gradients with extend types of PAD (the default) or NONE will
3828 generate native PDF gradients---others will still trigger
3829 rasterization, (but look for support for other extend modes in a
3830 future release). Many thanks to Miklós Erdélyi as well, who did the
3831 initial work for this support.
3833 Better compatibility with PDF viewers:
3835 The PDF output from cairo should now be displayed correctly by a
3836 wider range of PDF viewers. Adrian tested cairo's PDF output against
3837 many PDF viewers, identified a common bug in many of those viewers
3838 (ignoring the CTM matrix in some cases), and modified cairo's output
3839 to avoid triggering that bugs (pre-transforming coordinates and
3840 using an identity matrix).
3842 Better OpenType/CFF subsetting:
3844 Cairo will now embed CFF and TrueType fonts as CID fonts.
3846 Performance optimizations
3847 -------------------------
3848 Faster cairo_paint_with_alpha:
3850 The cairo_paint_with_alpha call is used to apply a uniform alpha
3851 mask to a pattern. For example, it can be used to gradually fade an
3852 image out or in. Jeff Muizelaar fixed some missing/broken
3853 optimizations within the implementation of this function resulting
3854 in cairo_paint_with_alpha being up to 4 times faster when using
3855 cairo's image backend.
3857 Optimize rendering of "off-screen" geometry:
3859 Something that applications often do is to ask cairo to render
3860 things that are either partially or wholly outside the current clip
3861 region. Since 1.4.0 the image backend has been fixed to not waste
3862 too much time in this case. But other backends have still been
3865 In particular, the xlib backend has often performed quite badly in
3866 this situation. This is due to a bug in the implementation of
3867 trapezoid rasterization in many X servers.
3869 Now, in cairo 1.4.6 there is a higher-level fix for this
3870 situation. Cairo now eliminates or clips trapezoids that are wholly
3871 or partially outside the clip region before handing the trapezoids
3872 to the backend. This means that the X server's performance bug is
3873 avoided in almost all cases.
3875 The net result is that doing an extreme zoom-in of vector-based
3876 objects drawn with cairo might have previously brought the X server
3877 to its knees as it allocated buffers large enough to fit all of the
3878 geometry, (whether visible or not). But now the memory usage should
3879 be bounded and performance should be dramatically better.
3883 Behdad contributed an impressively long series of changes that
3884 organizes cairo's internals in several ways that will be very
3885 beneficial to cairo developers. Thanks, Behdad!
3887 Behdad has also provided a utility for generating malloc statistics,
3888 (which was used during the great malloc purges of 1.4.2 and
3889 1.4.4). This utility isn't specific to cairo so may be of benefit to
3890 others. It is found in cairo/util/malloc-stats.c and here are Behdad's
3895 make malloc-stats.so
3897 inside util/, and to use, run:
3899 LD_PRELOAD=malloc-stats.so some-program
3901 For binaries managed by libtool, eg, cairo-perf, do:
3903 ../libtool --mode=execute /bin/true ./cairo-perf
3904 LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf
3906 Finally, the cairo-perf-diff-files utility was enhanced to allow for
3907 generating performance reports from several runs of the same backend
3908 while some system variables were changed. For example, this is now
3909 being used to allow cairo-perf to measure the performance of various
3910 different acceleration architectures and configuration options of the
3913 Release 1.4.4 (2007-04-13 Carl Worth <cworth@cworth.org>)
3914 =========================================================
3915 This is the second update release in cairo's stable 1.4 series. It
3916 comes just less than a month after 1.4.2. The changes since 1.4.2
3917 consist primarily of bug fixes, but also include at least one
3918 optimization. See below for details.
3920 Of all the work that went into the 1.4.4 release
3922 There have been lots of individuals doing lots of great work on cairo,
3923 but two efforts during the 1.4.4 series deserve particular mention:
3925 Internal cleanup of error handling, (Chris Wilson)
3926 --------------------------------------------------
3927 Chris contributed a tremendous series of patches (74 patches!) to
3928 improve cairo's handling of out-of-memory and other errors. He began
3929 by adding gcc's warn_unused_attribute to as many functions as
3930 possible, and then launched into the ambitious efforts of adding
3931 correct code to quiet the dozens of resulting warnings.
3933 Chris also wrote a custom valgrind skin to systematically inject
3934 malloc failures into cairo, and did all the work necessary to verify
3935 that cairo's performance test suite runs to completion without
3938 The end result is a much more robust implementation. Previously, many
3939 error conditions would have gone unnoticed and would have led to
3940 assertion failures, segmentation faults, or other harder-to-diagnose
3941 problems. Now, more than ever, cairo should cleanly let the user know
3942 of problems through cairo_status and other similar status
3943 functions. Well done, Chris!
3945 More malloc reduction, (Mathias Hasselmann)
3946 -------------------------------------------
3947 After 1.4.0, Behdad launched an effort to chase down excessive calls
3948 to malloc within the implementation of cairo. He fixed a lot of
3949 malloc-happy objects for 1.4.2, but one of the worst offenders,
3950 (pixman regions), was left around. Mathias contributed an excellent
3951 series of 15 patches to finish off this effort.
3953 The end result is a cairo that calls malloc much less often than it
3954 did before. Compared to 1.4.2, 55% of the calls to malloc have been
3955 eliminate, (and 60% have been eliminated compared to 1.4.0). Well
3958 Other improvements since 1.4.2
3959 ------------------------------
3960 • Centralize mutex declarations (will reduce future build breaks),
3961 (Mathias Hasselmann)
3963 • Reduce malloc by caching recently freed pattern objects (Chris
3966 • Fix some broken composite operations (David Reveman)
3967 https://bugs.freedesktop.org/show_bug.cgi?id=5777
3969 Backend-specific fixes
3970 ----------------------
3972 • Use TJ operator for more compact representation of glyphs (Adrian
3975 • Fix glyph positioning bug when glyphs are not horizontal
3976 http://lists.freedesktop.org/archives/cairo/2007-April/010337.html
3979 • Fix crash when rendering with bitmap fonts (Carl Worth)
3980 https://bugzilla.mozilla.org/show_bug.cgi?id=376498
3983 • Turn metrics-hinting on by default (Behdad Esfahbod)
3985 • Fix edge-effect problem with transformed images drawn to xlib
3987 https://bugs.freedesktop.org/show_bug.cgi?id=10508
3989 • Avoid dereferencing a NULL screen. (Chris Wilson)
3990 https://bugs.freedesktop.org/show_bug.cgi?id=10517
3993 • Fix scaling of glyph surfaces
3995 https://bugs.freedesktop.org/show_bug.cgi?id=9568
3997 • Fix compilation failure when both xlib and quartz enabled
4000 • Fix rounding bug leading to incorrectly positioned glyphs
4002 https://bugs.freedesktop.org/show_bug.cgi?id=10531
4004 Release 1.4.2 (2007-03-19 Carl Worth <cworth@cworth.org>)
4005 =========================================================
4006 This is the first update release in cairo's stable 1.4 series. It
4007 comes just less than 2 weeks after 1.4.0. We hadn't anticipated an
4008 update this early, but we've managed to collect some important fixes
4009 that we wanted to get out to cairo users as soon as possible, (6 fixes
4010 for crashes, 1 case where graphical elements would not be drawn at
4011 all, a handful of backend-specific bugs, and several important build
4014 There's almost nothing but bug fixes in this release, (see below one
4015 optimization that Behdad did sneak in), so we recommend that everyone
4016 upgrade to this release when possible.
4018 Thanks to the many people that worked to fix these bugs, and those
4019 that did the work to report them and to test the fixes, (wherever
4020 possible both names are credited below).
4024 • Fix a crash due to a LOCK vs. UNLOCK typo (M. Drochner fixing Carl
4025 Worth's embarrassing typo).
4027 http://bugs.freedesktop.org/show_bug.cgi?id=10235
4029 • Fix potential buffer overflow, which on some systems with a checking
4030 variant of snprintf would lead to a crash (Adrian Johnson, Stanislav
4033 https://bugs.freedesktop.org/show_bug.cgi?id=10267
4034 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=232576
4036 • Fix a crash in cairo_stroke_extents or cairo_in_stroke when line
4037 width is 0.0. (Carl Worth and Sebastien Bacher)
4039 https://bugs.freedesktop.org/show_bug.cgi?id=10231
4041 • Fix a crash on certain combinations of X server/video drivers (Carl
4042 Worth and Tomas Carnecky).
4044 https://bugs.freedesktop.org/show_bug.cgi?id=10250
4046 • Fix a crash due to mishandling of invalid user input (Carl Worth and
4047 Alexander Darovsky).
4049 https://bugs.freedesktop.org/show_bug.cgi?id=9844
4051 • xlib: Cleanup server-side glyph caches on XCloseDisplay. This
4052 eliminated a crash detected by the perf suite, (and that
4053 applications could have run into as well). (Chris Wilson)
4057 • Fix for some geometry which simply disappeared under some
4058 transformations---a stroked line with an extreme skew in X, for
4059 example (Carl Worth and Jonathan Watt).
4061 https://bugzilla.mozilla.org/show_bug.cgi?id=373632
4063 • SVG: Fix radial gradients for CAIRO_EXTEND_REFLECT and when r0 > r1
4066 • PDF: Set page group color space to DeviceRGB.
4068 This fixes incorrect (muddy) transparent colors when rendering cairo
4069 PDF output in some viewers. (Adrian Johnson, Adam Goode, and
4072 http://lists.freedesktop.org/archives/cairo/2006-November/008551.html
4074 • win32: Return correct metrics when hinting is off, and fix font
4075 descent computation (Behdad Esfahbod).
4077 • quartz: Fix glyph interfaces to correctly return user-space rather
4078 than device-space coordinates (Brian Ewins).
4080 https://bugs.freedesktop.org/show_bug.cgi?id=9568
4082 • xcb: Fix parameter-order confusion with xcb_create_pixmap, which now
4083 makes all tests that pass with xlib now pass with xcb (Carl Worth,
4086 • Fix some memory leaks in the perf suite (Chris Wilson).
4088 • Fix perf suite to consider changes in pixman/src (Mathias
4093 • Don't include pre-generated cairo-features.h file. This was causing
4094 build failures when building with the directfb backend enabled
4097 https://bugs.freedesktop.org/show_bug.cgi?id=10189
4099 • Eliminate use of maintainer mode from cairo's automake/configure
4100 script. This means that updates to files such as Makefile.am will
4101 take effect, (by rerunning automake and friends as necessary) when
4102 invoking make rather than being silently ignored. (Behdad Esfahbod)
4104 • Don't compile cairo-deflate-stream.c, which depends on zlib, unless
4105 building the pdf backend which requires it. (Carl Worth, Tor
4108 https://bugs.freedesktop.org/show_bug.cgi?id=10202
4110 • Don't make the ps backend link against zlib anymore, since it
4111 doesn't require it (Carl Worth).
4113 • Use "find !" rather than "find -not" for better portability (Thomas
4116 https://bugs.freedesktop.org/show_bug.cgi?id=10226
4118 • Don't use unsupported visibility attribute "hidden" on Solaris
4119 (Gilles Dauphin, Thomas Klausner).
4121 https://bugs.freedesktop.org/show_bug.cgi?id=10227
4125 • It was Behdad that suggested we focus strictly on bug fixes now that
4126 we shipped so many performance improvements in 1.4.0, but it was
4127 also Behdad that got distracted by the chance to remove a lot of
4128 mallocs from cairo. Paths, gstates, trapezoids, splines, polygons,
4129 and gradient color stops will now use small, stack-allocated buffers
4130 in the most common cases rather than calling malloc as
4131 often. (Behdad Esfahbod). And look for more from Mathias Hasselmann
4134 Release 1.4.0 (2007-03-06 Carl Worth <cworth@cworth.org>)
4135 =========================================================
4136 The many people[*] who have been working hard on cairo are very
4137 pleased to announce the long-awaited release of cairo 1.4. This
4138 release comes 4 months after the last stable update release (1.2.6)
4139 and 9 months since the initial release of 1.2.0.
4141 The release notes below are intended to capture the highlights of the
4142 changes that have occurred from the 1.2 series to the new 1.4.0
4145 Performance improvements
4146 ------------------------
4147 Within the cairo project, the last 6 months or so has seen an intense
4148 effort focusing on the performance of cairo itself. That effort has
4149 paid off considerably, as can be seen in the following highlights of
4150 some of the performance differences from cairo 1.2.6 to cairo 1.4.0.
4152 (Note: The performance results reported here were measured on an x86
4153 laptop. Many of the improvements in 1.4---particular those involving
4154 text rendering---are even more dramatic on embedded platforms without
4155 hardware floating-point units. Such devices played an important part
4156 of many of the optimizations that found their way into cairo over the
4159 • Dramatic improvement when drawing objects that are mostly off-screen
4160 with the image backend (with the xlib backend this case is still
4161 slow due to an X server bug):
4163 image-rgba long-lines-uncropped-100 479.64 -> 4.98: 96.24x speedup
4164 ███████████████████████████████████████████████▋
4166 • Dramatic improvement when copying a small fraction of an image
4167 surface to an xlib surface:
4169 xlib-rgba subimage_copy-512 3.93 -> 0.07: 54.52x speedup
4170 ██████████████████████████▊
4172 • Dramatic improvement to tessellation speed for complex objects:
4174 image-rgb tessellate-256-100 874.16 -> 34.79: 25.13x speedup
4176 xlib-rgba zrusin_another_fill-415 148.40 -> 13.85: 10.72x speedup
4178 xlib-rgb world_map-800 680.20 -> 345.54: 1.97x speedup
4181 • Dramatic improvement to the speed of stroking rectilinear shapes,
4182 (such as the outline of a rectangle or "box"):
4184 image-rgb box-outline-stroke-100 0.18 -> 0.01: 24.22x speedup
4186 xlib-rgb box-outline-stroke-100 0.46 -> 0.06: 8.05x speedup
4190 • Dramatic improvements to text rendering speeds:
4192 xlib-rgba text_image_rgba_over-256 63.12 -> 9.61: 6.57x speedup
4195 • 3x improvements to floating-point to fixed-point conversion speeds:
4197 image-rgba pattern_create_radial-16 9.29 -> 3.44: 2.70x speedup
4200 • 2x improvements to linear gradient computation:
4202 image-rgb paint_linear_rgb_source-512 26.22 -> 11.61: 2.26x speedup
4205 • 2x improvement to a case common in PDF rendering:
4207 image-rgb unaligned_clip-100 0.10 -> 0.06: 1.81x speedup
4210 • 1.3x improvement to rectangle filling speed (note: this improvement
4211 is new since 1.3.16---previously this test case was a 1.3x slowdown
4214 image-rgba rectangles-512 6.19 -> 4.37: 1.42x speedup
4216 xlib-rgba rectangles-512 7.48 -> 5.58: 1.34x speedup
4219 NOTE: In spite of our best efforts, there are some measurable
4220 performance regressions in 1.4 compared to 1.2. It appears that the
4221 primary problem is the increased overhead of the new tessellator when
4222 drawing many, very simple shapes. The following test cases capture
4223 some of that slowdown:
4225 image-rgba mosaic_tessellate_lines-800 11.03 -> 14.29: 1.30x slowdown
4227 image-rgba box-outline-fill-100 0.01 -> 0.01: 1.26x slowdown
4229 image-rgba fill_solid_rgb_over-64 0.20 -> 0.22: 1.12x slowdown
4231 image-rgba fill_image_rgba_over-64 0.23 -> 0.25: 1.10x slowdown
4233 xlib-rgb paint_image_rgba_source-256 3.24 -> 3.47: 1.07x slowdown
4235 We did put some special effort into eliminating this slowdown for the
4236 very common case of drawing axis-aligned rectangles with an identity
4237 matrix (see the box-outline-stroke and rectangles speedup numbers
4238 above). Eliminating the rest of this slowdown will be a worthwhile
4239 project going forward.
4241 Also note that the "box-outline-fill" case is a slowdown while
4242 "box-outline-stroke" is a (huge) speedup. These two test cases
4243 resulted from the fact that some GTK+ theme authors were filling
4244 between two rectangles to avoid slow performance from the more natural
4245 means of achieving the same shape by stroking a single rectangle. With
4246 1.4 that workaround should definitely be eliminated as it will now
4247 cause things to perform more slowly.
4249 Greatly improved PDF output
4250 ---------------------------
4251 We are very happy to be able to announce that cairo-generated PDF
4252 output will now have text that can be selected, cut-and-pasted, and
4253 searched with most capable PDF viewer applications. This is something
4254 that was not ever possible with cairo 1.2.
4256 Also, the PDF output now has much more compact encoding of text than
4257 before. Cairo is now much more careful to not embed multiple copies of
4258 the same font at different sizes. It also compresses text and font
4259 streams within the PDF output.
4263 There are several new functions available in 1.4 that were not
4264 available in 1.2. Curiously, almost all of the new functions simply
4265 allow the user to query state that has been set in cairo (many new
4266 "get" functions) rather than providing any fundamentally new
4267 operations. The new functionality is:
4269 • Getting information about the current clip region
4272 cairo_copy_clip_rectangle_list
4273 cairo_rectangle_list_destroy
4275 • Getting information about the current dash setting
4277 cairo_get_dash_count
4280 • Getting information from a pattern
4282 cairo_pattern_get_rgba
4283 cairo_pattern_get_surface
4284 cairo_pattern_get_color_stop_rgba
4285 cairo_pattern_get_color_stop_count
4286 cairo_pattern_get_linear_points
4287 cairo_pattern_get_radial_circles
4289 • Getting the current scaled font
4291 cairo_get_scaled_font
4293 • Getting reference counts
4295 cairo_get_reference_count
4296 cairo_surface_get_reference_count
4297 cairo_pattern_get_reference_count
4298 cairo_font_face_get_reference_count
4299 cairo_scaled_font_get_reference_count
4301 • Setting/getting user data on objects
4305 cairo_pattern_set_user_data
4306 cairo_pattern_get_user_data
4307 cairo_scaled_font_set_user_data
4308 cairo_scaled_font_get_user_data
4310 • New cairo-win32 functions:
4312 cairo_win32_surface_create_with_ddb
4313 cairo_win32_surface_get_image
4314 cairo_win32_scaled_font_get_logical_to_device
4315 cairo_win32_scaled_font_get_device_to_logical
4319 The CAIRO_FORMAT_RGB16_565 enum value has been deprecated. It never
4320 worked as a format value for cairo_image_surface_create, and it wasn't
4321 necessary for supporting 16-bit 565 X server visuals.
4323 A sampling of bug fixes in cairo 1.4
4324 ------------------------------------
4325 • Fixed radial gradients
4326 • Fixed dashing (degenerate and "leaky" cases)
4327 • Fixed transformed images in PDF/PS output (eliminate bogus repeating)
4328 • Eliminate errors from CAIRO_EXTEND_REFLECT and CAIRO_EXTEND_PAD
4329 • cairo_show_page no longer needed for single-page output
4330 • SVG: Fix bug preventing text from appearing in many viewers
4331 • cairo-ft: Return correct metrics when hinting is off
4332 • Eliminate crash in cairo_create_similar if nil surface is returned
4333 • Eliminate crash after INVALID_RESTORE error
4334 • Fix many bugs related to multi-threaded use and locking
4335 • Fix for glyph spacing 32 times larger than desired (cairo-win32)
4336 • Fixed several problems in cairo-atsui (assertion failures)
4337 • Fix PDF output to avoid problems when printing from Acrobat Reader
4338 • Fix segfault on Mac OS X (measuring a zero-length string)
4339 • Fix text extents to not include the size of non-inked characters
4340 • Fix for glyph cache race condition in glitz backend (Jinghua Luo)
4341 • Fix make check to work on OPD platforms (IA64 or PPC64)
4342 • Fix compilation problems of cairo "wideint" code on some platforms
4343 • Many, many others...
4345 Experimental backends (quartz, XCB, OS/2, BeOS, directfb)
4346 ---------------------------------------------------------
4347 None of cairo's experimental backends are graduating to "supported"
4348 status with 1.4.0, but two of them in particular (quartz and xcb), are
4351 The quartz baceknd has been entirely rewritten and is now much more
4352 efficient. The XCB backend has been updated to track the latest XCB
4353 API (which recently had a 1.0 release).
4355 We hope to see these backends become supported in a future release,
4356 (once they are passing all the tests in cairo's test suite).
4358 The experimental OS/2 backend is new in cairo 1.4 compared to cairo
4361 Documentation improvements
4362 --------------------------
4363 We have added documentation for several functions and types that
4364 were previously undocumented, and improved documentation on other
4365 ones. As of this release, there remain only two undocumented
4366 symbols: cairo_filter_t and cairo_operator_t.
4368 [*]Thanks to everyone
4369 ---------------------
4370 I've accounted for 41 distinct people with attributed code added to
4371 cairo between 1.2.6 and 1.4.0, (their names are below). That's an
4372 impressive number, but there are certainly dozens more that
4373 contributed with testing, suggestions, clarifying questions, and
4374 encouragement. I'm grateful for the friendships that have developed as
4375 we have worked on cairo together. Thanks to everyone for making this
4378 Adrian Johnson, Alfred Peng, Alp Toker, Behdad Esfahbod,
4379 Benjamin Otte, Brian Ewins, Carl Worth, Christian Biesinger,
4380 Christopher (Monty) Montgomery, Daniel Amelang, Dan Williams,
4381 Dave Yeo, David Turner, Emmanuel Pacaud, Eugeniy Meshcheryakov,
4382 Frederic Crozat, Hans Breuer, Ian Osgood, Jamey Sharp, Jeff Muizelaar,
4383 Jeff Smith, Jinghua Luo, Jonathan Watt, Joonas Pihlaja, Jorn Baayen,
4384 Kalle Vahlman, Kjartan Maraas, Kristian Høgsberg, M Joonas Pihlaja,
4385 Mathias Hasselmann, Mathieu Lacage, Michael Emmel, Nicholas Miell,
4386 Pavel Roskin, Peter Weilbacher, Robert O'Callahan,
4387 Soren Sandmann Pedersen, Stuart Parmenter, T Rowley,
4390 Snapshot 1.3.16 (2007-03-02 Carl Worth <cworth@cworth.org>)
4391 ===========================================================
4394 A few new public functions have been added to the cairo API since the
4395 1.3.14 snapshot. These include a function to query the current scaled
4398 cairo_get_scaled_font
4400 New functions to query the reference count of all cairo objects:
4402 cairo_get_reference_count
4404 cairo_surface_get_reference_count
4405 cairo_pattern_get_reference_count
4407 cairo_font_face_get_reference_count
4408 cairo_scaled_font_get_reference_count
4410 And new functions to allow the use of user_data with any cairo object,
4411 (previously these were only available on cairo_surface_t and
4412 cairo_font_face_t objects):
4417 cairo_pattern_set_user_data
4418 cairo_pattern_get_user_data
4420 cairo_scaled_font_set_user_data
4421 cairo_scaled_font_get_user_data
4423 Usability improvement for PDF/PS/SVG generation
4424 -----------------------------------------------
4425 In previous versions of cairo, generating single-page output with the
4426 cairo-pdf, cairo-ps, or cairo-svg backends required a final call to
4427 cairo_show_page. This was often quite confusing as people would port
4428 functional code from a non-paginated backend and be totally mystified
4429 as to why the output was blank until they learned to add this call.
4431 Now that call to cairo_show_page is optional, (it will be generated
4432 implicitly if the user does not call it). So cairo_show_page is only
4433 needed to explicitly separate multiple pages.
4435 Greatly improved PDF output
4436 ---------------------------
4437 We are very happy to be able to announce that cairo-generated PDF
4438 output will now have text that can be selected, cut-and-paste, and
4439 searched with most capable PDF viewer applications. This is something
4440 that was not ever possible with cairo 1.2.
4442 Also, the PDF output now has much more compact encoding of text than
4443 before. Cairo is now much more careful to not embed multiple copies of
4444 the same font at different sizes. It also compresses text and font
4445 streams within the PDF output.
4449 • Fixed radial gradients
4451 The rendering of radial gradients has been greatly improved. In
4452 the cairo 1.2 series, there was a serious regression affecting
4453 radial gradients---results would be very incorrect unless one of
4454 the gradient circles had a radius of 0.0 and a center point within
4455 the other circle. These bugs have now been fixed.
4459 Several fixes have been made to the implementation of dashed
4460 stroking. Previously, some dashed, stroked rectangles would
4461 mis-render and fill half of the rectangle with a large triangular
4462 shape. This bug has now been fixed.
4464 • Fixed transformed images in PDF/PS output
4466 In previous versions of cairo, painting with an image-based source
4467 surface pattern to the PDF or PS backends would cause many kinds
4468 of incorrect results. One of the most common problems was that an
4469 image would be repeated many times even when the user had
4470 explicitly requested no repetition with CAIRO_EXTEND_NONE. These
4471 bugs have now been fixed.
4473 • Eliminate errors from CAIRO_EXTEND_REFLECT and CAIRO_EXTEND_PAD
4475 In the 1.2 version of cairo any use of CAIRO_EXTEND_REFLECT or
4476 CAIRO_EXTEND_PAD with a surface-based pattern resulted in an
4477 error, (cairo would stop rendering). This bug has now been
4480 Now, CAIRO_EXTEND_REFLECT should work properly with surface
4483 CAIRO_EXTEND_PAD is still not working correctly, but it will now
4484 simply behave as CAIRO_EXTEND_NONE rather than triggering the
4487 New rewrite of quartz backend (still experimental)
4488 --------------------------------------------------
4489 Cairo's quartz backend has been entirely rewritten and is now much
4490 more efficient. This backend is still marked as experimental, not
4491 supported, but it is now much closer to becoming an officially
4492 supported backend. (For people that used the experimental nquartz
4493 backend in previous snapshots, that implementation has now been
4494 renamed from "nquartz" to "quartz" and has replaced the old quartz
4497 Documentation improvements
4498 --------------------------
4499 We have added documentation for several functions and types that
4500 were previously undocumented, and improved documentation on other
4501 ones. As of this release, there remain only two undocumented
4502 symbols: cairo_filter_t and cairo_operator_t.
4506 • cairo-svg: Fix bug that was preventing text from appearing in many
4509 • cairo-ft: Return correct metrics when hinting is off
4511 • Cairo 1.3.14 deadlocks in cairo_scaled_font_glyph_extents or
4512 _cairo_ft_unscaled_font_lock_face
4514 https://bugs.freedesktop.org/show_bug.cgi?id=10035
4516 • cairo crashes in cairo_create_similar if nil surface returned by
4517 other->backend->create_similar
4519 https://bugs.freedesktop.org/show_bug.cgi?id=9844
4521 • evolution crash in _cairo_gstate_backend_to_user()
4522 https://bugs.freedesktop.org/show_bug.cgi?id=9906
4524 • Fix memory leak in rectilinear stroking code
4526 Things not in this release
4527 --------------------------
4528 • Solid-surface-pattern cache: This patch had been applied during
4529 the 1.3.x series, but it was reverted due to some inter-thread
4530 problems it caused. The patch is interesting since it made a big
4531 benefit for text rendering performance---so we'll work to bring a
4532 corrected version of this patch back as soon as possible.
4534 Snapshot 1.3.14 (2006-02-13 Carl Worth <cworth@cworth.org>)
4535 ===========================================================
4536 This is the seventh development snapshot in the 1.3 series, (and there
4537 likely won't be many more before the 1.4.0 release). It comes just
4538 over 3 weeks after the 1.3.12 snapshot.
4540 Since we're so close to the 1.4.0 release, there are not a lot of new
4541 features nor even a lot of new performance improvements in this
4542 snapshot. Instead, there are a great number of bug fixes. Some are
4543 long-standing bugs that we're glad to say goodbye to, and several are
4544 fixes for regressions that were introduced as part of the optimization
4545 efforts during the 1.3.x series.
4547 PDF text selection fixed
4548 ------------------------
4549 The inability to correctly select text in cairo-generated PDF has been
4550 a defect ever since the initial support for the PDF backend in the
4551 cairo 1.2.0 release. With the 1.3.14 snapshot, in most situations, and
4552 with most PDF viewer applications, the PDF generated by cairo will
4553 allow text to be correctly selected for copy-and-paste, (as well as
4556 We're very excited about this new functionality, (and very grateful to
4557 Adrian Johnson, Behdad Esfahbod, and others that have put a lot of
4558 work into this lately). Please test this new ability and give feedback
4559 on the cairo@cairographics.org list.
4561 Many thread-safety issues fixed
4562 -------------------------------
4563 We've discovered that no release of cairo has ever provided safe text
4564 rendering from a multi-threaded application. With the 1.3.14 snapshot
4565 a huge number of the bugs in this area have been fixed, and multiple
4566 application dvelopers have now reported success at writing
4567 multi-threaded applications with cairo.
4571 Fixed a bug that was causing glyph spacing to be 32 times larger than
4572 desired when using cairo-win32.
4574 Fixed a regression in the rendering of linear gradients that had been
4575 present since the 1.3.8 snapshot.
4577 Fixed several problems in cairo-atsui that were leading to assertion
4578 failures when rendering text.
4580 Fix corrupted results when rendering a transformed source image
4581 surface to an xlib surface. This was a regression that had been
4582 present since the 1.3.2 snapshot.
4584 Fixed PDF output to prevent problems printing from some versions of
4585 Acrobat Reader, (a single glyph was being substituted for every
4588 And many other fixes as well, (see the logs for details).
4590 Snapshot 1.3.12 (2007-01-20 Carl Worth <cworth@cworth.org>)
4591 ===========================================================
4592 The relentless march toward the cairo 1.4 release continues, (even if
4593 slightly late out of the starting blocks in 2007). This is the sixth
4594 development snapshot in the 1.3 series. It comes 4 weeks after the
4599 As usual, this snapshot has some fun performance improvements to show
4602 image-rgba long-lines-uncropped-100 470.08 -> 4.95: 94.91x speedup
4603 ███████████████████████████████████████████████
4604 image-rgb long-lines-uncropped-100 461.60 -> 4.96: 93.02x speedup
4605 ██████████████████████████████████████████████
4607 This 100x improvement, (and yes, that's 100x, not 100%), in the image
4608 backend occurs when drawing large shapes where only a fraction of the
4609 shape actually appears in the final result, (the rest being outside
4610 the bounds of the destination surface). Many applications should see
4611 speedups here, and the actual amount of speedup depends on the ratio
4612 of non-visible to visible portions of geometry.
4614 [Note: There remains a similar performance bug when drawing mostly
4615 non-visible objects with the xlib backend. This is due to a similar
4616 bug in the X server itself, but we hope a future cairo snapshot will
4617 workaround that bug to get a similar speedup with the xlib backend.]
4619 image-rgba unaligned_clip-100 0.09 -> 0.06: 1.67x speedup
4621 image-rgb unaligned_clip-100 0.09 -> 0.06: 1.66x speedup
4624 This speedup is due to further MMX optimization by Soeren Sandmann for
4625 a case commonly hit when rendering PDF files, (and thanks to Jeff
4626 Muizelaar for writing code to extract the test case for us).
4628 There's another MMX optimization in this snapshot (without a fancy
4629 speedup chart) by Dan Williams which improves compositing performance
4630 specifically for the OLPC machine.
4632 Thanks to Adrian Johnson, cairo's PDF output is now much more
4633 efficient in the way it encodes text output. By reducing redundant
4634 information and adding compression to text output streams, Adrian
4635 achieved a ~25x improvement in the efficiency of encoding text in PDF
4636 files, (was ~45 bytes per glyph and is now ~1.6 bytes per glyph).
4640 In addition to those performance improvements, this snapshot includes
4643 * A huge number of bug fixes for cairo-atsui text rendering, (for mac
4644 OS X). These bugs affect font selection, glyph positioning, glyph
4645 rendering, etc. One noteworthy bug fixes is that
4646 cairo_select_font_face will no longer arbitrarily select bold nor
4647 italic when not requested, (at least not when using a standard CSS2
4648 font family name such as "serif", "sans-serif", "monospace", etc.).
4649 All these fixes are thanks to Brian Ewins who continues to do a
4650 great job as the new cairo-atsui maintainer.
4652 * Fix PDF output so that images that are scaled down no longer
4653 mysteriously repeat (Carl Worth).
4655 * Fix segfault on Mac OS X dues to attempt to measure extents of a
4656 zero-length string (Behdad Esfahbod).
4658 * Fix text extents to not include the size of initial/trailing
4659 non-inked characters (Behdad Esfahbod).
4663 Three functions have had API changes to improve consistency. Note that
4664 the API functions being changed here are all functions that were
4665 introduced as new functions during these 1.3.x snapshots. As always,
4666 there will not be any API changes to functions included in a major
4667 release (1.2.x, 1.4.x, etc.) of cairo.
4669 The changes are as follows:
4671 * Rename of cairo_copy_clip_rectangles to cairo_copy_clip_rectangle_list.
4673 * Change cairo_get_dash_count to return an int rather than accepting a
4674 pointer to an int for the return value.
4676 * Change cairo_get_dash to have a void return type rather than
4677 returning cairo_status_t.
4679 It's possible there will be one more round of changes to these
4680 functions, (and perhaps cairo_get_color_stop as well), as we seek to
4681 establish a unifying convention for returning lists of values.
4683 Snapshot 1.3.10 (2006-12-23 Carl Worth <cworth@cworth.org>)
4684 ===========================================================
4685 Santa Claus is coming just a little bit early this year, and he's
4686 bringing a shiny new cairo snapshot for all the good little boys and
4689 This is the fifth development snapshot in the 1.3 series. It comes 9
4690 days after the 1.3.8 snapshot, and still well within our goal of
4691 having a new snapshot every week, (though don't expect one next
4692 week---we'll all be too stuffed with sugar plums).
4694 Speaking of sugar plums, there's a sweet treat waiting in this cairo
4695 snapshot---greatly improved performance for stroking rectilinear
4696 shapes, like the ever common rectangle:
4698 image-rgb box-outline-stroke-100 0.18 -> 0.01: 25.58x speedup
4699 ████████████████████████▋
4700 image-rgba box-outline-stroke-100 0.18 -> 0.01: 25.57x speedup
4701 ████████████████████████▋
4702 xlib-rgb box-outline-stroke-100 0.49 -> 0.06: 8.67x speedup
4704 xlib-rgba box-outline-stroke-100 0.22 -> 0.04: 5.39x speedup
4707 In past releases of cairo, some people had noticed that using
4708 cairo_stroke to draw rectilinear shapes could be awfully slow. Many
4709 people had worked around this by using cairo_fill with a more complex
4710 path and gotten a 5-15x performance benefit from that.
4712 If you're one of those people, please rip that workaround out, as now
4713 the more natural use of cairo_stroke should be 1.2-2x faster than the
4714 unnatural use of cairo_fill.
4716 And if you hadn't ever implemented that workaround, then you just
4717 might get to see your stroked rectangles now get drawn 5-25x faster.
4719 Beyond that performance fix, there are a handful of bug fixes in this
4722 * Fix for glyph cache race condition in glitz backend (Jinghua Luo)
4724 * Many fixes for ATSUI text rendering (Brian Ewins)
4726 * Un-break recent optimization-triggered regression in rendering text
4727 with a translation in the font matrix (Behdad Esfahbod)
4729 * Fix make check to work on OPD platforms (IA64 or PPC64)
4732 * Fix a couple of character spacing issues on Windows
4735 Have fun with that, everybody, and we'll be back for more in the new
4736 year, (with a plan to add the last of our performance improvements in
4737 this round, fix a few bad, lingering bugs, and then finish off a nice,
4738 stable 1.4 release before the end of January).
4742 Snapshot 1.3.8 (2006-12-14 Carl Worth <cworth@cworth.org>)
4743 ==========================================================
4744 This is the fourth development snapshot in the 1.3 series. It comes
4745 just slightly more than one week after the 1.3.6 snapshot.
4747 After the bug fixes in 1.3.6, we're back to our original program of
4748 weekly snapshots, each one faster than the one from the week
4749 before. Cairo 1.3.8 brings a 2x improvement in the speed of rendering
4750 linear gradients (thanks to David Turner), and a significant reduction
4751 in X traffic when rendering text (thanks to Xan Lopez and Behdad
4752 Esfahbod), making cairo behave very much like Xft does.
4754 A few other things in the 1.3.8 snapshot worth noting include a more
4755 forgiving image comparator in the test suite, (using the "perceptual
4756 diff" metric and GPL implementation by Hector Yee[*]), a bug fix for
4757 broken linking on x86_64 (thanks to M Joonas Pihlaja) and an even
4758 better implementation of _cairo_lround, (not faster, but supporting a
4759 more complete input range), from Daniel Amelang.
4761 [*] http://pdiff.sourceforge.net/
4763 Snapshot 1.3.6 (2006-12-06 Carl Worth <cworth@cworth.org>)
4764 ==========================================================
4765 This is the third development snapshot in the 1.3 series. It comes two
4766 weeks after the 1.3.4 snapshot.
4768 We don't have fancy performance charts this week as the primary
4769 changes in this snapshot are bug fixes. The performance work continues
4770 and the next snapshot (planned for one week from today) should include
4771 several improvements. The bug fixes in this snapshot include:
4773 * Fix undesirable rounding in glyph positioning (Dan Amelang)
4775 This bug was noticed by several users, most commonly by seeing
4776 improper text spacing or scrambled glyphs as drawn by nautilus. For
4779 Update to cairo-1.3.4 worsen font rendering
4780 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=217819
4782 * Fix reduced range of valid input coordinates to tessellator
4785 This bug was causing lots of assertion failures in mozilla as
4788 CAIRO_BO_GUARD_BITS and coordinate space?
4789 http://lists.freedesktop.org/archives/cairo/2006-December/008743.html
4791 * Fix several regressions in new tessellator (M Joonas Pihlaja)
4793 Joonas just had a good eye for detail here. I don't think any
4794 external cairo users had noticed any of these bugs yet.
4796 * Fix compilation problems of cairo "wideint" code on some platforms
4799 * Fix failed configure due to broken grep (Dan Amelang)
4801 This bug was reported here:
4803 AX_C_FLOAT_WORDS_BIGENDIAN doesn't work because grep doesn't
4804 work with binary file
4805 https://bugs.freedesktop.org/show_bug.cgi?id=9124
4807 * Remove the pkg-config minimum version requirement (Behdad Esfahbod)
4809 Some systems ship with pkg-config 0.15 and there was really no good
4810 reason for cairo to insist on having version 0.19 before it would
4813 There is also one new (but inert) feature in this snapshot. There's a
4814 new option that can be passed to cairo's configure script:
4816 --disable-some-floating-point
4818 Disable certain code paths that rely heavily on double precision
4819 floating-point calculation. This option can improve
4820 performance on systems without a double precision floating-point
4821 unit, but might degrade performance on those that do.
4823 As of this snapshot, this option does not make any change to cairo,
4824 but it is possible that future versions of cairo will respect this
4825 option and change the implementation of various functions as
4828 Snapshot 1.3.4 (2006-11-22 Carl Worth <cworth@cworth.org>)
4829 ==========================================================
4830 This is the second development snapshot in the 1.3 series. It comes
4831 one week after the 1.3.2 snapshot.
4833 This snapshot has a couple of significant performance improvements,
4834 and also adds new support for producing multi-page SVG output, (when
4835 targeting SVG 1.2)---thanks to Emmanuel Pacaud. The details of the
4836 performance improvements are as follows:
4838 1. The long-awaited "new tessellator".
4840 The credit for this being an improvement goes to Joonas Pihlaja. He
4841 took my really slow code and really put it through its paces to get
4842 the dramatic performance improvement seen below (up to 38x faster
4843 on realistic cases, and more than 10x faster for the zrusin_another
4846 His own writeup of the work he did is quite thorough, but more than
4847 can be quoted here. Please see his post for the interesting details:
4849 http://lists.freedesktop.org/archives/cairo/2006-November/008483.html
4851 (Though note that this snapshot also includes some additional,
4852 significant improvements that were only sketched out in that
4853 email---see "Generating fewer trapezoids").
4855 2. More floating-point improvements
4857 Daniel Amelang continues to work the magic he began in the 1.3.2
4858 snapshot. This time he short-circuits floating-point
4859 transformations by identity matrices and applies the earlier
4860 floating-to-fixed-point technique to the problem of rounding.
4862 The improvements here will primarily benefit text performance, and
4863 will benefit platforms without hardware floating-point more than
4864 those that have it, (some text tests show 20% improvement on an x86
4865 machine and closer to 80% improvement on arm).
4867 The performance chart comparing 1.3.2 to 1.3.4 really speaks for
4868 itself, (this is on an x86 laptop). This is quite a lot of progress
4871 xlib-rgb stroke_similar_rgba_over-256 74.99 1.45% -> 2.03 68.38%: 36.86x speedup
4872 ███████████████████████████████████▉
4873 xlib-rgb stroke_similar_rgba_source-256 78.23 1.43% -> 3.30 67.05%: 23.71x speedup
4874 ██████████████████████▊
4875 xlib-rgba tessellate-256-100 820.42 0.15% -> 35.06 2.84%: 23.40x speedup
4876 ██████████████████████▍
4877 image-rgba tessellate-256-100 819.55 0.32% -> 35.04 3.56%: 23.39x speedup
4878 ██████████████████████▍
4879 xlib-rgb stroke_image_rgba_over-256 78.10 1.43% -> 4.33 65.56%: 18.04x speedup
4881 xlib-rgb stroke_image_rgba_source-256 80.11 1.63% -> 5.75 63.99%: 13.94x speedup
4883 xlib-rgba zrusin_another_tessellate-415 89.22 0.35% -> 8.38 5.23%: 10.65x speedup
4885 image-rgba zrusin_another_tessellate-415 87.38 0.89% -> 8.37 5.22%: 10.44x speedup
4887 image-rgba zrusin_another_fill-415 117.67 1.34% -> 12.88 2.77%: 9.14x speedup
4889 xlib-rgba zrusin_another_fill-415 140.52 1.57% -> 15.79 2.88%: 8.90x speedup
4891 image-rgba tessellate-64-100 9.68 3.42% -> 1.42 0.60%: 6.82x speedup
4893 xlib-rgba tessellate-64-100 9.78 4.35% -> 1.45 0.83%: 6.72x speedup
4895 xlib-rgb stroke_linear_rgba_over-256 46.01 2.44% -> 7.74 54.51%: 5.94x speedup
4897 xlib-rgb stroke_linear_rgba_source-256 48.09 2.15% -> 9.14 53.00%: 5.26x speedup
4899 xlib-rgb stroke_radial_rgba_over-256 50.96 2.34% -> 12.46 47.99%: 4.09x speedup
4901 xlib-rgb stroke_radial_rgba_source-256 53.06 1.57% -> 13.96 46.57%: 3.80x speedup
4903 image-rgba paint_similar_rgba_source-256 0.12 1.57% -> 0.08 9.92%: 1.42x speedup
4905 image-rgba paint_image_rgba_source-256 0.12 2.49% -> 0.08 10.70%: 1.41x speedup
4907 image-rgba world_map-800 356.28 0.46% -> 275.72 1.15%: 1.29x speedup
4909 xlib-rgba world_map-800 456.81 0.39% -> 357.95 1.39%: 1.28x speedup
4911 image-rgb tessellate-16-100 0.09 0.57% -> 0.07 3.43%: 1.23x speedup
4913 image-rgba tessellate-16-100 0.09 0.06% -> 0.07 2.46%: 1.23x speedup
4915 image-rgba text_solid_rgb_over-256 5.39 4.01% -> 4.47 0.70%: 1.21x speedup
4917 image-rgba text_solid_rgba_over-256 5.37 0.82% -> 4.45 0.75%: 1.21x speedup
4919 image-rgba text_image_rgb_over-64 0.78 0.10% -> 0.65 0.74%: 1.20x speedup
4921 image-rgba text_image_rgba_over-64 0.78 0.29% -> 0.65 0.68%: 1.19x speedup
4923 image-rgb text_solid_rgb_over-64 0.76 2.45% -> 0.63 0.81%: 1.19x speedup
4925 image-rgba text_solid_rgba_over-64 0.76 0.33% -> 0.64 0.66%: 1.19x speedup
4927 image-rgba text_similar_rgba_over-256 5.99 4.72% -> 5.04 1.09%: 1.19x speedup
4930 We should point out that there is some potential for slowdown in this
4931 snapshot. The following are the worst slowdowns reported by the cairo
4932 performance suite when comparing 1.3.2 to 1.3.4:
4934 image-rgba subimage_copy-256 0.01 0.87% -> 0.01 3.61%: 1.45x slowdown
4936 xlib-rgb paint_solid_rgb_over-256 0.31 10.23% -> 0.38 0.33%: 1.26x slowdown
4938 image-rgba box-outline-fill-100 0.01 0.30% -> 0.01 2.52%: 1.21x slowdown
4940 image-rgba fill_solid_rgb_over-64 0.20 1.22% -> 0.22 1.59%: 1.12x slowdown
4942 image-rgb fill_similar_rgb_over-64 0.21 1.04% -> 0.24 1.06%: 1.11x slowdown
4944 image-rgba fill_image_rgb_over-64 0.21 1.19% -> 0.24 0.72%: 1.11x slowdown
4946 image-rgba fill_similar_rgb_over-64 0.21 0.18% -> 0.24 0.30%: 1.11x slowdown
4948 image-rgb fill_solid_rgba_over-64 0.22 1.66% -> 0.24 1.15%: 1.11x slowdown
4950 image-rgb fill_image_rgb_over-64 0.21 0.14% -> 0.24 0.80%: 1.11x slowdown
4952 image-rgba fill_image_rgba_over-64 0.22 1.34% -> 0.25 0.20%: 1.11x slowdown
4954 image-rgba fill_solid_rgba_over-64 0.22 1.48% -> 0.24 0.95%: 1.11x slowdown
4956 image-rgb fill_similar_rgba_over-64 0.22 1.13% -> 0.25 1.25%: 1.10x slowdown
4959 The 45% slowdown for subimage_copy is an extreme case. It's unlikely
4960 to hit many applications unless they often use cairo_rectangle;
4961 cairo_fill to copy a single pixel at a time. In any case, it shows a
4962 worst-case impact of the overhead of the new tessellator. The other
4963 slowdowns (~ 10%) are probably more realistic, and still very
4966 We will work to ensure that performance regressions like these are not
4967 present from one major release of cairo to the next, (for example,
4970 But we're putting this 1.3.4 snapshot out there now, even with this
4971 potential slowdown so that people can experiment with it. If you've
4972 got complex geometry, we hope you will see some benefit from the new
4973 tessellator. If you've got primarily simple geometry, we hope things
4974 won't slowdown too much, but please let us know what slowdown you see,
4975 if any, so we can calibrate our performance suite against real-world
4978 Thanks, and have fun with cairo!
4980 Snapshot 1.3.2 (2006-11-14 Carl Worth <cworth@cworth.org>)
4981 ==========================================================
4982 This is the first development snapshot since the 1.2 stable series
4983 branched off shortly after the 1.2.4 release in August 2006.
4985 This snapshot includes all the bug fixes from the 1.2.6 release,
4986 (since they originated here on the 1.3 branch first and were
4987 cherry-picked over to 1.2). But more importantly, it contains some new
4988 API in preparation for a future 1.4 release, and most importantly, it
4989 contains several performance improvements.
4991 The bug fixes will not be reviewed here, as most of them are already
4992 described in the 1.2.6 release notes. But details for the new API and
4993 some performance improvements are included here.
4995 As with all snapshots, this is experimental code, and the new API
4996 added here is still experimental and is not guaranteed to appear
4997 unchanged in any future release of cairo.
5001 Several new API additions are available in this release. There is a
5002 common theme among all the additions in that they allow cairo to
5003 advertise information about its state that it was refusing to
5004 volunteer earlier. So this isn't groundbreaking new functionality, but
5005 it is essential for easily achieving several tasks.
5007 The new functions can be divided into three categories:
5009 Getting information about the current clip region
5010 -------------------------------------------------
5012 cairo_copy_clip_rectangles
5013 cairo_rectangle_list_destroy
5015 Getting information about the current dash setting
5016 --------------------------------------------------
5017 cairo_get_dash_count
5020 Getting information from a pattern
5021 ----------------------------------
5022 cairo_pattern_get_rgba
5023 cairo_pattern_get_surface
5024 cairo_pattern_get_color_stop_rgba
5025 cairo_pattern_get_color_stop_count
5026 cairo_pattern_get_linear_points
5027 cairo_pattern_get_radial_circles
5029 In each of these areas, we have new API for providing a list of
5030 uniform values from cairo. The closest thing we had to this before was
5031 cairo_copy_path, (which is rather unique in providing a list of
5034 The copy_clip_rectangles/rectangle_list_destroy functions follow a
5035 style similar to that of cairo_copy_path. Meanwhile, the dash and
5036 pattern color stop functions introduce a new style in which there is a
5037 single call to return the number of elements available (get_dash_count
5038 and get_color_stop_count) and then a function to be called once to get
5039 each element (get_dash and get_color_stop_rgba).
5041 I'm interested in hearing feedback from users of these new API
5042 functions, particularly from people writing language bindings. One
5043 open question is whether the clip "getter" functionality should adopt
5044 a style similar to that of the new dash and color_stop interfaces.
5048 The CAIRO_FORMAT_RGB16_565 enum value has been deprecated. It never
5049 worked as a format value for cairo_image_surface_create, and it wasn't
5050 necessary for supporting 16-bit 565 X server visuals.
5054 The XCB backend has been updated to track the latest XCB API (which
5055 recently had a 1.0 release).
5059 Vladimir Vukicevic has written a new "native quartz" backend which
5060 will eventually replace the current "image-surface wrapping" quartz
5061 backend. For now, both backends are available, (the old one is
5062 "quartz" and the new one is "nquartz"). But it is anticipated that the
5063 new backend will replace the old one and take on the "quartz" name
5064 before this backend is marked as supported in a release of cairo.
5068 Doodle and Peter Weilbacher have contributed a new, experimental
5069 backend for using cairo on OS/2 systems.
5071 Performance improvements
5072 ------------------------
5073 Here are some highlights from cairo's performance suite showing
5074 improvements from cairo 1.2.6 to cairo 1.3.2. The command used to
5075 generate this data is:
5077 ./cairo-perf-diff 1.2.6 HEAD
5079 available in the perf/ directory of a recent checkout of cairo's
5080 source, (the cairo-perf-diff script does require a git checkout and
5081 will not work from a tar file---though ./cairo-perf can still be used
5082 to generate a single report there and ./cairo-perf-diff-files can be
5083 used to compare two reports).
5085 Results are described below both for an x86 laptop (with an old Radeon
5086 video card, recent X.org build, XAA, free software drivers), as well
5087 as for a Nokia 770. First the x86 results with comments on each, (all
5088 times are reported in milliseconds).
5090 Copying subsets of an image surface to an xlib surface (much faster)
5091 --------------------------------------------------------------------
5092 xlib-rgba subimage_copy-512 10.50 -> : 53.97x speedup
5093 █████████████████████████████████████████████████████
5095 Thanks to Christopher (Monty) Montgomery for this big performance
5096 improvement. Any application which has a large image surface and is
5097 copying small pieces of it at a time to an xlib surface, (imagine an
5098 application that loads a single image containing all the "sprites" for
5099 that application), will benefit from this fix. The larger the ratio of
5100 the image surface to the portion being copied, the larger the benefit.
5102 Floating-point conversion (3x faster)
5103 -------------------------------------
5104 xlib-rgba pattern_create_radial-16 27.75 -> 3.93 : 2.94x speedup
5106 image-rgb pattern_create_radial-16 26.06 -> 3.74 : 2.90x speedup
5109 Thanks to Daniel Amelang, (and others who had contributed the idea
5110 earlier), for this nice improvement in the speed of converting
5111 floating-point values to fixed-point.
5113 Text rendering (1.3 - 2x faster)
5114 ------------------------------
5115 xlib-rgba text_image_rgba_source-256 319.73 -> 62.40 : 2.13x speedup
5117 image-rgb text_solid_rgba_over-64 2.85 -> 0.88 : 1.35x speedup
5120 I don't think we've ever set out to improve text performance
5121 specifically, but we did it a bit anyway. I believe the extra
5122 improvement in the xlib backend is due to Monty's image copying fix
5123 above, and the rest is due to the floating-point conversion speedup.
5125 Thin stroke improvements (1.5x faster)
5126 ---------------------------------------------
5127 image-rgb world_map-800 1641.09 -> 414.77 : 1.65x speedup
5129 xlib-rgba world_map-800 1939.66 -> 529.94 : 1.52x speedup
5132 The most modest stuff to announce in this release is the 50%
5133 improvement I made in the world_map case. This is in improvement that
5134 should help basically anything that is doing strokes with many
5135 straight line segments, (and the thinner the better, since that makes
5136 tessellation dominate rasterization). The fixes here are to use a
5137 custom quadrilateral tessellator rather than the generic tessellator
5138 for straight line segments and the miter joins.
5140 Performance results from the Nokia 770
5141 --------------------------------------
5142 xlib-rgba subimage_copy-512 55.88 -> 2.04 : 27.34x speedup
5143 ██████████████████████████▍
5144 xlib-rgb text_image_rgb_over-256 1487.58 -> 294.43 : 5.05x speedup
5146 image-rgb pattern_create_radial-16 187.13 -> 91.86 : 2.04x speedup
5148 xlib-rgba world_map-800 21261.41 -> 15628.02 : 1.36x speedup
5151 Here we see that the subimage_copy improvement was only about half as
5152 large as the corresponding improvement on my laptop, (27x faster
5153 compared to 54x) and the floating-point conversion fix also was quite
5154 as significant, (2x compared to 3x). Oddly the improvement to text
5155 rendering performance was more than twice as good (5x compared to
5156 2x). I don't know what the reason for that is, but I don't think it's
5157 anything anybody should complain about.
5159 Release 1.2.6 (2006-11-02 Behdad Esfahbod <behdad@behdad.org>)
5160 ==============================================================
5161 This is the third bug fix release in the 1.2 series, coming less than
5162 two months after the 1.2.4 release made on August 18.
5164 The 1.2.4 release turned out to be a pretty solid one, except for a crasher
5165 bug when forwarding an X connection where the client and the server have
5166 varying byte orders, eg. from a PPC to an i686. Other than that, various
5167 other small bugs have been fixed.
5169 Various improvements have been made in the testing infrastructure to prevent
5170 false positives, and to make sure the generated cairo shared object behaves as
5171 expected in terms of exported symbols and relocations.
5173 There were a total of 89 changes since 1.2.4. The following list the most
5178 - Avoid unsigned loop control variable to eliminate infinite,
5179 memory-scribbling loop. (#7593)
5180 - Fix cairo_image_surface_create to report INVALID_FORMAT errors.
5181 Previously the detected error was being lost and a nil surface was
5182 returned that erroneously reported CAIRO_STATUS_NO_MEMORY.
5183 - Change _cairo_color_compute_shorts to not rely on any particular
5184 floating-point epsilon value. (#7497)
5185 - Fix infinite-join test case (bug #8379)
5186 - Pass correct surface to create_similar in _cairo_clip_init_deep_copy().
5190 - Fix Type 1 embedding in PDF.
5191 - Correct the value of /LastChar in the PDF Type 1 font dictionary.
5192 - Improve error checking in TrueType subsetting.
5193 - Compute right index when looking up left side bearing. (bug #8180)
5194 - Correct an unsigned to signed conversion problem in truetype subsetting
5196 - Type1 subsetting: Don't put .notdef in Encoding when there are 256 glyphs.
5197 - Add cairo version to PS header / PDF document info dictionary.
5198 - Set CTM before path construction.
5202 - Get correct unhinted outlines on win32. (bug 7603)
5203 - Make cairo as a win32 static library possible.
5204 - Use CAIRO_FORMAT_RGB24 for BITSPIXEL==32 surfaces too.
5208 - Define WINVER if it's not defined. (bug 6456)
5209 - Fix the AMD64 final link by removing SLIM from pixman.
5210 - Misc win32 compilation fixes.
5211 - Add Sun Pro C definition of pixman_private.
5212 - Use pixman_private consistently as prefix not suffix.
5213 - Added three tests check-plt.sh, check-def.sh, and check-header.sh that check
5214 that the shared object, the .def file, and the public headers agree about
5215 the exported symbols.
5216 - Require pkg-config 0.19. (#8686)
5219 Release 1.2.4 (2006-08-18 Carl Worth <cworth@cworth.org>)
5220 =========================================================
5221 This is the second bug fix release in the 1.2 series, coming less than
5222 two weeks after the 1.2.2 release made on August 8.
5224 The big motivation for a quick release was that there were a log of
5225 build system snags that people ran into with the 1.2.2 release. But,
5226 by the time we got those all done, we found that we had a bunch of
5227 fixes for cairo's rendering as well. So there's a lot of goodness in
5228 here for such a short time period.
5232 Fix image surfaces to not be clipped when used as a source (Vladimir Vukicevic)
5233 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=72e25648c4c4bc82ddd938aa4e05887a293f0d8b
5235 Fix a couple of corner cases in dashing degenerate paths (Jeff Muizelaar)
5236 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=fbb1758ba8384650157b2bbbc93d161b0c2a05f0
5238 Fix support for type1 fonts on win32 (Adrian Johnson)
5239 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=da1019c9138695cb838a54f8b871bbfd0e8996d7
5241 Fix assertion failure when rotating bitmap fonts (Carl Worth)
5242 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=0bfa6d4f33b8ddb5dc55bbe419c15df4af856ff9
5244 Fix assertion failure when calling cairo_text_path with bitmap fonts (Carl Worth)
5245 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=9878a033531e6b96b5f27e69e10e90dee7440cd9
5247 Fix mis-handling of cairo_close_path in some situations (Tim Rowley, Carl Worth)
5248 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=53f74e59faf1af78f2f0741ccf1f23aa5dad4efc
5250 Respect font_matrix translation in _cairo_gstate_glyph_path (Behdad Esfahbod)
5251 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=f183b835b111d23e838889178aa8106ec84663b3
5253 Fix vertical metrics adjustment to work with non-identity shapes (Behdad Esfahbod)
5254 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=b7bc263842a798d657a95e539e1693372448837f
5256 [PS] Set correct ImageMatrix in _cairo_ps_surface_emit_bitmap_glyph_data (Behdad Esfahbod)
5257 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=d47388ad759b0a1a0869655a87d9b5eb6ae2445d
5261 Fix xlib detection to prefer pkg-config to avoid false libXt dependency (Behdad Esfahbod)
5262 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=0e78e7144353703cbd28aae6a67cd9ca261f1d68
5264 Fix typos causing win32 build problem with PS,PDF, and SVG backends (Behdad Esfahbod)
5265 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=aea83b908d020e26732753830bb3056e6702a774
5267 Fix configure cache to not use stale results (Behdad Esfahbod)
5268 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=6d0e3260444a2d5b6fb0cb223ac79f1c0e7b3a6e
5270 Fix to not pass unsupported warning options to the compiler (Jens Granseuer)
5271 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=97524a8fdb899de1ae4a3e920fb7bda6d76c5571
5273 Fix to allow env. variables such as png_REQUIRES to override configure detection (Jens Granseuer)
5274 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=abd16e47d6331bd3811c908e524b4dcb6bd23bf0
5276 Fix test suite to not use an old system cairo when converting svg2png (Behdad Esfahbod)
5277 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=6122cc85c8f71b1ba2df3ab86907768edebe1781
5279 Fix test suite to not require signal.h to be present (Behdad Esfahbod)
5280 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=6f8cf53b1e1ccdbe1ab6a275656b19c6e5120e40
5284 Many useful warnings cleanups from sparse, valgrind, and careful eyes
5285 (Kjartan Maraas, Pavel Roskin)
5287 Release 1.2.2 (2006-08-08 Carl Worth <cworth@cworth.org>)
5288 =========================================================
5289 This is the first bug fix release in the 1.2 series since the original
5290 1.2.0 release made six weeks ago.
5292 There were some very serious bugs in the 1.2.0 release, (see below),
5293 so everybody is encouraged to upgrade from 1.2.0 to 1.2.2. The 1.2.2
5294 release maintains source and binary compatibility with 1.2.0 and does
5295 not make any API additions.
5297 Fix crashes with BGR X servers
5298 ------------------------------
5299 With cairo 1.2.0 many people reported problems with all cairo-using
5300 programs, (including all GTK+ programs with GTK+ >= 2.8) immediately
5301 crashing with a complaint about an unsupported image format. This bug
5302 affected X servers that do not provide the Render extension and that
5303 provide a visual with BGR rather than RGB channel order.
5305 report: https://bugs.freedesktop.org/show_bug.cgi?id=7294
5306 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=9ae66174e774b57f16ad791452ed44efc2770a59
5308 Fix the "disappearing text" bug
5309 -------------------------------
5310 With cairo 1.2.0 many people reported that text would disappear from
5311 applications, sometimes reappearing with mouse motion or
5312 selection. The text would disappear after the first space in a string
5313 of text. This bug was caused by an underlying bug in (very common) X
5314 servers, and only affected text rendered without antialiasing, (either
5315 a bitmap font or a vector font with antialiasing disabled). The bug
5316 was also exacerbated by a KDE migration bug that caused antialiasing
5317 to be disabled more than desired.
5319 report: https://bugs.freedesktop.org/show_bug.cgi?id=7494
5320 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=456cdb3058f3b416109a9600167cd8842300ae14
5322 Xorg: https://bugs.freedesktop.org/show_bug.cgi?id=7681
5323 KDE: http://qa.mandriva.com/show_bug.cgi?id=23990
5325 Fix broken image fallback scaling (aka. "broken printing")
5326 ----------------------------------------------------------
5327 The various "print" backends, (pdf, ps, and svg), sometimes fallback
5328 to using image-based rendering for some operations. In cairo 1.2.0
5329 these image fallbacks were scaled improperly. Applications using cairo
5330 can influence the resolution of the image fallbacks with
5331 cairo_surface_set_fallback_resolution. With the bug, any value other
5332 than 72.0 would lead to incorrect results, (larger values would lead
5333 to increasingly shrunken output).
5335 report: https://bugs.freedesktop.org/show_bug.cgi?id=7533
5336 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=1feb4291cf7813494355459bb547eec604c54ffb
5338 Fix inadvertent semantic change of font matrix translation (Behdad Esfahbod)
5339 ----------------------------------------------------------------------------
5340 The 1.2.0 release introduced an inadvertent change to how the
5341 translation components of a font matrix are interpreted. In the 1.0
5342 series, font matrix translation could be used to offset the glyph
5343 origin, (though glyph metrics were reported incorrectly in
5344 1.0). However in 1.2.0, the translation was applied to the advance
5345 values between each glyph. The 1.2.0 behavior is fairly useless in
5346 practice, and it was not intentional to introduce a semantic
5347 change. With 1.2.2 we return to the 1.0 semantics, with a much better
5348 implementation that provides correct glyph metrics.
5350 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=84840e6bba6e72aa88fad7a0ee929e8955ba9051
5352 Fix create_similar to preserve fallback resolution and font options (Behdad Esfahbod)
5353 -------------------------------------------------------------------------------------
5354 There has been a long-standing issue with cairo_surface_create_similar
5355 such that font options and other settings from the original
5356 destination surface would not be preserved to the intermediate
5357 "similar" surface. This could result in incorrect rendering
5358 (particularly with respect to text hinting/antialiasing) with
5359 fallbacks, for example.
5361 report: https://bugs.freedesktop.org/show_bug.cgi?id=4106
5362 fixes: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=9fcb3c32c1f16fe6ab913e27eb54d18b7d9a06b0
5363 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=bdb4e1edadb78a2118ff70b28163f8bd4317f1ec
5365 xlib: Fix text performance regression from 1.0 to 1.2.0 (Vladimir Vukicevic)
5366 ----------------------------------------------------------------------------
5367 Several people noticed that upgrading from cairo 1.0 to cairo 1.2.0
5368 caused a significant performance regression when using the xlib
5369 backend. This performance regression was particularly noticeable when
5370 doing lots of text rendering and when using a high-latency connection
5371 to the X server, (such as a remote X server over an ssh
5372 connection). The slowdown was identified and fixed in 1.2.2.
5374 report: https://bugs.freedesktop.org/show_bug.cgi?id=7514
5375 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=b7191885c88068dad57d68ced69a752d1162b12c
5377 PDF: Eliminate dependency on FreeType library dependency (Adrian Johnson)
5378 -------------------------------------------------------------------------
5379 The cairo 1.2 series adds a supported pdf backend to cairo. In cairo
5380 1.2.0 this backend required the freetype library, which was an
5381 undesirable dependency on systems such as win32, (cairo is designed to
5382 always prefer the "native" font system). As of cairo 1.2.2 the
5383 freetype library is not required to use the pdf backend on the win32
5386 report: https://bugs.freedesktop.org/show_bug.cgi?id=7538
5387 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=a0989f427be87c60415963dd6822b3c5c3781691
5389 PDF: Fix broken output on amd64 (Adrian Johnson)
5390 ------------------------------------------------
5391 report: http://bugzilla.gnome.org/show_bug.cgi?id=349826
5392 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=f4b12e497b7ac282b2f6831b8fb68deebc412e60
5394 PS: Fix broken output for truetype fonts > 64k (Adrian Johnson)
5395 ---------------------------------------------------------------
5396 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=067d97eb1793a6b0d0dddfbd0b54117844511a94
5398 PDF: Fix so that dashing doesn't get stuck on (Kent Worsnop)
5399 ------------------------------------------------------------
5400 Kent notices that with the PDF backend in cairo 1.2.0 as soon as a
5401 stroke was performed with dashing, all subsequent strokes would also
5402 be dashed. There was no way to turn dashing off again.
5404 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=778c4730a86296bf0a71080cf7008d7291792256
5406 Fix memory leaks in failure paths in gradient creation (Alfred Peng)
5407 --------------------------------------------------------------------
5408 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=db06681b487873788b51a6766894fc619eb8d8f2
5410 Fix memory leak in _cairo_surface_show_glyphs (Chris Wilson)
5411 ------------------------------------------------------------
5412 report: https://bugs.freedesktop.org/show_bug.cgi?id=7766
5413 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=e2fddcccb43d06486d3680a19cfdd5a54963fcbd
5415 Solaris: Add definition of cairo_private for some Sun compilers (Alfred Peng)
5416 -----------------------------------------------------------------------------
5417 report: https://bugzilla.mozilla.org/show_bug.cgi?id=341874
5418 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=04757a3aa8deeff3265719ebe01b021638990ec6
5420 Solaris: Change version number of Sun's Xorg server with buggy repeat (Brian Cameron)
5421 -------------------------------------------------------------------------------------
5422 report: https://bugs.freedesktop.org/show_bug.cgi?id=7483
5423 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=e0ad1aa995bcec4246c0b8ab0d5a5a79871ce235
5425 Various memory leak fixes
5426 -------------------------
5427 Fix memory leak in _cairo_surface_show_glyphs (bug 7766)
5428 Fix file handle leak in failure path (bug 7616)
5429 Fix some memory leaks in the test cases.
5430 Fix some memory leaks in font subsetting code used in print backends.
5432 Documentation improvements (Behdad Esfahbod)
5433 --------------------------------------------
5434 Added new documentation for several functions (cairo_show_page,
5435 cairo_copy_page, cairo_in_stroke, cairo_in_fill).
5437 Fixed some syntax errors that were preventing some existing
5438 documentation from being published.
5440 Fixed several minor typographical errors.
5442 Added an index for new symbols in 1.2.
5444 Release 1.2.0 (2006-06-27 Carl Worth <cworth@cworth.org>)
5445 =========================================================
5446 This is the culmination of the work that has gone on within the 1.1
5449 There has been one API addition since the cairo 1.1.10 snapshot:
5451 cairo_xlib_surface_get_width
5452 cairo_xlib_surface_get_height
5454 There's also a new feature without any API change:
5456 Dots can now be drawn by using CAIRO_LINE_CAP_ROUND with
5457 degenerate sub-paths, (cairo_move_to() followed by either
5458 cairo_close_path() or a cairo_line_to() to the same location).
5460 And at least the following bugs have been fixed:
5462 6759 fontconfig option AntiAlias doesn't work in cairo 1.1.2
5463 6955 Some characters aren't displayed when using xlib (cache u...
5464 7268 positive device_offset values don't work as source
5465 * PDF emit_glyph function needs to support bitmapped glyphs
5466 * PS emit_glyph function needs to support bitmapped glyphs
5467 * SVG emit_glyph function needs to support bitmapped glyphs
5468 * PDF: minefield page one is falling back unnecessarily
5469 * PS/PDF: Fix broken placement for vertical glyphs
5470 * PS: Fix to not draw BUTT-capped zero-length dash segments
5471 * Do device offset before float->fixed conversion
5472 http://bugzilla.gnome.org/show_bug.cgi?id=332266
5473 * PS: Fix source surfaces with transformations
5474 * PS: Fix to not draw BUTT-capped degnerate sub-paths
5475 * PS: Don't walk off end of array when printing "~>"
5476 * Fix some memory leaks in the test suite rig
5477 * SVG: Fix memory leak when using cairo_mask
5478 * Fix EXTEND_REFLECT and EXTEND_PAD to not crash (though these are
5479 still not yet fully implemented for surface patterns).
5481 This has been a tremendous effort by everyone, and I'm proud to have
5482 been a part of it. Congratulations to all contributors to cairo!
5484 Snapshot 1.1.10 (2006-06-16 Carl Worth <cworth@cworth.org>)
5485 ===========================================================
5486 This is the fifth in a series of snapshots working toward the 1.2
5489 The primary motivation for this snapshot is to fix a long-standing bug
5490 that had long been silent, but as of the 1.1.8 snapshot started
5491 causing crashes when run against 16-bit depth X servers, (often Xvnc
5492 or Xnest). The fix for this adds a new CAIRO_FORMAT_RGB16_565 to the
5495 This snapshot also includes a rewrite of cairo's SVG backend to
5496 eliminate the dependency on libxml2. With this in place, cairo 1.2
5497 will not depend on any libraries that cairo 1.0 did not.
5499 As usual, there are also a few fixes for minor bugs.
5501 Snapshot 1.1.8 (2006-06-14 Carl Worth <cworth@cworth.org>)
5502 ==========================================================
5503 This is the fourth in a series of snapshots working toward the 1.2
5504 release of cairo. At this point, all major features of the 1.2 release
5505 are in place, leaving just a few bug fixes left.
5507 In particular, there well be no additional API changes between this
5508 1.1.8 snapshot and the 1.2 release.
5510 The announcement for 1.1.6 mentioned several API changes being
5511 considered. Only one of these changes was actually implemented
5512 (set_dpi -> fallback_resolution). This change does introduce one
5513 source-level incompatibility with respect to previous 1.1.x snapshots,
5514 so see below for details.
5516 Here is an abbreviated summary of changes since the 1.1.6 snapshot:
5520 According to the plan mentioned in the 1.1.6 notes, one source-level
5521 incompatible change has been implemented. The following three
5522 functions have been removed from cairo's API:
5524 cairo_pdf_surface_set_dpi
5525 cairo_ps_surface_set_dpi
5526 cairo_svg_surface_set_dpi
5528 and in their place the following function has been added:
5530 cairo_surface_set_fallback_resolution
5532 The signature and semantics of the function remains the same, so it is
5533 a simple matter of changing the name of the function when calling
5534 it. As a transition mechanism, this snapshot will (on many systems)
5535 build to include the old symbols so that code previously compiled will
5536 still run. However, all source code using the old names must be
5537 updated before it will compile. And the upcoming 1.2 release is not
5538 anticipated to include the old symbols.
5540 Finally, it should be pointed out that the old symbols never existed
5541 in the supported API of any stable release of cairo. (In the stable
5542 1.0 releases the PDF, PS, and SVG backends were advertised as
5543 experimental and unstable.)
5545 And, as always, cairo continues to maintain source and binary
5546 compatibility between major releases. So applications compiled against
5547 supported backends in a stable release of cairo (1.0.4 say) will
5548 continue to compile and run without modification against new major
5549 releases (1.2.0 say) without modification.
5553 The following new functions have been added to cairo's API:
5555 cairo_surface_get_content
5556 cairo_debug_reset_static_data
5557 cairo_image_surface_get_data
5558 cairo_image_surface_get_format
5559 cairo_image_surface_get_stride
5560 cairo_win32_font_face_create_for_hfont
5562 New, backend-specific pkg-config files
5563 --------------------------------------
5564 In addition to the original cairo.pc file, cairo will also now install
5565 a pkg-config files for each configured backend, (for example
5566 cairo-pdf.pc, cairo-svg.pc, cairo-xlib.pc, cairo-win32.pc, etc.) this
5567 also includes optional font backends (such as cairo-ft.pc) and the
5568 optional png functionality (cairo-png.pc).
5570 These new pkg-config files should be very convenient for allowing
5571 cairo-using code to easily check for the existing of optional
5572 functionality in cairo without having to write complex rules to grub
5573 through cairo header files or the compiled library looking for
5576 Printing backend (PS, PDF, and SVG)
5577 -----------------------------------
5578 Improving the quality of the "printing" backends has been a priority
5579 of the development between cairo 1.1.6 and cairo 1.1.8.
5581 The big improvement here is in the area of text output. Previously, at
5582 best, text was output as paths without taking advantage of any font
5583 support available in the output file format.
5585 Now, at the minimum text paths will be shared by using type3 fonts
5586 (for PS and PDF---and similarly, defs for SVG). Also, if possible,
5587 type3 and truetype fonts will be embedded in PostScript and PDF
5588 output. There are still some known bugs with this, (for example,
5589 selecting text in a cairo-generated PDF file with an embedded truetype
5590 font does not work). So there will be some more changes in this area
5591 before cairo 1.2, but do try test this feature out as it exists so
5594 Many thanks to Kristian Høgsberg for the truetype and type1 font
5599 Performance improvements by preferring GDI over pixman rendering when possible.
5600 Fixes for text rendering.
5604 Fix potentially big performance bug by making xlib's create_similar
5605 try harder to create a pixmap of a depth matching that of the screen.
5609 Among various other fixes, the following bugs listed in bugzilla have
5612 Bug 2488: Patch to fix pixman samping location bug (#2488).
5613 https://bugs.freedesktop.org/show_bug.cgi?id=2488
5615 Bug 4196: undef MIN an MAX before defining to avoid duplicate definition
5616 https://bugs.freedesktop.org/show_bug.cgi?id=4196
5618 Bug 4723: configure.in: Fix m4 quoting when examining pkg-config version
5619 https://bugs.freedesktop.org/show_bug.cgi?id=4723
5621 Bug 4882: Flag Sun's X server has having buggy_repeat.
5622 https://bugs.freedesktop.org/show_bug.cgi?id=4882
5624 Bug 5306: test/pdf2png: Add missing include of stdio.h
5625 https://bugs.freedesktop.org/show_bug.cgi?id=5306
5627 Bug 7075: Fix make clean to remove cairo.def
5628 https://bugs.freedesktop.org/show_bug.cgi?id=7075
5630 (Many thanks to Behdad Esfahbod for helping us track down and fix many
5633 Snapshot 1.1.6 (2006-05-04 Carl Worth <cworth@cworth.org>)
5634 ==========================================================
5635 This is the third in a series of snapshots working toward the imminent
5636 1.2 release of cairo. For a list of items still needing work on the
5637 cairo 1.2 roadmap, please see:
5639 http://cairographics.org/ROADMAP
5641 As can be seen in that list, there are no longer any API additions
5642 left on the roadmap. Instead, there is a feature (PDF type 3 fonts) a
5643 performance optimization (X server gradients) and a list of bug
5644 fixes. This gives us a fair amount of freedom to cut the 1.2 release
5645 at almost any point by deciding to defer remaining bug fixes to
5646 subsequent maintenance releases such as 1.2.2 and 1.2.4.
5648 Before we will do that, we must first be wiling to commit to all the
5649 new API additions. As a heads-up, there are a couple of potential API
5650 changes being considered. (Note that these are changes to new API
5651 introduced during 1.1 so these will not introduce API
5652 incompatibilities compared to the stable 1.0 series). The changes
5653 being considered are:
5655 cairo_get_group_target: may acquire x and y offset return
5656 parameters. May also be eliminated in favor of
5657 cairo_get_target assuming its role
5659 cairo_pdf_surface_set_dpi:
5660 cairo_ps_surface_set_dpi:
5661 cairo_svg_surface_set_dpi: These functions may be removed in favor
5662 of a new cairo_surface_set_fallback_resolution
5664 Additionally there is the possibility of a slight change in the
5665 semantics of cairo_set_line_width. We believe the current behavior of the sequence:
5667 cairo_set_line_width; ... change CTM ...; cairo_stroke;
5669 is buggy. It is currently behaving the same as:
5671 ... change CTM ...; cairo_set_line_width; cairo_stroke;
5673 We are considering fixing this bug before 1.2 with the hope that
5674 nobody is already relying on the buggy behavior described here. Do
5675 shout if you suspect you might be in that position.
5677 The items included in this snapshot (since the 1.1.4 snapshot) are
5682 The long-awaited group-rendering support is now available with the
5683 following function calls:
5686 cairo_push_group_with_content
5688 cairo_pop_group_to_source
5689 cairo_get_group_target
5691 This API provides a much more convenient mechanism for doing rendering
5692 to an intermediate surface without the need to manually create a
5693 temporary cairo_surface_t and a temporary cairo_t and clean them up
5696 Add the following missing get function to complement
5697 cairo_surface_set_device_offset:
5699 cairo_surface_get_device_offset
5701 PDF backend (API addition)
5702 --------------------------
5703 The PDF backend now provides for per-page size changes, (similar to
5704 what the PostScript backend got in the 1.1.4 snapshot). The new API
5707 cairo_pdf_surface_set_size
5709 Xlib backend (API additions)
5710 ----------------------------
5711 The following functions have been added to allow the extraction of
5714 cairo_xlib_surface_get_display
5715 cairo_xlib_surface_get_drawable
5716 cairo_xlib_surface_get_screen
5717 cairo_xlib_surface_get_visual
5718 cairo_xlib_surface_get_depth
5720 XCB backend (experimental)
5721 --------------------------
5722 Update backend so that it now compiles with the recent XCB 0.9 release.
5724 Bug fixes and memory leak cleanup
5725 ---------------------------------
5726 Various little things, nothing too significant though.
5728 Snapshot 1.1.4 (2006-05-03 Carl Worth <cworth@cworth.org>)
5729 ==========================================================
5730 This is the second in a series of snapshots working toward the
5731 upcoming 1.2 release of cairo. For a list of items still needing work
5732 on the cairo 1.2 roadmap, please see:
5734 http://cairographics.org/ROADMAP
5736 The items included in this snapshot (since the 1.1.2 snapshot) are
5739 PostScript backend: new printing-oriented API
5740 ---------------------------------------------
5741 We anticipate that with cairo 1.2, toolkits will begin to use cairo
5742 for printing on systems that use PostScript as the spool format. To
5743 support this use case, we have added 4 new function calls that are
5744 specific to the PostScript backend:
5746 cairo_ps_surface_set_size
5747 cairo_ps_surface_dsc_comment
5748 cairo_ps_surface_dsc_begin_setup
5749 cairo_ps_surface_dsc_begin_page_setup
5751 These functions allow variation of the page size/orientation from one
5752 page to the next in the PostScript output. They also allow the toolkit
5753 to provide per-document and per-page printer control options in a
5754 device-independent way, (for example, by using PPD options and
5755 emitting them as DSC comments into the PostScript output). This should
5756 allow toolkits to provide very fine-grained control of many options
5757 available in printers, (media size, media type, tray selection, etc.).
5759 SVG backend: builds by default, version control
5760 -----------------------------------------------
5761 The SVG backend continues to see major improvements. It is expected
5762 that the SVG backend will be a supported backend in the 1.2
5763 release. This backend will now be built by default if its dependencies
5764 (freetype and libxml2) are met.
5766 Additionally, the SVG backend now has flexibility with regard to what
5767 version of SVG it targets. It will target SVG 1.1 by default, which
5768 will require image fallbacks for some of the "fancier" cairo
5769 compositing operators. Or with the following new function calls:
5771 cairo_svg_surface_restrict_to_version
5772 cairo_svg_get_versions
5773 cairo_svg_version_to_string
5775 it can be made to target SVG 1.2 in which there is native support for
5776 these compositing operators.
5780 At least the following bugs have been fixed since the 1.1.2 snapshot:
5782 crash at XRenderAddGlyphs
5783 https://bugs.freedesktop.org/show_bug.cgi?id=4705
5785 Can't build cairo-1.1.2 on opensolaris due to " void function cannot return value"
5786 https://bugs.freedesktop.org/show_bug.cgi?id=6792
5788 Missing out-of-memory check at gfx/cairo/cairo/src/cairo-atsui-font.c:185
5789 https://bugzilla.mozilla.org/show_bug.cgi?id=336129
5791 A couple of memory leaks.
5793 Snapshot 1.1.2 (2006-04-25 Carl Worth <cworth@cworth.org>)
5794 ==========================================================
5795 This is the first in a series of snapshots working toward the upcoming
5796 1.2 release of cairo. (Subsequent snapshot will use successive even
5797 numbers for the third digit, 1.1.4, 1.1.6, etc.) This snapshot is
5798 backwards-compatible with the 1.0 series---it makes a few API
5799 additions but does not remove any API.
5801 PostScript and PDF backends are no longer "experimental"
5802 --------------------------------------------------------
5803 The major theme of the 1.2 release is improved PostScript and PDF
5804 backends for cairo. Unlike the 1.0 series, in the 1.2 series these
5805 backends will not be marked as experimental and will be enabled by
5806 default. We encourage people to test this snapshot and the PS/PDF
5807 backends in particular as much as possible.
5809 The PostScript and PDF output is not yet ideal.
5811 * One major problem with the PostScript output is that image
5812 fallbacks are used more often than strictly necessary, and the
5813 image fallbacks are at a lower resolution than desired, (the
5814 cairo_ps_surface_set_dpi call is ignored).
5816 * The major drawback of the current PDF backend implementation is
5817 its text support. Every glyph is represented by a filled path in
5818 the PDF file. The causes file sizes to be much larger and
5819 rendering to be much slower than desired.
5821 It is anticipated that both of these shortcomings will see some
5822 improvements before the final 1.2 release.
5824 In spite of those shortcomings, we hope that the PS and PDF backends
5825 will yield faithful results for pretty much any cairo operations you
5826 can throw at them. Please let us know if you are getting obviously
5827 "different" results from the PS/PDF backends than from the image or
5830 Other new experimental backends
5831 -------------------------------
5832 This snapshot includes three new backends that did not exist in the
5841 These are all currently marked "experimental" and are disabled by
5842 default. But the SVG backend in particular has seen a lot of recent
5843 development and is very close to passing the entire cairo test
5844 suite. It is possible that this backend will become a fully supported
5845 backend by the time of the cairo 1.2 release.
5847 Public API additions
5848 --------------------
5849 There have been a few new API functions added to cairo, including:
5851 New get_type functions for querying sub-types of object:
5853 cairo_surface_get_type
5854 cairo_pattern_get_type
5855 cairo_font_face_get_type
5856 cairo_scaled_font_get_type
5858 More convenience in working with cairo_scaled_font_t with new getter
5861 cairo_scaled_font_get_font_face
5862 cairo_scaled_font_get_font_matrix
5863 cairo_scaled_font_get_ctm
5864 cairo_scaled_font_get_font_options
5866 As well as a convenience function for setting a scaled font into a
5869 cairo_set_scaled_font
5871 and a function to allow text extents to be queried directly from a
5872 scaled font, (without requiring a cairo_surface_t or a cairo_t):
5874 cairo_scaled_font_text_extents
5876 These new scaled font functions were motivated by the needs of the
5879 Finally, a new path-construction function was added which clears the
5880 current point in preparation for a new sub path. This makes cairo_arc
5881 easier to use in some situations:
5885 Before the 1.2 release is final we do still plan a few more API
5886 additions specifically motivated by the needs of Mozilla/Firefox.
5888 Optimizations and bug fixes
5889 ---------------------------
5890 Shortly after the 1.0 maintenance series branched off the mainline
5891 there was a major rework of the cairo font internals. This should
5892 provide some good performance benefits, but it's also another area
5893 people should look at closely for potential regressions.
5895 There has not yet been any widespread, systematic optimization of
5896 cairo, but various performance improvements have been made, (and some
5897 of them are fairly significant). So if some things seem faster than
5898 1.0 then things are good. If there are any performance regressions
5899 compared to 1.0 then there is a real problem and we would like to hear
5902 There has been a huge number of bug fixes---too many to mention in
5903 detail. Again, things should be better, and never worse compared to
5904 1.0. Please let us know if your testing shows otherwise.
5906 Release 1.0.2 (2005-10-03 Carl Worth <cworth@cworth.org>)
5907 =========================================================
5908 For each bug number XXXX below, see:
5910 https://bugs.freedesktop.org/show_bug.cgi?id=XXXX
5916 * 4408 - Add support for dashing of stroked curves
5919 * 4409 - Fix dashing so that each dash is capped on both ends
5922 * 4414 - Prevent SIGILL failures (proper use of -mmmx and -msse flags)
5923 (Sebastien Bacher, Billy Biggs)
5925 * 4299 - Fix crashes with text display in multi-threaded program
5926 (Alexey Shabalin, Carl Worth)
5928 * 4401 - Do not use sincos function since it is buggy on some platforms)
5929 (Tim Mooney, Carl Worth)
5931 * 4245 - Fix several bugs in the test suite exposed by amd64 systems
5932 (Seemant Kulleen, Carl Worth)
5934 * 4321 - Add missing byteswapping on GetImage/PutImage
5935 (Sjoerd Simons, Owen Taylor)
5937 * 4220 - Make the check for rectangular trapezoids simpler and more accurate
5938 (Richard Stellingwerff, Owen Taylor)
5940 * 4260 - Add missing channel-order swapping for antialised fonts
5941 (Barbie LeVile, Owen Taylor)
5943 * 4283 - Fix compilation failure with aggressive inlining (gcc -O3)
5944 (Marco Manfredini, Owen Taylor)
5946 * 4208 - Fix some warnings from sparse
5947 (Kjartan Maraas, Billy Biggs)
5949 * 4269 - Fix to not crash when compiled with -fomit-frame-pointer
5950 (Ronald Wahl, Owen Taylor)
5952 * 4263 - Improve performance for vertical gradients
5953 (Richard Stellingwerff, Owen Taylor)
5956 * 4298 - Accommodate gentoo and Mandriva versions in X server vendor string check
5957 (Billy Biggs, Frederic Crozat, Owen Taylor)
5959 win32-specific fixes
5960 --------------------
5961 * 4599 - Fix "missing wedges" on some stroked paths (win32)
5962 (Tim Rowley, Jonathan Watt, Bertram Felgenhauer, Carl Worth, Keith Packard)
5964 * 4612 - Fix disappearing text if first character out of surface (win32)
5967 * 4602 - Fix shutdown of cairo from failing intermediate, size-0 bitmaps (win32)
5968 Aka. the "white rectangles" bug from mozilla-svg testing
5971 * Various portability improvements for win32
5972 (Hans Breuer, Owen Taylor, Carl Worth)
5974 * 4593 - Fix font sizes to match user expectations (win32)
5975 (Tor Lillqvist, Owen Taylor)
5977 * 3927 - Fix to report metrics of size 0 for glyph-not-available (win32)
5978 (Hans Breuer, Owen Taylor, Tor Lillqvist)
5980 * Add locking primitives for win32
5985 * Fix crash from size-0 pixmap due to empty clip region (xlib)
5986 (Radek Doulík, Carl Worth)
5988 Release 1.0.0 (2005-08-24 Carl Worth <cworth@cworth.org>)
5989 =========================================================
5990 Experimental backends
5991 ---------------------
5992 * The Glitz, PS, PDF, Quartz, and XCB backends have been declared
5993 experimental, and are not part of the API guarantees that accompany
5994 this release. They are not built by default, even when the required
5995 libraries are available, and must be enabled explicitly with
5996 --enable-ps, --enable-pdf, --enable-quartz or --enable-xcb.
5998 It is very painful for us to be pushing out a major release without
5999 these backends enabled. There has been a tremendous amount of work
6000 put into each one and all are quite functional to some
6001 extent. However, each also has some limitations. And none of these
6002 backends have been tested to the level of completeness and
6003 correctness that we expect from cairo backends.
6005 We do encourage people to experiment with these backends and report
6006 success, failure, or means of improving them.
6010 * Prior to 0.9.0 the SOURCE, CLEAR and a number of other operators
6011 behaved in an inconsistent and buggy fashion and could affect areas
6012 outside the clip mask. In 0.9.0, these six "unbounded" operators
6013 were fixed to consistently clear areas outside the shape but within
6014 the clip mask. This is useful behavior for an operator such as IN,
6015 but not what was expected for SOURCE and CLEAR. So, in this release
6016 the behavior of SOURCE and CLEAR has been changed again. They now
6017 affect areas only within both the source and shape. We can write
6018 the new operators as:
6020 SOURCE: dest' = (mask IN clip) ? source : dest
6021 CLEAR: dest' = (mask IN clip) ? 0 : dest
6023 Behavior and API changes
6024 ------------------------
6025 * Setting the filter on a gradient pattern would change the
6026 interpolation between color stops away from the normal linear
6027 interpolation. This dubious behavior has been removed.
6029 * The CAIRO_CONTENT_VALID() and CAIRO_FORMAT_VALID() macros --
6030 implementation details that leaked into cairo.h -- have been moved
6031 into an internal header.
6033 * The cairo_show_text function now advances the current point
6034 according to the total advance values of the string.
6038 * cairo_set_dash can now detect error and can set
6039 CAIRO_STATUS_INVALID_DASH.
6043 * When compiled against recent versions of fontconfig and FreeType,
6044 artificial bold fonts can now be turned on from fonts.conf using
6045 the FC_EMBOLDEN fontconfig key.
6049 * The compositing code from the 'xserver' code tree has now been
6050 completely merged into libpixman. This includes MMX optimization of
6053 * The image transformation code in libpixman has been improved and
6054 now performs significantly faster.
6058 * Several crashes related to corruption in the font caches have been
6061 * All test cases now match pixel-for-pixel on x86 and PPC; this
6062 required fixing bugs in the compositing, stroking, and pattern
6065 * Negative dash offsets have been fixed to work correctly.
6067 * The stroking of paths with mutiple subpaths has now been fixed to
6068 apply caps to all subpaths rather than just the last one.
6070 * Many build fixes for better portability on various systems.
6072 * Lots of other bug fixes, but we're too tired to describe them in
6075 Release 0.9.2 (2005-08-13 Carl Worth <cworth@cworth.org>)
6076 =========================================================
6079 * You will notice that this release jumped from 0.9.0 to 0.9.2. We've
6080 decided to use an odd micro version number (eg. 0.9.1) to indicate
6081 in-progress development between releases. As soon as 0.9.2 is
6082 tagged, the version will be incremented in CVS to 0.9.3 where it
6083 will stay until just before 0.9.4 is built, uploaded, and tagged.
6085 So, even-micro == a released version, odd-micro == something in-between.
6087 Libpixman dependency dropped
6088 ----------------------------
6089 * As of this release, the dependency on an external libpixman has
6090 been dropped. Instead, the code from libpixman needed for cairo has
6091 been incorporated into the cairo source tree. The motivation for
6092 this change is that while cairo's API is stable and ready to be
6093 maintained after the 1.0 release, libpixman's API is not, so we do
6094 not want to expose it at this time.
6096 Also, the incorporation of libpixman into cairo also renames all
6097 previously-public libpixman symbols in order to avoid any conflict
6098 with a future release of libpixman
6102 * Macros and functions have been added so that the version of cairo
6103 can be queried at either compile-time or at run-time. The version
6104 is made available as both a human-readable string and as a single
6107 CAIRO_VERSION_STRING eg. "0.9.2"
6108 CAIRO_VERSION eg. 000902
6111 cairo_version_string (void); /* eg. "0.9.2" */
6114 cairo_version (void); /* eg. 000902 */
6116 A macro is provided to convert a three-part component version into
6117 the encoded single-integer form:
6119 CAIRO_VERSION_ENCODE(X,Y,Z)
6121 For example, the CAIRO_VERSION value of 000902 is obtained as
6122 CAIRO_VERSION_ENCODE(0,9,2). The intent is to make version
6123 comparisons easy, either at compile-time:
6125 #if CAIRO_VERSION >= CAIRO_VERSION_ENCODE(0,9,2)
6131 if (cairo_version() >= CAIRO_VERSION_ENCODE(0,9,2)) { /* ... */ }
6135 * This release adds pthread-based locking (when available) to make
6136 the caches used by cairo safe for threaded programs. Some may
6137 remember a failed experiment with this locking between the 0.5.1
6138 and 0.5.2 snapshots, (where even single-threaded programs that
6139 linked with -lpthread would deadlock). We believe that that problem
6140 has been fixed, so we are looking forward to testing and reports
6141 from users with threaded applications.
6145 * The XCB and Quartz backends failed to compiled in the 0.9.0 release
6146 due to minor syntax errors. These have now been fixed.
6148 * Various crashes in glitz and pixman due to size 0 glyphs have been
6151 Release 0.9.0 (2005-08-08 Carl Worth <cworth@cworth.org>)
6152 =========================================================
6155 * In all prior snapshots, the libtool library versioning was set to
6156 1:0:0. As this release is intended to mark the beginning of
6157 backwards-compatible releases, the versioning has been incremented
6158 to 2:0:0. You will notice that the numeric extension on the
6159 installed library filename will change similarly.
6161 This change will also require all cairo-using applications to be
6162 recompiled. We recognize that this may cause some frustration since
6163 this release is backwards-compatible with 0.6.0 and in that sense
6164 "shouldn't" require re-compilation. However, since all historical
6165 snapshots have used the same 1:0:0 version in spite of incompatible
6166 API changes between them, it was essential that the upcoming 1.0
6167 release series have distinct library versioning.
6169 All future releases will use the library versioning to properly
6170 indicate compatibility between releases. So, any application
6171 re-compiled now to work with the 0.9.0 will not need to be
6172 recompiled when a compatible 1.0 release of cairo is made in the
6177 * Add new function calls to set/get the current antialiasing mode in
6183 This call accepts the same modes recently added for font options
6184 (NONE or GRAY) but affects the rendering of geometry other than
6185 text. The intent of this call is to enable more precise control of
6186 which pixels are affected by each operation, for example to allow
6187 for full-scene antialiasing for seam-free rendering. It is not
6188 expected that non-antialiased rendering will perform better than
6189 anti-aliased rendering.
6191 * Three new functions were added to provide support for mixed cairo-
6192 and non-cairo drawing to the same surface:
6194 cairo_surface_mark_dirty
6195 cairo_surface_mark_dirty_rectangle
6198 * The return type of the several "reference" functions was change,
6199 (API compatibly), from void to the same type as the argument. The
6200 affected functions are:
6202 cairo_font_face_reference
6203 cairo_scaled_font_reference
6204 cairo_pattern_reference
6205 cairo_surface_reference
6208 This allows a convenient way to assign and reference in a single
6213 * The behavior of cairo_set_source with a pattern with a non-identity
6214 matrix was previously not well-defined. The new behavior is as
6217 The pattern's transformation matrix will be locked to the
6218 user space in effect at the time of cairo_set_source(). This means
6219 that further modifications of the CTM will not affect the source
6224 * Some portability improvements, (eg. workaround for missing stdint.h).
6228 * Updated to allow compilation with older versions of freetype.
6232 * Fix the unbounded operators to actually produce a correct result,
6233 (previously the results were artificially restricted to the
6234 bounding box of whatever shape was being drawn rather than
6235 extending out infinitely). The fixed operators are:
6237 CAIRO_OPERATOR_CLEAR
6238 CAIRO_OPERATOR_SOURCE
6241 CAIRO_OPERATOR_DEST_IN
6242 CAIRO_OPERATOR_DEST_ATOP
6244 * Fix cairo_mask and cairo_mask_surface to transform the mask by the
6245 current transformation matrix (CTM).
6247 * Fix cairo_set_source to lock the CTM used to transform the pattern.
6249 * Workaround for X server Render bug involving repeating patterns
6250 with a general transformation matrix.
6252 * cairo_get_font_face fixed to return a "nil" font face object rather
6255 * cairo_set_font_face fixed to not crash if given a NULL font face,
6256 (which is the documented interface for restoring the default font
6259 * Fix xlib glyphset caching to not try to free a NULL glyph.
6261 Snapshot 0.6.0 (2005-07-28 Carl Worth <cworth@cworth.org>)
6262 ==========================================================
6265 * The prototypes of the following functions have changed:
6267 cairo_xlib_surface_create_with_xrender_format
6268 cairo_xlib_surface_create_for_bitmap
6270 A Screen* parameter has been added to each. This allows the cairo
6271 xlib backend to work correctly with multi-head X servers.
6273 * The following function has been modified:
6275 cairo_scaled_font_create
6277 to accept a cairo_font_options_t*. See below fore more details.
6279 * All opaque, reference-counted cairo objects have now been moved to a
6280 standard error-handling scheme. The new objects to receive this
6281 treatment are cairo_font_face_t, cairo_scaled_font_t, and
6282 cairo_surface_t. (Previous snapshots already provided this scheme
6283 for cairo_t, cairo_path_t, and cairo_pattern_t.)
6285 This changes two functions to have a return type of void rather than
6288 cairo_scaled_font_extent
6289 cairo_surface_finish
6291 And significantly, none of the create functions for any of the
6292 objects listed above will return NULL. The pointer returned from any
6293 function will now always be a valid pointer and should always be
6294 passed to the corresponding destroy function when finished
6296 The simplest strategy for porting code is to switch from:
6298 object = cairo_<object>_create ();
6304 cairo_<object>_destroy (object);
6308 object = cairo_<object>_create ();
6309 if (cairo_<object>_status (object))
6314 cairo_<object>_destroy (object);
6316 But significantly, it is not required to check for an error status
6317 before the "act on object" portions of the code above. All
6318 operations on an object with an error status are, by definition,
6319 no-ops without side effect. So new code might be written in an
6320 easier-to-read style of:
6322 object = cairo_<object>_create ();
6326 cairo_<object>_destroy (object);
6328 with cairo_<object>_status checks placed only at strategic
6329 locations. For example, passing an error object to another object,
6330 (eg. cairo_set_source with an in-error pattern), will propagate the
6331 error to the subsequent object (eg. the cairo_t). This means that
6332 error checking can often be deferred even beyond the destruction of
6337 * New functions for checking the status of objects that have been
6338 switched to the common error-handling scheme:
6340 cairo_font_face_status
6341 cairo_scaled_font_status
6342 cairo_surface_status
6344 * The _cairo_error function which was added in 0.5.1 has now been made
6345 much more useful. In 0.5.1 only errors on cairo_t objects passed
6346 through _cairo_error. Now, an error on any object should pass
6347 through _cairo_error making it much more reliable as a debugging
6348 mechanism for finding when an error first occurs.
6350 * Added new font options support with a myriad of functions:
6352 cairo_font_options_create
6353 cairo_font_options_copy
6354 cairo_font_options_destroy
6356 cairo_font_options_status
6358 cairo_font_options_merge
6359 cairo_font_options_equal
6360 cairo_font_options_hash
6362 cairo_font_options_set_antialias
6363 cairo_font_options_get_antialias
6364 cairo_font_options_set_subpixel_order
6365 cairo_font_options_get_subpixel_order
6366 cairo_font_options_set_hint_style
6367 cairo_font_options_get_hint_style
6368 cairo_font_options_set_hint_metrics
6369 cairo_font_options_get_hint_metrics
6371 cairo_surface_get_font_options
6373 cairo_ft_font_options_substitute
6375 cairo_set_font_options
6376 cairo_get_font_options
6378 This new font options support allows the application to have much
6379 more fine-grained control over how fonts are rendered.
6380 Significantly, it also allows surface backends to have some
6381 influence over the process. For example, the xlib backend now
6382 queries existing Xft properties to set font option defaults.
6386 cairo_xlib_surface_set_drawable
6388 which allows the target drawable for an xlib cairo_surface_t to be
6389 changed to another with the same format, screen, and display. This
6390 is necessary in certain double-buffering techniques.
6394 * Sub-pixel text antialiasing is now supported.
6398 * Fixed assertion failure in cairo_surface_create_similar when
6399 application commits an error by passing a cairo_format_t rather than
6402 * Avoid division by zero in various places (cairo-ft).
6404 * Fix infinite loop when using non-default visuals (cairo-xlib).
6406 * Eliminate segfault in cairo_image_surface_create_from_png_stream.
6408 * Prevent errant sign-extension of masks on 64-bit architectures
6409 (cairo-xlib and cairo-xcb).
6411 * Other miscellaneous fixes.
6413 Snapshot 0.5.2 (2005-07-18 Carl Worth <cworth@cworth.org>)
6414 ==========================================================
6417 * New functions for creating patterns of a single color:
6419 cairo_pattern_create_rgb
6420 cairo_pattern_create_rgba
6422 * Change cairo_surface_create_similar to accept a new type of
6423 cairo_content_t rather than cairo_format_t:
6425 typedef enum _cairo_content {
6426 CAIRO_CONTENT_COLOR = 0x1000,
6427 CAIRO_CONTENT_ALPHA = 0x2000,
6428 CAIRO_CONTENT_COLOR_ALPHA = 0x3000
6431 * Add new CAIRO_FORMAT_VALID and CAIRO_CONTENT_VALID macros.
6433 * Remove unused status value:
6435 CAIRO_STATUS_NO_TARGET_SURFACE
6437 * Add new status values:
6439 CAIRO_STATUS_INVALID_STATUS
6441 * Require libpixman >= 0.1.5 (for necessary bug fixes)
6445 * Fix cairo_surface_write_to_png for RGB24 images.
6447 * Fix broken metrics and rendering for bitmap fonts. Add mostly
6448 useless bitmap glyph transformation.
6450 * Fix glyph caches to not eject entries that might be immediately
6451 needed, (fixing intermittent crashes when rendering text).
6453 * Fix all memory leaks found by running "make check-valgrind".
6455 ATSUI backend changes
6456 ---------------------
6457 * Allow building against < 10.3 SDK.
6459 * Prevent crash on empty strings.
6461 Glitz backend changes
6462 ---------------------
6463 * Require glitz >= 0.4.4.
6465 * Use frame buffer objects instead of pbuffers for accelerated
6468 * Minor improvement to gradient pattern creation.
6470 PostScript backend fixes
6471 ------------------------
6472 * Rewrite of the PS backend to generate more interesting output that
6473 the old big-image implementation.
6477 * Implement glyph path support.
6479 * Fix swap of blue and green values in the fill_rectangles path.
6483 * Add optimization to use XCopyArea rather than XRenderComposite when
6484 transforming only with an integer translation, and using SOURCE
6485 operator or OVER with a source pattern without alpha.
6487 Snapshot 0.5.1 (2005-06-20 Carl Worth <cworth@cworth.org>)
6488 ==========================================================
6491 * Removed cairo_status_string(cairo_t*) and add
6492 cairo_status_to_string(cairo_status_t) in its place. Code using
6493 cairo_status_string can be ported forward as follows:
6497 cairo_status_to_string (cairo_status (cr));
6499 * Removed the BAD_NESTING restriction which means that two different
6500 cairo_t objects can now interleave drawing to the same
6501 cairo_surface_t without causing an error.
6503 * The following functions which previously had a return type of
6504 cairo_status_t now have a return type of void:
6506 cairo_pattern_add_color_stop_rgba
6507 cairo_pattern_set_matrix
6508 cairo_pattern_get_matrix
6509 cairo_pattern_set_extend
6510 cairo_pattern_set_filter
6512 See discussion of cairo_pattern_status below for more details.
6516 * Improved error handling:
6519 cairo_pattern_status (cairo_pattern_t *pattern);
6521 This snapshot expands the status-based error handling scheme from
6522 cairo_t to cairo_path_t and cairo_pattern_t. It also expands the
6523 scheme so that object-creating functions, (cairo_create,
6524 cairo_pattern_create_*, cairo_copy_path_*), are now guaranteed to
6525 not return NULL. Instead, in the case of out-of-memory these
6526 functions will return a static object with
6527 status==CAIRO_STATUS_NO_MEMORY. The status can be checked with the
6528 functions cairo_status and cairo_pattern_status, or by direct
6529 inspection of the new status field in cairo_path_t.
6531 Please note that some objects, including cairo_surface_t and all of
6532 the font-related objects have not been converted to this
6533 error-handling scheme.
6535 * In addition to the above changes, a new private function has been added:
6539 This function can be used to set a breakpoint in a debugger to make
6540 it easier to find programming error in cairo-using code. (Currently,
6541 _cairo_error is called when any error is detected within a cairo_t
6542 context, but is not called for non-cairo_t errors such as for
6543 cairo_path_t and cairo_pattern_t).
6545 * Fixed cairo_path_data_t so that its enum is visible to C++ code, (as
6546 cairo_path_data_type_t).
6548 Performance improvements
6549 ------------------------
6550 * Made a minor performance improvement for clipping, (restrict clip
6551 surface to the new intersected bounds).
6553 * Optimize rendering of a solid source pattern with a pixel-aligned
6554 rectangular path to use backend clipping rather than rasterization
6555 and backend compositing.
6557 * Optimize cairo_paint_with_alpha to defer to cairo_paint when alpha
6562 * Fixed memory leak in cairo_copy_path.
6564 * A build fix for non-srcdir builds.
6568 * New support for path-based clipping.
6570 * Fix for text rotated to angles other than multiples of π/2.
6574 * Fix for text extents.
6578 * Implemented a complex workaround for X server bug[*] related to
6579 Render-based compositing with untransformed, repeating source
6580 pictures. The workaround uses core Xlib when possible for
6581 performance, (ie. with CAIRO_OPERATOR_SOURCE or CAIRO_OPERATOR_OVER
6582 with an opaque source surface), and falls back to the pixman
6583 image-based compositing otherwise.
6585 [*] https://bugs.freedesktop.org/show_bug.cgi?id=3566
6587 * Various bug fixes, particularly in the fallback paths.
6589 Snapshot 0.5.0 (2005-05-17 Carl Worth <cworth@cworth.org>)
6590 ==========================================================
6591 This is a pretty big, and fairly significant snapshot. It represents
6592 between 2 and 3 months of solid work from a lot of people on improving
6593 the API as much as possible. I'd like to express my appreciation and
6594 congratulations to everyone who has worked on the big API Shakeup,
6595 (whether in email battles over names, or fixing my silly bugs).
6597 This snapshot will require some effort on the part of users, since
6598 there are a _lot_ of API changes (ie. no cairo program ever written is
6599 safe --- they're all broken now in at least one way). But, in spite of
6600 that, we do encourage everyone to move their code to this snapshot as
6601 soon as possible. And we're doing everything we can think of to make
6602 the transition as smooth as possible.
6604 The idea behind 0.5 is that we've tried to make every good API change
6605 we could want now, and get them all done with. That is, between now
6606 and the 1.0 release of cairo, we expect very few new API changes,
6607 (though some will certainly sneak in). We will have some significant
6608 additions, but the pain of moving code from cairo 0.4 to cairo 0.5
6609 should be a one time experience, and things should be much smoother as
6610 we continue to move toward cairo 1.0.
6612 And with so many changes coming out for the first time in this 0.5
6613 release, we really do need a lot of people trying this out to make
6614 sure the ideas are solid before we freeze the API in preparation for
6617 OK, enough introduction. Here is a (not-quite-complete) description of
6618 the API removals, changes and additions in this snapshot, (compared to
6623 The following public functions have been removed:
6625 - cairo_set_target_*
6627 This is a big change. See the description of cairo_create in
6628 the API changes section for how to deal with this.
6632 Alpha blending hasn't gone away; there's just a much more
6633 unified rendering model now. Almost all uses of
6634 cairo_set_alpha will be trivially replaced with
6635 cairo_set_source_rgba and a few others will be replaced just
6636 as easily with cairo_paint_with_alpha.
6638 - cairo_show_surface
6640 Another useful function that we realized was muddling up the
6641 rendering model. The replacement is quite easy:
6642 cairo_set_source_surface and cairo_paint.
6644 - cairo_matrix_create
6645 - cairo_matrix_destroy
6647 - cairo_matrix_get_affine
6649 These functions supported an opaque cairo_matrix_t. We now
6650 have an exposed cairo_matrix_t structure, so these can be
6653 - cairo_surface_set_repeat
6654 - cairo_surface_set_matrix
6655 - cairo_surface_set_filter
6657 These properties don't belong on surfaces. If you were using
6658 them, you'll just want to instead use
6659 cairo_pattern_create_for_surface and then set these properties
6664 This was a confusing function and hopefully nobody will miss
6665 it. But if you really don't find cairo_save/restore adequate,
6666 let us know and we have another idea for a potential
6669 And while we're on the subject of removals, we carefully tightened up
6670 the cairo header files so they no longer gratuitously include header
6671 files that are not strictly necessary, (stdio.h, stdint.h, pixman.h,
6672 Xrender.h, etc. and their dependencies). This may lead to some
6673 surprising errors, so keep your eyes open for that.
6677 Here are some of the API changes that have occurred:
6679 ~ cairo_create(void) -> cairo_create(cairo_surface_t *)
6681 This is the big change that breaks every program. The ability
6682 to re-target a cairo_t was not particularly useful, but it did
6683 introduce a lot of muddy semantic questions. To eliminate
6684 that, cairo_create now requires its target surface to be
6685 passed in at creation time. This isn't too hard to cope with
6686 as the typical first operation after cairo_create was often
6687 cairo_set_target_foo. So the order of those two swap and the
6688 application instead has cairo_foo_surface_create, then
6691 ~ cairo_current_* -> cairo_get_*
6693 We had a strange mixture of cairo_get and cairo_current
6694 functions. They've all been standardized on cairo_get, (though
6695 note one is cairo_get_current_point).
6697 ~ CAIRO_OPERATOR_SRC -> CAIRO_OPERATOR_SOURCE
6698 ~ CAIRO_OPERATOR_OVER_REVERSE -> CAIRO_OPERATOR_DEST_OVER
6700 Many of the cairo_operator_t symbolic values were renamed to
6701 reduce the amount of abbreviation. The confusing "OP_REVERSE"
6702 naming was also changed to use "DEST_OP" instead which is
6703 easier to read and has wider acceptance in other
6704 libraries/languages.
6706 ~ cairo_set_pattern -> cairo_set_source
6707 ~ cairo_set_rgb_color -> cairo_set_source_rgb
6709 All of the various functions that changed the source
6710 color/pattern were unified to use cairo_set_source names to
6711 make the relation more clear.
6713 ~ cairo_transform_point -> cairo_user_to_device
6714 ~ cairo_transform_distance -> cairo_user_to_device_distance
6715 ~ cairo_inverse_transform_point -> cairo_device_to_user
6716 ~ cairo_inverse_transform_distance -> cairo_device_to_user_distance
6718 These names just seemed a lot more clear.
6720 ~ cairo_init_clip -> cairo_reset_clip
6721 ~ cairo_concat_matrix -> cairo_transform
6723 More abbreviation elimination
6725 ~ cairo_current_path -> cairo_copy_path
6726 ~ cairo_current_path_flat -> cairo_copy_path_flat
6728 The former mechanism for examining the current path was a
6729 function that required 3 or 4 callbacks. This was more
6730 complexity than warranted in most situations. The new
6731 cairo_copy_path function copies the current path into an
6732 exposed data structure, and the documentation provides a
6733 convenient idiom for navigating the path data.
6739 A generalized version of the painting operators cairo_stroke
6740 and cairo_fill. The cairo_paint call applies the source paint
6741 everywhere within the current clip region. Very useful for
6742 clearing a surface to a solid color, or painting an image,
6743 (see cairo_set_source_surface).
6745 + cairo_paint_with_alpha
6747 Like cairo_paint but applying some alpha to the source,
6748 (making the source paint translucent, eg. to blend an image on
6753 A more generalized version of cairo_paint_with_alpha which
6754 allows a pattern to specify the amount of translucence at each
6755 point rather than using a constant value everywhere.
6757 + cairo_mask_surface
6759 A convenience function on cairo_mask for when the mask pattern
6760 is already contained within a surface.
6762 + cairo_surface_set_user_data
6763 + cairo_surface_get_user_data
6764 + cairo_font_face_set_user_data
6765 + cairo_font_face_get_user_data
6767 Associate arbitrary data with a surface or font face for later
6768 retrieval. Get notified when a surface or font face object is
6771 + cairo_surface_finish
6773 Allows the user to instruct cairo to finish all of its
6774 operations for a given surface. This provides a safe point for
6775 doing things such as flushing and closing files that the
6776 surface may have had open for writing.
6778 + cairo_fill_preserve
6779 + cairo_stroke_preserve
6780 + cairo_clip_preserve
6782 One interesting change in cairo is that the path is no longer
6783 part of the graphics state managed by
6784 cairo_save/restore. This allows functions to construct paths
6785 without interfering with the graphics state. But it prevents
6786 the traditional idiom for fill-and-stroke:
6788 cairo_save; cairo_fill; cairo_restore; cairo_stroke
6790 Instead we know have alternate versions cairo cairo_fill,
6791 cairo_stroke, and cairo_clip that preserve the current path
6792 rather than consuming it. So the idiom now becomes simply:
6794 cairo_fill_preserve; cairo_stroke
6796 + cairo_surface_write_to_png
6797 + cairo_surface_write_to_png_stream
6799 In place of a single PNG backend, now a surface created
6800 through any backend (except PDF currently) can be written out
6803 + cairo_image_surface_create_from_png
6804 + cairo_image_surface_create_from_png_stream
6806 And its just as easy to load a PNG image into a surface as well.
6810 With the new, exposed path data structure, it's now possible
6811 to append bulk path data to the current path, (rather than
6812 issuing a long sequence of cairo_move_to/line_to/curve_to
6815 Xlib and XCB backends
6816 ---------------------
6818 Any cairo_format_t and Colormap arguments have been dropped from
6819 cairo_xlib_surface_create. There are also two new
6820 cairo_xlib|xcb_surface_create functions:
6822 cairo_xlib|xcb_surface_create_for_bitmap
6823 (Particular for creating A1 surfaces)
6824 cairo_xlib|xcb_surface_create_with_xrender_format
6825 (For any other surface types, not described by a Visual*)
6827 All of these surface create functions now accept width and height. In
6828 addition, there are new cairo_xlib|xcb_surface_set_size functions
6829 which must be called each time a window that is underlying a surface
6832 Print backends (PS and PDF)
6833 ---------------------------
6834 The old FILE* based interfaces have been eliminated. In their place we
6835 have two different functions. One accepts a simple const char
6836 *filename. The other is a more general function which accepts a
6837 callback write function and a void* closure. This should allow the
6838 flexibility needed to hook up with various stream object in many
6841 In addition, when specifying the surface size during construction, the
6842 units are now device-space units (ie. points) rather than inches. This
6843 provides consistency with all the other surface types and also makes
6844 it much easier to reason about the size of the surface when drawing to
6845 it with the default identity matrix.
6847 Finally, the DPI parameters, which are only needed to control the
6848 quality of fallbacks, have been made optional. Nothing is required
6849 during surface_create (300 DPI is assumed) and
6850 cairo_ps|pdf_surface_set_dpi can be used to set alternate values if
6855 Owen very graciously listened to feedback after the big font rework he
6856 had done for 0.4, and came up with way to improve it even more. In 0.4
6857 there was a cairo_font_t that was always pre-scaled. Now, there is an
6858 unscaled cairo_font_face_t which is easier to construct, (eg. no
6859 scaling matrix required) and work with, (it can be scaled and
6860 transformed after being set on the graphics state). And the font size
6861 manipulation functions are much easier. You can set an explicit size
6862 and read/modify/write the font matrix with:
6865 cairo_get_font_matrix
6866 cairo_set_font_matrix
6868 (Previously you could only multiply in a scale factor or a matrix.) A
6869 pleasant side effect is that we can (and do) now have a default font
6870 size that is reasonable, as opposed to the old default height of one
6871 device-space unit which was useless until scaled.
6873 Of course, the old pre-scaled font had allowed some performance
6874 benefits when getting many metrics for a font. Those benefits are
6875 still made available through the new cairo_scaled_font_t. And a
6876 cairo_font_face_t can be "promoted" to a cairo_scaled_font_t by
6877 suppling a font_matrix and the desired CTM.
6881 Tim Rowley put in the work to bring the Quartz backend back after it
6882 had been disabled in the 0.4.0 snapshot. He was not able to bring back
6883 the function that allows one to create a cairo_font_t from an ATSUI
6887 cairo_atsui_font_create (ATSUStyle style);
6889 because he didn't have a test case for it. If you care about this
6890 function, please provide a fairly minimal test and we'll try to bring
6891 it back in an upcoming snapshot.
6893 Snapshot 0.4.0 (2005-03-08 Carl Worth <cworth@cworth.org>)
6894 ==========================================================
6897 Owen Taylor has converted cairo's documentation system to gtk-doc and
6898 has begun some long-needed work on the documentation, which can now be
6901 http://cairographics.org/manual/
6905 This is the first snapshot to include a functional win32 backend,
6906 (thanks to Owen Taylor). The interface is as follows:
6908 #include <cairo-win32.h>
6911 cairo_set_target_win32 (cairo_t *cr,
6915 cairo_win32_surface_create (HDC hdc);
6918 cairo_win32_font_create_for_logfontw (LOGFONTW *logfont,
6919 cairo_matrix_t *scale);
6922 cairo_win32_font_select_font (cairo_font_t *font,
6926 cairo_win32_font_done_font (cairo_font_t *font);
6929 cairo_win32_font_get_scale_factor (cairo_font_t *font);
6931 And see also the documentation at:
6933 http://cairographics.org/manual/cairo-Microsoft-Windows-Backend.html
6935 Disabled backend: quartz
6936 ------------------------
6937 Unfortunately, the quartz backend code is currently out of date with
6938 respect to some recent backend interface changes. So, the quartz
6939 backend is disabled in this snapshot.
6941 If the quartz backend is brought up-to-date before the next snapshot,
6942 we would be glad to make a 0.4.1 snapshot that re-enables it, (we do
6943 not expect many more big backend interface changes).
6947 The font system has been revamped, (as Owen Taylor's work with
6948 integrating pango and cairo gave us the first serious usage of the
6951 One fundamental, user-visible change is that the cairo_font_t object
6952 now represents a font that is scaled to a particular device
6953 resolution. Further changes are described below.
6957 Removed cairo_font_set_transform and cairo_font_current_transform.
6959 Added cairo_font_extents and cairo_font_glyph_extents. See
6960 documentation for details:
6962 http://cairographics.org/manual/cairo-cairo-t.html#cairo-font-extents
6966 The cairo_ft_font API changed considerably. Please see the
6967 documentation for details:
6969 http://cairographics.org/manual/cairo-FreeType-Fonts.html
6973 Make the fast-path clipping (pixel-aligned rectangles) faster.
6975 Add optimization for applying a constant alpha to a pattern.
6977 Optimize gradients that are horizontal or vertical in device space.
6979 Xlib: When RENDER is not available, use image surfaces for
6980 intermediate surfaces rather than xlib surfaces.
6982 Backend-specific changes
6983 ------------------------
6986 Major update to glitz backend. The output quality should now be just
6987 as good as the image and xlib backends.
6989 Track changes to glitz 0.4.0.
6993 Various improvements to produce more conformant output.
6997 David Reveman contributed a large re-work of the cairo_pattern_t
6998 implementation, providing cleaner code and more optimization
7001 Backend interface changes
7002 -------------------------
7003 Rework backend interface to accept patterns, not surfaces for source
7006 Remove set_matrix, set_filter, and set_repeat functions.
7008 More sophisticated backend interface for image fallbacks,
7009 ({acquire,release}_{source,dest}_image() and clone_similar).
7013 Only install header files for backends that have been compiled.
7015 Fixed some rounding errors leading to incorrectly placed glyphs.
7017 Many other minor fixes.
7019 Snapshot 0.3.0 (2005-01-21 Carl Worth <cworth@cworth.org>)
7020 ==========================================================
7023 1) The public header files will no longer be directly installed into
7024 the system include directory. They will now be installed in a
7025 subdirectory named "cairo", (eg. in /usr/include/cairo rather than
7028 As always, the easiest way for applications to discover the
7029 location of the header file is to let pkg-config generate the
7030 necessary -I CFLAGS and -L/-l LDFLAGS. For example:
7032 cc `pkg-config --cflags --libs cairo` -o foo foo.c
7034 IMPORTANT: Users with old versions of cairo installed will need to
7035 manually remove cairo.h and cairo-features.h from the
7036 system include directories in order to prevent the old
7037 headers from being used in preference to the new ones.
7039 2) The backend-specific portions of the old monolithic cairo.h have
7040 been split out into individual public header files. The new files
7053 Applications will need to be modified to explicitly include the new
7054 header files where appropriate.
7056 3) There are two new graphics backends in this snapshot, a PDF
7057 backend, and a Quartz backend. There is also one new font backend,
7062 Kristian Høgsberg has contributed a new backend to allow cairo-based
7063 applications to generate PDF output. The interface for creating a PDF
7064 surface is similar to that of the PS backend, as can be seen in
7068 cairo_set_target_pdf (cairo_t *cr,
7070 double width_inches,
7071 double height_inches,
7072 double x_pixels_per_inch,
7073 double y_pixels_per_inch);
7076 cairo_pdf_surface_create (FILE *file,
7077 double width_inches,
7078 double height_inches,
7079 double x_pixels_per_inch,
7080 double y_pixels_per_inch);
7082 Once a PDF surface has been created, applications can draw to it as
7083 any other cairo surface.
7085 This code is still a bit rough around the edges, and does not yet
7086 support clipping, surface patterns, or transparent gradients. Text
7087 only works with TrueType fonts at this point and only black text is
7088 supported. Also, the size of the generated PDF files is currently
7091 Kristian is still actively developing this backend, so watch this
7092 space for future progress.
7096 Calum Robinson has contributed a new backend to allow cairo
7097 applications to target native Mac OS X windows through the Quartz
7098 API. Geoff Norton integrated this backend into the current
7099 configure-based build system, while Calum also provided Xcode build
7100 support in the separate "macosx" module available in CVS.
7102 The new interface, available in cairo-quartz.h, is as follows:
7105 cairo_set_target_quartz_context (cairo_t *cr,
7106 CGContextRef context,
7111 cairo_quartz_surface_create (CGContextRef context,
7115 There is an example program available in CVS in cairo-demo/quartz. It
7116 is a port of Keith Packard's fdclock program originally written for
7117 the xlib backend. A screenshot of this program running on Mac OS X is
7120 http://cairographics.org/~cworth/images/fdclock-quartz.png
7124 This new font backend complements the Quartz backend by allowing
7125 applications to use native font selection on Mac OS X. The interface
7126 is a single new function:
7129 cairo_atsui_font_create (ATSUStyle style);
7133 Prototype for non-existent function "cairo_ft_font_destroy" removed.
7135 Now depends on libpixman 0.1.2 or newer, (0.1.3 is being released
7136 concurrently and has some useful performance improvements).
7138 Default paint color is now opaque black, (was opaque white). Default
7139 background color is transparent (as before).
7141 Renamed "struct cairo" to "struct _cairo" to free up the word "cairo"
7142 from the C++ identifier name space.
7144 Functions returning multiple return values through provided pointers,
7145 (cairo_matrix_get_affine, cairo_current_point, and
7146 cairo_current_color_rgb), will now accept NULL for values the user
7149 CAIRO_HAS_FREETYPE_FONT has now been renamed to CAIRO_HAS_FT_FONT.
7151 Performance improvements
7152 ------------------------
7153 Alexander Larsson provided some fantastic performance improvements
7154 yielding a 10000% performance improvement in his application, (when
7155 also including his performance work in libpixman-0.1.3). These include
7157 * Fixed handling of cache misses.
7159 * Creating intermediate clip surfaces at the minimal size required.
7161 * Eliminating roundtrips when creating intermediate Xlib surfaces.
7165 Major re-work of font metrics system by Keith Packard. Font metrics
7166 should now be much more reliable.
7170 Updated for glitz-0.3.0.
7171 Bug fixes in reference counting.
7175 New tests for cache crashing, rotating text, improper filling of
7176 complex polygons, and leaky rasterization.
7180 Fixed assertion failure when selecting the same font multiple times in
7183 Fixed reference counting so cache_destroy functions work.
7185 Remove unintended copyright statement from files generated with
7188 Fixed to eliminate new warnings from gcc 3.4 and gcc 4.
7190 Snapshot 0.2.0 (2004-10-27 Carl Worth <cworth@cworth.org>)
7191 ===========================================================
7192 New license: LGPL/MPL
7193 ---------------------
7194 The most significant news with this release is that the license of
7195 cairo has changed. It is now dual-licensed under the LGPL and the
7196 MPL. For details see the COPYING file as well as COPYING-LGPL-2.1 and
7199 I express my thanks to everyone involved in the license change process
7200 for their patience and support!
7202 New font and glyph internals
7203 ----------------------------
7204 Graydon Hoare has put a tremendous amount of work into new internals
7205 for handling fonts and glyphs, including caches where appropriate.
7206 This work has no impact on the user-level API, but should result in
7207 great performance improvements for applications using text.
7211 This snapshot of cairo includes a (small) test suite in
7212 cairo/test. The tests can be run with "make check". The test suite was
7213 designed to make it very easy to add new tests, and we hope to see
7214 many contributions here. As you find bugs, please try adding a minimal
7215 test case to the suite, and submit it with the bug report to the
7216 cairo@cairographics.org mailing list. This will make it much easier
7217 for us to track progress in fixing bugs.
7219 New name for glitz backend
7220 --------------------------
7221 The gl backend has now been renamed to the glitz backend. This means
7222 that the following names have changed:
7224 CAIRO_HAS_GL_SURFACE -> CAIRO_HAS_GLITZ_SURFACE
7225 cairo_set_target_gl -> cairo_set_target_glitz
7226 cairo_gl_surface_create -> cairo_glitz_surface_create
7228 This change obviously breaks backwards compatibility for applications
7229 using the old gl backend.
7231 Up-to-date with latest glitz snapshots
7232 --------------------------------------
7233 This snapshot of cairo is now up to date with the latest glitz
7234 snapshot, (currently 0.2.3). We know that the latest cairo and glitz
7235 snapshots have been incompatible for a very long time. We've finally
7236 fixed that now and we're determined to not let that happen again.
7238 Revert some tessellation regression bugs
7239 ----------------------------------------
7240 People that have been seeing some tessellation bugs, (eg. leaked
7241 fills), in the CVS version of cairo may have better luck with this
7242 release. A change since the last snapshot was identified to trigger
7243 some of these bugs and was reverted before making the snapshot. The
7244 behavior should be the same as the previous (0.1.23) snapshot.
7246 Miscellaneous changes
7247 ---------------------
7248 Changed CAIRO_FILTER_DEFAULT to CAIRO_FILTER_BEST to make gradients
7251 Track XCB API change regarding iterators.
7255 Fix calculation of required number of vertices for pen.
7257 Fix to avoid zero-dimensioned pixmaps.
7259 Fix broken sort of pen vertices.
7261 Fix bug when cairo_show_text called with a NULL string.
7265 Fix bug in computing image length with XCB.
7267 Fix infinite loop bug in cairo_arc.
7269 Fix memory management interactions with libpixman.
7271 Snapshot 0.1.23 (2004-05-11 Carl Worth <cworth@isi.edu>)
7272 ========================================================
7275 Fix prototype mismatches so that cairo can be built by gcc 3.4.
7277 Updates to track glitz
7278 ----------------------
7279 Various fixes to support the latest glitz snapshot (0.1.2).
7283 Radial gradients now support both inner and outer circles.
7284 Transformed linear gradients are now properly handled.
7285 Fixes for extend type reflect.
7289 Converted shading routines to use fixed point values and introduced a
7290 shading operator structure for more efficient shading calculations.
7291 Support compositing with mask surface when mask is solid or
7292 multi-texturing is available.
7294 PNG backend cleanups
7295 --------------------
7296 Fix output to properly compensate for pre-multiplied alpha format in cairo.
7297 Add support for A8 and A1 image formats.
7301 Avoid crash or infinite loop on null strings and degeneratively short
7304 New? bugs in cairo_clip
7305 -----------------------
7306 There are some fairly serious bugs in cairo_clip. It is sometimes
7307 causing an incorrect result. And even when it does work, it is
7308 sometimes so slow as to be unusable. Some of these bugs may not be
7309 new, (indeed cairo_clip has only ever had a braindead-slow
7310 implementation), but I think they're worth mentioning here.
7312 Snapshot 0.1.22 (2004-04-16 Carl Worth <cworth@isi.edu>)
7313 ========================================================
7314 Cairo was updated to track the changes in libpixman, and now depends
7315 on libpixman version 0.1.1.
7317 Snapshot 0.1.21 (2004-04-09 David Reveman <c99drn@cs.umu.se>)
7318 =============================================================
7321 The OpenGL backend provides hardware accelerated output for
7322 X11 and OS X. The significant new functions are:
7325 cairo_gl_surface_create
7327 Automatic detection of available backends
7328 -----------------------------------------
7329 The configure script now automatically detect what backends are
7330 available, (use ./configure --disable-`backend' to prevent
7331 compilation of specific backends).
7333 Snapshot 0.1.20 (2004-04-06 Carl Worth <cworth@isi.edu>)
7334 ========================================================
7337 David Reveman has contributed a new pattern API which enable linear
7338 and radial gradient patterns in addition to the original surface-based
7339 patterns. The significant new top-level functions are:
7341 cairo_pattern_create_linear
7342 cairo_pattern_create_radial
7343 cairo_pattern_create_for_surface
7344 cairo_pattern_add_color_stop
7347 Any code using the old cairo_set_pattern, (which accepted a
7348 cairo_surface_t rather than a cairo_pattern_t), will need to be
7351 Update to XCB backend
7352 ---------------------
7353 The XCB backend is now enabled by default, (use ./configure
7354 --disable-xcb to turn it off).
7358 Graydon Hoare has added optimizations that make cairo_clip much faster
7359 when the path is a pixel-aligned, rectangular region.
7363 Snapshot 0.1.19 (2004-02-24 Carl Worth <cworth@isi.edu>)
7364 ========================================================
7367 Olivier Andrieu contributed a new PNG backend. It builds on the
7368 existing image backend to make it easy to render "directly" to a
7369 .png file. The user never needs to deal with the actual image
7370 buffer. The significant new functions are:
7372 cairo_set_target_png
7373 cairo_png_surface_create
7375 The PNG backend is not enabled by default so that by default there is
7376 not a new dependency on libpng. Use ./configure --enable-png to enable
7379 Snapshot 0.1.18 (2004-02-17 Carl Worth <cworth@isi.edu>)
7380 ========================================================
7381 Path query functionality
7382 ------------------------
7383 It's now possible to query the current path. The two new functions
7387 cairo_current_path_flat
7389 Each function accepts a number of callback functions that will be
7390 called for each element in the path (move_to, line_to, curve_to,
7391 close_path). The cairo_current_path_flat function does not accept a
7392 curve_to callback. Instead, all curved portions of the path will be
7393 converted to line segments, (within the current tolerance value). This
7394 can be handy for doing things like text-on-path without having to
7395 manually interpolate Bézier splines.
7399 Jamey Sharp has contributed a second X backend that uses the new, lean
7400 XCB library rather than Xlib. It cannot currently be compiled at the
7401 same time as the Xlib backend. See ./configure --enable-xcb.
7403 Build fixes for cygwin.
7407 Snapshot 0.1.17 (2003-12-16 Carl Worth <cworth@isi.edu>)
7408 ========================================================
7412 This snapshot provides much better text support by implementing the
7413 following four functions:
7420 The text/glyph_extents functions can be used to determine the bounding
7421 box (and advance) for text as if drawn by show_text/glyphs.
7423 The text/glyph_path objects functions place text shapes on the current
7424 path, where they can be subsequently manipulated. For example,
7425 following these functions with cairo_stroke allows outline text to be
7426 drawn. Calling cairo_clip allows clipping to a text-shaped region.
7428 Combined dependencies
7429 ---------------------
7430 The cairo core now depends only on the libpixman library. This single
7431 library replaces the three previous libraries libic, libpixregion, and
7432 slim. Thanks to Dave Beckett <dave.beckett@bristol.ac.uk> for all of
7433 the heavy lifting with this renaming effort.
7435 Conditional compilation of backends
7436 -----------------------------------
7437 Cairo now allows optional backends to be disabled at compile time. The
7438 following options may now be passed to the configure script:
7443 Note that the first option is a change from the old --without-x option
7444 which will no longer have any effect.
7446 OS X supported - several byte-order issues resolved
7447 ---------------------------------------------------
7448 Cairo has now been successfully compiled under OS X. Testing revealed
7449 that there were some byte-order problems in the PostScript backend and
7450 the PNG generation in the demos. These have now been resolved.
7454 Graydon Hoare <graydon@redhat.com> implemented the first real text
7455 support using Freetype/fontconfig, (previous versions of cairo used
7456 Xft and could only draw text when using an X backend).
7460 Graydon Hoare <graydon@redhat.com> added the first real support for
7461 running cairo with a non-render-aware X server.
7463 Jamey Sharp <jamey@minilop.net> virtualized the backend font and
7464 surface interfaces in September, 2003.
7468 Xr is renamed cairo to avoid confusion since it no longer had a strict
7473 A new image surface backend is added to Xr. Keith Packard
7474 <keithp@keithp.com> wrote the image compositing code in libic that is
7475 used for the image_surface backend. This code was originally written
7476 as the software fallback for the render extension within the X
7481 Carl Worth <cworth@isi.edu> wrote the first lines of Xr, after Keith
7482 Packard <keithp@keithp.com> proposed the plan for a stateful drawing
7483 library in C providing a PostScript-like rendering model.
7485 LocalWords: mutex BeOS extraordinaire distro's URL lcd bool tarball