1 Release 1.12.16 (2013-08-21 Chris Wilson <chris@chris-wilson.co.uk>)
2 ===================================================================
3 Thanks to everybody who reported a bug and helped us develop a fix,
4 we have amassed quite a few bug fixes. There are still more outstanding
5 bugs that seek attention and a little bit of TLC, but this release has
6 been delayed long enough...
11 Set the correct orientation for simple boxes with a negative scale
14 Fix the creation of the shading dictionary in PDF.
16 Fix a crash in PDF when incorporating an image with CAIRO_EXTEND_PAD.
17 https://bugs.freedesktop.org/show_bug.cgi?id=61451
19 Avoid upscaling bitmap fonts if possible.
21 Fix an assertion failure within the mempool allocator for shared memory.
23 Fix allocation size for CFF subsets.
25 Export cairo_matrix_t for GObject bindings.
27 Fix a double free in the Quartz backend.
28 https://bugs.freedesktop.org/show_bug.cgi?id=62885
30 Fix origin of GDI StretchBlits for the Windows backend
31 https://bugs.freedesktop.org/show_bug.cgi?id=61876
33 Fix error propagation for requests to create a similar surface with
35 https://bugs.freedesktop.org/show_bug.cgi?id=63196
37 Fix complex clipping of trapezoids with regions
38 https://bugzilla.gnome.org/show_bug.cgi?id=697357
40 Stop leaking the image data when loading PNGs
42 Fix unbounded operations with a clip mask through the span compositor
43 https://bugs.freedesktop.org/show_bug.cgi?id=61592
45 Add missing checks before rendering to a finished surface - so we return
46 an error rather than hit an assert.
47 https://bugs.freedesktop.org/show_bug.cgi?id=68014
49 Prevent an assertion failure when creating similar GL surfaces larger
50 than supported by hardware.
52 Prevent a double free of a similar image under Windows.
53 https://bugs.freedesktop.org/show_bug.cgi?id=63787
56 Release 1.12.14 (2013-02-10 Chris Wilson <chris@chris-wilson.co.uk>)
57 ===================================================================
58 In the last week we had a few more bugs reported and promptly resolved.
59 As these are a combination of regressions and stability issues, it is
60 time for a prompt update and release. Many thanks to everyone for
61 testing and reporting issues, and helping to make Cairo better.
66 Prevent user callbacks accessing user-data during destroy to prevent
68 https://bugzilla.mozilla.org/show_bug.cgi?id=722975
70 Use standard names for glyphs in subset fonts (PDF).
71 https://bugs.freedesktop.org/show_bug.cgi?id=60248
73 Fix detection of Win98. The logic for detecting Win98 (and its broken
74 AlphaBlend()) was inverted, disabling AlphaBlend() for everyone.
76 Prevent numeric overflow from extrapolating polygon edges to the clip
77 boundary and causing severe render artifacts.
78 https://bugs.freedesktop.org/show_bug.cgi?id=60489
80 Fix computation of glyph string coordinates when breaking up runs
83 Fix an assertion in the win32 backend for failing to clear its
85 https://bugs.freedesktop.org/show_bug.cgi?id=60519
88 Release 1.12.12 (2013-01-31 Chris Wilson <chris@chris-wilson.co.uk>)
89 ===================================================================
90 The goal of this release is to fix the synchronisation problems that
91 were exhibited in the SHM transport for cairo-xlib. This cropped up
92 any place that tried to rapidly push fresh pixel data to the X server
93 through an ordinary image surface, such as gimp-2.9 and evince.
98 Avoid replacing the entire image when uploading subimages
99 https://bugs.freedesktop.org/show_bug.cgi?id=59635
101 Force synchronisation for scratch SHM image buffers, so that we do
102 not overwrite data as it is being read by X.
103 https://bugs.freedesktop.org/show_bug.cgi?id=59635 (also)
105 Fix typos in detecting multisampling for the GL (MSAA) backend.
107 Fix a memory leak in the GL (MSAA) backend.
109 Fix a reference counting bug when mapping a GL surface to an image.
112 Release 1.12.10 (2013-01-16 Chris Wilson <chris@chris-wilson.co.uk>)
113 ===================================================================
114 A heap of bug fixes everywhere, and the gradual completion of the MSAA
115 backend for cairo-gl. Perhaps the most noteworthy set of the bugfixes
116 was the crusage lead by Behdad Eshfabod to make font handling by
117 pango/cairo/fontconfig fully threadsafe. This testing revealed a couple
118 of races that needed fixing in Cairo's scaled-font and glyph cache.
123 Append coincident elements to the recording's surface bbtree so that
124 the list is not corrupted and the overlapping elements lost.
126 Fix cairo-trace to correctly record map-to-image/unmap-image and then
129 Ignore MappingNotifies when running the XCB testsuite as they are sent
130 to all clients when the keyboard changes. The testsuite would detect
131 the unexpected event and complain.
133 Handle very large images in the XCB backend.
135 Fix a memory leak in the xlib/shm layer, and prevent use of the SHM
136 surfaces after the display is closed.
137 https://bugs.freedesktop.org/show_bug.cgi?id=58253
139 Handle resizing of bitmap fonts, in preparation for a fix to
140 fontconfig to correctly pass on the user request for scaling.
142 Always include subroutine 4 (hint replacement idion) when subsetting
143 type 1 fonts in order to prevent a crash in cgpdftops on Mac OS/X
145 Fix a couple of typos in the cairo-gobject.h header files for
148 Prevent a mutex deadlock when freeing a scaled-glyph containing a
149 recording-surface that itself references another scaled-glyph.
150 https://bugs.freedesktop.org/show_bug.cgi?id=54950
152 Make scaled-font cache actually thread-safe and prevent
155 Restore support for older versions of XRender. A couple of typos and a
156 few forgotten chunks prevented the xlib compositor from running
157 correctly with XRender < 0.10. Note that there are still a few
158 regressions remaining.
161 Release 1.12.8 (2012-11-24 Chris Wilson <chris@chris-wilson.co.uk>)
162 ===================================================================
163 Another couple of weeks and a few more bugs have been found and fixed,
164 it is time to push the next point release. Many thanks to everyone who
165 reported their issues and helped us track down the bugs and helped
171 Expand the sanity checking for broken combinations of XSendEvent and
174 Notice that "The X.Org Foundation" sometimes also identifies itself
175 as "The Xorg Foundation".
177 Handle various ages of libXext and its Shm headers.
179 Fix the invalid clipping of the source drawable when using SHM
180 transport to upload images.
181 https://bugs.freedesktop.org/show_bug.cgi?id=56547
183 Handle all Type1 postscript operators for better font compatibility.
184 https://bugs.freedesktop.org/show_bug.cgi?id=56265
186 Fix a couple of memory leaks in Type1 font subsetting
187 https://bugs.freedesktop.org/show_bug.cgi?id=56566
189 Tighten the evaluation of the start/stop pen vertices, and catch a few
190 instances where we would use a fan instead of a bevel.
191 https://bugs.freedesktop.org/show_bug.cgi?id=56432
193 Fix assumption that geometric clipping always succeeds with the
195 https://bugs.freedesktop.org/show_bug.cgi?id=56574
197 Fix call to spline intersection when evaluating whether a stoke is
200 Remember to copy inferior sources when using SHM to readback the
201 surface for use as a source.
203 Release 1.12.6 (2012-10-22 Chris Wilson <chris@chris-wilson.co.uk>)
204 ===================================================================
205 Thanks to everyone who download cairo-1.12.4 and gave us their feedback.
206 It truly was invaluable and has helped us to fix many portability issues
207 that crept in with some of the new features. This release aims to fix
208 those stability issues and run on a wider range of systems.
213 Fix the recording surface to actually snapshot the source and so fix
216 Calling XSendEvent with an XShmCompletionEvent is incompatabile with
219 Reorder CloseDisplay chain so that XShm is not reinstantiated after
220 shutdown, causing a potential crash if the Display was immediately
221 recreated using the same memory address.
223 Make sure that the Xserver has attached to the SHM segment before
224 deleting it from the global namespace on systems that do not support
227 Type1 subsetting support for PDF (and PS) was once again improved to
228 work with a larger number of PDF readers.
230 GLESv2 build fixes and improved support for embedded GPUs.
232 Tweak the invisible pen detection for applications that are currently
233 using too large values for geometric tolerance.
235 A build fix for older freetype libraries.
238 Release 1.12.4 (2012-10-05 Chris Wilson <chris@chris-wilson.co.uk>)
239 ===================================================================
240 More bugs, and more importantly, more fixes. On the cairo-gl side, we
241 have refinements to the MSAA compositor which enables hardware
242 acceleration of comparitively low-quality antialiasing - which is useful
243 in animations and on very high density screens. For cairo-xlib, we have
244 finally enabled SHM transport for image transfers to and from the X
245 server. A long standing required feature, SHM transport offers a notable
246 reduction in rendering latency by reducing the number of copies
247 required to upload image data - given hardware and driver support,
248 cairo-xlib can now perform zero copy uploads onto the GPU. And as usual
249 Adrian Johnson has been very busy fixing many different corner cases in
250 cairo-pdf, impoving opacity groups and font subsetting. Last, but not
251 least, for cairo-image Søren Sandmann Pedersen added support for
252 rendering glyphs to pixman and using that from within cairo. The new
253 glyph rendering facility reduces the overhead for setting up the
254 compositing operation, improving glyph thoughput for the image backend
255 by a factor of about 4. And before he did so, he also fixed up a few
256 bugs in the existing glyph rendering code. So many thanks to Andrea
257 Canciani, Adrian Johnson, Chuanbo Weng, Dongyeon Kim, Henry Song, Martin
258 Robinson, Søren Sandmann Pedersen and Uli Schlachter for their
259 contributions, finding and fixing bugs.
264 Interior boxes were being dropped when amalgamating regions during
266 https://bugs.freedesktop.org/show_bug.cgi?id=49446
268 Allow building without gtk-doc installed
270 Invalid edge generation whilst reducing complex polygons.
271 https://bugs.freedesktop.org/show_bug.cgi?id=50852
273 Stroking around tight cusps
275 Use locale correct formats for reading font subsetting and valid
277 https://bugs.freedesktop.org/show_bug.cgi?id=51443
279 Ensure that the type1 subset includes all the glyph encodings
280 https://bugs.freedesktop.org/show_bug.cgi?id=53040
282 Upload the whole source for a repeating pattern.
283 https://bugs.freedesktop.org/show_bug.cgi?id=51910
285 Fix damage tracking to handle continuation chunks corectly and so
286 prevent crashes on win32.
287 https://bugs.freedesktop.org/show_bug.cgi?id=53384
289 Avoid emitting miter joins for degenerate line segments
290 https://bugzilla.mozilla.org/show_bug.cgi?id=407107
292 Convert the relative path semgents into the backend coordinates
293 and then back again to user coordinates (cairo_copy_path,
295 https://bugs.freedesktop.org/show_bug.cgi?id=54732
297 Fix extents computations for a degenerate path consisting only of a
299 https://bugs.freedesktop.org/show_bug.cgi?id=54549
301 Prevent crashing on a degenerate project edge after polygon
303 https://bugs.freedesktop.org/show_bug.cgi?id=54822
307 Release 1.12.2 (2012-04-29 Chris Wilson <chris@chris-wilson.co.uk>)
308 ===================================================================
309 After such a long gestation period for the release of Cairo 1.12, we
310 inevitably accumulated a few bugs that were flushed out by broadening the
311 test base. Thanks to everybody who tried the release, apologies to any one
312 unfortunate enough to encounter a bug and many thanks for reporting it. As
313 a result Adrian Johnson, Alexandros Frantzis, Andrea Canciani, Kalev
314 Lember, Maarten Bosman, Marcus Meissner, Nis Martensen and Uli Schlachter
315 have squashed many more bugs and improved the documentation. I would
316 strongly recommend everyone to upgrade to cairo-1.12.2.
322 Allow applications to create 0x0 xlib surfaces, such as used by LibreOffice.
323 https://bugs.freedesktop.org/show_bug.cgi?id=49118
325 Trim composite extents for SOURCE/CLEAR operators to the mask.
327 Use fallback fonts in PDF for unhandled computed glyph widths
328 https://bugs.freedesktop.org/show_bug.cgi?id=48349
330 Handle snapshots of recording surfaces for analysing pattern extents.
331 Fixes a regression of reporting the PDF bounding box as being the page size.
333 Fix allocation size for PDF pattern ids.
334 Bugzilla: https://bugs.freedesktop.org/show_bug.cgi?id=49089
336 Fix emission of rectilinear dashed segments, with and without scaling, and
337 application of degenerate line joins.
339 Clamp unbounded fixup polygons to the clip extents.
341 Prevent infinite loop due to rounding errors whilst incrementing along dashes.
343 Prevent overflow for inline a8 span filling.
345 Miscellaneous build fixes for Cygwin on Windows and Solaris.
347 Release 1.12.0 (2012-03-23 Chris Wilson <chris@chris-wilson.co.uk>)
348 ===================================================================
349 It's taken over 18 months, but the wait is finally over. A new cairo release!
350 We are pleased to annouce a new stable release of Cairo that brings many
351 new features and performance improvements, all whilst maintaining
352 compatibility with cairo-1.0 and all releases since. We recommend anyone
353 using a previous release of Cairo to upgrade to 1.12.0.
355 The major feature of this release is the introduction of a new procedural
356 pattern; the mesh gradient. This, albeit complex, gradient is constructed
357 from a set of cubic Bezier patches and is a superset of all other gradient
358 surfaces which allows for the construction of incredibily detailed patterns.
359 In PDF parlance, the mesh gradient corresponds with type 7 patterns. Many
360 thanks to Andrea Canciani for bringing this to Cairo, and for his work on
361 making gradient handling robust.
363 Not content with just adding another procedural pattern, Cairo 1.12 also
364 adds new API to create a callback pattern,
365 cairo_pattern_create_raster_source, that allows the application to
366 provide the pixel data for the region of interest at the time of
367 rendering. This can be used for instance, by an application to decode
368 compressed images on demand and to keep a cache of those decompressed
369 images, independently of Cairo. When combined with the recording
370 surface, it should form a useful basis for a deferred renderer.
372 With the release of cairo-1.12, we also introduce a new supported
373 backend for interoperating with X using XCB. Uli Schlachter, also
374 maintainer of awesome and contributor to libxcb, has volunteered to
375 maintain cairo-xcb for us. Thanks Uli!
377 For cairo-1.12, we have also added some common API to address any
378 surface as an image and so allow direct modification of the raster data.
379 Previously, only the Quartz and Win32 backends supported a very narrow
380 interface to allow for efficient pixel upload. Now with
381 cairo_surface_create_similar_image, cairo_surface_map_to_image, and
382 cairo_surface_unmap_image, Cairo exports a consistent method for
383 treating those surfaces as an image and so allow modification inplace.
384 These are the same routines used internally, and should support
385 efficient transfer or direct mapping of the target surfaces as
388 Another focus over the past year has been to address many performance
389 issues, without sacrificing the composition model. To accomplish the
390 goal, once again the rasterisation pipeline was overhauled and made
391 explicit, giving the backends the freedom to implement their own
392 specific pipeline whilst also providing a library of common routines
393 from which to build the pipeline. For instance, this allows the image
394 backend and the gl backend to composite scan line primitives inplace,
395 and to then implement custom fallbacks to catch the corner cases that do
396 not map onto their fastest paths. Similarly, this allows for the Xlib
397 backend to implement trapezoidation without compromising the other
398 backends, yet still allow for the pipeline to be used elsewhere for
399 testing and fallbacks. Clipping was once again overhauled, so that the
400 common cases for the raster pipelines could be captured and processed
401 with fast paths with the emphasis on performing geometric clipping to
402 reduce the frequency of using multi-pass clipmasks. Stroking was made
403 faster, both by providing specialised fast-paths for simple, yet frequent,
404 cases (such as stroking around a rectangle) and by reducing the number
405 of edges generated by the general stroker.
407 As part of the focus on performance, Cairo 1.12 introduces some
408 antialias hints (NONE,FAST, GOOD, BEST) that are interpolated by the
409 raserisers to fine tune their performance versus quality. Cairo 1.12
410 also introduces a new observation architecture,
411 cairo_surface_observer_t, which can be used to analyse the amount of
412 time consumed by drawing commands and help identify inefficiencies in
413 both Cairo and the application.
415 Last, but by no means least, the OpenGL backend has seen significant
416 work including the port to GLESv2 and the exploitation of advanced
417 hardware features. Interesting times.
419 As always, I would like to thank everyone who contributed to Cairo,
420 not only through writing code, but also submitting documentation, bug
421 reports, suggestions and generally having fun with Cairo! In particular
422 though this release could not have happened without the efforts of
423 Adrian Johnson, Alexandros Frantiz, Andrea Canicani, Martin Robinson,
424 Nis Martensen, and Uli Schlachter. Thanks.
427 Snapshot 1.11.4 (2012-13-12)
428 ============================
429 The cairo community is pleased to finally announce the long aniticpated
430 release candidate for 1.12, 1.11.4, of the cairo graphics library. This
431 is the first major update to cairo in over a year and brings a large
432 number of new features; undoubtably a few bugs as well.
434 While many people have contributed and have helped to test the release,
435 providing feedback on 1.10 and suggesting improvements, this release
436 is the result of a few persevering souls who deserve recognition for their
437 outstanding contributions: Andrea Canciani (all round bug fixing,
438 performance tuning and master of the gradients), Adrian Johnson (PDF
439 supremo) and Uli Schlachter (who stepped forward as maintainer for the
442 Major additions since 1.11.2:
444 * cairo_surface_map_to_image API for pixel level access to any surface
446 * New antialias hints to control the trade-off between speed and quality
448 * A callback pattern, cairo_pattern_create_raster_source, for lazy
449 decoding of image data.
451 * cairo_surface_observer_t, a new type of surface to gather performance
454 * XCB as a supported backend
456 * A rewritten compositor pipeline for performance improvements for, but not
457 limited to, the xlib and image backends.
458 From ION and PineView through to SandyBridge, every machine I have shows
459 across the board performance improvement on the cairo-traces:
461 i5-2520m gnome-system-monitor: 5.97x speedup
462 pnv gnome-system-monitor: 4.86x speedup
463 i5-2520m firefox-asteroids: 4.66x speedup
464 pnv firefox-asteroids: 4.43x speedup
465 image firefox-canvas: 3.82x speedup
466 i5-2520m firefox-canvas-alpha: 3.49x speedup
467 image firefox-asteroids: 2.87x speedup
468 pnv firefox-talos-svg: 2.83x speedup
469 ion grads-heat-map: 2.75x speedup
470 pnv firefox-canvas-alpha: 2.66x speedup
471 image gnome-system-monitor: 2.66x speedup
472 image swfdec-giant-steps: 2.46x speedup
473 image firefox-canvas-alpha: 2.14x speedup
474 i5-2520m firefox-talos-svg: 2.03x speedup
475 image grads-heat-map: 2.02x speedup
476 ion gnome-system-monitor: 2.00x speedup
477 pnv firefox-particles: 1.99x speedup
478 i5-2520m grads-heat-map: 1.96x speedup
479 pnv firefox-canvas: 1.92x speedup
480 ion firefox-particles: 1.80x speedup
481 image poppler-reseau: 1.77x speedup
482 pnv xfce4-terminal-a1: 1.72x speedup
483 image firefox-talos-svg: 1.65x speedup
484 pnv grads-heat-map: 1.63x speedup
485 i5-2520m firefox-canvas: 1.63x speedup
486 pnv swfdec-youtube: 1.62x speedup
487 image ocitysmap: 1.59x speedup
488 i5-2520m firefox-fishbowl: 1.56x speedup
489 i5-2520m poppler-reseau: 1.50x speedup
490 i5-2520m evolution: 1.50x speedup
491 i5-2520m midori-zoomed: 1.43x speedup
492 pnv firefox-planet-gnome: 1.42x speedup
493 i5-2520m firefox-talos-gfx: 1.41x speedup
494 i5-2520m gvim: 1.41x speedup
495 pnv ocitysmap: 1.37x speedup
496 image poppler: 1.31x speedup
497 ion firefox-canvas-alpha: 1.35x speedup
498 ion firefox-talos-svg: 1.34x speedup
499 i5-2520m ocitysmap: 1.32x speedup
500 pnv poppler-reseau: 1.31x speedup
501 i5-2520m firefox-planet-gnome: 1.31x speedup
502 pnv firefox-fishbowl: 1.30x speedup
503 pnv evolution: 1.28x speedup
504 image gvim: 1.27x speedup
505 i5-2520m swfdec-youtube: 1.25x speedup
506 pnv gnome-terminal-vim: 1.27x speedup
507 pnv gvim: 1.25x speedup
508 image firefox-planet-gnome: 1.25x speedup
509 image swfdec-youtube: 1.25x speedup
512 And a plethora of minor improvements everywhere!
515 Snapshot 1.11.2 (2011-01-23)
516 ===========================
518 In this first snapshot along the way to cairo-1.12.0, we are very excited
519 to announce the introduction of Bezier surface gradients, known as type
520 6/7 gradients in PS/PDF parlance. This is the culmination of much work by
521 the dynamic duo: Adrian Johnson and Andrea Canciani. Thanks guys!
523 Also, I want to warmly welcome Uli Schlachter who recently joined the
524 Cairo community on a mission. That mission is to make cairo-xcb a
525 supported backend for 1.12. And for this snapshot he has made great
526 strides in fixing all the bugs I had left behind. Thanks Uli!
528 And we have also seen a new contributor, Alexandros Frantzis, who has
529 begun bringing up cairo-gl for GLESv2 devices. Thanks Alex!
531 And lastly, I must also thank Adrian and Andrea for the vast numbers of
532 bugs that they have tackled between them, fixing all those little corner
533 cases that lie hidden until too late.
537 The ability to construct piece-wise Bezier surface gradients:
539 cairo_pattern_create_mesh
541 constructs a pattern of type CAIRO_PATTERN_TYPE_MESH using
543 cairo_pattern_mesh_begin_patch
544 cairo_pattern_mesh_end_patch
545 cairo_pattern_mesh_curve_to
546 cairo_pattern_mesh_line_to
547 cairo_pattern_mesh_move_to
548 cairo_pattern_mesh_set_control_point
549 cairo_pattern_mesh_set_corner_color_rgb
550 cairo_pattern_mesh_set_corner_color_rgba
551 cairo_pattern_mesh_get_patch_count
552 cairo_pattern_mesh_get_path
553 cairo_pattern_mesh_get_corner_color_rgba
554 cairo_pattern_mesh_get_control_point
556 The introduction of a unique ID accessible via the mime data type:
557 CAIRO_MIME_TYPE_UNIQUE_ID
563 Release 1.10.2 (2010-12-25 Chris Wilson <chris@chris-wilson.co.uk>)
564 ===================================================================
565 The cairo community is pleased to announce the 1.10.2 release of the
566 cairo graphics library. This is the first update to cairo's stable 1.10
567 series and contains a large number of bug fixes.
569 While many people have contributed and have help to test the release,
570 2 people deserve special recognition for their efforts in tracking down
571 and fixing bugs, Andrea Canciani and Adrian Johnson. Thanks to their
572 tremendous efforts, and of all cairo contributors, it is much
575 We recommend everyone upgrade to cairo 1.10.2 and hope that everyone
576 will continue to have lots of fun with cairo!
583 Fix embedding of grayscale jpegs in PS.
584 https://bugs.freedesktop.org/show_bug.cgi?id=31632
586 Fix the reported path of extents containing a curve.
588 Fix the compositing of unaligned boxes.
590 Reset the clipper in PDF upon finish.
592 Fix degenerates arcs to become a degenerate line.
594 Build support for autoconf 2.67
596 Fix painting of transformed patterns in PS
598 Fix the EPS bounding box for PS
599 https://bugs.freedesktop.org/show_bug.cgi?id=24688
601 Fix the missing content for EPS
602 https://bugs.freedesktop.org/show_bug.cgi?id=24688
604 Fix regression upon changing page size in PS/PDF
605 https://bugs.freedesktop.org/show_bug.cgi?id=24691
607 Only use ActualText with PDF-1.5 documents
609 Fix the bbox for type1 fallbacks.
611 Reset the color after ending the context in PDF
612 https://bugs.freedesktop.org/show_bug.cgi?id=31140
614 Fix the advance of subsetted type1 fonts
615 https://bugs.freedesktop.org/show_bug.cgi?id=31062
617 Fix handling of EXTEND_NONE gradients for PDF
619 Restrict in-place optimisation for a8 image masks with SOURCE
622 Release 1.10.0 (2010-09-06 Chris Wilson <chris@chris-wilson.co.uk>)
623 ===================================================================
624 The cairo community is astounded (and flabbergast) to finally announce
625 the 1.10.0 release of the cairo graphics library. This is a major update
626 to cairo, with new features and enhanced functionality which maintains
627 compatibility for applications written using any previous major cairo
628 release, (1.8, 1.6, 1.4, 1.2, or 1.0). We recommend that anybody using
629 a previous version of cairo upgrade to cairo 1.10.0.
631 One of the more interesting departures for cairo for this release is the
632 inclusion of a tracing utility, cairo-trace. cairo-trace generates a
633 human-readable, replayable, compact representation of the sequences of
634 drawing commands made by an application. This can be used to inspecting
635 applications to understand issues and as a means for profiling
636 real-world usage of cairo.
638 The traces generated by cairo-trace have been collected in
640 git://git.cairographics.org/git/cairo-traces
642 and have driven the performance tuning of cairo over the last couple of
643 years. In particular, the image backend is much faster with a new
644 polygon rasterisation and a complete overhaul of the tessellator. Not
645 only is this faster, but also eliminates visual artifacts from
646 self-intersecting strokes. Not only has cairo-trace been driving
647 performance improvements within cairo, but as a repeatable means of
648 driving complex graphics it has been used to tune OpenGL, DDX, and
651 Cairo's API has been extended to better support printing, notably
652 through the ability to include a single compressed representation of an
653 image for patterns used throughout a document, leading to dramatic file
654 size reductions. Also the meta-surface used to record the vector
655 commands compromising a drawing sequence is now exposed as a
656 CAIRO_SURFACE_TYPE_RECORDING, along with a new surface that is a child of a
657 larger surface, CAIRO_SURFACE_TYPE_SUBSURFACE. One typical usage of a
658 subsurface would be as a source glyph in a texture atlas, or as a
659 restricted subwindow within a canvas.
661 Cairo's API has also resurrected the RGB16 format from the past as
662 the prevalence of 16-bit framebuffers has not diminished and is a
663 fore-taste of the extended format support we anticipate in the future.
664 Increasing cairo's utility, we introduce the cairo_region_t for handling
665 sets of pixel aligned rectangles commonly used in graphics applications.
666 This is a merger of the GdkRegion and the pixman_region_t, hopefully
667 providing the utility of the former with the speed of the latter.
669 Furthermore cairo has been reworked to interoperate more closely with
670 various acceleration architectures, gaining the ability to share
671 those hardware resources through the new cairo_device_t. For instance,
672 with the new OpenGL backend that supersedes the Glitz backend, hardware
673 and rendering operations can be shared between a classic OpenGL
674 application mixing libVA for the hardware assisted video decode with
675 cairo for high quality overlays all within the same OpenGL canvas.
677 Many thanks for the hard work of Adrian Johnson, Andrea Canciani, Behdad
678 Esfahbod, Benjamin Otte, Carl Worth, Carlos Garcia Campos, Chris Wilson,
679 Eric Anholt, Jeff Muizelaar, Karl Tomlinson, M Joonas Pihlaja, Søren
680 Sandmann Pedersen and many others that have contributed over the last
681 couple of years to cairo. Thank you all!
683 Snapshot 1.9.14 (2010-07-26)
684 ============================
686 A quiet couple of weeks, hopefully Cairo is seeing widescale deployment and
687 we are being to see the results of the stabilisation effort. Clipping bugs
688 seems to have been the order of the last couple of weeks, with a couple
689 reported and duly fixed. Thank you Igor Nikitin and Karl Tomlinsion for
690 finding those regressions. At this point all that seems to remain to do is
691 to fix the outstanding regressions in the PDF backend...
696 Clip doesn't work for text on the image backend
697 https://bugs.freedesktop.org/show_bug.cgi?id=29008
699 Add explicit dependency for cxx
700 https://bugs.freedesktop.org/show_bug.cgi?id=29114
702 Fix regressions in reporting clip extents
703 https://bugs.freedesktop.org/show_bug.cgi?id=29120
704 https://bugs.freedesktop.org/show_bug.cgi?id=29121
705 https://bugs.freedesktop.org/show_bug.cgi?id=29122
706 https://bugs.freedesktop.org/show_bug.cgi?id=29124
707 https://bugs.freedesktop.org/show_bug.cgi?id=29125
710 Snapshot 1.9.12 (2010-07-12)
711 ============================
713 A couple of weeks spent fixing those annoying bugs and cleaning up the build
714 system; the list of outstanding tasks to complete for the stable release is
715 finally shrinking. The chief bug fixer has been Benjamin Otte who not only
716 made sure that the public API is consistent and being tested for its
717 consistency, but also ensured that the documentation was up-to-date and
718 spent time clarifying cases where even the Cairo developers have come
719 unstuck in the past. Many thanks, Benjamin. However, he was not alone,
720 as Andrea Canciani continued his fine work in isolating broken corner cases
721 and proceeding to fix them, and tidying up the quartz backend. And last, but
722 definitely not least, M Joonas Pihlaja tried building Cairo across a
723 perverse range of systems and fixed up all the loose bits of code that came
724 unravelled. Thanks everybody!
729 cairo_surface_set_mime_data, cairo_surface_get_mime_data:
731 The length parameter is now an unsigned long (as opposed to an unsigned
732 int). The parameter is intended to be an equivalent to a size_t without
733 requiring POSIX types and be large enough to store the size of the
734 largest possible allocation.
736 cairo_gl_surface_create_for_texture:
738 This a new surface constructor for cairo-gl that explicitly enables
739 render-to-texture for foreign, i.e. application, textures.
741 cairo_region_xor, cairo_region_xor_rectangle
743 A couple of utility routines add to the region handling interface for
744 the purpose of replacing existing GdkRegion functionality.
749 https://bugs.launchpad.net/ubuntu/+source/cairo/+bug/600622
751 Inkscape was caught in the act of attempting to modify a finished surface.
752 Unfortunately, we had the ordering of our guards and assertions wrong and
753 so an ordinary application error was triggering an assert in Cairo. This
754 lead Benjamin to add a test case to ensure that the entire public API
755 could handle erroneous input and then proceeded to fix a whole slew of
759 https://bugs.freedesktop.org/show_bug.cgi?id=28888
761 A regression introduced by the special casing of uploading images to an
762 xlib surface in-place which was ignoring the translation applied to the
766 Snapshot 1.9.10 (2010-06-26)
767 ============================
769 The first "quick" snapshot in the run up to the stable release. The
770 last snapshot was picked up by the bleeding edge distributions and so the
771 bug reports have to started to roll in. The most frequent of these are the
772 introduction of rendering errors by applications that modify a surface
773 without subsequently calling cairo_surface_mark_dirty(). Make sure the
774 application developers are aware of increased reliance on strict use of the
775 Cairo API before 1.10 is released!
777 The usual slew of bugs reported and we would like to thank Zoxc for
778 contributing the WGL interface for cairo-gl, and finding more build
779 failures on win32. And it just wouldn't be a 1.9 snapshot unless
780 Benjamin Otte improved the error handling within cairo-gl, as well as
781 isolating and fixing some more errors in the test suite. The biggest bug of
782 the snapshot turned out to be a major sign extension issue that had lain
783 hidden for many years and was suddenly exposed by incorrectly rounding
784 rectangles when performing non-antialiased rendering. Also to the relief
785 of many we have included the downstream patch to honour the user's LCD
786 filtering preferences for subpixel rendering of fonts. The interface
787 remains private for the time being, whilst the proposed public API is
794 Snapshot 1.9.8 (2010-06-12)
795 ===========================
797 One major API changes since the last snapshot, and a whole slew of bugs
798 fixed and inconsistencies eliminated. Far too many bugs fixed to
799 individually identify. We need to thank Benjamin Otte for his fantastic
800 work on the cairo-gl backend making it faster and more robust, Andrea
801 Canciani for finding so many bugs and developing test cases for them, as
802 well fixing them. And last but not least we must all thank Adrian Johnson for
803 continuing to eliminate bugs and improving the PostScript and PDF backends.
805 This snapshot represents almost 4 months of bug fixing, bringing Cairo to
806 a point where we consider it almost ready to be a candidate for release.
807 There are a few known bugs left to be fixed, being tracked in
808 https://bugs.freedesktop.org/show_bug.cgi?id=24384, so please give Cairo a
809 whirl and report any regressions. The plan is to release a new snapshot
810 every other week leading to a 1.10 release with a target date of
815 CAIRO_FORMAT_RGB16_565
817 16 bit devices still remain popular, and so with great demand,
818 CAIRO_FORMAT_RGB16_565 has been restored enabling applications to create
819 and use 16 bit images as sources and render targets.
821 cairo_surface_create_for_rectangle()
823 It is common practice to cut an image up into many smaller pieces and use
824 each of those as a source - a technique called texture atlasing.
825 cairo_surface_create_for_rectangle() extends Cairo to directly support use
826 of these subregions of another cairo_surface_t both as a source and as a
829 cairo_region_create()
830 cairo_region_create_rectangle()
831 cairo_region_create_rectangles()
833 cairo_region_reference()
834 cairo_region_destroy()
836 cairo_region_status()
837 cairo_region_get_extents()
838 cairo_region_num_rectangles()
839 cairo_region_get_rectangle()
840 cairo_region_is_empty()
841 cairo_region_contains_rectangle()
842 cairo_region_contains_point()
843 cairo_region_translate()
844 cairo_region_subtract()
845 cairo_region_subtract_rectangle()
846 cairo_region_intersect()
847 cairo_region_intersect_rectangle()
849 cairo_region_union_rectangle()
851 The Cairo region API was actually added a couple of snapshots ago, but we
852 forgot to mention it at the time. A simple API for the handling of
853 rectangular pixel-aligned regions by Soeren Sandmann.
856 Backend-specific improvements
857 -----------------------------
860 Benjamin Otte made more than 200 commits in which he refactored the cairo-gl
861 backend, reducing a lot of code duplication and enabled him to begin working
862 on improving performance by reducing state changes and associated overhead.
866 Access to the underlying connection to the Display is now thread-safe
867 enabling cairo-xlib to be used in a multi-threaded application without fear
868 of random corruption. Thanks Benjamin Otte!
870 cairo-xlib will now attempt to use PolyModeImprecise when compositing
871 trapezoids (i.e. a fill or a stroke operation with a non-trivial path) which
872 should allow hardware drivers more scope for accelerating the operation at
873 the cost of potentially incurring minute rendering errors. The mode can be
874 forced back to PolyModePrecise by setting the antialias parameter to
875 CAIRO_ANTIALIAS_SUBPIXEL.
879 A notable improvement was contributed by Alexander Shulgin to enable SVG to
880 reference external image through the use an extended MIME data type.
882 Snapshot 1.9.6 (2010-02-19)
883 ===========================
888 The device is a generic method for accessing the underlying interface
889 with the native graphics subsystem, typically the X connection or
890 perhaps the GL context. By exposing a cairo_device_t on a surface and
891 its various methods we enable finer control over interoperability with
892 external interactions of the device by applications. The use case in
893 mind is, for example, a multi-threaded gstreamer which needs to serialise
894 its own direct access to the device along with Cairo's across many
897 Secondly, the cairo_device_t is a unifying API for the mismash of
898 backend specific methods for controlling creation of surfaces with
899 explicit devices and a convenient hook for debugging and introspection.
901 The principal components of the API are the memory management of:
903 cairo_device_reference(),
904 cairo_device_finish() and
905 cairo_device_destroy();
907 along with a pair of routines for serialising interaction:
909 cairo_device_acquire() and
910 cairo_device_release()
912 and a method to flush any outstanding accesses:
914 cairo_device_flush().
916 The device for a particular surface may be retrieved using:
918 cairo_surface_get_device().
920 The device returned is owned by the surface.
922 API changes (to API new in the cairo 1.9.x series)
923 --------------------------------------------------
924 cairo_recording_surface_create()
925 cairo_recording_surface_ink_extents()
927 These are the replacement names for the functions previously named
928 cairo_meta_surface_create and cairo_meta_surface_ink_extents.
930 cairo_surface_set_mime_data
932 This interface is now changed such that the MIME data will be
933 detached if the surface is modified at all. This guarantees that
934 the MIME data will not become out of synch due to surface
935 modifications, and also means that for the MIME data to be useful,
936 it must be set after all modifications to the surface are
939 API removal (of experiment API)
940 -------------------------------
941 The cairo-glitz backend is removed entirely, (in favor of the new
942 cairo-gl backend). See below for more on cairo-gl.
947 Many improvements for drawing of dashed strokes
949 Fix incorrect handling of negative offset
950 Faster computation of first dash (avoids near-infinite looping)
951 Approximate extremely fine dash patterns with appropriate alpha value
953 Optimize spans-based renderers for repeated rows, (such as in a rounded rectangle)
955 Backend-specific improvements
956 -----------------------------
959 This is a new, direct-rendering backend that supports Intel graphics
960 chipsets in the i915 and i965 families. It's still experimental and
961 will likely remain that way for a while. It's already got extremely
962 good performance on the hardware it supports, so if nothing else
963 provides a working proof and performance target for the cairo-gl
964 work for Intel graphics.
968 Start using GLSL to accelerate many operations. Many thanks to Eric
969 Anholt and T. Zachary Laine for this work. For the first time, we
970 have what looks like what will be a very compelling OpenGL-based
971 backend for cairo (in terms of both quality and performance).
973 See this writeup from Eric for more details on recent progress of
974 cairo-gl (which he presented at FOSDEM 2010):
976 http://anholt.livejournal.com/42146.html
980 The image backend is made dramatically faster (3-5 times faster for
981 benchmarks consisting primarily of glyph rendering).
985 Many fixes from Robert O'Callahan and Andrea Canciani including:
987 Fixed gradient pattern painting
988 Improved A8 image handling
989 Fixes for "unbounded" and other compositing operators
993 Improvements to embedding of JPEG and JPEG2000 data.
997 Fix printing of rotated user fonts.
999 Snapshot 1.9.4 (2009-10-15)
1000 ===========================
1003 cairo_meta_surface_create()
1004 cairo_meta_surface_ink_extents()
1006 Finally exporting the internal meta-surface so that applications
1007 have a method to record and replay a sequence of drawing commands.
1011 Determines whether a given point is inside the current clip.
1012 ??? Should this be called cairo_in_paint() instead? in-clip is the test
1013 that is performed, but in-paint would be similar to in-fill and in-stroke.
1019 A companion to cairo-perf-trace, this utility replays a trace against
1020 multiple targets in parallel and looks for differences in the output,
1021 and then records any drawing commands that cause a failure.
1023 Further minimisation of the fail trace using "delta debugging".
1024 More control over test/reference targets.
1026 Backend improvements:
1030 Server-side gradients. The theory is that we can offload computation
1031 of gradients to the GPU and avoid pushing large images over the
1032 connection. Even if the driver has to fallback and use pixman to render
1033 a temporary source, it should be able to do so in a more efficient manner
1034 than Cairo itself. However, cairo-perf suggests otherwise:
1036 On tiny, Celeron/i915:
1038 before: firefox-20090601 211.585
1039 after: firefox-20090601 270.939
1041 and on tiger, CoreDuo/nvidia:
1043 before: firefox-20090601 70.143
1044 after: firefox-20090601 87.326
1046 In particular, looking at tiny:
1048 xlib-rgba paint-with-alpha_linear-rgba_over-512 47.11 (47.16 0.05%) -> 123.42 (123.72 0.13%): 2.62x slowdown
1050 xlib-rgba paint-with-alpha_linear3-rgba_over-512 47.27 (47.32 0.04%) -> 123.78 (124.04 0.13%): 2.62x slowdown
1054 New experimental backends:
1058 OpenVG - The initial work was done by Øyvind Kolås, and made ready for
1059 inclusion by Pierre Tardy.
1061 OpenGL - An advanced OpenGL compositor. The aim is to write a integrate
1062 directed rendering using OpenGL at a high-level into Cairo. In
1063 contrast to the previous attempt using Glitz which tried to
1064 implement the RENDER protocol on top of OpenGL, using the
1065 high-level interface should permit greater flexibility and
1066 more offloading onto the GPU.
1067 The initial work on the backend was performed by Eric Anholt.
1069 Long standing bugs fixed:
1071 Self-intersecting strokes.
1073 A long standing bug where the coverage from overlapping semi-opaque
1074 strokes (including neighbouring edges) was simply summed in lieu of
1075 a costly global calculation has been fixed (by performing the costly
1076 global calculation!) In order to mitigate the extra cost, the
1077 tessellator has been overhauled and tune, which handles the fallback
1078 for when we are unable to use the new span rasteriser on the stroke
1079 (e.g. when using the current RENDER protocol). The large number of
1080 pixel artefacts that implementing self-intersection elimination
1081 removes is ample justification for the potential performance
1082 regression. If you unfortunately do suffer a substantial performance
1083 regression in your application, please consider obtaining a
1084 cairo-trace and submitting it to us for analysis and inclusion into
1085 our performance suite.
1089 To the AuroraUX team for providing access to one of their OpenSolaris
1090 machines for cairo and pixman development. http://www.auroraux.org/
1092 Snapshot 1.9.2 (2009-06-12)
1093 ===========================
1096 cairo_surface_set_mime_data()
1097 cairo_surface_get_mime_data()
1099 Should this take unsigned int, unsigned long or size_t for the length
1100 parameter? (Some datasets may be >4GiB in size.)
1102 Associate an alternate, compressed, representation for a surface.
1104 "image/jp2" (JPEG2000) is understood by PDF >= 1.5
1105 "image/jpeg" is understood by PDF,PS,SVG,win32-printing.
1106 "image/png" is understood by SVG.
1109 cairo_pdf_surface_restrict_to_version()
1110 cairo_pdf_get_versions()
1111 cairo_pdf_version_to_string()
1113 Similar to restrict to version and level found in SVG and PS,
1114 these limit the features used in the output to comply with the PDF
1115 specification for that version.
1117 CAIRO_STATUS_INVALID_SIZE
1118 Indicates that the request surface size is not supported by the
1119 backend. This generally indicates that the request is too large.
1121 CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED
1122 Indicates that a required callback for a user-font was not implemented.
1124 CAIRO_STATUS_LAST_STATUS
1125 This is a special value to indicate the number of status values enumerated
1126 at compile time. (This may differ to the number known at run-time.)
1128 The built-in twin font is now called "@cairo:" and supports a limited set
1129 of options like "@cairo:mono". Where are these specified?
1131 cairo_in_fill() now uses HTML Canvas semantics, all edges are inside.
1133 New experimental backends:
1139 cairo-trace and cairo-perf-trace
1141 cairo-trace generates a human-readable, replayable, compact(-ish!)
1142 representation of the sequences of drawing commands made by an
1145 Under the util/cairo-script directory is a library to replay traces.
1147 perf/cairo-perf-trace replays traces against multiple backends
1148 and makes useful benchmark reports. This is integrated with
1149 'make perf'. You may collect your own traces or take advantage
1150 of traces collected by the community:
1152 git://git.cairographics.org/git/cairo-traces
1154 (Put this into perf/cairo-traces to run these as part of "make perf".)
1156 There is additional WIP in building a debugging tool for cairo applications
1157 based on CairoScript (currently very preliminary, mostly serves to show
1158 that GtkSourceView is too slow) :
1160 people.freedesktop.org:~ickle/sphinx
1162 Test suite overhaul:
1164 The test suite is undergoing an overhaul, primarily to improve its speed
1165 and utility. (Expect more changes in the near future to improve XFAIL
1169 polygon rasterisation! Joonas implemented the Tor polygon scan converter,
1170 on typical geometry is about 30% faster for the image backend.
1172 Bovine Polaroids! For those not in on the joke, this is the long
1173 awaited "copy-on-write snapshot" or "COW snapshot" support. The
1174 user-visible feature is that including the same image multiple times
1175 into a PDF file should result in only a single instance of that
1176 image in the final output. This is unlike previous versions of cairo
1177 which would generate very large PDF files with multiple copies of
1178 the same image. Adrian says that the PDF is not quite working as
1179 well as it should yet, so we hope for futher improvements before
1186 Better handling of large scale-factors on image patterns.
1188 Emit /Interpolate for PS,PDF images.
1190 Global glyph cache - cap on the total number of inactive glyphs,
1191 should prove fairer for fonts with larger glyph sets.
1193 Compilation without fontconfig
1195 Improved handling of low-bitdepth sources (e.g. copying the contents
1196 of 16-bit xserver windows)
1200 cairo_traps_extract_region >10x slower. Fix pending.
1204 Region tracking API (ssp) for damage tracking, hit testing etc
1207 An expiremental OpenGL backend?
1209 Tweaks to tessellator, allocations of patterns, delayed
1210 initialisation of the xlib backend (reduce the cairo overhead of
1211 render_bench by ~80%).
1214 Release 1.8.8 (2009-06-16 Chris Wilson <chris@chris-wilson.co.uk>)
1215 ==================================================================
1216 The cairo community is pleased to announce the 1.8.8 release of the
1217 cairo graphics library. This is the fourth update to cairo's stable
1218 1.8 series and contains a small number of bug fixes (in particular a
1219 few corrections to the documentation and a few fixes in the FreeType font
1220 backend). This is being released just over six months after cairo 1.8.6.
1222 We recommend that everyone using cairo upgrade to 1.8.8.
1228 There were reports of incompatibilities with the autotools bundled in with
1229 the 1.8.6 tarball. This release has been built with automake-1.10.2 and
1232 The configure check for FreeType has been improved:
1234 typo in check for version of freetype in configure script
1235 https://bugs.freedesktop.org/show_bug.cgi?id=19283
1237 Compilation on 64-bit MacOS/X fixes:
1239 Cannot build cairo_quartz_font_face_create_for_atsu_font_id on 64-bit Mac OS X
1240 https://bugs.freedesktop.org/show_bug.cgi?id=15702
1244 Uninitialised status return within _cairo_clip_intersect_mask(). This caused
1245 random crashes and general mayhem as an error could be generated causing all
1246 rendering to the context to stop.
1248 Avoid transforming nearly-degenerate matrices into degenerate matrices:
1250 Painting stops in this case, using -moz-transform: scale, rotate and video
1251 https://bugzilla.mozilla.org/show_bug.cgi?id=467423
1253 A few FreeType font handling bugs were fixed:
1255 Rendering with PANGO_GRAVITY_EAST leads to different results with image and pdf
1256 https://bugs.freedesktop.org/show_bug.cgi?id=21985
1258 Don't call FT_Done_Face() on faces we did not create
1260 zombie ft_font_face / ft_unscaled_font mutual referencing problems
1261 http://bugs.freedesktop.org/show_bug.cgi?id=21706
1263 Ensure win32 font backend sets the return value to -1 (indicating the absent
1264 glyph) if the font index lookup for the unicode character fails. And
1265 similarly fix a bug where a fatal error was raised for an invalid glyph.
1267 cairo_scaled_font_glyph_extents breaks with invalid glyph id
1268 http://bugs.freedesktop.org/show_bug.cgi?id=20255
1270 Various improvements to the documentation, reported by Truc Troung:
1272 https://bugs.freedesktop.org/show_bug.cgi?id=20095
1273 https://bugs.freedesktop.org/show_bug.cgi?id=20154
1274 https://bugs.freedesktop.org/show_bug.cgi?id=20180
1275 https://bugs.freedesktop.org/show_bug.cgi?id=20183
1276 https://bugs.freedesktop.org/show_bug.cgi?id=20182
1277 https://bugs.freedesktop.org/show_bug.cgi?id=20441
1280 Release 1.8.6 (2008-12-13 Chris Wilson <chris@chris-wilson.co.uk>)
1281 ==================================================================
1282 The cairo community is pleased to announce the 1.8.6 release of the
1283 cairo graphics library. This is the third update to cairo's stable
1284 1.8 series and contains a small number of bug fixes (in particular a
1285 few fixes for failures of cairo 1.8.4 on Quartz and PDF, and build fixes for
1286 a couple of backends). This is being released just under a month after
1289 We recommend that everyone using cairo upgrade to 1.8.6.
1295 Fix build of DirectFB backend with debugging enabled:
1297 Bug in _cairo_directfb_surface_release_source_image function
1298 http://bugs.freedesktop.org/show_bug.cgi?id=18322
1304 Workaround a mis-compilation of cairo_matrix_invert() that generated invalid
1305 matrices and triggered assertion failures later. The issue was reported by
1308 Invalid computation of the modulus:
1310 https://bugzilla.mozilla.org/show_bug.cgi?id=466258
1312 Invalid referencing of patterns in the Quartz backend:
1314 Failed assertion `CAIRO_REFERENCE_COUNT_HAS_REFERENCE
1315 (&pattern->ref_count)' when using cairo quartz backend
1316 http://bugs.freedesktop.org/show_bug.cgi?id=18632
1318 Invalid references to glyphs after early culling, causing segmentation faults
1321 http://lists.cairographics.org/archives/cairo/2008-December/015976.html
1323 Check for XRender in the XCB backend, or else we may attempt an invalid memory
1326 XCB backend fails with missing render.
1327 https://bugs.freedesktop.org/show_bug.cgi?id=18588
1329 Release 1.8.4 (2008-11-14 Carl Worth <cworth@cworth.org>)
1330 =========================================================
1331 The cairo community is pleased to announce the 1.8.4 release of the
1332 cairo graphics library. This is the second update to cairo's stable
1333 1.8 series and contains a small number of bug fixes, (in particular a
1334 few fixes for build failures of cairo 1.8.2 on various systems). This
1335 is being released just over two weeks after cairo 1.8.2.
1337 We recommend that everyone using cairo upgrade to 1.8.4.
1343 Fix build with older XRender that doesn't define RepeatNone:
1345 Build of xlib backend fails against old XRender (RepeatNone undeclared)
1346 https://bugs.freedesktop.org/show_bug.cgi?id=18385
1348 Fix build with bash version <= 3.0:
1350 doltlibtool broken on linux with bash 3.00.0
1351 https://bugs.freedesktop.org/show_bug.cgi?id=18363
1355 Avoid triggering a bug in X.org server 6.9 resulting in a hung machine
1358 https://bugs.freedesktop.org/show_bug.cgi?id=15628#c2
1360 Fix display of user fonts as exercised by proposed support for type3
1361 fonts in poppler (unsigned promotion fixes):
1363 Use cairo user-font for Type 3 fonts
1364 http://lists.freedesktop.org/archives/poppler/2008-October/004181.html
1366 Avoid miscomputing size of fallback images required when rendering
1367 with CLEAR, IN, or SOURCE operator to vector surfaces, (PS, PDF, SVG,
1370 Be more tolerant of broken fonts when subsetting type1 fonts:
1372 Error handling in cairo_type1_font_subset_get_glyph_names_and_widths
1373 http://lists.cairographics.org/archives/cairo/2008-October/015569.html
1375 Fix cairo_fill_extents, cairo_stroke_extents, cairo_path_extents, to
1376 correctly allow NULL parameters as documented.
1378 Fix potential crash on emitting a type3 glyph after having drawn text
1379 paths from the same font, (for example with cairo_text_path).
1381 Release 1.8.2 (2008-10-29 Carl Worth <cworth@cworth.org>)
1382 =========================================================
1383 The cairo community is pleased to announce the 1.8.2 release of the
1384 cairo graphics library. This is the first update to cairo's stable 1.8
1385 series and contains a large number of bug fixes. It is being released
1386 just over one month since cairo 1.8.0.
1388 This release consists primarily of bug fixes, but there is one notable
1389 new feature, (the ability to build cairo without an external font
1390 backend), and there are a few optimizations as well. See below for
1391 details on these changes and the most important bug fixes.
1393 While many people have contributed to this release, Chris Wilson
1394 deserves particular mention. He has contributed well over twice as
1395 many changes to cairo since 1.8.0 than everyone else combined. We
1396 greatly appreciate the tremendous efforts of Chris and all cairo
1399 We recommend everyone upgrade to cairo 1.8.2 and hope that everyone
1400 will have lots of fun with cairo!
1406 It is now possible to build cairo without any font backend, (such as
1407 freetype, win32 or quartz). This is most useful when the application
1408 provides custom font rendering through the user-font API. But in the
1409 case where no external font backend is available, and no user-font is
1410 provided, cairo will render with a failsafe font, (a stroked font
1411 covering visible ASCII character). (Behdad Esfahbod)
1415 Dramatically speed up compilation with dolt (removes much of the
1416 libtool overhead) (Behdad Esfahbod with thanks to Josh Triplett).
1418 Several minor optimizations to tessellator (special-cased comparisons,
1419 faster insert for skiplist, etc.) (Chris Wilson).
1421 Optimize away fractional translation component when doing
1422 EXTEND_NEAREST filtering, (for better performance).
1426 Allow cloning sub-regions of similar surfaces to fix this bug
1429 Crafted gif file will crash firefox
1430 [XError: 'BadAlloc (insufficient resources for operation)']
1431 https://bugzilla.mozilla.org/show_bug.cgi?id=424333
1433 Fix some matrix confusion to fix this regression (Chris Wilson):
1435 Translucent star exports in a wrong way to PDF
1436 https://bugs.launchpad.net/inkscape/+bug/234546
1438 Fix some long-standing bugs with respect to properly computing the
1439 extents of transformed, filtered surfaces (Owen Taylor, Carl Worth,
1442 Bad clipping with EXTEND_NONE
1443 http://bugs.freedesktop.org/show_bug.cgi?id=15349
1445 Improve filtering handling in cairo-pattern.c
1446 http://bugs.freedesktop.org/show_bug.cgi?id=15367
1448 Many thanks to Chris Wilson for digging out and cleaning up
1451 Fix compilation on Solaris 10 (Chris Wilson):
1453 Cairo requires -DREENTRANT (along with -D_POSIX_THREAD_SEMANTICS)
1454 to compile on Solaris 10 with pthreads
1455 https://bugs.freedesktop.org/show_bug.cgi?id=18010
1457 Fix very old bug causing dashes to be rendered at the wrong length in
1458 fallback images (Adrian Johnson)
1460 Dashed strokes too long in fallback images
1461 https://bugs.freedesktop.org/show_bug.cgi?id=9189
1463 Fix broken dashing when a dashed path starts outside the clip region
1466 Avoid range overflow when computing large patterns (Benjamin Otte and
1469 Avoid crashing due to an invalid font with an incorrect entry in its
1470 CMAP table (Adrian Johnson).
1472 Fix bugs in computing maximum size of text requests that can be sent
1473 with the Render extension, (avoiding potential crashes when rendering
1474 large amounts of text) (Behdad Esfahbod and Chris Wilson).
1476 Fix rendering of operators unbounded by the mask (Chris Wilson).
1478 Fix compilation on systems without compiler support for a native
1479 64-bit type (Chris Wilson).
1481 Fix several cases of missing error-status propagation. (Chris Wilson,
1482 doing the work he seems to never tire of).
1484 Fix several locking issues found with the lockdep valgrind skin (Chris
1487 Backend-specific bug fixes
1488 --------------------------
1489 xlib: Avoid crash due to attempting XRender calls on pixmaps with
1490 formats not supported by the Render extension (Chris Wilson):
1492 XRender crashes due to NULL pointer from Cairo on SGI O2
1493 https://bugs.freedesktop.org/show_bug.cgi?id=11734
1495 xlib: Add support for XImages with depth of 4, 20, 24, or 28 bits
1498 cairo doesn't support 24 bits per pixel mode on X11
1499 https://bugs.freedesktop.org/show_bug.cgi?id=9102
1501 xlib: Avoid mistakenly considering two surfaces as similar just
1502 because their depths match (while their Render formats do not) (Karl
1505 ps: Fix slight mis-scaling of bitmapped fonts (Adrian Johnson)
1507 svg: Correctly emit comp-op for paint, mask, and show_glyphs
1508 operations (Emmanuel Pacaud).
1510 svg: Use finer-grained fallbacks for SVG 1.2 (as PS and PDF backends
1511 have been doing since 1.6.0) (Chris Wilson).
1513 win32: Fallback to DIB if DDB create fails for
1514 cairo_surface_create_similar (Vladimir Vukicevic).
1516 win32: Fix compatibility with Windows Mobile (Vladimir Vukicevic).
1518 win32: Fix static builds to not do __declspec(dllimport) on public
1519 functions. This requires the user to set a CAIRO_WIN32_STATIC_BUILD
1520 environment variable when compiling (Behdad Esfahbod).
1522 Release 1.8.0 (2008-09-25 Carl Worth <cworth@cworth.org>)
1523 =========================================================
1524 The cairo community is happy (and relieved) to announce the 1.8.0
1525 release of the cairo graphics library. This is a major update to
1526 cairo, with new features and enhanced functionality which maintains
1527 compatibility for applications written using any previous major cairo
1528 release, (1.6, 1.4, 1.2, or 1.0). We recommend that anybody using a
1529 previous version of cairo upgrade to cairo 1.8.0.
1531 The dominant theme of this release is improvements to cairo's ability
1532 to handle text. The highlights include a new "user fonts" feature as
1533 well as a new cairo_show_text_glyphs API which allows glyphs to be
1534 embedded in PDF output along with their original text, (for searching,
1535 selection, and copy-and-paste). Another major feature is a revamp of
1536 cairo's build system making it much easier to build cairo on various
1539 See below for more details.
1543 This new API allows the user of cairo API to provide drawings for
1544 glyphs in a font. A common use for this is implementing fonts in
1545 non-standard formats, like SVG fonts and Flash fonts. This API can
1546 also be used by applications to provide custom glyph shapes for fonts
1547 while still getting access to cairo's glyph caches. See
1548 test/user-font.c and test/user-font-proxy.c for usage examples. This
1549 is based on early work by Kristian Høgsberg. Thanks Kristian!
1551 This new API consists of the following functions (and corresponding
1554 cairo_user_font_face_create
1556 cairo_user_font_face_set_init_func
1557 cairo_user_font_face_set_render_glyph_func
1558 cairo_user_font_face_set_text_to_glyphs_func
1559 cairo_user_font_face_set_unicode_to_glyph_func
1561 An additional, new API is
1563 cairo_scaled_font_text_to_glyphs
1565 We were previously reluctant to provide this function as
1566 text-to-glyphs support in cairo was limited to "toy" font
1567 functionality, not really interesting for real-world text
1568 processing. However, with user fonts landing, this API is needed to
1569 expose full access to how user fonts convert text to glyphs. This is
1570 expected to be used by text toolkits like Pango, as well as "proxy"
1571 user-font implementations.
1573 cairo_show_text_glyphs
1574 ----------------------
1575 This new API allows the caller of cairo to provide text data
1576 corresponding to glyphs being drawn. The PDF backend implements this
1577 new API so that complex text can be copied out of cairo's PDF output
1578 correctly and reliably, (assuming the user of cairo calls
1579 cairo_show_text_glyphs). The cairo_show_text_glyphs API is definitely
1580 the most daunting API to debut in cairo. It is anticipated that pango
1581 (and similar high-level text libraries) will be the primary users of
1582 this API. In fact, pango 1.22 already uses cairo_show_text_glyphs.
1583 Behdad was the architect and implementor of this effort. Thanks,
1586 The cairo_show_text_glyphs API includes the following new functions:
1588 cairo_show_text_glyphs
1590 cairo_glyph_allocate
1593 cairo_text_cluster_allocate
1594 cairo_text_cluster_free
1596 cairo_surface_has_show_text_glyphs
1600 The primary goal of the revamp is to make the build system less
1601 fragile, (particularly for non-Linux platforms). For example, now
1602 people building on win32 will no longer need to maintain a
1603 platform-specific list of files to be built. See the new README.win32
1604 for details. Also, the .so file will now be installed with a different
1605 naming scheme, (for example, 1.7.6 will install with a .10800
1606 suffix). Many thanks to Behdad and his small army of helpers!
1608 Assorted API additions
1609 ----------------------
1610 For API completeness, several missing "getter" functions were added:
1612 cairo_scaled_font_get_scale_matrix
1614 cairo_surface_get_fallback_resolution
1616 cairo_toy_font_face_create
1617 cairo_toy_font_face_get_family
1618 cairo_toy_font_face_get_slant
1619 cairo_toy_font_face_get_weight
1621 The new cairo_toy_font_face functions provide access to functionality
1622 and settings provided by cairo_select_font_face(). Thanks Behdad!
1624 cairo-ps/cairo-pdf: More efficient output
1625 -----------------------------------------
1626 Adrian Johnson has been busy fixing all kinds of bugs in PS and PDF
1627 backends, as well making them generate much more compact output by
1628 avoiding things like re-emitting the color or linestyle on every
1629 drawing operation. Thanks Adrian!
1631 cairo-xlib: dithering
1632 ---------------------
1633 Dithering: Cairo now does simple dithering when rendering to legacy X
1634 servers. This is most visible with 8-bit visuals. Thanks Behdad!
1636 cairo-xlib: Avoid rendering glyphs out of surface bounds
1637 --------------------------------------------------------
1638 This seemingly harmless optimization exposed a bug in OpenOffice.org 3
1639 versions where OO.o was passing bogus surface extents to cairo,
1640 resulting in no text rendered in OO.o. Please contact your
1641 distribution's OO.o maintainers if you see this bug and point them to
1644 https://bugs.freedesktop.org/show_bug.cgi?id=16209
1646 cairo-xlib: Improved performance with X server without Render
1647 -------------------------------------------------------------
1648 Cairo now performs better on remote X servers that lack the Render
1649 extension by being smarter about using X core protocol facilities
1650 instead of falling back to doing all rendering on the client side.
1652 cairo-ft: respecting FC_FT_FACE
1653 -------------------------------
1654 Previously it was impossible to instruct cairo to do emboldening on a
1655 font face object created from an FT_Face. Cairo now respects and uses
1656 the FC_FT_FACE fontconfig pattern element, so emboldening can be
1657 achieved by using cairo_ft_font_face_create_for_pattern() and a
1658 carefully crafted pattern using FC_FT_FACE and FC_EMBOLDEN. Thanks
1661 cairo-directfb: backend improvements
1662 ------------------------------------
1663 The directfb backend, though still unsupported, has seen a good deal
1664 of improvements. Thanks Vlad!
1666 Bug fixing and optimizations
1667 ----------------------------
1668 xlib: Faster bookkeeping (Karl Tomlinson)
1669 https://bugzilla.mozilla.org/show_bug.cgi?id=453199#c5
1671 PS: Fix gradients with non-constant alpha (Chris Wilson)
1673 Fix deadlock in user-font code (Richard Hughes and Behdad Esfahbod)
1674 http://bugs.freedesktop.org/show_bug.cgi?id=16819
1676 Countless other bugs have been fixed and optimizations made, many of
1677 them thanks to Chris Wilson. Thanks Chris and others!
1679 Note also that the code that had been in cairo 1.7.x calling into
1680 freetype's optional lcd_filter function was removed from cairo before
1681 the 1.8.0 release. We do expect this code to come back in some form in
1684 Snapshot 1.7.6 (2008-09-17 Carl Worth <cworth@cworth.org>)
1685 ==========================================================
1686 The cairo community is happy to announce the 1.7.6 snapshot of the
1687 cairo graphics library. This is a "release candidate" for the upcoming
1688 1.8.0 release, so we will greatly appreciate any reports of problems
1689 in this release, and no major changes are currently planned before
1692 Notable changes in 1.7.6
1693 ------------------------
1694 The largest number of changes since 1.7.4 did not change the
1695 implementation of cairo itself, but instead revamped cairo's build
1696 system. The primary goal of the revamp is to make the build system
1697 less fragile, (particularly for non-Linux platforms). For example, now
1698 people building on win32 will no longer need to maintain a
1699 platform-specific list of files to be built. Also, the .so file will
1700 now be installed with a different naming scheme, (for example, 1.7.6
1701 will install with a .10706 suffix). Much thanks, Behdad!
1703 And, as usual, Chris Wilson has made another large round of robustness
1704 improvements, (eliminating dead code, fixing propagation of error
1705 status values, test suite improvements, etc. etc.). Thanks as always,
1708 API changes since 1.7.4
1709 -----------------------
1710 There have been a few changes of API that was new during the 1.7
1713 * Remove cairo_font_options_set_lcd_filter
1714 and cairo_font_options_get_lcd_filter
1716 Motivation: At the Cairo Summit, this API was determined to be too
1717 specific to the freetype font backend to be in the general
1718 API. A similar API with a cairo_ft prefix might be introduced
1719 in the future. Note that cairo will still respect the
1720 corresponding fontconfig settings for these options.
1722 * Replace cairo_has_show_glyphs
1723 with cairo_surface_has_show_glyphs
1725 Motivation: This really is a surface-specific interface, and the
1726 convenience function on the cairo_t is not obviously
1727 necessary. An application can easily call:
1729 cairo_surface_has_show_glyphs (cairo_get_target (cr));
1733 * Add cairo_text_cluster_flags_t
1734 to cairo_show_text_glyphs
1735 cairo_scaled_font_text_to_glyphs
1736 cairo_user_scaled_font_text_to_glyphs_func_t
1738 Motivation: This flag, (and specifically the
1739 CAIRO_TEXT_CLUSTER_FLAG_BACKWARD value), replaces the
1740 cairo_bool_t backward argument in each of the above
1741 interfaces. This leads to more readable user code, and also
1742 allows future extensibility.
1744 As always, there are no changes to any API from any major cairo
1745 release, (1.0.x, 1.2.x, 1.4.x, 1.6.x). Cairo maintains the same
1746 compatibility promise it always has.
1748 Bug fixes since 1.7.4
1749 ---------------------
1750 xlib: Faster bookkeeping (Karl Tomlinson)
1751 https://bugzilla.mozilla.org/show_bug.cgi?id=453199#c5
1753 PS: Fix gradients with non-constant alpha (Chris Wilson)
1755 Fix deadlock in user-font code (Richard Hughes and Behdad Esfahbod)
1756 http://bugs.freedesktop.org/show_bug.cgi?id=16819
1758 Several other minor fixes.
1760 Snapshot 1.7.4 (2008-08-11 Behdad Esfahbod <behdad@behdad.org>)
1761 ===============================================================
1762 The cairo community is embarrassed to announce availability of the 1.7.4
1763 snapshot of the cairo graphics library. This is a followup release to the
1764 1.7.2 snapshot to ship a tarball that can actually be built. The only
1765 change since 1.7.4 is including the missing header file
1766 cairo-user-font-private.h in the distribution.
1768 Snapshot 1.7.2 (2008-08-11 Behdad Esfahbod <behdad@behdad.org>)
1769 ===============================================================
1770 The cairo community is finally ready to announce availability of the 1.7.2
1771 snapshot of the cairo graphics library. This is embarrassingly the first
1772 snapshot in the 1.7 unstable series of cairo, leading to the eventual release
1773 of cairo 1.8, currently planned for late September.
1775 This snapshot comes four months after the 1.6.4 release. We have done a
1776 really bad job on getting development snapshots out this cycle, but
1777 hopefully all the API changes for 1.8 are now finished and the remaining
1778 weeks will be spent on bug-fixing. There is more than 400 commits worth
1779 of changes in this snapshot, and those can use some testing. Read on!
1781 Text, text, and more text!
1782 --------------------------
1783 The dominant theme of this release, and 1.8 in general, is improvements
1784 around cairo text API. Here is a high-level list of changes with text
1789 This is new API allowing the user of cairo API to provide drawings for glyphs
1790 in a font. This is most useful in implementing fonts in non-standard formats,
1791 like SVG fonts and Flash fonts, but can also be used by games and other
1792 applications to draw "funky" fonts. See test/user-font.c and
1793 test/user-font-proxy.c for usage examples. This is based on early work by
1794 Kristian Høgsberg. Thanks Kristian!
1798 This new API allows the caller of cairo to mark text glyphs with their
1799 original text. The PDF backend implements this new API and latest Pango
1800 master uses it. The result is (when bugs are fixed) that complex text can be
1801 copied out of pangocairo's PDF output correctly and reliably. There are bugs
1802 to fix though. A few poppler bugs, and some more in cairo and pango.
1804 To test show_text_glyph, just grab pango master and this cairo snapshot and
1805 print text in gedit. Open in acroread or evince, select all, copy, paste
1806 in gedit and compare. The Arabic text with diacritic marks is particularly
1807 showing bad. Try with pango/pango-view/HELLO.txt if you are brave
1808 enough. The Indic text is showing improvements, but is still coming out
1811 LCD subpixel filtering using FreeType
1812 -------------------------------------
1813 FreeType 2.3.5 added support for various LCD subpixel filtering, and
1814 fontconfig 2.6.0 added support for configuring LCD filter on a font by font
1815 basis. Cairo now relies on FreeType and fontconfig for subpixel filtering.
1816 This work is based on David Turner's original patch to cairo, maintained
1817 and tested by Sylvain Pasche and others. Thanks all!
1819 Toy font face constructor and getter
1820 ------------------------------------
1821 Mostly for API completion, but also useful for higher level (like Pango) to
1822 hook into what the user has set using cairo_select_font_face(), making that
1823 toy API a bit more useful.
1825 FreeType: respecting FC_FT_FACE
1826 -------------------------------
1827 Previously it was impossible to instruct cairo to do emboldening on a font
1828 face object created from an FT_Face. Cairo now respects and uses the
1829 FC_FT_FACE fontconfig pattern element, so emboldening can be achieved by
1830 using cairo_ft_font_face_create_for_pattern() and a carefully crafted pattern
1831 using FC_FT_FACE and FC_EMBOLDEN.
1834 PS/PDF: More efficient output
1835 -----------------------------
1836 Adrian Johnson has been busy fixing all kinds of bugs in PS and PDF
1837 backends, as well making them generate much more compact output by avoiding
1838 things like re-emitting the color or linestyle on every drawing operation.
1844 Cairo now does simple dithering when rendering to legacy X servers. This is
1845 mostly visible with 8-bit visuals.
1847 Xlib: Avoid rendering glyphs out of surface bounds
1848 --------------------------------------------------
1849 This seemingly harmless change manifested a bug with OpenOffice.org 3 versions
1850 where OO.o was passing bogus surface extents to cairo, resulting in no text
1851 rendered in OO.o. Please contact your distro's OO.o maintainers if you see
1852 this bug and point them to the following URL:
1854 https://bugs.freedesktop.org/show_bug.cgi?id=16209
1856 Xlib: Improved performance with Xrender-less X servers
1857 ------------------------------------------------------
1858 Cairo now performs better on remote, Xrender-less X servers by being smarter
1859 about using X core protocol facilities instead of falling back to doing all
1860 rendering on the client side.
1863 Directfb: backend improvements
1864 ------------------------------
1865 The directfb backend, though still unsupported, has seen a good deal of
1866 improvements. Thanks Vlad!
1869 Bug fixing and optimizations
1870 ----------------------------
1871 Countless bugs have been fixed and optimizations made, many of them thanks to
1872 Chris Wilson. Thanks Chris!
1878 cairo_show_text_glyphs
1880 This is a new text rendering API. Being a more advanced version of
1881 cairo_show_glyphs(), it is aimed for use by higher-level text toolkits like
1882 Pango, and enables better text extraction from output generated by backends
1883 like PDF and SVG. The PDF backend already implements it, and the upcoming
1884 Pango release will use it.
1886 To make that API work, a bunch of other additions were made:
1888 cairo_glyph_allocate
1890 cairo_text_cluster_t
1891 cairo_text_cluster_allocate
1892 cairo_text_cluster_free
1893 cairo_surface_has_show_text_glyphs
1896 cairo_user_font_face_create
1898 This is the "user" font face constructor, accompanied by a variety of method
1899 signatures, getters, and setters for a callback-based font backend:
1901 CAIRO_FONT_TYPE_USER
1902 cairo_user_scaled_font_init_func_t
1903 cairo_user_scaled_font_render_glyph_func_t
1904 cairo_user_scaled_font_text_to_glyphs_func_t
1905 cairo_user_scaled_font_unicode_to_glyph_func_t
1906 cairo_user_font_face_set_init_func
1907 cairo_user_font_face_set_render_glyph_func
1908 cairo_user_font_face_set_text_to_glyphs_func
1909 cairo_user_font_face_set_unicode_to_glyph_func
1910 cairo_user_font_face_get_init_func
1911 cairo_user_font_face_get_render_glyph_func
1912 cairo_user_font_face_get_text_to_glyphs_func
1913 cairo_user_font_face_get_unicode_to_glyph_func
1916 cairo_scaled_font_text_to_glyphs
1918 We were previously reluctant to provide this function as text-to-glyphs
1919 support in cairo was limited to "toy" font functionality, not really
1920 interesting for real-world text processing. However, with user-fonts
1921 landing, this API is needed to expose full access to how user-fonts
1922 convert text to glyphs. This is expected to be used by text toolkits like
1923 Pango, as well as "proxy" user-font implementations.
1927 cairo_font_options_set_lcd_filter
1928 cairo_font_options_get_lcd_filter
1930 These add the possibility to choose between various available LCD subpixel
1931 filters. The available filter values are modeled after what FreeType
1935 cairo_toy_font_face_create
1936 cairo_toy_font_face_get_family
1937 cairo_toy_font_face_get_slant
1938 cairo_toy_font_face_get_weight
1940 These provide access to functionality and settings provided by
1941 cairo_select_font_face().
1944 cairo_scaled_font_get_scale_matrix
1945 cairo_surface_get_fallback_resolution
1947 For API completeness.
1950 Various new values for cairo_status_t enum
1955 - Type3 fonts generated by cairo's PDF backend may show up in poppler/Evince
1956 in a different color than expected. This is fixed in poppler master branch.
1957 This mostly affects cairo user fonts. The test case test/user-font.c
1960 - User fonts using other fonts in their rendering are currently embedded in
1961 PDF as fallback bitmap glyphs. This will be (hopefully) fixed before 1.8.
1962 The test case test/user-font-proxy.c demonstrates this.
1965 Release 1.6.4 (2008-04-11 Carl Worth <cworth@cworth.org>)
1966 =========================================================
1967 The cairo community is wildly embarrassed to announce the 1.6.4
1968 release of the cairo graphics library. This release reverts the xlib
1969 locking change introduced in 1.6.4, (and the application crashes that
1970 it caused). The community would be glad to sack its current release
1971 manager and is accepting applications for someone who could do the job
1972 with more discipline.
1974 Revert 'add missing locking in cairo-xlib'
1975 ------------------------------------------
1976 This change was introduced in cairo 1.6.2, but also introduced a bug
1977 which causes many cairo-xlib applications to crash, (with a
1978 segmentation fault inside of XSetClipMask). Instead of attempting
1979 another fix for the broken fix, the change in 1.6.2 has been
1980 reverted. The original bug which the change was addressing has been
1981 present since at least cairo 1.4, so it is not expected that leaving
1982 this bug unfixed will cause any new problems for applications moving
1983 from cairo 1.4 to cairo 1.6.
1985 At this point, the code of cairo 1.6.4 differs from cairo 1.6.0 only
1986 in the fix for the PostScript-printer crashes.
1988 Tweak build to avoid linking with g++
1989 -------------------------------------
1990 Cairo 1.6.4 avoids a quirk in automake that was causing the cairo
1991 library to be linked with g++ and linked against libstdc++ even when
1992 only C source files were compiled for the library.
1994 Release 1.6.2 (2008-04-11 Carl Worth <cworth@cworth.org>)
1995 =========================================================
1996 The cairo community is pleased (but somewhat sheepish) to announce the
1997 1.6.2 release of the cairo graphics library. This is an update to
1998 yesterday's 1.6.0 release with an important fix to prevent cairo's
1999 PostScript output from crashing some printers. This release also
2000 includes a locking fix for cairo's xlib backend to improve thread
2001 safety. There are no changes beyond these two fixes.
2003 Fix for PostScript printer crash
2004 --------------------------------
2005 Adrian Johnson discovered that cairo 1.6.0 was being a bit hard on
2006 PostScript printers, by changing the font matrix very frequently. This
2007 causes some PostScript interpreters to allocate new font objects every
2008 few glyphs, eventually exhausting available resources. The fix
2009 involves leaving translational components of the font matrix as zero,
2010 so that the PostScript interpreter sees an identical font matrix
2011 repeatedly, and can more easily share internal font object resources.
2013 This fix has been tested to resolve the bugs posted here, (for both
2014 Xerox and Dell printers):
2016 Printing some PDFs from evince is crashing our Xerox printer
2017 http://bugs.freedesktop.org/show_bug.cgi?id=15348
2019 Cairo-generated postscript blocks Dell 5100cn
2020 http://bugs.freedesktop.org/show_bug.cgi?id=15445
2022 Add missing locking in cairo-xlib
2023 ---------------------------------
2024 Chris Wilson noticed that cairo 1.6.0 was manipulating an internal
2025 cache of GC object within cairo's Xlib backend without proper
2026 locking. The missing locking could cause failures for multi-threaded
2027 applications. He fixed this in 1.6.2 by adding the missing locks.
2029 Release 1.6.0 (2008-04-10 Carl Worth <cworth@cworth.org>)
2030 =========================================================
2031 The cairo community is quite pleased to announce the 1.6.0 release of
2032 the cairo graphics library. This is a major update to cairo, with new
2033 features and enhanced functionality which maintains compatibility for
2034 applications written using cairo 1.4, 1.2, or 1.0. We recommend that
2035 anybody using a previous version of cairo upgrade to cairo 1.6.0.
2037 The most significant new features in this release are dramatically
2038 improved PDF and PostScript[*] output, support for arbitrary X server
2039 visuals (including PseudoColor), a new Quartz backend, and and a new
2040 "win32 printing" backend. See below for more details on these and
2043 New dependency on external pixman library (Thanks, Søren!)
2044 ----------------------------------------------------------
2045 As of cairo 1.6, cairo now depends on the pixman library, for which
2046 the latest release can be obtained alongside cairo:
2048 http://cairographics.org/releases/pixman-0.10.0.tar.gz
2050 This library provides all software rendering for cairo, (the
2051 implementation of the image backend as well as any image fallbacks
2052 required for other backends). This is the same code that was
2053 previously included as part of cairo itself, but is now an external
2054 library so that it can be shared by both cairo and by the X server,
2055 (which is where the code originated).
2057 Improved PDF, PostScript, and SVG output (Thanks, Adrian!)
2058 ----------------------------------------------------------
2059 Users of the cairo-pdf, cairo-ps, and cairo-svg should see a dramatic
2060 improvement from cairo 1.2/1.4 to 1.6. With this release there are now
2061 almost no operations that will result in unnecessary rasterization in
2062 the PDF and PostScript. Rasterized "image fallbacks" are restricted
2063 only to minimal portions of the document where something is being
2064 drawn with cairo that is beyond the native capabilities of the
2065 document, (this is rare for PDF or SVG, but occurs when blending
2066 translucent objects for PostScript).
2068 This means that the final output will be of higher quality, and will
2069 also be much smaller, and therefore will print more quickly. The
2070 machinery for doing analysis and minimal fallbacks also benefits the
2071 win32-printing surface described below.
2073 In addition to doing less rasterization, the PostScript and PDF output
2074 also has several other improvements to make the output more efficient
2075 and more compatible with specifications.
2077 [*] Note: Just before this release, a bug has been reported that the
2078 PostScript output from cairo can crash some printers, (so far the
2079 following models have been reported as problematic Xerox Workcentre
2080 7228 or 7328 and Dell 5100cn). We will implement a workaround as soon
2081 as we can learn exactly what in cairo's output these printers object
2082 to, (and we could use help from users that have access to misbehaving
2083 printers). This bug is being tracked here:
2085 Printing some PDFs from evince is crashing our Xerox printer
2086 http://bugs.freedesktop.org/show_bug.cgi?id=15348
2088 New support for arbitrary X server visuals (Thanks, Keith and Behdad!)
2089 ----------------------------------------------------------------------
2090 As of cairo 1.6, cairo should now work with an arbitrary TrueColor or
2091 8-bit PseudoColor X server visual. Previous versions of cairo did not
2092 support these X servers and refused to draw anything. We're pleased to
2093 announce that this limitation has been lifted and people stuck with
2094 ancient display systems need no longer be stuck with ancient software
2095 just because of cairo.
2097 New, supported Quartz backend for Mac OS X (Thanks, Brian and Vladimir!)
2098 ------------------------------------------------------------------------
2099 As of cairo 1.6, the cairo-quartz backend is now marked as "supported"
2100 rather than "experimental" as in previous cairo releases. Its API now
2101 has guarantees of API stability into future cairo releases, and its
2102 output quality is comparable to other backends. There have been
2103 significant improvements to cairo-quartz since 1.4. It now uses many
2104 fewer image fallbacks, (meaning better performance), and has greatly
2105 improved text rendering.
2107 New, "win32 printing" backend (Thanks, Adrian and Vladimir!)
2108 ------------------------------------------------------------
2109 A new win32-printing surface has been added with an interface very
2110 similar to the original win32 surface, (both accept an HDC
2111 parameter). But this new surface should only be called with a printing
2112 DC, and will result in all drawing commands being stored into a
2113 meta-surface and emitted after each page is complete. This allows
2114 cairo to analyze the contents, (as it does with PDF, PostScript, and
2115 SVG backends), and to do minimal image-based fallbacks as
2116 necessary. The analysis keeps things as efficient as possible, while
2117 the presence of fallbacks, (when necessary), ensure the consistent,
2118 high-quality output expected from cairo.
2120 Robustness fixes (Thanks, Chris!)
2121 ---------------------------------
2122 There has been a tremendous number of improvements to cairo's
2123 robustness. Areas that have been improved include:
2125 * Proper reporting of errors
2127 * Responding correctly to invalid input
2129 * Avoiding integer overflows
2131 * Avoiding memory leaks on error-recovery paths
2133 * Making reference counting thread safe
2135 * Exhaustive testing of memory allocation points
2137 Other fixes (Thanks, everybody!)
2138 --------------------------------
2139 Cairo's internal fixed-point representation has been changed from
2140 16.16 to 24.8. This has a direct impact on applications as it allows
2141 much larger objects to be drawn before internal limits in cairo make
2142 the drawing not work.
2144 The CAIRO_EXTEND_PAD mode is now fully supported by surface
2145 patterns. This mode allows applications to use cairo_rectangle and
2146 cairo_fill to draw scaled images with high-quality bilinear filtering
2147 for the internal of the image, but without any objectionably blurry
2148 edges, (as would happen with the default EXTEND_NONE and cairo_paint).
2150 Rendering with CAIRO_ANTIALIAS_NONE has been fixed to be more
2151 predictable, (previously image rendering and geometry rendering would
2152 be slightly misaligned with respect to each other).
2154 The reference manual at http://cairographics.org/manual now documents
2155 100% of the functions and types in cairo's public API.
2159 Several small features have been added to cairo with new API functions:
2161 cairo_format_stride_for_width
2163 Must be called to compute a properly aligned stride value before
2164 calling cairo_image_surface_create_for_data.
2166 cairo_has_current_point
2168 Allows querying if there is a current point defined for the
2173 Allows querying for path extents, (independent of any fill or
2176 cairo_surface_copy_page
2177 cairo_surface_show_page
2179 Allow beginning a new document page without requiring a cairo_t
2182 cairo_ps_surface_restrict_to_level
2184 cairo_ps_level_to_string
2185 cairo_ps_surface_set_eps
2187 Allow controlling the Post PostScript level, (2 or 3), to
2188 target, as well as to generate Encapsulated PostScript (EPS).
2190 cairo_quartz_font_face_create_for_cgfont
2192 Create a quartz-specific cairo_font_face_t from a CGFontRef.
2194 cairo_win32_font_face_create_for_logfontw_hfont
2196 Create a win32-specific cairo_font_face from a LOGFONTW and an
2201 I've accounted for 32 distinct people with attributed code added to
2202 cairo between 1.4.14 and 1.6.0, (their names are below). That's an
2203 impressive number, but there are certainly dozens more that
2204 contributed with testing, suggestions, clarifying questions, and
2205 encouragement. I'm grateful for the friendships that have developed as
2206 we have worked on cairo together. Thanks to everyone for making this
2209 Adrian Johnson, Alp Toker, Antoine Azar, Behdad Esfahbod,
2210 Benjamin Otte, Bernardo Innocenti, Bertram Felgenhauer,
2211 Boying Lu, Brian Ewins, Carl Worth, Chris Heath, Chris Wilson,
2212 Claudio Ciccani, Emmanuel Pacaud, Jeff Muizelaar, Jeremy Huddleston,
2213 Jim Meyering, Jinghua Luo, Jody Goldberg, Jonathan Gramain,
2214 Keith Packard, Ken Herron, Kouhei Sutou, Kristian Høgsberg,
2215 Larry Ewing, Martin Ejdestig, Nis Martensen, Peter Weilbacher,
2216 Richard Hult, Shailendra Jain, Søren Sandmann Pedersen,
2219 Snapshot 1.5.20 (2008-04-04 Carl Worth <cworth@cworth.org>)
2220 ===========================================================
2221 This is the tenth snapshot in cairo's unstable 1.5 series. It comes
2222 just two days (and only one working day) after the 1.5.18
2223 snapshot. The quick snapshot is due to two embarrassing bugs (both
2224 affecting cairo-xlib) that had been introduced in the 1.5.18
2225 snapshot. The fixes for these are described below along with a few
2226 other fixes, (which hopefully aren't introducing new bugs this time).
2230 Revert fix from 1.5.18 to allow pattern expansion based on the filter
2231 mode. This fix seemed so boring, (the use case it addresses is almost
2232 never used in practice), that it didn't even get mentioned in the
2233 1.5.18 release notes. However, the "fix" happened to break rendering
2234 that is always used resulting in corrupt image rendering in mozilla,
2235 evolution, and probably everything else that uses cairo.
2237 Fix to avoid BadMatch errors in cairo_surface_create_similar. These
2238 were introduced, (inadvertently, of course), as part of the fix in
2239 1.5.18 for creating similar surfaces without the Render
2240 extension. Again, thanks to mozilla, (and Vladimir Vukicevic in
2241 particular), for noticing our mistake.
2245 Correctly handle an in-error surface in
2246 cairo_surface_write_to_png. Previously this function would cause an
2247 assertion failure if you gave it a finished surface. Now it cleanly
2248 returns a CAIRO_STATUS_SURFACE_FINISHED result instead.
2250 Avoid potentially infinite wandering through memory inside
2251 _cairo_hull_prev_valid. Thanks to Jonathan Watt for noticing this
2254 https://bugzilla.mozilla.org/show_bug.cgi?id=306649#c21
2258 Fix generation of "soft" masks made by drawing to a similar surface
2259 and then calling cairo_mask_surface() with it.
2263 Fix for code that uses cairo_mask() on an intermediate surface which
2264 is later passed to cairo_mask_surface().
2266 Snapshot 1.5.18 (2008-04-05 Carl Worth <cworth@cworth.org>)
2267 ===========================================================
2268 This is the ninth snapshot in cairo's unstable 1.5 series. It comes
2269 just 4 days after the 1.5.16 snapshot. We had hoped to not need
2270 another snapshot before the final 1.6.0 release, but several critical
2271 bugs were found and fixed in the last few days, so we thought it
2272 important to let people test the fixes with this snapshot. See below
2277 The README now lists necessary dependencies.
2279 Various graphics state defaults are now documented, (source pattern is
2280 opaque black, line width is 2.0, line join is miter, line cap is butt,
2281 miter limit is 10.0, etc.).
2285 Several cleanups have been made along many error-path returns,
2286 (carefully propagating up the original error status values, cleaning
2287 up memory leaks during error recovery, etc.). This is yet another in
2288 Chris "ickle" Wilson's long series of error-handling cleanups during
2291 Avoid undesired clipping when drawing scaled surface patterns with
2296 Fix emission of 1-bit alpha masks in PDF output.
2298 Fix a bug that would cause glyphs to be misplaced along the Y axis:
2300 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=%23474136
2302 Originally, an issue about a crash, but later leading to the
2303 misplaced glyphs issue being discovered.
2307 Fix misplaced glyphs in cairo's PostScript output.
2309 This issue occurs when consecutive glyphs are placed far
2310 apart. This case is exercised by the new ft-show-glyphs-table test
2311 case, which was originally inspired by the Debian bug #23474136
2314 Fix more misplaced glyphs in cairo's PostScript output:
2316 The issue here showed up under very particular circumstance, (when
2317 converting a PDF file with a CFF font with CID Identity-H encoding
2318 and using glyph 0, (defined by the CFF specification as .notdef)
2319 as a space instead). More concretely, this problem appeared when
2320 converting the UbuntuDesktop.pdf file mentioned in this bug
2323 https://bugs.freedesktop.org/show_bug.cgi?id=15348#c3
2325 As usual with arcane font-encoding-specific bugs like this, many
2326 thanks to Adrian Johnson for his magical ability to dive into
2327 specifications and emerge almost instantaneously with fixes. And
2328 thanks to Sebastien Bacher for bringing the bug to our attention.
2332 Fix serious failure on X servers without the Render extension.
2334 Since the 1.5.14 snapshot (with support for PseudoColor visuals),
2335 any application attempting to create a "similar" xlib surface would
2336 fail on an X server without the Render extension. Thanks to
2337 Frederic Crozat for pointing out that cairo's test suite was
2338 entirely failing when run against Xvfb.
2340 Avoid crashing cairo-xlib applications for too-large glyphs
2342 Naively sending glyphs of any size to the X server will eventually
2343 violate the X limit on maximum request sizes. We now properly
2344 detect when a glyph would be too large and use existing fallbacks
2345 to render the glyph rather than trying to send it to the X server.
2347 Enable the buggy_repeat workaround for Xorg servers < 1.4
2349 We have determined that Xorg 1.3.0 (as packaged in Fedora 8 at
2350 least) has a bug that can result in an X server crash when cairo
2351 uses certain X Render repeat operations, (as exercised by cairo's
2352 extend-reflect test). We avoid this crash by using fallbacks
2353 whenever a repeating surface is needed for any Xorg server with a
2354 version less than 1.4. This is slower, but should prevent the
2357 (Meanwhile, there appears to be a separate bug where some X
2358 servers or specific X-server drivers will use random pixmap data
2359 when asked to draw a repeating surface. The buggy_repeat
2360 workaround would also avoid those problems, but we have not yet
2361 characterized whether the new "version < 1.4" is a good
2362 characterization of those problems or not.)
2366 Implement cairo_font_extents for this backend.
2368 The cairo-quartz-font implementation added in the 1.5.14 snapshot was
2369 entirely missing support for the cairo_font_extents function. Thanks to
2370 Richard Hult for pointing out this obvious shortcoming, (and obvious
2371 lack of coverage in our test suite):
2373 CGFont backend returns 0 font extents
2374 https://bugs.freedesktop.org/show_bug.cgi?id=15319
2376 Snapshot 1.5.16 (2008-04-01 Carl Worth <cworth@cworth.org>)
2377 ===========================================================
2378 This is the eighth snapshot in cairo's unstable 1.5 series. It comes
2379 less than two weeks after the 1.5.14 snapshot and it really is a
2380 legitimate snapshot, (in spite of sharing this date with that of many
2381 bogus announcements). The major change in this snapshot is that the
2382 cairo-quartz backend is now officially "supported", including new API
2383 to construct a font face from a CGFontRef . Also several bug fixes
2384 have been fixed in many backends. See below for details.
2388 Cairo now depends on pixman 0.10.0 which was recently released. The
2389 latest pixman release can always be found alongside cairo releases at:
2391 http://cairographics.org/releases
2393 Increase the precision of color stops for gradients. This fixes a
2394 regression in gradient rendering that had been present since the
2397 paginated (all of ps, pdf, svg, and win32-printing)
2398 ---------------------------------------------------
2399 Fix assertion failure when some drawing elements are outside the page
2400 boundaries, (this bug was noticed when using Inkscape to print a
2401 drawing with landscape orientation to a portrait-oriented piece of
2406 Fix of bug causing incorrect glyph positioning.
2408 Fix handling of CAIRO_OPERATOR_SOURCE.
2412 More reduction of unnecessary digits of precision in PDF output.
2414 Fix handling of CAIRO_OPERATOR_SOURCE.
2418 Fix bug in usage of libpng that was preventing cairo_mask from working
2419 with the svg backend.
2421 Fix transformation of source pattern for cairo_stroke().
2423 cairo-win32-printing
2424 --------------------
2425 Fix fallback resolution, (thanks again to inkscape users/developers
2426 for helping us find this one).
2430 Mark the cairo-quartz backend as "supported" rather than
2431 "experimental". This means the following:
2433 * The backend will now be built by default (if possible).
2435 * We are committing that the backend-specific API (as published in
2436 cairo-quartz.h) are stable and will be supported in all future
2439 * We are committing that the output quality of this backend
2440 compares favorably with other cairo backends, (and that quality
2441 is ensured by good results from the cairo test suite).
2443 * We recommend that distributions build and distribute this
2444 backend when possible.
2446 Note that the cairo_quartz_image API (in cairo-quartz-image.h) is
2447 still experimental, will not build by default, (pass
2448 --enable-quartz-image to configure to build it), and may see API
2449 changes before it is marked as "supported" in a future release.
2451 Put the CAIRO_FONT_TYPE_ATSUI name back into
2452 cairo-deprecated.h. Without this, the cairo 1.5.14 snapshot broke all
2453 builds for applications using the C++ cairomm bindings (and perhaps
2454 others) which have the CAIRO_FONT_TYPE_ATSUI name in their header
2455 files. This breakage happened even for applications not using
2456 cairo-quartz at all.
2458 Note: Even though the CAIRO_FONT_TYPE_ATSUI name is provided to
2459 avoid this build breakage, we still recommend that bindings and
2460 applications move to the new, and more accurate,
2461 CAIRO_FONT_TYPE_QUARTZ name.
2463 Replace the implementation of cairo-quartz-font to use CFFont instead
2464 of ATSUI. The CGFont API is a better fit than ATSUI, and this new
2465 implementation is also more correct than the old one as well.
2467 This also adds the following new API call:
2469 cairo_public cairo_font_face_t *
2470 cairo_quartz_font_face_create_for_cgfont (CGFontRef font);
2472 The previous cairo_quartz_font_face_create_for_atsu_font_id function
2473 continues to exist and is part of the supported API going
2474 forward. (However, the old name of that same function, which was
2475 cairo_atsui_font_face_create_for_atsu_font_id is officially
2476 deprecated. Any source code using the old name should be updated to
2479 Fix transformation of source pattern for cairo_stroke().
2483 Avoid crash in create_similar is cairo_win32_surface_create fails.
2485 Snapshot 1.5.14 (2008-03-20 Carl Worth <cworth@cworth.org>)
2486 ===========================================================
2487 This is the seventh snapshot in cairo's unstable 1.5 series. It comes
2488 3 weeks after the 1.5.12 snapshot. This snapshot includes support for
2489 arbitrary X server visuals, (including PseudoColor), which was the
2490 final remaining cairo-specific item on the cairo 1.6 roadmap. It also
2491 includes a huge number of improvements to the cairo-quartz backend. So
2492 this is effectively a cairo 1.6 release candidate. We expect very few
2493 changes from now until 1.6 and only for specific bug fixes.
2497 Rename ATSUI font backend to Quartz font backend. This affects the
2500 --enable-atsui -> --enable-quartz-font
2501 CAIRO_HAS_ATSUI_FONT -> CAIRO_HAS_QUARTZ_FONT
2502 CAIRO_FONT_TYPE_ATSUI -> CAIRO_FONT_TYPE_QUARTZ
2504 cairo_atsui_font_face_create_for_atsu_font_id ->
2505 cairo_quartz_font_font_create_for_atsu_font_id
2507 This API change is justified by the cairo-quartz backend still be
2508 marked as "experimental" rather than "supported", (though this is one
2509 step toward making the change to "supported" before 1.6). Cairo will
2510 still provide ABI compatibility with the old symbol name, however.
2512 paginated (all of ps, pdf, svg, and win32-printing)
2513 ---------------------------------------------------
2514 Optimize by not analyzing an image surface for transparency more than
2515 once, (previously all images were analyzed twice).
2517 cairo-ps and cairo-pdf
2518 ----------------------
2519 Avoiding emitting a matrix into the stroke output when unnecessary,
2520 (making output size more efficient).
2522 Reduce rounding error of path shapes by factoring large scale factors
2523 out of the path matrix, (ensuring that a fixed-number of printed
2524 digits for path coordinates contains as much information as possible).
2526 Reduce excess digits for text position coordinates. This makes the
2527 output file size much smaller without making the result any less
2532 Eliminate bug causing extraneous text repetition on Linux PostScript
2533 output in some cases.
2535 See: Mozilla Bug 419917 – Printed page contents are reflected
2536 inside bordered tables (Linux-only)
2538 https://bugzilla.mozilla.org/show_bug.cgi?id=419917
2540 Optimize output when EXTEND_PAD is used.
2544 Fix to not use fill-stroke operator with transparent fill, (else PDF
2545 output doesn't match the cairo-defined correct result). See:
2547 https://bugs.launchpad.net/inkscape/+bug/202096
2551 Fix stroke of path with a non-solid-color source pattern:
2553 http://bugs.freedesktop.org/show_bug.cgi?id=14556
2557 Fix text rendering with gradient or image source pattern.
2559 Handling antialiasing correctly for cairo_stroke(), cairo_clip(), and
2560 cairo_show_text()/cairo_show_glyphs().
2562 Correctly handle gradients with non-identity transformations:
2564 Fixes http://bugs.freedesktop.org/show_bug.cgi?id=14248
2566 Add native implementation of REPEAT and REFLECT extend modes for
2569 Fix implementation for the "unbounded" operators, (CAIRO_OPERATOR_OUT,
2570 _IN, _DEST_IN, and _DEST_ATOP).
2572 Correctly handle endiannees in multi-architecture compiles on Mac OS
2575 Avoid behavior which would cause Core Graphics to print warnings to
2576 the console in some cases.
2580 Fix handling of miter limit.
2582 cairo-win32-printing
2583 --------------------
2584 Fix to not use a 1bpp temporary surface in some cases while printing,
2585 (so grayscale data is preserved rather than just becoming black and
2590 Add support for rendering to arbitrary TrueColor X server
2591 visuals. This fixes at least the following bugs:
2593 cairo doesn't support 8-bit truecolor visuals
2594 https://bugs.freedesktop.org/show_bug.cgi?id=7735
2596 cairo doesn't support 655 xlib format
2597 https://bugs.freedesktop.org/show_bug.cgi?id=9719
2599 Add support for rendering to 8-bit PseudoColor X server visuals. This
2600 fixes the following bug:
2602 Cairo doesn't support 8-bit pseudocolor visuals
2603 https://bugs.freedesktop.org/show_bug.cgi?id=4945
2605 Snapshot 1.5.12 (2008-02-28 Carl Worth <cworth@cworth.org>)
2606 ===========================================================
2607 This is the sixth snapshot in cairo's unstable 1.5 series. It comes 1
2608 week after the 1.5.10 snapshot. This snapshot includes the
2609 long-awaited change from 16.16 to 24.8 fixed-point values, (see below
2610 for why you should care). It also includes several backend-specific
2613 24.8 fixed-point format
2614 -----------------------
2615 Cairo has always converted path coordinates to a fixed-point
2616 representation very early in its processing. Historically, this has
2617 been a 32-bit representation with 16 bits of integer for the
2618 device-pixel grid and 16 bits of sub-pixel positioning. The choice of
2619 16 bits for the integer coordinate space was based on the 16-bit limit
2620 for X Window drawables.
2622 This 16-bit limit has proven problematic for many applications. It's
2623 an especially vexing problem when targeting non-X backends that don't
2624 have any 16-bit restriction. But even when targeting cairo-xlib, it's
2625 often desirable to draw a large shape, (say a background rectangle),
2626 that extends beyond the surface bounds and expect it to fill the
2627 surface completely, (rather than overflowing and triggering random
2630 Meanwhile, nobody has ever really needed 16 bits of sub-pixel
2633 With this snapshot, the fixed-point system is still in place and is
2634 still using a 32-bit representation, (future versions of cairo might
2635 move entirely to floating-point when targeting PDF output for
2636 example). But the representation now provides 24 bits of pixel
2637 addressing and only 8 bits of sub-pixel positioning. This should give
2638 a much less stifling space to many applications.
2640 However, the underlying pixman library still has 16-bit limitations in
2641 many places, (it has its roots in the X server as well). Until those
2642 are also fixed, applications targeting cairo image surfaces, or
2643 hitting software fallbacks when targeting other surfaces will still
2644 encounter problems with device-space values needing more than 16
2649 Add a few tests to the test suite to increase coverage.
2651 Cleanup a few error-handling paths, (propagate error correctly).
2655 Fix handling of font sizes smaller than 1 device pixel.
2659 Fix to properly save/restore clip when analyzing meta-surface
2660 patterns, (fixing a couple of test-suite failures).
2662 Implement native support for CAIRO_OPERATOR_SOURCE when the source
2665 Emit rectangles as PDF rectangles ("re" operator) rather than as
2670 Fix to work properly with the 16.16->24.8 change.
2674 Fix CAIRO_EXTEND_REFLECT by using an image fallback, (there's no
2675 direct SVG support for reflected patterns).
2677 Fix the use of alpha-only masks, (such as CAIRO_FORMAT_A8).
2681 Add new API for efficiently using image data as a source:
2684 cairo_quartz_image_surface_create (cairo_surface_t *image_surface);
2687 cairo_quartz_image_surface_get_image (cairo_surface_t *surface);
2689 For full documentation, see:
2691 http://cairographics.org/manual/cairo-Quartz-Surfaces.html#cairo-quartz-image-surface-create
2693 Several fixes for cairo_mask().
2697 Change default from from Monaco to Helvetica to be more consistent
2698 with other font backends.
2700 Snapshot 1.5.10 (2008-02-20 Carl Worth <cworth@cworth.org>)
2701 ===========================================================
2702 This is the fifth snapshot in cairo's unstable 1.5 series. It comes 3
2703 weeks after the 1.5.8 snapshot. This snapshot adds one new API
2704 function, (cairo_has_current_point), and the usual mix of
2705 improvements, (more efficient PostScript/PDF output, optimized
2706 stroking), and fixes (more robust error-handling, etc.). See below for
2711 Add a new function to query if there is a current point:
2714 cairo_has_current_point (cairo_t *cr);
2716 There is no current point immediately after cairo_create(), nor after
2717 cairo_new_path() or cairo_new_sub_path(). There is a current point
2718 after any of the path-creation functions, (cairo_move_to,
2719 cairo_line_to, cairo_curve_to, etc.).
2721 With this new function, we also revert the change of the return type
2722 of cairo_get_current_point from cairo 1.5.8, (it's now a void function
2727 Optimize stroking code to avoid repeated calculation of redundant
2728 values, (particularly significant for very large, offscreen paths).
2732 Patch a few more potential buffer overruns, (due to integer
2735 Many fixes and improvements to cairo's error-handling, (ensure that
2736 correct error values are returned, clean up memory leaks on
2737 error-handling paths, etc.).
2739 Fix a potential infinite loop when stroking a spline with a pen that
2740 has been transformed to a line segment.
2742 Remove treating NULL as a synonym for a valid cairo_font_options_t*
2743 with default values, (a change that had been introduced as of cairo
2746 Remove the altered handling of tolerance and fallback-resolution that
2747 had been introduced as of cairo 1.5.4.
2751 Pass the original Drawable, (as opposed to the root window), to
2752 XCreatePixmap when creating a similar surface. This gives the X server
2753 more information so that it can be clever and efficient.
2757 Fix the rendering of repeating and reflecting patterns.
2759 Ensure miter limit is always >= 1, (smaller limits are not meaningful,
2760 but they can cause some PDF viewers to fail to display pages).
2762 Generate more efficient output when the same path is used for both
2767 Start sharing much of the cairo-pdf code rather than implementing very
2768 similar code in cairo-ps.
2770 Implement native support for repeating and reflecting linear
2773 Implement reflected surface patterns.
2775 Ensure miter limit is always >= 1, (smaller limits are not meaningful,
2776 but they can cause some PostScript viewers to crash).
2778 Generate PostScript that will perform more efficiently and use less
2779 memory on printers, (use currentfile instead of a giant string array
2780 for image data, and avoid using PostScript patterns for paint() and
2781 fill() when possible).
2785 Avoid unnecessary rasterization when copying a "similar" surface to
2786 another svg surface, (allow the SOURCE operator to be implemented with
2787 all-vector operations if there are no underlying objects).
2791 Eliminate infinite loop when attempting to render an empty string.
2793 Snapshot 1.5.8 (2008-01-30 Carl Worth <cworth@cworth.org>)
2794 ==========================================================
2795 This is the fourth snapshot in cairo's unstable 1.5 series. It comes 2
2796 weeks after the 1.5.6 snapshot. It adds a few new API functions. Most
2797 notably all callers of cairo_image_surface_create_for_data should now
2798 be calling cairo_format_stride_for_width to compute a legal stride
2799 value. See below for more details.
2801 New API in cairo 1.5.8
2802 ----------------------
2803 We've added a new function that should be called to compute a legal
2804 stride value before allocating data to be used with
2805 cairo_image_surface_create_for_data:
2808 cairo_format_stride_for_width (cairo_format_t format,
2811 We've also added a new cairo_path_extents function that can be used to
2812 compute a bounding box for geometry such as a single line segment,
2813 (contrast with cairo_path_extents and cairo_stroke_extents):
2816 cairo_path_extents (cairo_t *cr,
2817 double *x1, double *y1,
2818 double *x2, double *y2);
2820 And finally, we've added a function to allow for querying the
2821 XRenderPictFormat of a cairo-xlib surface:
2824 cairo_xlib_surface_get_xrender_format (cairo_surface_t *surface);
2828 Fix return types of cairo_surface_show_page and
2829 cairo_surface_copy_page. This is an API change to functions that are
2830 new in the 1.5 series, so not an API break compared to any stable
2831 cairo release, (1.0.x, 1.2.x, 1.4.x).
2833 Change the return type of cairo_get_current_point() from void to
2834 cairo_status_t. This allows the caller to receive a
2835 CAIRO_STATUS_NO_CURRENT_POINT value to distinguish the a current point
2836 at the origin from no current point existing.
2838 Performance improvement
2839 -----------------------
2840 Improve performance of clipping by using an optimized code path
2841 internally, (with the ADD operator instead of IN).
2845 Fix various cairo_*_extents functions to initialize the return-value
2846 variables even in the case of a cairo_t in error.
2848 Treat NULL as a legitimate value for cairo_font_options_t*. [NOTE:
2849 On discussion afterwards, we decided against this change so it has
2850 been removed as of cairo 1.5.10.]
2852 Fix rendering with CAIRO_ANTIALIAS_NONE to be more predictable, (that
2853 is, to avoid seams appearing when geometry and imagery share an
2854 identical edge). Portions of this fix are in the pixman library and
2855 will appear in a future release of that library.
2857 Avoid triggering an error for a font size of 0.
2859 Miscellaneous changes
2860 ---------------------
2861 Require pixman >= 0.9.6.
2863 There has been a tremendous amount improvement to cairo's
2864 documentation. We're delighted that 100% of the public API has at
2865 least some documentation in the API reference manual. Many thanks to
2866 Behdad Esfahbod and Nis Martensen for leading this effort.
2868 cairo-pdf and cairo-ps
2869 ----------------------
2870 Eliminate failure when a Type 1 font is embedded with an explicit
2875 Implement a more correct and more efficient approach for patterns with
2876 an extend mode of CAIRO_EXTEND_REFLECT.
2880 Fix image masks to properly pack and pad mask bits.
2884 Take care to only use DrawTiledImage for integer-aligned images, (and
2885 use slower paths to get the correct result in other cases).
2889 Fix for older versions of mingw.
2891 Improve the handling of the clipping with the win32 and win32-printing
2894 Fix rendering of non black/white text.
2896 Snapshot 1.5.6 (2008-01-15 Carl Worth <cworth@cworth.org>)
2897 ==========================================================
2898 This is the third snapshot in cairo's unstable 1.5 series. It comes
2899 about 6 weeks after the 1.5.4 snapshot. The only API addition compared
2900 to 1.5.4 is very minor, (a new value CAIRO_STATUS_TEMP_FILE_ERROR).
2901 The remainder of the changes are the usual accumulation of bug fixes
2902 and improvements. See below for details.
2906 Fix handling of fonts that contain a mixture of outline and bitmapped
2907 glyphs. There was a change in this handling in 1.5.4 that improved
2908 some cases and also regressed other cases. Now, all cases should be
2911 Fix alignment issues that were causing SIGBUS failures on SPARC.
2913 Fix a regression (which first appeared in 1.5.2) where stroking under
2914 a large scale would sometimes incorrectly replace a miter join with a
2915 bevel join. (Thanks to Keith Packard.)
2917 Fix reporting of zero-sized extents to be {0,0} rather than
2918 {INT_MAX,INT_MIN}. This avoids several integer overflow and
2919 allocations of massive regions in some cases.
2921 Fix failures of gradients with no stops, (quartz, ps, and pdf).
2923 Fix handling of Type 1 fonts on Windows platforms.
2925 Fix handling of Type 1 fonts with no specific family name in the font
2926 itself, (generate a CairoFont-x-y name).
2928 Handle NULL string values in cairo_show_text, cairo_show_glyphs, and
2931 Many robustness improvements along error-handling paths, (thanks as
2932 always, to Chris "ickle" Wilson).
2934 Various other minor fixes.
2936 Paginated backends (PDF/PostScript/win32-printing)
2937 --------------------------------------------------
2938 Avoid unnecessary rasterization when using a paginated surface as a
2939 source, (such as drawing from one pdf surface to another).
2941 Fix replaying of paginated surface with more than one level of push/pop
2946 Fix xlib backend to not consider recent X server release as having a
2947 buggy repeat implementation in the Render extension.
2951 Fix PDF output to avoid triggering very slow rendering in PDF viewers,
2952 (avoid starting and stopping the content stream for each pattern
2955 Support CAIRO_OPERATOR_SOURCE in cases where there is nothing below
2956 the object being drawn.
2958 Fix to avoid seams appearing between multiple fallback regions.
2960 cairo-ps (PostScript)
2961 ---------------------
2962 Use correct bounding box in Type 3 fonts.
2964 Fix several bugs in cairo's PostScript output. These include making
2965 the PostScript output more compatible with recent versions of
2966 ghostscript that are more strict about Type 3 fonts, for
2969 Fix for win32 to not attempt to create temporary files in the root
2970 directory, (where the user may not have write permission).
2972 Avoid generating Level 3 PostScript if Level 2 is sufficient. Also,
2973 add code in output documents to alert the user if Level 3 PostScript
2974 is handed to a device that cannot handle PostScript beyond Level
2979 Various performance optimizations.
2981 Fixed support for small surfaces (less than 8x8).
2983 Provide support for environment variables CAIRO_DIRECTFB_NO_ACCEL to
2984 disable acceleration and CAIRO_DIRECTFB_ARGB_FONT to enable ARGB fonts
2989 Allow OS/2 APIs instead of C library allocation functions.
2991 Snapshot 1.5.4 (2007-12-05 Carl Worth <cworth@cworth.org>)
2992 ==========================================================
2993 This is the second snapshot in cairo's unstable 1.5 series. It comes
2994 just over 1 month after the 1.5.2 snapshot. There are no API changes
2995 or additions in 1.5.4 compared to 1.5.2, but there are several bug
2996 fixes, and some optimizations. Most of these apply to particular
2997 backends. See below for details.
2999 General improvements
3000 --------------------
3001 Use less memory for spline approximation calculations.
3003 Change how the tolerance value is interpreted with regard to
3004 fallback-resolution. [Note: On further discussion, we decided against
3005 this change for now. It is removed as of cairo 1.5.10.]
3007 Fix precision of floating-point values in vector-output backends to
3008 avoid rounding errors with very small numbers.
3012 Fix bug in glyph rendering with xlib, (due to everything being clipped
3013 out). This was a regression in the 1.5.2 snapshot that was visible in
3014 the GIMP, for example. See:
3016 cairo 1.5.2 causes font problems in GIMP 2.4 status bar and evolution 2.12.1
3017 https://bugs.freedesktop.org/show_bug.cgi?id=13084
3019 PostScript improvements
3020 -----------------------
3021 Fix bug leading to invalid PostScript files when rendering
3022 text, (need "0 0 xyshow" instead of "0 xyshow").
3024 Fix many issues with Type 3 fonts, including making the resulting text
3029 Fix font metrics height value for ATSUI, (helps webkit on GTK+ OS X
3034 Fix EXTEND_NONE mode for patterns.
3036 Fix cairo_quartz_surface_create to properly clear the new surface
3037 in cairo_quartz_surface_create.
3039 Fix to correctly handle 0x0 sized surfaces.
3041 Optimize drawing of EXTEND_REPEAT patterns for OS X 10.5.
3043 Snapshot 1.5.2 (2007-10-30 Carl Worth <cworth@cworth.org>)
3044 ==========================================================
3045 This is the first snapshot in cairo's unstable 1.5 series. It comes 4
3046 months after the 1.4.10 release. This snapshot includes significant
3047 improvements to PDF and PostScript output, which is one of the things
3048 in which we're most interested in getting feedback. There are a couple
3049 of minor API additions, and several optimizations, (primarily in the
3050 "print/vector" backends). And there are dozens of bug fixes and
3051 robustness improvements.
3053 New dependency on external pixman library
3054 -----------------------------------------
3055 A significant change in this snapshot compared to all previous cairo
3056 releases is that cairo now depends on an external "pixman" library for
3057 its software rendering. Previously this same code was compiled
3058 internally as part of cairo, but now the code is separate so that both
3059 cairo and the X server can now share common code, (thanks very much to
3060 Søren Sandmann for his work on separating pixman and maintaining it).
3062 So users will need to acquire and build pixman before being able to
3063 build cairo. The current release is 0.9.6 and can be obtained from
3066 http://cairographics.org/releases/pixman-0.9.6.tar.gz
3068 which can be verified with:
3070 http://cairographics.org/releases/pixman-0.9.6.tar.gz.sha1
3071 66f01a682c64403a3d7a855ba5aa609ed93bcb9e pixman-0.9.6.tar.gz
3073 http://cairographics.org/releases/pixman-0.9.6.tar.gz.sha1.asc
3074 (signed by Carl Worth)
3076 Major PDF/PostScript improvements
3077 ---------------------------------
3078 Adrian Johnson has done some long-awaited work to make cairo's PDF and
3079 PostScript output more interesting than ever before. First, many
3080 operations that previously triggered image fallbacks will now be
3081 rendered as native vectors. These operations include:
3083 PDF: cairo_push_group, cairo_surface_create_similar,
3084 cairo_mask, A8/A1 surface sources, repeating/reflecting linear
3087 PostScript: cairo_push_group, cairo_surface_create_similar,
3088 gradients, bilevel alpha masks, (for example, all values either 0 or
3089 255 for an A8 mask).
3091 Not only that, but when an image fallback is required, it will now be
3092 limited to only the necessary region. For example, a tiny translucent
3093 image overlaying a small portion of text would previously caused an
3094 entire PostScript page to be rendered as a giant image. Now, the
3095 majority of that page will be nice text, and there will only be a tiny
3096 image in the output.
3098 Additionally, the PostScript output now carefully encodes text so that
3099 if it is subsequently converted to PDF, the text will be
3102 This is very exciting progress, and we're hoping to hear from users
3103 during the 1.5 series about how things have improved, (for example,
3104 inkscape users doing cairo-based PDF export: please let us know how
3105 things look). And feel free to pass your thanks along to Adrian for his excellent work.
3107 NOTE: This much improved PDF output makes more sophisticated use of
3108 functionality in the PDF specification. This means that cairo's output
3109 will sometimes expose bugs in some free software PDF viewers, (evince,
3110 poppler, and xpdf, for example), that are not yet ready for such PDF
3111 files. We're working with the poppler maintainers to get these bugs
3112 fixed as quickly as possible. In the meantime, please double-check
3113 with other PDF viewers if cairo-generated PDF files are not being
3114 rendered correctly. It may be due to a bug in the viewer rather than
3115 in the PDF file that cairo has created.
3117 Robustness improvements
3118 -----------------------
3119 Chris Wilson has made the largest contribution by far to cairo 1.5.2,
3120 (in number of commits). His more than 150 commits include a huge
3121 number of fixes to increase cairo's robustness. These fixes make cairo
3122 more robust against invalid and degenerate input, (NaN, empty path,
3123 etc.), against size-0 malloc calls, against memory leaks on
3124 error-recovery paths, and against other failures during error
3125 handling. He also implemented atomic operations to cairo, and used
3126 them to fix cairo's previously non-thread-safe reference counting,
3127 again improving robustness.
3129 Chris has put a tremendous amount of time and effort into writing
3130 analysis tools for this work, and in running those tools and fixing
3131 the problems they report. We're very grateful for this work, and hope
3132 that all cairo users appreciate the more robust implementation that
3135 This work is largely thankless, so it might make sense to notice
3136 sometime that cairo has been running quite smoothly for you, and when
3137 you do, send a quick "thank you" off to Chris Wilson, since it
3138 is all definitely running smoother thanks to his work.
3142 There are no major additions to cairo's core API. The only new,
3143 generic functions are:
3146 cairo_surface_copy_page (cairo_surface_t *surface);
3149 cairo_surface_show_page (cairo_surface_t *surface);
3151 which can now be used much more conveniently than the existing
3152 cairo_copy_page and cairo_show_page functions in some
3153 situations. These functions act identically, but require only a
3154 cairo_surface_t* and not a cairo_t*.
3156 All other API additions are specific to particular backends.
3158 New cairo-win32 API (new font face function and "win32 printing" surface)
3159 -------------------------------------------------------------------------
3160 There is a new function for creating a win32 font face for both a
3161 logfontw and an hfont together. This complements the existing
3162 functions for creating a font face from one or the other:
3165 cairo_win32_font_face_create_for_logfontw_hfont (LOGFONTW *logfont,
3168 There is also a new "win32 printing" surface:
3171 cairo_win32_printing_surface_create (HDC hdc);
3173 This interface looks identical to the original
3174 cairo_win32_surface_create, (both accept and HDC), but the behavior of
3175 this new surface is very different. It should only be called with a
3176 printing DC, and will result in all drawing commands being stored into
3177 a meta-surface and emitted after each page is complete, with analysis
3178 to do as minimal image-based fallbacks as necessary. The behavior and
3179 implementation shares much with the PDF and PostScript backends.
3181 New cairo-ps API (EPS and PostScript level control)
3182 ---------------------------------------------------
3183 An often requested feature has been the ability to generate
3184 Encapsulated PostScript (EPS) with cairo. We have that now with the
3185 following very simple API. Just do cairo_ps_surface_create as usual
3186 then call this function with a true value:
3189 cairo_ps_surface_set_eps (cairo_surface_t *surface,
3192 [NOTE: As always with snapshots, it's possible---though not very
3193 likely---that the API could still be modified before a final
3194 release. For example, this is the first public cairo function that
3195 accepts a Boolean parameter. I'm generally opposed to Boolean
3196 parameters, but this is probably the one case where I'm willing to
3197 accept one, (namely a "set" function that accepts a single Boolean).]
3199 Also, it is now possible to control what PostScript level to target,
3200 (either level 2 or level 3), with the following new API:
3202 typedef enum _cairo_ps_level {
3208 cairo_ps_surface_restrict_to_level (cairo_surface_t *surface,
3209 cairo_ps_level_t level);
3212 cairo_ps_get_levels (cairo_ps_level_t const **levels,
3216 cairo_ps_level_to_string (cairo_ps_level_t level);
3218 Improvement for cairo-quartz
3219 ----------------------------
3220 Brian Ewins had contributed several improvements to cairo-quartz. These
3221 include an implementation of EXTEND_NONE for linear and radial
3222 gradients, (so this extend mode will no longer trigger image fallbacks
3223 for these gradients), as well as native surface-mask clipping, (only
3224 on OS X 10.4+ where the CGContextClipToMask function is available).
3226 He also fixed a semantic mismatch between cairo and quartz for dashing
3227 with an odd number of entries in the dash array.
3229 We're grateful for Brian since not many quartz-specific improvements
3230 to cairo would be happening without him.
3234 Optimize SVG output for when the same path is both filled and stroked,
3235 and avoid unnecessary identity matrix in SVG output. (Emmanuel Pacaud).
3237 Optimize PS output to take less space (Ken Herron).
3239 Make PS output more compliant with DSC recommendations (avoid initclip
3240 and copy_page) (Adrian Johnson).
3242 Make PDF output more compact (Adrian Johnson).
3244 Release glyph surfaces after uploading them to the X server, (should
3245 save some memory for many xlib-using cairo application). (Behdad
3248 Optimize cairo-win32 to use fewer GDI objects (Vladimir Vukicevic).
3250 win32-printing: Avoid falling back to images when alpha == 255
3251 everywhere. (Adrian Johnson).
3253 win32-printing: Avoid falling back for cairo_push_group and
3254 cairo_surface_create_similar. (Adrian Johnson)
3258 Avoid potential integer overflows when allocating large buffers
3259 (Vladimir Vukicevic).
3261 Preparations to allow the 16.16 fixed-point format to change to
3262 24.8 (Vladimir Vukicevic).
3264 Fix bugs for unsupported X server visuals (rgb565, rgb555, bgr888, and
3265 abgr8888). (Carl Worth and Vladimir Vukicevic)
3267 Fix bugs in PDF gradients (Adrian Johnson).
3269 Fix cairo-xlib to build without requiring Xrender header
3270 files (Behdad Esfahbod).
3272 Make cairo more resilient in the case of glyphs not being available in
3273 the current font. (Behdad Esfahbod)
3275 Prevent crashes when both atsui and ft font backends are compiled in
3278 Make font subsetting code more robust against fonts that don't include
3279 optional tables (Adrian Johnson).
3281 Fix CFF subsetting bug, (which manifested by generating PDF files that
3282 Apple's Preview viewer could not read) (Adrian Johnson).
3284 Fixed error handling for quartz and ATSUI backends (Brian Ewins).
3286 Avoid rounding problems by pre-transforming to avoid integer-only
3287 restrictions on transformation in GDI (Adrian Johnson).
3289 Fixed an obscure bug (#7245) computing extents for some stroked
3292 Fix crashes due to extreme transformation of the pen, (seems to show
3293 up in many .swf files for some reason) (Carl Worth).
3295 Release 1.4.10 (2007-06-27 Carl Worth <cworth@cworth.org>)
3296 ==========================================================
3297 This is the fifth update in cairo's stable 1.4 series. It comes
3298 roughly three weeks after the 1.4.8 release. The most significant
3299 change in this release is a fix to avoid an X error in certain cases,
3300 (that were causing OpenOffice.org to crash in Fedora). There is also a
3301 semantic change to include child window contents when using an xlib
3302 surface as a source, an optimization when drawing many rectangles, and
3303 several minor fixes.
3305 Eliminate X errors that were killing OO.o (Chris Wilson)
3306 --------------------------------------------------------
3307 Cairo is fixed to avoid the X errors propagated when cleaning up
3308 Render Pictures after the application had already destroyed the
3309 Drawable they reference. (It would be nice if the X server wouldn't
3310 complain that some cleanup work is already done, but there you have
3311 it.) This fixes the bug causing OpenOffice.org to crash as described
3314 XError on right click menus in OOo.
3315 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=243811
3317 Use IncludeInferiors when using xlib surface as a source (Ryan Lortie)
3318 ----------------------------------------------------------------------
3319 When an xlib surface is used as the source of a draw operation the
3320 contents of child windows are now included in the source data. The
3321 semantics of drawing to xlib surfaces are unchanged (ie: draws are
3322 still clipped by child windows overlapping the destination window).
3324 Optimize drawing of many rectangles (Vladimir Vukicevic)
3325 --------------------------------------------------------
3326 Avoid O(N*N) loop when filling many axis-aligned rectangles, (either
3327 many rectangles as separate sub-paths or due to dashing).
3331 Fix cairo-perf on Solaris by linking to librt. (Behdad Esfahbod)
3333 Fix make check for systems that require executable files to have a
3334 particular extension. (Behdad Esfahbod)
3336 Eliminate some warnings in cairo-quartz. (Brian Ewins)
3338 Fix build-breaking typo for cairo-directfb. (Chris Wilson)
3340 Release 1.4.8 (2007-06-07 Carl Worth <cworth@cworth.org>)
3341 =========================================================
3342 This is the fourth update in cairo's stable 1.4 series. It comes just
3343 over five weeks after the 1.4.6 release. This release includes a
3344 thread-safe surface-cache for solid patterns which significantly
3345 improves text rendering with the xlib backend. Also, dozens of error
3346 paths in cairo have been fixed thanks to extensive fault-injection
3347 testing by Chris Wilson.
3349 Surface cache for solid patterns
3350 --------------------------------
3351 Originally written by Jorn Baayen, the introduction of a small cache
3352 for surfaces created for solid patterns improves performance
3353 dramatically. For example, this reduces the volume of X requests
3354 during text rendering to the same level as Xft.
3356 This cache first made its appearance in a 1.3.x snapshot, but was
3357 removed before appearing in any previous major release due to
3358 complications with multi-threaded programs. For example, programs like
3359 evince that would carefully restrict usage of cairo-xlib to a single
3360 thread were unpleasantly surprised to find that using cairo-image in a
3361 separate thread could trigger X requests.
3363 Behdad Esfahbod designed a fix which was implemented by Chris
3364 Wilson. Now, the necessary X requests are queued up until the next
3365 time the application directly operates on an xlib surface.
3367 Improved error handling paths
3368 ------------------------------
3369 Chris Wilson continued the excellent work he started in cairo 1.4.4 to
3370 make cairo much more robust against out-of-memory and other errors. He
3371 applied his memory allocation fault injection cairo's main test suite,
3372 (previously he had applied it to cairo's performance suite).
3374 Chris's testing found dozens of bugs which he fixed. Many of these
3375 bugs had perhaps never been hit by any users. But at least one was
3376 hit by the gnome-about program which resulted in dozens of duplicated
3377 bug reports against that program:
3379 http://bugzilla.gnome.org/show_bug.cgi?id=431990
3381 We were very pleasantly surprised to see this bug get fixed as a
3382 side-effect of Chris's work. Well done, Chris!
3386 Cleanup of mutex declarations (Behdad Esfahbod)
3388 Remove unnecessary clip region from SVG output (Emmanuel Pacaud)
3390 Remove Xsun from the buggy_repeat blacklist (Elaine Xiong)
3392 ATSUI: Fix glyph measurement: faster and more correct (Brian Ewins)
3394 Quartz: fixed 'extend' behaviour for patterns, improved pattern performance,
3395 and a few smaller correctness fixes. (Brian Ewins, Vladimir Vukicevic)
3397 Release 1.4.6 (2007-05-01 Carl Worth <cworth@cworth.org>)
3398 =========================================================
3399 This is the third update in cairo's stable 1.4 series. It comes a
3400 little less than three weeks since the 1.4.4 release. This release
3401 fixes the broken mutex initialization that made cairo 1.4.4 unusable
3402 on win32, OS/2, and BeOS systems. This release also adds significant
3403 improvements to cairo's PDF backend, (native gradients!), and a couple
3404 of performance optimizations, (one of which is very significant for
3405 users of the xlib backend). See below for more details.
3407 Repaired mutex initialization
3408 -----------------------------
3409 We apologize that cairo 1.4.4 did little more than crash on many
3410 platforms which are less-frequently used by the most regular cairo
3411 maintainers, (win32, OS/2, and BeOS). The mutex initialization
3412 problems that caused those crashes should be fixed now. And to avoid
3413 similar problems in the future, we've now started posting pre-release
3414 snapshots to get better testing, (subscribe to cairo@cairographics.org
3415 if you're interested in getting notified of those and testing them).
3419 Thanks to Adrian Johnson, (cairo PDF hacker extraordinaire), we have
3420 several improvements to cairo's PDF backend to announce:
3424 As of cairo 1.4.6, cairo will now generate native PDF gradients in
3425 many cases, (previously, the presence of a gradient on any page
3426 would force rasterized output for that page). Currently, only
3427 gradients with extend types of PAD (the default) or NONE will
3428 generate native PDF gradients---others will still trigger
3429 rasterization, (but look for support for other extend modes in a
3430 future release). Many thanks to Miklós Erdélyi as well, who did the
3431 initial work for this support.
3433 Better compatibility with PDF viewers:
3435 The PDF output from cairo should now be displayed correctly by a
3436 wider range of PDF viewers. Adrian tested cairo's PDF output against
3437 many PDF viewers, identified a common bug in many of those viewers
3438 (ignoring the CTM matrix in some cases), and modified cairo's output
3439 to avoid triggering that bugs (pre-transforming coordinates and
3440 using an identity matrix).
3442 Better OpenType/CFF subsetting:
3444 Cairo will now embed CFF and TrueType fonts as CID fonts.
3446 Performance optimizations
3447 -------------------------
3448 Faster cairo_paint_with_alpha:
3450 The cairo_paint_with_alpha call is used to apply a uniform alpha
3451 mask to a pattern. For example, it can be used to gradually fade an
3452 image out or in. Jeff Muizelaar fixed some missing/broken
3453 optimizations within the implementation of this function resulting
3454 in cairo_paint_with_alpha being up to 4 times faster when using
3455 cairo's image backend.
3457 Optimize rendering of "off-screen" geometry:
3459 Something that applications often do is to ask cairo to render
3460 things that are either partially or wholly outside the current clip
3461 region. Since 1.4.0 the image backend has been fixed to not waste
3462 too much time in this case. But other backends have still been
3465 In particular, the xlib backend has often performed quite badly in
3466 this situation. This is due to a bug in the implementation of
3467 trapezoid rasterization in many X servers.
3469 Now, in cairo 1.4.6 there is a higher-level fix for this
3470 situation. Cairo now eliminates or clips trapezoids that are wholly
3471 or partially outside the clip region before handing the trapezoids
3472 to the backend. This means that the X server's performance bug is
3473 avoided in almost all cases.
3475 The net result is that doing an extreme zoom-in of vector-based
3476 objects drawn with cairo might have previously brought the X server
3477 to its knees as it allocated buffers large enough to fit all of the
3478 geometry, (whether visible or not). But now the memory usage should
3479 be bounded and performance should be dramatically better.
3483 Behdad contributed an impressively long series of changes that
3484 organizes cairo's internals in several ways that will be very
3485 beneficial to cairo developers. Thanks, Behdad!
3487 Behdad has also provided a utility for generating malloc statistics,
3488 (which was used during the great malloc purges of 1.4.2 and
3489 1.4.4). This utility isn't specific to cairo so may be of benefit to
3490 others. It is found in cairo/util/malloc-stats.c and here are Behdad's
3495 make malloc-stats.so
3497 inside util/, and to use, run:
3499 LD_PRELOAD=malloc-stats.so some-program
3501 For binaries managed by libtool, eg, cairo-perf, do:
3503 ../libtool --mode=execute /bin/true ./cairo-perf
3504 LD_PRELOAD="../util/malloc-stats.so" .libs/lt-cairo-perf
3506 Finally, the cairo-perf-diff-files utility was enhanced to allow for
3507 generating performance reports from several runs of the same backend
3508 while some system variables were changed. For example, this is now
3509 being used to allow cairo-perf to measure the performance of various
3510 different acceleration architectures and configuration options of the
3513 Release 1.4.4 (2007-04-13 Carl Worth <cworth@cworth.org>)
3514 =========================================================
3515 This is the second update release in cairo's stable 1.4 series. It
3516 comes just less than a month after 1.4.2. The changes since 1.4.2
3517 consist primarily of bug fixes, but also include at least one
3518 optimization. See below for details.
3520 Of all the work that went into the 1.4.4 release
3522 There have been lots of individuals doing lots of great work on cairo,
3523 but two efforts during the 1.4.4 series deserve particular mention:
3525 Internal cleanup of error handling, (Chris Wilson)
3526 --------------------------------------------------
3527 Chris contributed a tremendous series of patches (74 patches!) to
3528 improve cairo's handling of out-of-memory and other errors. He began
3529 by adding gcc's warn_unused_attribute to as many functions as
3530 possible, and then launched into the ambitious efforts of adding
3531 correct code to quiet the dozens of resulting warnings.
3533 Chris also wrote a custom valgrind skin to systematically inject
3534 malloc failures into cairo, and did all the work necessary to verify
3535 that cairo's performance test suite runs to completion without
3538 The end result is a much more robust implementation. Previously, many
3539 error conditions would have gone unnoticed and would have led to
3540 assertion failures, segmentation faults, or other harder-to-diagnose
3541 problems. Now, more than ever, cairo should cleanly let the user know
3542 of problems through cairo_status and other similar status
3543 functions. Well done, Chris!
3545 More malloc reduction, (Mathias Hasselmann)
3546 -------------------------------------------
3547 After 1.4.0, Behdad launched an effort to chase down excessive calls
3548 to malloc within the implementation of cairo. He fixed a lot of
3549 malloc-happy objects for 1.4.2, but one of the worst offenders,
3550 (pixman regions), was left around. Mathias contributed an excellent
3551 series of 15 patches to finish off this effort.
3553 The end result is a cairo that calls malloc much less often than it
3554 did before. Compared to 1.4.2, 55% of the calls to malloc have been
3555 eliminate, (and 60% have been eliminated compared to 1.4.0). Well
3558 Other improvements since 1.4.2
3559 ------------------------------
3560 • Centralize mutex declarations (will reduce future build breaks),
3561 (Mathias Hasselmann)
3563 • Reduce malloc by caching recently freed pattern objects (Chris
3566 • Fix some broken composite operations (David Reveman)
3567 https://bugs.freedesktop.org/show_bug.cgi?id=5777
3569 Backend-specific fixes
3570 ----------------------
3572 • Use TJ operator for more compact representation of glyphs (Adrian
3575 • Fix glyph positioning bug when glyphs are not horizontal
3576 http://lists.freedesktop.org/archives/cairo/2007-April/010337.html
3579 • Fix crash when rendering with bitmap fonts (Carl Worth)
3580 https://bugzilla.mozilla.org/show_bug.cgi?id=376498
3583 • Turn metrics-hinting on by default (Behdad Esfahbod)
3585 • Fix edge-effect problem with transformed images drawn to xlib
3587 https://bugs.freedesktop.org/show_bug.cgi?id=10508
3589 • Avoid dereferencing a NULL screen. (Chris Wilson)
3590 https://bugs.freedesktop.org/show_bug.cgi?id=10517
3593 • Fix scaling of glyph surfaces
3595 https://bugs.freedesktop.org/show_bug.cgi?id=9568
3597 • Fix compilation failure when both xlib and quartz enabled
3600 • Fix rounding bug leading to incorrectly positioned glyphs
3602 https://bugs.freedesktop.org/show_bug.cgi?id=10531
3604 Release 1.4.2 (2007-03-19 Carl Worth <cworth@cworth.org>)
3605 =========================================================
3606 This is the first update release in cairo's stable 1.4 series. It
3607 comes just less than 2 weeks after 1.4.0. We hadn't anticipated an
3608 update this early, but we've managed to collect some important fixes
3609 that we wanted to get out to cairo users as soon as possible, (6 fixes
3610 for crashes, 1 case where graphical elements would not be drawn at
3611 all, a handful of backend-specific bugs, and several important build
3614 There's almost nothing but bug fixes in this release, (see below one
3615 optimization that Behdad did sneak in), so we recommend that everyone
3616 upgrade to this release when possible.
3618 Thanks to the many people that worked to fix these bugs, and those
3619 that did the work to report them and to test the fixes, (wherever
3620 possible both names are credited below).
3624 • Fix a crash due to a LOCK vs. UNLOCK typo (M. Drochner fixing Carl
3625 Worth's embarrassing typo).
3627 http://bugs.freedesktop.org/show_bug.cgi?id=10235
3629 • Fix potential buffer overflow, which on some systems with a checking
3630 variant of snprintf would lead to a crash (Adrian Johnson, Stanislav
3633 https://bugs.freedesktop.org/show_bug.cgi?id=10267
3634 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=232576
3636 • Fix a crash in cairo_stroke_extents or cairo_in_stroke when line
3637 width is 0.0. (Carl Worth and Sebastien Bacher)
3639 https://bugs.freedesktop.org/show_bug.cgi?id=10231
3641 • Fix a crash on certain combinations of X server/video drivers (Carl
3642 Worth and Tomas Carnecky).
3644 https://bugs.freedesktop.org/show_bug.cgi?id=10250
3646 • Fix a crash due to mishandling of invalid user input (Carl Worth and
3647 Alexander Darovsky).
3649 https://bugs.freedesktop.org/show_bug.cgi?id=9844
3651 • xlib: Cleanup server-side glyph caches on XCloseDisplay. This
3652 eliminated a crash detected by the perf suite, (and that
3653 applications could have run into as well). (Chris Wilson)
3657 • Fix for some geometry which simply disappeared under some
3658 transformations---a stroked line with an extreme skew in X, for
3659 example (Carl Worth and Jonathan Watt).
3661 https://bugzilla.mozilla.org/show_bug.cgi?id=373632
3663 • SVG: Fix radial gradients for CAIRO_EXTEND_REFLECT and when r0 > r1
3666 • PDF: Set page group color space to DeviceRGB.
3668 This fixes incorrect (muddy) transparent colors when rendering cairo
3669 PDF output in some viewers. (Adrian Johnson, Adam Goode, and
3672 http://lists.freedesktop.org/archives/cairo/2006-November/008551.html
3674 • win32: Return correct metrics when hinting is off, and fix font
3675 descent computation (Behdad Esfahbod).
3677 • quartz: Fix glyph interfaces to correctly return user-space rather
3678 than device-space coordinates (Brian Ewins).
3680 https://bugs.freedesktop.org/show_bug.cgi?id=9568
3682 • xcb: Fix parameter-order confusion with xcb_create_pixmap, which now
3683 makes all tests that pass with xlib now pass with xcb (Carl Worth,
3686 • Fix some memory leaks in the perf suite (Chris Wilson).
3688 • Fix perf suite to consider changes in pixman/src (Mathias
3693 • Don't include pre-generated cairo-features.h file. This was causing
3694 build failures when building with the directfb backend enabled
3697 https://bugs.freedesktop.org/show_bug.cgi?id=10189
3699 • Eliminate use of maintainer mode from cairo's automake/configure
3700 script. This means that updates to files such as Makefile.am will
3701 take effect, (by rerunning automake and friends as necessary) when
3702 invoking make rather than being silently ignored. (Behdad Esfahbod)
3704 • Don't compile cairo-deflate-stream.c, which depends on zlib, unless
3705 building the pdf backend which requires it. (Carl Worth, Tor
3708 https://bugs.freedesktop.org/show_bug.cgi?id=10202
3710 • Don't make the ps backend link against zlib anymore, since it
3711 doesn't require it (Carl Worth).
3713 • Use "find !" rather than "find -not" for better portability (Thomas
3716 https://bugs.freedesktop.org/show_bug.cgi?id=10226
3718 • Don't use unsupported visibility attribute "hidden" on Solaris
3719 (Gilles Dauphin, Thomas Klausner).
3721 https://bugs.freedesktop.org/show_bug.cgi?id=10227
3725 • It was Behdad that suggested we focus strictly on bug fixes now that
3726 we shipped so many performance improvements in 1.4.0, but it was
3727 also Behdad that got distracted by the chance to remove a lot of
3728 mallocs from cairo. Paths, gstates, trapezoids, splines, polygons,
3729 and gradient color stops will now use small, stack-allocated buffers
3730 in the most common cases rather than calling malloc as
3731 often. (Behdad Esfahbod). And look for more from Mathias Hasselmann
3734 Release 1.4.0 (2007-03-06 Carl Worth <cworth@cworth.org>)
3735 =========================================================
3736 The many people[*] who have been working hard on cairo are very
3737 pleased to announce the long-awaited release of cairo 1.4. This
3738 release comes 4 months after the last stable update release (1.2.6)
3739 and 9 months since the initial release of 1.2.0.
3741 The release notes below are intended to capture the highlights of the
3742 changes that have occurred from the 1.2 series to the new 1.4.0
3745 Performance improvements
3746 ------------------------
3747 Within the cairo project, the last 6 months or so has seen an intense
3748 effort focusing on the performance of cairo itself. That effort has
3749 paid off considerably, as can be seen in the following highlights of
3750 some of the performance differences from cairo 1.2.6 to cairo 1.4.0.
3752 (Note: The performance results reported here were measured on an x86
3753 laptop. Many of the improvements in 1.4---particular those involving
3754 text rendering---are even more dramatic on embedded platforms without
3755 hardware floating-point units. Such devices played an important part
3756 of many of the optimizations that found their way into cairo over the
3759 • Dramatic improvement when drawing objects that are mostly off-screen
3760 with the image backend (with the xlib backend this case is still
3761 slow due to an X server bug):
3763 image-rgba long-lines-uncropped-100 479.64 -> 4.98: 96.24x speedup
3764 ███████████████████████████████████████████████▋
3766 • Dramatic improvement when copying a small fraction of an image
3767 surface to an xlib surface:
3769 xlib-rgba subimage_copy-512 3.93 -> 0.07: 54.52x speedup
3770 ██████████████████████████▊
3772 • Dramatic improvement to tessellation speed for complex objects:
3774 image-rgb tessellate-256-100 874.16 -> 34.79: 25.13x speedup
3776 xlib-rgba zrusin_another_fill-415 148.40 -> 13.85: 10.72x speedup
3778 xlib-rgb world_map-800 680.20 -> 345.54: 1.97x speedup
3781 • Dramatic improvement to the speed of stroking rectilinear shapes,
3782 (such as the outline of a rectangle or "box"):
3784 image-rgb box-outline-stroke-100 0.18 -> 0.01: 24.22x speedup
3786 xlib-rgb box-outline-stroke-100 0.46 -> 0.06: 8.05x speedup
3790 • Dramatic improvements to text rendering speeds:
3792 xlib-rgba text_image_rgba_over-256 63.12 -> 9.61: 6.57x speedup
3795 • 3x improvements to floating-point to fixed-point conversion speeds:
3797 image-rgba pattern_create_radial-16 9.29 -> 3.44: 2.70x speedup
3800 • 2x improvements to linear gradient computation:
3802 image-rgb paint_linear_rgb_source-512 26.22 -> 11.61: 2.26x speedup
3805 • 2x improvement to a case common in PDF rendering:
3807 image-rgb unaligned_clip-100 0.10 -> 0.06: 1.81x speedup
3810 • 1.3x improvement to rectangle filling speed (note: this improvement
3811 is new since 1.3.16---previously this test case was a 1.3x slowdown
3814 image-rgba rectangles-512 6.19 -> 4.37: 1.42x speedup
3816 xlib-rgba rectangles-512 7.48 -> 5.58: 1.34x speedup
3819 NOTE: In spite of our best efforts, there are some measurable
3820 performance regressions in 1.4 compared to 1.2. It appears that the
3821 primary problem is the increased overhead of the new tessellator when
3822 drawing many, very simple shapes. The following test cases capture
3823 some of that slowdown:
3825 image-rgba mosaic_tessellate_lines-800 11.03 -> 14.29: 1.30x slowdown
3827 image-rgba box-outline-fill-100 0.01 -> 0.01: 1.26x slowdown
3829 image-rgba fill_solid_rgb_over-64 0.20 -> 0.22: 1.12x slowdown
3831 image-rgba fill_image_rgba_over-64 0.23 -> 0.25: 1.10x slowdown
3833 xlib-rgb paint_image_rgba_source-256 3.24 -> 3.47: 1.07x slowdown
3835 We did put some special effort into eliminating this slowdown for the
3836 very common case of drawing axis-aligned rectangles with an identity
3837 matrix (see the box-outline-stroke and rectangles speedup numbers
3838 above). Eliminating the rest of this slowdown will be a worthwhile
3839 project going forward.
3841 Also note that the "box-outline-fill" case is a slowdown while
3842 "box-outline-stroke" is a (huge) speedup. These two test cases
3843 resulted from the fact that some GTK+ theme authors were filling
3844 between two rectangles to avoid slow performance from the more natural
3845 means of achieving the same shape by stroking a single rectangle. With
3846 1.4 that workaround should definitely be eliminated as it will now
3847 cause things to perform more slowly.
3849 Greatly improved PDF output
3850 ---------------------------
3851 We are very happy to be able to announce that cairo-generated PDF
3852 output will now have text that can be selected, cut-and-pasted, and
3853 searched with most capable PDF viewer applications. This is something
3854 that was not ever possible with cairo 1.2.
3856 Also, the PDF output now has much more compact encoding of text than
3857 before. Cairo is now much more careful to not embed multiple copies of
3858 the same font at different sizes. It also compresses text and font
3859 streams within the PDF output.
3863 There are several new functions available in 1.4 that were not
3864 available in 1.2. Curiously, almost all of the new functions simply
3865 allow the user to query state that has been set in cairo (many new
3866 "get" functions) rather than providing any fundamentally new
3867 operations. The new functionality is:
3869 • Getting information about the current clip region
3872 cairo_copy_clip_rectangle_list
3873 cairo_rectangle_list_destroy
3875 • Getting information about the current dash setting
3877 cairo_get_dash_count
3880 • Getting information from a pattern
3882 cairo_pattern_get_rgba
3883 cairo_pattern_get_surface
3884 cairo_pattern_get_color_stop_rgba
3885 cairo_pattern_get_color_stop_count
3886 cairo_pattern_get_linear_points
3887 cairo_pattern_get_radial_circles
3889 • Getting the current scaled font
3891 cairo_get_scaled_font
3893 • Getting reference counts
3895 cairo_get_reference_count
3896 cairo_surface_get_reference_count
3897 cairo_pattern_get_reference_count
3898 cairo_font_face_get_reference_count
3899 cairo_scaled_font_get_reference_count
3901 • Setting/getting user data on objects
3905 cairo_pattern_set_user_data
3906 cairo_pattern_get_user_data
3907 cairo_scaled_font_set_user_data
3908 cairo_scaled_font_get_user_data
3910 • New cairo-win32 functions:
3912 cairo_win32_surface_create_with_ddb
3913 cairo_win32_surface_get_image
3914 cairo_win32_scaled_font_get_logical_to_device
3915 cairo_win32_scaled_font_get_device_to_logical
3919 The CAIRO_FORMAT_RGB16_565 enum value has been deprecated. It never
3920 worked as a format value for cairo_image_surface_create, and it wasn't
3921 necessary for supporting 16-bit 565 X server visuals.
3923 A sampling of bug fixes in cairo 1.4
3924 ------------------------------------
3925 • Fixed radial gradients
3926 • Fixed dashing (degenerate and "leaky" cases)
3927 • Fixed transformed images in PDF/PS output (eliminate bogus repeating)
3928 • Eliminate errors from CAIRO_EXTEND_REFLECT and CAIRO_EXTEND_PAD
3929 • cairo_show_page no longer needed for single-page output
3930 • SVG: Fix bug preventing text from appearing in many viewers
3931 • cairo-ft: Return correct metrics when hinting is off
3932 • Eliminate crash in cairo_create_similar if nil surface is returned
3933 • Eliminate crash after INVALID_RESTORE error
3934 • Fix many bugs related to multi-threaded use and locking
3935 • Fix for glyph spacing 32 times larger than desired (cairo-win32)
3936 • Fixed several problems in cairo-atsui (assertion failures)
3937 • Fix PDF output to avoid problems when printing from Acrobat Reader
3938 • Fix segfault on Mac OS X (measuring a zero-length string)
3939 • Fix text extents to not include the size of non-inked characters
3940 • Fix for glyph cache race condition in glitz backend (Jinghua Luo)
3941 • Fix make check to work on OPD platforms (IA64 or PPC64)
3942 • Fix compilation problems of cairo "wideint" code on some platforms
3943 • Many, many others...
3945 Experimental backends (quartz, XCB, OS/2, BeOS, directfb)
3946 ---------------------------------------------------------
3947 None of cairo's experimental backends are graduating to "supported"
3948 status with 1.4.0, but two of them in particular (quartz and xcb), are
3951 The quartz baceknd has been entirely rewritten and is now much more
3952 efficient. The XCB backend has been updated to track the latest XCB
3953 API (which recently had a 1.0 release).
3955 We hope to see these backends become supported in a future release,
3956 (once they are passing all the tests in cairo's test suite).
3958 The experimental OS/2 backend is new in cairo 1.4 compared to cairo
3961 Documentation improvements
3962 --------------------------
3963 We have added documentation for several functions and types that
3964 were previously undocumented, and improved documentation on other
3965 ones. As of this release, there remain only two undocumented
3966 symbols: cairo_filter_t and cairo_operator_t.
3968 [*]Thanks to everyone
3969 ---------------------
3970 I've accounted for 41 distinct people with attributed code added to
3971 cairo between 1.2.6 and 1.4.0, (their names are below). That's an
3972 impressive number, but there are certainly dozens more that
3973 contributed with testing, suggestions, clarifying questions, and
3974 encouragement. I'm grateful for the friendships that have developed as
3975 we have worked on cairo together. Thanks to everyone for making this
3978 Adrian Johnson, Alfred Peng, Alp Toker, Behdad Esfahbod,
3979 Benjamin Otte, Brian Ewins, Carl Worth, Christian Biesinger,
3980 Christopher (Monty) Montgomery, Daniel Amelang, Dan Williams,
3981 Dave Yeo, David Turner, Emmanuel Pacaud, Eugeniy Meshcheryakov,
3982 Frederic Crozat, Hans Breuer, Ian Osgood, Jamey Sharp, Jeff Muizelaar,
3983 Jeff Smith, Jinghua Luo, Jonathan Watt, Joonas Pihlaja, Jorn Baayen,
3984 Kalle Vahlman, Kjartan Maraas, Kristian Høgsberg, M Joonas Pihlaja,
3985 Mathias Hasselmann, Mathieu Lacage, Michael Emmel, Nicholas Miell,
3986 Pavel Roskin, Peter Weilbacher, Robert O'Callahan,
3987 Soren Sandmann Pedersen, Stuart Parmenter, T Rowley,
3990 Snapshot 1.3.16 (2007-03-02 Carl Worth <cworth@cworth.org>)
3991 ===========================================================
3994 A few new public functions have been added to the cairo API since the
3995 1.3.14 snapshot. These include a function to query the current scaled
3998 cairo_get_scaled_font
4000 New functions to query the reference count of all cairo objects:
4002 cairo_get_reference_count
4004 cairo_surface_get_reference_count
4005 cairo_pattern_get_reference_count
4007 cairo_font_face_get_reference_count
4008 cairo_scaled_font_get_reference_count
4010 And new functions to allow the use of user_data with any cairo object,
4011 (previously these were only available on cairo_surface_t and
4012 cairo_font_face_t objects):
4017 cairo_pattern_set_user_data
4018 cairo_pattern_get_user_data
4020 cairo_scaled_font_set_user_data
4021 cairo_scaled_font_get_user_data
4023 Usability improvement for PDF/PS/SVG generation
4024 -----------------------------------------------
4025 In previous versions of cairo, generating single-page output with the
4026 cairo-pdf, cairo-ps, or cairo-svg backends required a final call to
4027 cairo_show_page. This was often quite confusing as people would port
4028 functional code from a non-paginated backend and be totally mystified
4029 as to why the output was blank until they learned to add this call.
4031 Now that call to cairo_show_page is optional, (it will be generated
4032 implicitly if the user does not call it). So cairo_show_page is only
4033 needed to explicitly separate multiple pages.
4035 Greatly improved PDF output
4036 ---------------------------
4037 We are very happy to be able to announce that cairo-generated PDF
4038 output will now have text that can be selected, cut-and-paste, and
4039 searched with most capable PDF viewer applications. This is something
4040 that was not ever possible with cairo 1.2.
4042 Also, the PDF output now has much more compact encoding of text than
4043 before. Cairo is now much more careful to not embed multiple copies of
4044 the same font at different sizes. It also compresses text and font
4045 streams within the PDF output.
4049 • Fixed radial gradients
4051 The rendering of radial gradients has been greatly improved. In
4052 the cairo 1.2 series, there was a serious regression affecting
4053 radial gradients---results would be very incorrect unless one of
4054 the gradient circles had a radius of 0.0 and a center point within
4055 the other circle. These bugs have now been fixed.
4059 Several fixes have been made to the implementation of dashed
4060 stroking. Previously, some dashed, stroked rectangles would
4061 mis-render and fill half of the rectangle with a large triangular
4062 shape. This bug has now been fixed.
4064 • Fixed transformed images in PDF/PS output
4066 In previous versions of cairo, painting with an image-based source
4067 surface pattern to the PDF or PS backends would cause many kinds
4068 of incorrect results. One of the most common problems was that an
4069 image would be repeated many times even when the user had
4070 explicitly requested no repetition with CAIRO_EXTEND_NONE. These
4071 bugs have now been fixed.
4073 • Eliminate errors from CAIRO_EXTEND_REFLECT and CAIRO_EXTEND_PAD
4075 In the 1.2 version of cairo any use of CAIRO_EXTEND_REFLECT or
4076 CAIRO_EXTEND_PAD with a surface-based pattern resulted in an
4077 error, (cairo would stop rendering). This bug has now been
4080 Now, CAIRO_EXTEND_REFLECT should work properly with surface
4083 CAIRO_EXTEND_PAD is still not working correctly, but it will now
4084 simply behave as CAIRO_EXTEND_NONE rather than triggering the
4087 New rewrite of quartz backend (still experimental)
4088 --------------------------------------------------
4089 Cairo's quartz backend has been entirely rewritten and is now much
4090 more efficient. This backend is still marked as experimental, not
4091 supported, but it is now much closer to becoming an officially
4092 supported backend. (For people that used the experimental nquartz
4093 backend in previous snapshots, that implementation has now been
4094 renamed from "nquartz" to "quartz" and has replaced the old quartz
4097 Documentation improvements
4098 --------------------------
4099 We have added documentation for several functions and types that
4100 were previously undocumented, and improved documentation on other
4101 ones. As of this release, there remain only two undocumented
4102 symbols: cairo_filter_t and cairo_operator_t.
4106 • cairo-svg: Fix bug that was preventing text from appearing in many
4109 • cairo-ft: Return correct metrics when hinting is off
4111 • Cairo 1.3.14 deadlocks in cairo_scaled_font_glyph_extents or
4112 _cairo_ft_unscaled_font_lock_face
4114 https://bugs.freedesktop.org/show_bug.cgi?id=10035
4116 • cairo crashes in cairo_create_similar if nil surface returned by
4117 other->backend->create_similar
4119 https://bugs.freedesktop.org/show_bug.cgi?id=9844
4121 • evolution crash in _cairo_gstate_backend_to_user()
4122 https://bugs.freedesktop.org/show_bug.cgi?id=9906
4124 • Fix memory leak in rectilinear stroking code
4126 Things not in this release
4127 --------------------------
4128 • Solid-surface-pattern cache: This patch had been applied during
4129 the 1.3.x series, but it was reverted due to some inter-thread
4130 problems it caused. The patch is interesting since it made a big
4131 benefit for text rendering performance---so we'll work to bring a
4132 corrected version of this patch back as soon as possible.
4134 Snapshot 1.3.14 (2006-02-13 Carl Worth <cworth@cworth.org>)
4135 ===========================================================
4136 This is the seventh development snapshot in the 1.3 series, (and there
4137 likely won't be many more before the 1.4.0 release). It comes just
4138 over 3 weeks after the 1.3.12 snapshot.
4140 Since we're so close to the 1.4.0 release, there are not a lot of new
4141 features nor even a lot of new performance improvements in this
4142 snapshot. Instead, there are a great number of bug fixes. Some are
4143 long-standing bugs that we're glad to say goodbye to, and several are
4144 fixes for regressions that were introduced as part of the optimization
4145 efforts during the 1.3.x series.
4147 PDF text selection fixed
4148 ------------------------
4149 The inability to correctly select text in cairo-generated PDF has been
4150 a defect ever since the initial support for the PDF backend in the
4151 cairo 1.2.0 release. With the 1.3.14 snapshot, in most situations, and
4152 with most PDF viewer applications, the PDF generated by cairo will
4153 allow text to be correctly selected for copy-and-paste, (as well as
4156 We're very excited about this new functionality, (and very grateful to
4157 Adrian Johnson, Behdad Esfahbod, and others that have put a lot of
4158 work into this lately). Please test this new ability and give feedback
4159 on the cairo@cairographics.org list.
4161 Many thread-safety issues fixed
4162 -------------------------------
4163 We've discovered that no release of cairo has ever provided safe text
4164 rendering from a multi-threaded application. With the 1.3.14 snapshot
4165 a huge number of the bugs in this area have been fixed, and multiple
4166 application dvelopers have now reported success at writing
4167 multi-threaded applications with cairo.
4171 Fixed a bug that was causing glyph spacing to be 32 times larger than
4172 desired when using cairo-win32.
4174 Fixed a regression in the rendering of linear gradients that had been
4175 present since the 1.3.8 snapshot.
4177 Fixed several problems in cairo-atsui that were leading to assertion
4178 failures when rendering text.
4180 Fix corrupted results when rendering a transformed source image
4181 surface to an xlib surface. This was a regression that had been
4182 present since the 1.3.2 snapshot.
4184 Fixed PDF output to prevent problems printing from some versions of
4185 Acrobat Reader, (a single glyph was being substituted for every
4188 And many other fixes as well, (see the logs for details).
4190 Snapshot 1.3.12 (2007-01-20 Carl Worth <cworth@cworth.org>)
4191 ===========================================================
4192 The relentless march toward the cairo 1.4 release continues, (even if
4193 slightly late out of the starting blocks in 2007). This is the sixth
4194 development snapshot in the 1.3 series. It comes 4 weeks after the
4199 As usual, this snapshot has some fun performance improvements to show
4202 image-rgba long-lines-uncropped-100 470.08 -> 4.95: 94.91x speedup
4203 ███████████████████████████████████████████████
4204 image-rgb long-lines-uncropped-100 461.60 -> 4.96: 93.02x speedup
4205 ██████████████████████████████████████████████
4207 This 100x improvement, (and yes, that's 100x, not 100%), in the image
4208 backend occurs when drawing large shapes where only a fraction of the
4209 shape actually appears in the final result, (the rest being outside
4210 the bounds of the destination surface). Many applications should see
4211 speedups here, and the actual amount of speedup depends on the ratio
4212 of non-visible to visible portions of geometry.
4214 [Note: There remains a similar performance bug when drawing mostly
4215 non-visible objects with the xlib backend. This is due to a similar
4216 bug in the X server itself, but we hope a future cairo snapshot will
4217 workaround that bug to get a similar speedup with the xlib backend.]
4219 image-rgba unaligned_clip-100 0.09 -> 0.06: 1.67x speedup
4221 image-rgb unaligned_clip-100 0.09 -> 0.06: 1.66x speedup
4224 This speedup is due to further MMX optimization by Soeren Sandmann for
4225 a case commonly hit when rendering PDF files, (and thanks to Jeff
4226 Muizelaar for writing code to extract the test case for us).
4228 There's another MMX optimization in this snapshot (without a fancy
4229 speedup chart) by Dan Williams which improves compositing performance
4230 specifically for the OLPC machine.
4232 Thanks to Adrian Johnson, cairo's PDF output is now much more
4233 efficient in the way it encodes text output. By reducing redundant
4234 information and adding compression to text output streams, Adrian
4235 achieved a ~25x improvement in the efficiency of encoding text in PDF
4236 files, (was ~45 bytes per glyph and is now ~1.6 bytes per glyph).
4240 In addition to those performance improvements, this snapshot includes
4243 * A huge number of bug fixes for cairo-atsui text rendering, (for mac
4244 OS X). These bugs affect font selection, glyph positioning, glyph
4245 rendering, etc. One noteworthy bug fixes is that
4246 cairo_select_font_face will no longer arbitrarily select bold nor
4247 italic when not requested, (at least not when using a standard CSS2
4248 font family name such as "serif", "sans-serif", "monospace", etc.).
4249 All these fixes are thanks to Brian Ewins who continues to do a
4250 great job as the new cairo-atsui maintainer.
4252 * Fix PDF output so that images that are scaled down no longer
4253 mysteriously repeat (Carl Worth).
4255 * Fix segfault on Mac OS X dues to attempt to measure extents of a
4256 zero-length string (Behdad Esfahbod).
4258 * Fix text extents to not include the size of initial/trailing
4259 non-inked characters (Behdad Esfahbod).
4263 Three functions have had API changes to improve consistency. Note that
4264 the API functions being changed here are all functions that were
4265 introduced as new functions during these 1.3.x snapshots. As always,
4266 there will not be any API changes to functions included in a major
4267 release (1.2.x, 1.4.x, etc.) of cairo.
4269 The changes are as follows:
4271 * Rename of cairo_copy_clip_rectangles to cairo_copy_clip_rectangle_list.
4273 * Change cairo_get_dash_count to return an int rather than accepting a
4274 pointer to an int for the return value.
4276 * Change cairo_get_dash to have a void return type rather than
4277 returning cairo_status_t.
4279 It's possible there will be one more round of changes to these
4280 functions, (and perhaps cairo_get_color_stop as well), as we seek to
4281 establish a unifying convention for returning lists of values.
4283 Snapshot 1.3.10 (2006-12-23 Carl Worth <cworth@cworth.org>)
4284 ===========================================================
4285 Santa Claus is coming just a little bit early this year, and he's
4286 bringing a shiny new cairo snapshot for all the good little boys and
4289 This is the fifth development snapshot in the 1.3 series. It comes 9
4290 days after the 1.3.8 snapshot, and still well within our goal of
4291 having a new snapshot every week, (though don't expect one next
4292 week---we'll all be too stuffed with sugar plums).
4294 Speaking of sugar plums, there's a sweet treat waiting in this cairo
4295 snapshot---greatly improved performance for stroking rectilinear
4296 shapes, like the ever common rectangle:
4298 image-rgb box-outline-stroke-100 0.18 -> 0.01: 25.58x speedup
4299 ████████████████████████▋
4300 image-rgba box-outline-stroke-100 0.18 -> 0.01: 25.57x speedup
4301 ████████████████████████▋
4302 xlib-rgb box-outline-stroke-100 0.49 -> 0.06: 8.67x speedup
4304 xlib-rgba box-outline-stroke-100 0.22 -> 0.04: 5.39x speedup
4307 In past releases of cairo, some people had noticed that using
4308 cairo_stroke to draw rectilinear shapes could be awfully slow. Many
4309 people had worked around this by using cairo_fill with a more complex
4310 path and gotten a 5-15x performance benefit from that.
4312 If you're one of those people, please rip that workaround out, as now
4313 the more natural use of cairo_stroke should be 1.2-2x faster than the
4314 unnatural use of cairo_fill.
4316 And if you hadn't ever implemented that workaround, then you just
4317 might get to see your stroked rectangles now get drawn 5-25x faster.
4319 Beyond that performance fix, there are a handful of bug fixes in this
4322 * Fix for glyph cache race condition in glitz backend (Jinghua Luo)
4324 * Many fixes for ATSUI text rendering (Brian Ewins)
4326 * Un-break recent optimization-triggered regression in rendering text
4327 with a translation in the font matrix (Behdad Esfahbod)
4329 * Fix make check to work on OPD platforms (IA64 or PPC64)
4332 * Fix a couple of character spacing issues on Windows
4335 Have fun with that, everybody, and we'll be back for more in the new
4336 year, (with a plan to add the last of our performance improvements in
4337 this round, fix a few bad, lingering bugs, and then finish off a nice,
4338 stable 1.4 release before the end of January).
4342 Snapshot 1.3.8 (2006-12-14 Carl Worth <cworth@cworth.org>)
4343 ==========================================================
4344 This is the fourth development snapshot in the 1.3 series. It comes
4345 just slightly more than one week after the 1.3.6 snapshot.
4347 After the bug fixes in 1.3.6, we're back to our original program of
4348 weekly snapshots, each one faster than the one from the week
4349 before. Cairo 1.3.8 brings a 2x improvement in the speed of rendering
4350 linear gradients (thanks to David Turner), and a significant reduction
4351 in X traffic when rendering text (thanks to Xan Lopez and Behdad
4352 Esfahbod), making cairo behave very much like Xft does.
4354 A few other things in the 1.3.8 snapshot worth noting include a more
4355 forgiving image comparator in the test suite, (using the "perceptual
4356 diff" metric and GPL implementation by Hector Yee[*]), a bug fix for
4357 broken linking on x86_64 (thanks to M Joonas Pihlaja) and an even
4358 better implementation of _cairo_lround, (not faster, but supporting a
4359 more complete input range), from Daniel Amelang.
4361 [*] http://pdiff.sourceforge.net/
4363 Snapshot 1.3.6 (2006-12-06 Carl Worth <cworth@cworth.org>)
4364 ==========================================================
4365 This is the third development snapshot in the 1.3 series. It comes two
4366 weeks after the 1.3.4 snapshot.
4368 We don't have fancy performance charts this week as the primary
4369 changes in this snapshot are bug fixes. The performance work continues
4370 and the next snapshot (planned for one week from today) should include
4371 several improvements. The bug fixes in this snapshot include:
4373 * Fix undesirable rounding in glyph positioning (Dan Amelang)
4375 This bug was noticed by several users, most commonly by seeing
4376 improper text spacing or scrambled glyphs as drawn by nautilus. For
4379 Update to cairo-1.3.4 worsen font rendering
4380 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=217819
4382 * Fix reduced range of valid input coordinates to tessellator
4385 This bug was causing lots of assertion failures in mozilla as
4388 CAIRO_BO_GUARD_BITS and coordinate space?
4389 http://lists.freedesktop.org/archives/cairo/2006-December/008743.html
4391 * Fix several regressions in new tessellator (M Joonas Pihlaja)
4393 Joonas just had a good eye for detail here. I don't think any
4394 external cairo users had noticed any of these bugs yet.
4396 * Fix compilation problems of cairo "wideint" code on some platforms
4399 * Fix failed configure due to broken grep (Dan Amelang)
4401 This bug was reported here:
4403 AX_C_FLOAT_WORDS_BIGENDIAN doesn't work because grep doesn't
4404 work with binary file
4405 https://bugs.freedesktop.org/show_bug.cgi?id=9124
4407 * Remove the pkg-config minimum version requirement (Behdad Esfahbod)
4409 Some systems ship with pkg-config 0.15 and there was really no good
4410 reason for cairo to insist on having version 0.19 before it would
4413 There is also one new (but inert) feature in this snapshot. There's a
4414 new option that can be passed to cairo's configure script:
4416 --disable-some-floating-point
4418 Disable certain code paths that rely heavily on double precision
4419 floating-point calculation. This option can improve
4420 performance on systems without a double precision floating-point
4421 unit, but might degrade performance on those that do.
4423 As of this snapshot, this option does not make any change to cairo,
4424 but it is possible that future versions of cairo will respect this
4425 option and change the implementation of various functions as
4428 Snapshot 1.3.4 (2006-11-22 Carl Worth <cworth@cworth.org>)
4429 ==========================================================
4430 This is the second development snapshot in the 1.3 series. It comes
4431 one week after the 1.3.2 snapshot.
4433 This snapshot has a couple of significant performance improvements,
4434 and also adds new support for producing multi-page SVG output, (when
4435 targeting SVG 1.2)---thanks to Emmanuel Pacaud. The details of the
4436 performance improvements are as follows:
4438 1. The long-awaited "new tessellator".
4440 The credit for this being an improvement goes to Joonas Pihlaja. He
4441 took my really slow code and really put it through its paces to get
4442 the dramatic performance improvement seen below (up to 38x faster
4443 on realistic cases, and more than 10x faster for the zrusin_another
4446 His own writeup of the work he did is quite thorough, but more than
4447 can be quoted here. Please see his post for the interesting details:
4449 http://lists.freedesktop.org/archives/cairo/2006-November/008483.html
4451 (Though note that this snapshot also includes some additional,
4452 significant improvements that were only sketched out in that
4453 email---see "Generating fewer trapezoids").
4455 2. More floating-point improvements
4457 Daniel Amelang continues to work the magic he began in the 1.3.2
4458 snapshot. This time he short-circuits floating-point
4459 transformations by identity matrices and applies the earlier
4460 floating-to-fixed-point technique to the problem of rounding.
4462 The improvements here will primarily benefit text performance, and
4463 will benefit platforms without hardware floating-point more than
4464 those that have it, (some text tests show 20% improvement on an x86
4465 machine and closer to 80% improvement on arm).
4467 The performance chart comparing 1.3.2 to 1.3.4 really speaks for
4468 itself, (this is on an x86 laptop). This is quite a lot of progress
4471 xlib-rgb stroke_similar_rgba_over-256 74.99 1.45% -> 2.03 68.38%: 36.86x speedup
4472 ███████████████████████████████████▉
4473 xlib-rgb stroke_similar_rgba_source-256 78.23 1.43% -> 3.30 67.05%: 23.71x speedup
4474 ██████████████████████▊
4475 xlib-rgba tessellate-256-100 820.42 0.15% -> 35.06 2.84%: 23.40x speedup
4476 ██████████████████████▍
4477 image-rgba tessellate-256-100 819.55 0.32% -> 35.04 3.56%: 23.39x speedup
4478 ██████████████████████▍
4479 xlib-rgb stroke_image_rgba_over-256 78.10 1.43% -> 4.33 65.56%: 18.04x speedup
4481 xlib-rgb stroke_image_rgba_source-256 80.11 1.63% -> 5.75 63.99%: 13.94x speedup
4483 xlib-rgba zrusin_another_tessellate-415 89.22 0.35% -> 8.38 5.23%: 10.65x speedup
4485 image-rgba zrusin_another_tessellate-415 87.38 0.89% -> 8.37 5.22%: 10.44x speedup
4487 image-rgba zrusin_another_fill-415 117.67 1.34% -> 12.88 2.77%: 9.14x speedup
4489 xlib-rgba zrusin_another_fill-415 140.52 1.57% -> 15.79 2.88%: 8.90x speedup
4491 image-rgba tessellate-64-100 9.68 3.42% -> 1.42 0.60%: 6.82x speedup
4493 xlib-rgba tessellate-64-100 9.78 4.35% -> 1.45 0.83%: 6.72x speedup
4495 xlib-rgb stroke_linear_rgba_over-256 46.01 2.44% -> 7.74 54.51%: 5.94x speedup
4497 xlib-rgb stroke_linear_rgba_source-256 48.09 2.15% -> 9.14 53.00%: 5.26x speedup
4499 xlib-rgb stroke_radial_rgba_over-256 50.96 2.34% -> 12.46 47.99%: 4.09x speedup
4501 xlib-rgb stroke_radial_rgba_source-256 53.06 1.57% -> 13.96 46.57%: 3.80x speedup
4503 image-rgba paint_similar_rgba_source-256 0.12 1.57% -> 0.08 9.92%: 1.42x speedup
4505 image-rgba paint_image_rgba_source-256 0.12 2.49% -> 0.08 10.70%: 1.41x speedup
4507 image-rgba world_map-800 356.28 0.46% -> 275.72 1.15%: 1.29x speedup
4509 xlib-rgba world_map-800 456.81 0.39% -> 357.95 1.39%: 1.28x speedup
4511 image-rgb tessellate-16-100 0.09 0.57% -> 0.07 3.43%: 1.23x speedup
4513 image-rgba tessellate-16-100 0.09 0.06% -> 0.07 2.46%: 1.23x speedup
4515 image-rgba text_solid_rgb_over-256 5.39 4.01% -> 4.47 0.70%: 1.21x speedup
4517 image-rgba text_solid_rgba_over-256 5.37 0.82% -> 4.45 0.75%: 1.21x speedup
4519 image-rgba text_image_rgb_over-64 0.78 0.10% -> 0.65 0.74%: 1.20x speedup
4521 image-rgba text_image_rgba_over-64 0.78 0.29% -> 0.65 0.68%: 1.19x speedup
4523 image-rgb text_solid_rgb_over-64 0.76 2.45% -> 0.63 0.81%: 1.19x speedup
4525 image-rgba text_solid_rgba_over-64 0.76 0.33% -> 0.64 0.66%: 1.19x speedup
4527 image-rgba text_similar_rgba_over-256 5.99 4.72% -> 5.04 1.09%: 1.19x speedup
4530 We should point out that there is some potential for slowdown in this
4531 snapshot. The following are the worst slowdowns reported by the cairo
4532 performance suite when comparing 1.3.2 to 1.3.4:
4534 image-rgba subimage_copy-256 0.01 0.87% -> 0.01 3.61%: 1.45x slowdown
4536 xlib-rgb paint_solid_rgb_over-256 0.31 10.23% -> 0.38 0.33%: 1.26x slowdown
4538 image-rgba box-outline-fill-100 0.01 0.30% -> 0.01 2.52%: 1.21x slowdown
4540 image-rgba fill_solid_rgb_over-64 0.20 1.22% -> 0.22 1.59%: 1.12x slowdown
4542 image-rgb fill_similar_rgb_over-64 0.21 1.04% -> 0.24 1.06%: 1.11x slowdown
4544 image-rgba fill_image_rgb_over-64 0.21 1.19% -> 0.24 0.72%: 1.11x slowdown
4546 image-rgba fill_similar_rgb_over-64 0.21 0.18% -> 0.24 0.30%: 1.11x slowdown
4548 image-rgb fill_solid_rgba_over-64 0.22 1.66% -> 0.24 1.15%: 1.11x slowdown
4550 image-rgb fill_image_rgb_over-64 0.21 0.14% -> 0.24 0.80%: 1.11x slowdown
4552 image-rgba fill_image_rgba_over-64 0.22 1.34% -> 0.25 0.20%: 1.11x slowdown
4554 image-rgba fill_solid_rgba_over-64 0.22 1.48% -> 0.24 0.95%: 1.11x slowdown
4556 image-rgb fill_similar_rgba_over-64 0.22 1.13% -> 0.25 1.25%: 1.10x slowdown
4559 The 45% slowdown for subimage_copy is an extreme case. It's unlikely
4560 to hit many applications unless they often use cairo_rectangle;
4561 cairo_fill to copy a single pixel at a time. In any case, it shows a
4562 worst-case impact of the overhead of the new tessellator. The other
4563 slowdowns (~ 10%) are probably more realistic, and still very
4566 We will work to ensure that performance regressions like these are not
4567 present from one major release of cairo to the next, (for example,
4570 But we're putting this 1.3.4 snapshot out there now, even with this
4571 potential slowdown so that people can experiment with it. If you've
4572 got complex geometry, we hope you will see some benefit from the new
4573 tessellator. If you've got primarily simple geometry, we hope things
4574 won't slowdown too much, but please let us know what slowdown you see,
4575 if any, so we can calibrate our performance suite against real-world
4578 Thanks, and have fun with cairo!
4580 Snapshot 1.3.2 (2006-11-14 Carl Worth <cworth@cworth.org>)
4581 ==========================================================
4582 This is the first development snapshot since the 1.2 stable series
4583 branched off shortly after the 1.2.4 release in August 2006.
4585 This snapshot includes all the bug fixes from the 1.2.6 release,
4586 (since they originated here on the 1.3 branch first and were
4587 cherry-picked over to 1.2). But more importantly, it contains some new
4588 API in preparation for a future 1.4 release, and most importantly, it
4589 contains several performance improvements.
4591 The bug fixes will not be reviewed here, as most of them are already
4592 described in the 1.2.6 release notes. But details for the new API and
4593 some performance improvements are included here.
4595 As with all snapshots, this is experimental code, and the new API
4596 added here is still experimental and is not guaranteed to appear
4597 unchanged in any future release of cairo.
4601 Several new API additions are available in this release. There is a
4602 common theme among all the additions in that they allow cairo to
4603 advertise information about its state that it was refusing to
4604 volunteer earlier. So this isn't groundbreaking new functionality, but
4605 it is essential for easily achieving several tasks.
4607 The new functions can be divided into three categories:
4609 Getting information about the current clip region
4610 -------------------------------------------------
4612 cairo_copy_clip_rectangles
4613 cairo_rectangle_list_destroy
4615 Getting information about the current dash setting
4616 --------------------------------------------------
4617 cairo_get_dash_count
4620 Getting information from a pattern
4621 ----------------------------------
4622 cairo_pattern_get_rgba
4623 cairo_pattern_get_surface
4624 cairo_pattern_get_color_stop_rgba
4625 cairo_pattern_get_color_stop_count
4626 cairo_pattern_get_linear_points
4627 cairo_pattern_get_radial_circles
4629 In each of these areas, we have new API for providing a list of
4630 uniform values from cairo. The closest thing we had to this before was
4631 cairo_copy_path, (which is rather unique in providing a list of
4634 The copy_clip_rectangles/rectangle_list_destroy functions follow a
4635 style similar to that of cairo_copy_path. Meanwhile, the dash and
4636 pattern color stop functions introduce a new style in which there is a
4637 single call to return the number of elements available (get_dash_count
4638 and get_color_stop_count) and then a function to be called once to get
4639 each element (get_dash and get_color_stop_rgba).
4641 I'm interested in hearing feedback from users of these new API
4642 functions, particularly from people writing language bindings. One
4643 open question is whether the clip "getter" functionality should adopt
4644 a style similar to that of the new dash and color_stop interfaces.
4648 The CAIRO_FORMAT_RGB16_565 enum value has been deprecated. It never
4649 worked as a format value for cairo_image_surface_create, and it wasn't
4650 necessary for supporting 16-bit 565 X server visuals.
4654 The XCB backend has been updated to track the latest XCB API (which
4655 recently had a 1.0 release).
4659 Vladimir Vukicevic has written a new "native quartz" backend which
4660 will eventually replace the current "image-surface wrapping" quartz
4661 backend. For now, both backends are available, (the old one is
4662 "quartz" and the new one is "nquartz"). But it is anticipated that the
4663 new backend will replace the old one and take on the "quartz" name
4664 before this backend is marked as supported in a release of cairo.
4668 Doodle and Peter Weilbacher have contributed a new, experimental
4669 backend for using cairo on OS/2 systems.
4671 Performance improvements
4672 ------------------------
4673 Here are some highlights from cairo's performance suite showing
4674 improvements from cairo 1.2.6 to cairo 1.3.2. The command used to
4675 generate this data is:
4677 ./cairo-perf-diff 1.2.6 HEAD
4679 available in the perf/ directory of a recent checkout of cairo's
4680 source, (the cairo-perf-diff script does require a git checkout and
4681 will not work from a tar file---though ./cairo-perf can still be used
4682 to generate a single report there and ./cairo-perf-diff-files can be
4683 used to compare two reports).
4685 Results are described below both for an x86 laptop (with an old Radeon
4686 video card, recent X.org build, XAA, free software drivers), as well
4687 as for a Nokia 770. First the x86 results with comments on each, (all
4688 times are reported in milliseconds).
4690 Copying subsets of an image surface to an xlib surface (much faster)
4691 --------------------------------------------------------------------
4692 xlib-rgba subimage_copy-512 10.50 -> : 53.97x speedup
4693 █████████████████████████████████████████████████████
4695 Thanks to Christopher (Monty) Montgomery for this big performance
4696 improvement. Any application which has a large image surface and is
4697 copying small pieces of it at a time to an xlib surface, (imagine an
4698 application that loads a single image containing all the "sprites" for
4699 that application), will benefit from this fix. The larger the ratio of
4700 the image surface to the portion being copied, the larger the benefit.
4702 Floating-point conversion (3x faster)
4703 -------------------------------------
4704 xlib-rgba pattern_create_radial-16 27.75 -> 3.93 : 2.94x speedup
4706 image-rgb pattern_create_radial-16 26.06 -> 3.74 : 2.90x speedup
4709 Thanks to Daniel Amelang, (and others who had contributed the idea
4710 earlier), for this nice improvement in the speed of converting
4711 floating-point values to fixed-point.
4713 Text rendering (1.3 - 2x faster)
4714 ------------------------------
4715 xlib-rgba text_image_rgba_source-256 319.73 -> 62.40 : 2.13x speedup
4717 image-rgb text_solid_rgba_over-64 2.85 -> 0.88 : 1.35x speedup
4720 I don't think we've ever set out to improve text performance
4721 specifically, but we did it a bit anyway. I believe the extra
4722 improvement in the xlib backend is due to Monty's image copying fix
4723 above, and the rest is due to the floating-point conversion speedup.
4725 Thin stroke improvements (1.5x faster)
4726 ---------------------------------------------
4727 image-rgb world_map-800 1641.09 -> 414.77 : 1.65x speedup
4729 xlib-rgba world_map-800 1939.66 -> 529.94 : 1.52x speedup
4732 The most modest stuff to announce in this release is the 50%
4733 improvement I made in the world_map case. This is in improvement that
4734 should help basically anything that is doing strokes with many
4735 straight line segments, (and the thinner the better, since that makes
4736 tessellation dominate rasterization). The fixes here are to use a
4737 custom quadrilateral tessellator rather than the generic tessellator
4738 for straight line segments and the miter joins.
4740 Performance results from the Nokia 770
4741 --------------------------------------
4742 xlib-rgba subimage_copy-512 55.88 -> 2.04 : 27.34x speedup
4743 ██████████████████████████▍
4744 xlib-rgb text_image_rgb_over-256 1487.58 -> 294.43 : 5.05x speedup
4746 image-rgb pattern_create_radial-16 187.13 -> 91.86 : 2.04x speedup
4748 xlib-rgba world_map-800 21261.41 -> 15628.02 : 1.36x speedup
4751 Here we see that the subimage_copy improvement was only about half as
4752 large as the corresponding improvement on my laptop, (27x faster
4753 compared to 54x) and the floating-point conversion fix also was quite
4754 as significant, (2x compared to 3x). Oddly the improvement to text
4755 rendering performance was more than twice as good (5x compared to
4756 2x). I don't know what the reason for that is, but I don't think it's
4757 anything anybody should complain about.
4759 Release 1.2.6 (2006-11-02 Behdad Esfahbod <behdad@behdad.org>)
4760 ==============================================================
4761 This is the third bug fix release in the 1.2 series, coming less than
4762 two months after the 1.2.4 release made on August 18.
4764 The 1.2.4 release turned out to be a pretty solid one, except for a crasher
4765 bug when forwarding an X connection where the client and the server have
4766 varying byte orders, eg. from a PPC to an i686. Other than that, various
4767 other small bugs have been fixed.
4769 Various improvements have been made in the testing infrastructure to prevent
4770 false positives, and to make sure the generated cairo shared object behaves as
4771 expected in terms of exported symbols and relocations.
4773 There were a total of 89 changes since 1.2.4. The following list the most
4778 - Avoid unsigned loop control variable to eliminate infinite,
4779 memory-scribbling loop. (#7593)
4780 - Fix cairo_image_surface_create to report INVALID_FORMAT errors.
4781 Previously the detected error was being lost and a nil surface was
4782 returned that erroneously reported CAIRO_STATUS_NO_MEMORY.
4783 - Change _cairo_color_compute_shorts to not rely on any particular
4784 floating-point epsilon value. (#7497)
4785 - Fix infinite-join test case (bug #8379)
4786 - Pass correct surface to create_similar in _cairo_clip_init_deep_copy().
4790 - Fix Type 1 embedding in PDF.
4791 - Correct the value of /LastChar in the PDF Type 1 font dictionary.
4792 - Improve error checking in TrueType subsetting.
4793 - Compute right index when looking up left side bearing. (bug #8180)
4794 - Correct an unsigned to signed conversion problem in truetype subsetting
4796 - Type1 subsetting: Don't put .notdef in Encoding when there are 256 glyphs.
4797 - Add cairo version to PS header / PDF document info dictionary.
4798 - Set CTM before path construction.
4802 - Get correct unhinted outlines on win32. (bug 7603)
4803 - Make cairo as a win32 static library possible.
4804 - Use CAIRO_FORMAT_RGB24 for BITSPIXEL==32 surfaces too.
4808 - Define WINVER if it's not defined. (bug 6456)
4809 - Fix the AMD64 final link by removing SLIM from pixman.
4810 - Misc win32 compilation fixes.
4811 - Add Sun Pro C definition of pixman_private.
4812 - Use pixman_private consistently as prefix not suffix.
4813 - Added three tests check-plt.sh, check-def.sh, and check-header.sh that check
4814 that the shared object, the .def file, and the public headers agree about
4815 the exported symbols.
4816 - Require pkg-config 0.19. (#8686)
4819 Release 1.2.4 (2006-08-18 Carl Worth <cworth@cworth.org>)
4820 =========================================================
4821 This is the second bug fix release in the 1.2 series, coming less than
4822 two weeks after the 1.2.2 release made on August 8.
4824 The big motivation for a quick release was that there were a log of
4825 build system snags that people ran into with the 1.2.2 release. But,
4826 by the time we got those all done, we found that we had a bunch of
4827 fixes for cairo's rendering as well. So there's a lot of goodness in
4828 here for such a short time period.
4832 Fix image surfaces to not be clipped when used as a source (Vladimir Vukicevic)
4833 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=72e25648c4c4bc82ddd938aa4e05887a293f0d8b
4835 Fix a couple of corner cases in dashing degenerate paths (Jeff Muizelaar)
4836 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=fbb1758ba8384650157b2bbbc93d161b0c2a05f0
4838 Fix support for type1 fonts on win32 (Adrian Johnson)
4839 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=da1019c9138695cb838a54f8b871bbfd0e8996d7
4841 Fix assertion failure when rotating bitmap fonts (Carl Worth)
4842 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=0bfa6d4f33b8ddb5dc55bbe419c15df4af856ff9
4844 Fix assertion failure when calling cairo_text_path with bitmap fonts (Carl Worth)
4845 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=9878a033531e6b96b5f27e69e10e90dee7440cd9
4847 Fix mis-handling of cairo_close_path in some situations (Tim Rowley, Carl Worth)
4848 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=53f74e59faf1af78f2f0741ccf1f23aa5dad4efc
4850 Respect font_matrix translation in _cairo_gstate_glyph_path (Behdad Esfahbod)
4851 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=f183b835b111d23e838889178aa8106ec84663b3
4853 Fix vertical metrics adjustment to work with non-identity shapes (Behdad Esfahbod)
4854 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=b7bc263842a798d657a95e539e1693372448837f
4856 [PS] Set correct ImageMatrix in _cairo_ps_surface_emit_bitmap_glyph_data (Behdad Esfahbod)
4857 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=d47388ad759b0a1a0869655a87d9b5eb6ae2445d
4861 Fix xlib detection to prefer pkg-config to avoid false libXt dependency (Behdad Esfahbod)
4862 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=0e78e7144353703cbd28aae6a67cd9ca261f1d68
4864 Fix typos causing win32 build problem with PS,PDF, and SVG backends (Behdad Esfahbod)
4865 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=aea83b908d020e26732753830bb3056e6702a774
4867 Fix configure cache to not use stale results (Behdad Esfahbod)
4868 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=6d0e3260444a2d5b6fb0cb223ac79f1c0e7b3a6e
4870 Fix to not pass unsupported warning options to the compiler (Jens Granseuer)
4871 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=97524a8fdb899de1ae4a3e920fb7bda6d76c5571
4873 Fix to allow env. variables such as png_REQUIRES to override configure detection (Jens Granseuer)
4874 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=abd16e47d6331bd3811c908e524b4dcb6bd23bf0
4876 Fix test suite to not use an old system cairo when converting svg2png (Behdad Esfahbod)
4877 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=6122cc85c8f71b1ba2df3ab86907768edebe1781
4879 Fix test suite to not require signal.h to be present (Behdad Esfahbod)
4880 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=6f8cf53b1e1ccdbe1ab6a275656b19c6e5120e40
4884 Many useful warnings cleanups from sparse, valgrind, and careful eyes
4885 (Kjartan Maraas, Pavel Roskin)
4887 Release 1.2.2 (2006-08-08 Carl Worth <cworth@cworth.org>)
4888 =========================================================
4889 This is the first bug fix release in the 1.2 series since the original
4890 1.2.0 release made six weeks ago.
4892 There were some very serious bugs in the 1.2.0 release, (see below),
4893 so everybody is encouraged to upgrade from 1.2.0 to 1.2.2. The 1.2.2
4894 release maintains source and binary compatibility with 1.2.0 and does
4895 not make any API additions.
4897 Fix crashes with BGR X servers
4898 ------------------------------
4899 With cairo 1.2.0 many people reported problems with all cairo-using
4900 programs, (including all GTK+ programs with GTK+ >= 2.8) immediately
4901 crashing with a complaint about an unsupported image format. This bug
4902 affected X servers that do not provide the Render extension and that
4903 provide a visual with BGR rather than RGB channel order.
4905 report: https://bugs.freedesktop.org/show_bug.cgi?id=7294
4906 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=9ae66174e774b57f16ad791452ed44efc2770a59
4908 Fix the "disappearing text" bug
4909 -------------------------------
4910 With cairo 1.2.0 many people reported that text would disappear from
4911 applications, sometimes reappearing with mouse motion or
4912 selection. The text would disappear after the first space in a string
4913 of text. This bug was caused by an underlying bug in (very common) X
4914 servers, and only affected text rendered without antialiasing, (either
4915 a bitmap font or a vector font with antialiasing disabled). The bug
4916 was also exacerbated by a KDE migration bug that caused antialiasing
4917 to be disabled more than desired.
4919 report: https://bugs.freedesktop.org/show_bug.cgi?id=7494
4920 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=456cdb3058f3b416109a9600167cd8842300ae14
4922 Xorg: https://bugs.freedesktop.org/show_bug.cgi?id=7681
4923 KDE: http://qa.mandriva.com/show_bug.cgi?id=23990
4925 Fix broken image fallback scaling (aka. "broken printing")
4926 ----------------------------------------------------------
4927 The various "print" backends, (pdf, ps, and svg), sometimes fallback
4928 to using image-based rendering for some operations. In cairo 1.2.0
4929 these image fallbacks were scaled improperly. Applications using cairo
4930 can influence the resolution of the image fallbacks with
4931 cairo_surface_set_fallback_resolution. With the bug, any value other
4932 than 72.0 would lead to incorrect results, (larger values would lead
4933 to increasingly shrunken output).
4935 report: https://bugs.freedesktop.org/show_bug.cgi?id=7533
4936 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=1feb4291cf7813494355459bb547eec604c54ffb
4938 Fix inadvertent semantic change of font matrix translation (Behdad Esfahbod)
4939 ----------------------------------------------------------------------------
4940 The 1.2.0 release introduced an inadvertent change to how the
4941 translation components of a font matrix are interpreted. In the 1.0
4942 series, font matrix translation could be used to offset the glyph
4943 origin, (though glyph metrics were reported incorrectly in
4944 1.0). However in 1.2.0, the translation was applied to the advance
4945 values between each glyph. The 1.2.0 behavior is fairly useless in
4946 practice, and it was not intentional to introduce a semantic
4947 change. With 1.2.2 we return to the 1.0 semantics, with a much better
4948 implementation that provides correct glyph metrics.
4950 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=84840e6bba6e72aa88fad7a0ee929e8955ba9051
4952 Fix create_similar to preserve fallback resolution and font options (Behdad Esfahbod)
4953 -------------------------------------------------------------------------------------
4954 There has been a long-standing issue with cairo_surface_create_similar
4955 such that font options and other settings from the original
4956 destination surface would not be preserved to the intermediate
4957 "similar" surface. This could result in incorrect rendering
4958 (particularly with respect to text hinting/antialiasing) with
4959 fallbacks, for example.
4961 report: https://bugs.freedesktop.org/show_bug.cgi?id=4106
4962 fixes: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=9fcb3c32c1f16fe6ab913e27eb54d18b7d9a06b0
4963 http://gitweb.freedesktop.org/?p=cairo;a=commit;h=bdb4e1edadb78a2118ff70b28163f8bd4317f1ec
4965 xlib: Fix text performance regression from 1.0 to 1.2.0 (Vladimir Vukicevic)
4966 ----------------------------------------------------------------------------
4967 Several people noticed that upgrading from cairo 1.0 to cairo 1.2.0
4968 caused a significant performance regression when using the xlib
4969 backend. This performance regression was particularly noticeable when
4970 doing lots of text rendering and when using a high-latency connection
4971 to the X server, (such as a remote X server over an ssh
4972 connection). The slowdown was identified and fixed in 1.2.2.
4974 report: https://bugs.freedesktop.org/show_bug.cgi?id=7514
4975 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=b7191885c88068dad57d68ced69a752d1162b12c
4977 PDF: Eliminate dependency on FreeType library dependency (Adrian Johnson)
4978 -------------------------------------------------------------------------
4979 The cairo 1.2 series adds a supported pdf backend to cairo. In cairo
4980 1.2.0 this backend required the freetype library, which was an
4981 undesirable dependency on systems such as win32, (cairo is designed to
4982 always prefer the "native" font system). As of cairo 1.2.2 the
4983 freetype library is not required to use the pdf backend on the win32
4986 report: https://bugs.freedesktop.org/show_bug.cgi?id=7538
4987 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=a0989f427be87c60415963dd6822b3c5c3781691
4989 PDF: Fix broken output on amd64 (Adrian Johnson)
4990 ------------------------------------------------
4991 report: http://bugzilla.gnome.org/show_bug.cgi?id=349826
4992 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=f4b12e497b7ac282b2f6831b8fb68deebc412e60
4994 PS: Fix broken output for truetype fonts > 64k (Adrian Johnson)
4995 ---------------------------------------------------------------
4996 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=067d97eb1793a6b0d0dddfbd0b54117844511a94
4998 PDF: Fix so that dashing doesn't get stuck on (Kent Worsnop)
4999 ------------------------------------------------------------
5000 Kent notices that with the PDF backend in cairo 1.2.0 as soon as a
5001 stroke was performed with dashing, all subsequent strokes would also
5002 be dashed. There was no way to turn dashing off again.
5004 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=778c4730a86296bf0a71080cf7008d7291792256
5006 Fix memory leaks in failure paths in gradient creation (Alfred Peng)
5007 --------------------------------------------------------------------
5008 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=db06681b487873788b51a6766894fc619eb8d8f2
5010 Fix memory leak in _cairo_surface_show_glyphs (Chris Wilson)
5011 ------------------------------------------------------------
5012 report: https://bugs.freedesktop.org/show_bug.cgi?id=7766
5013 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=e2fddcccb43d06486d3680a19cfdd5a54963fcbd
5015 Solaris: Add definition of cairo_private for some Sun compilers (Alfred Peng)
5016 -----------------------------------------------------------------------------
5017 report: https://bugzilla.mozilla.org/show_bug.cgi?id=341874
5018 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=04757a3aa8deeff3265719ebe01b021638990ec6
5020 Solaris: Change version number of Sun's Xorg server with buggy repeat (Brian Cameron)
5021 -------------------------------------------------------------------------------------
5022 report: https://bugs.freedesktop.org/show_bug.cgi?id=7483
5023 fix: http://gitweb.freedesktop.org/?p=cairo;a=commit;h=e0ad1aa995bcec4246c0b8ab0d5a5a79871ce235
5025 Various memory leak fixes
5026 -------------------------
5027 Fix memory leak in _cairo_surface_show_glyphs (bug 7766)
5028 Fix file handle leak in failure path (bug 7616)
5029 Fix some memory leaks in the test cases.
5030 Fix some memory leaks in font subsetting code used in print backends.
5032 Documentation improvements (Behdad Esfahbod)
5033 --------------------------------------------
5034 Added new documentation for several functions (cairo_show_page,
5035 cairo_copy_page, cairo_in_stroke, cairo_in_fill).
5037 Fixed some syntax errors that were preventing some existing
5038 documentation from being published.
5040 Fixed several minor typographical errors.
5042 Added an index for new symbols in 1.2.
5044 Release 1.2.0 (2006-06-27 Carl Worth <cworth@cworth.org>)
5045 =========================================================
5046 This is the culmination of the work that has gone on within the 1.1
5049 There has been one API addition since the cairo 1.1.10 snapshot:
5051 cairo_xlib_surface_get_width
5052 cairo_xlib_surface_get_height
5054 There's also a new feature without any API change:
5056 Dots can now be drawn by using CAIRO_LINE_CAP_ROUND with
5057 degenerate sub-paths, (cairo_move_to() followed by either
5058 cairo_close_path() or a cairo_line_to() to the same location).
5060 And at least the following bugs have been fixed:
5062 6759 fontconfig option AntiAlias doesn't work in cairo 1.1.2
5063 6955 Some characters aren't displayed when using xlib (cache u...
5064 7268 positive device_offset values don't work as source
5065 * PDF emit_glyph function needs to support bitmapped glyphs
5066 * PS emit_glyph function needs to support bitmapped glyphs
5067 * SVG emit_glyph function needs to support bitmapped glyphs
5068 * PDF: minefield page one is falling back unnecessarily
5069 * PS/PDF: Fix broken placement for vertical glyphs
5070 * PS: Fix to not draw BUTT-capped zero-length dash segments
5071 * Do device offset before float->fixed conversion
5072 http://bugzilla.gnome.org/show_bug.cgi?id=332266
5073 * PS: Fix source surfaces with transformations
5074 * PS: Fix to not draw BUTT-capped degnerate sub-paths
5075 * PS: Don't walk off end of array when printing "~>"
5076 * Fix some memory leaks in the test suite rig
5077 * SVG: Fix memory leak when using cairo_mask
5078 * Fix EXTEND_REFLECT and EXTEND_PAD to not crash (though these are
5079 still not yet fully implemented for surface patterns).
5081 This has been a tremendous effort by everyone, and I'm proud to have
5082 been a part of it. Congratulations to all contributors to cairo!
5084 Snapshot 1.1.10 (2006-06-16 Carl Worth <cworth@cworth.org>)
5085 ===========================================================
5086 This is the fifth in a series of snapshots working toward the 1.2
5089 The primary motivation for this snapshot is to fix a long-standing bug
5090 that had long been silent, but as of the 1.1.8 snapshot started
5091 causing crashes when run against 16-bit depth X servers, (often Xvnc
5092 or Xnest). The fix for this adds a new CAIRO_FORMAT_RGB16_565 to the
5095 This snapshot also includes a rewrite of cairo's SVG backend to
5096 eliminate the dependency on libxml2. With this in place, cairo 1.2
5097 will not depend on any libraries that cairo 1.0 did not.
5099 As usual, there are also a few fixes for minor bugs.
5101 Snapshot 1.1.8 (2006-06-14 Carl Worth <cworth@cworth.org>)
5102 ==========================================================
5103 This is the fourth in a series of snapshots working toward the 1.2
5104 release of cairo. At this point, all major features of the 1.2 release
5105 are in place, leaving just a few bug fixes left.
5107 In particular, there well be no additional API changes between this
5108 1.1.8 snapshot and the 1.2 release.
5110 The announcement for 1.1.6 mentioned several API changes being
5111 considered. Only one of these changes was actually implemented
5112 (set_dpi -> fallback_resolution). This change does introduce one
5113 source-level incompatibility with respect to previous 1.1.x snapshots,
5114 so see below for details.
5116 Here is an abbreviated summary of changes since the 1.1.6 snapshot:
5120 According to the plan mentioned in the 1.1.6 notes, one source-level
5121 incompatible change has been implemented. The following three
5122 functions have been removed from cairo's API:
5124 cairo_pdf_surface_set_dpi
5125 cairo_ps_surface_set_dpi
5126 cairo_svg_surface_set_dpi
5128 and in their place the following function has been added:
5130 cairo_surface_set_fallback_resolution
5132 The signature and semantics of the function remains the same, so it is
5133 a simple matter of changing the name of the function when calling
5134 it. As a transition mechanism, this snapshot will (on many systems)
5135 build to include the old symbols so that code previously compiled will
5136 still run. However, all source code using the old names must be
5137 updated before it will compile. And the upcoming 1.2 release is not
5138 anticipated to include the old symbols.
5140 Finally, it should be pointed out that the old symbols never existed
5141 in the supported API of any stable release of cairo. (In the stable
5142 1.0 releases the PDF, PS, and SVG backends were advertised as
5143 experimental and unstable.)
5145 And, as always, cairo continues to maintain source and binary
5146 compatibility between major releases. So applications compiled against
5147 supported backends in a stable release of cairo (1.0.4 say) will
5148 continue to compile and run without modification against new major
5149 releases (1.2.0 say) without modification.
5153 The following new functions have been added to cairo's API:
5155 cairo_surface_get_content
5156 cairo_debug_reset_static_data
5157 cairo_image_surface_get_data
5158 cairo_image_surface_get_format
5159 cairo_image_surface_get_stride
5160 cairo_win32_font_face_create_for_hfont
5162 New, backend-specific pkg-config files
5163 --------------------------------------
5164 In addition to the original cairo.pc file, cairo will also now install
5165 a pkg-config files for each configured backend, (for example
5166 cairo-pdf.pc, cairo-svg.pc, cairo-xlib.pc, cairo-win32.pc, etc.) this
5167 also includes optional font backends (such as cairo-ft.pc) and the
5168 optional png functionality (cairo-png.pc).
5170 These new pkg-config files should be very convenient for allowing
5171 cairo-using code to easily check for the existing of optional
5172 functionality in cairo without having to write complex rules to grub
5173 through cairo header files or the compiled library looking for
5176 Printing backend (PS, PDF, and SVG)
5177 -----------------------------------
5178 Improving the quality of the "printing" backends has been a priority
5179 of the development between cairo 1.1.6 and cairo 1.1.8.
5181 The big improvement here is in the area of text output. Previously, at
5182 best, text was output as paths without taking advantage of any font
5183 support available in the output file format.
5185 Now, at the minimum text paths will be shared by using type3 fonts
5186 (for PS and PDF---and similarly, defs for SVG). Also, if possible,
5187 type3 and truetype fonts will be embedded in PostScript and PDF
5188 output. There are still some known bugs with this, (for example,
5189 selecting text in a cairo-generated PDF file with an embedded truetype
5190 font does not work). So there will be some more changes in this area
5191 before cairo 1.2, but do try test this feature out as it exists so
5194 Many thanks to Kristian Høgsberg for the truetype and type1 font
5199 Performance improvements by preferring GDI over pixman rendering when possible.
5200 Fixes for text rendering.
5204 Fix potentially big performance bug by making xlib's create_similar
5205 try harder to create a pixmap of a depth matching that of the screen.
5209 Among various other fixes, the following bugs listed in bugzilla have
5212 Bug 2488: Patch to fix pixman samping location bug (#2488).
5213 https://bugs.freedesktop.org/show_bug.cgi?id=2488
5215 Bug 4196: undef MIN an MAX before defining to avoid duplicate definition
5216 https://bugs.freedesktop.org/show_bug.cgi?id=4196
5218 Bug 4723: configure.in: Fix m4 quoting when examining pkg-config version
5219 https://bugs.freedesktop.org/show_bug.cgi?id=4723
5221 Bug 4882: Flag Sun's X server has having buggy_repeat.
5222 https://bugs.freedesktop.org/show_bug.cgi?id=4882
5224 Bug 5306: test/pdf2png: Add missing include of stdio.h
5225 https://bugs.freedesktop.org/show_bug.cgi?id=5306
5227 Bug 7075: Fix make clean to remove cairo.def
5228 https://bugs.freedesktop.org/show_bug.cgi?id=7075
5230 (Many thanks to Behdad Esfahbod for helping us track down and fix many
5233 Snapshot 1.1.6 (2006-05-04 Carl Worth <cworth@cworth.org>)
5234 ==========================================================
5235 This is the third in a series of snapshots working toward the imminent
5236 1.2 release of cairo. For a list of items still needing work on the
5237 cairo 1.2 roadmap, please see:
5239 http://cairographics.org/ROADMAP
5241 As can be seen in that list, there are no longer any API additions
5242 left on the roadmap. Instead, there is a feature (PDF type 3 fonts) a
5243 performance optimization (X server gradients) and a list of bug
5244 fixes. This gives us a fair amount of freedom to cut the 1.2 release
5245 at almost any point by deciding to defer remaining bug fixes to
5246 subsequent maintenance releases such as 1.2.2 and 1.2.4.
5248 Before we will do that, we must first be wiling to commit to all the
5249 new API additions. As a heads-up, there are a couple of potential API
5250 changes being considered. (Note that these are changes to new API
5251 introduced during 1.1 so these will not introduce API
5252 incompatibilities compared to the stable 1.0 series). The changes
5253 being considered are:
5255 cairo_get_group_target: may acquire x and y offset return
5256 parameters. May also be eliminated in favor of
5257 cairo_get_target assuming its role
5259 cairo_pdf_surface_set_dpi:
5260 cairo_ps_surface_set_dpi:
5261 cairo_svg_surface_set_dpi: These functions may be removed in favor
5262 of a new cairo_surface_set_fallback_resolution
5264 Additionally there is the possibility of a slight change in the
5265 semantics of cairo_set_line_width. We believe the current behavior of the sequence:
5267 cairo_set_line_width; ... change CTM ...; cairo_stroke;
5269 is buggy. It is currently behaving the same as:
5271 ... change CTM ...; cairo_set_line_width; cairo_stroke;
5273 We are considering fixing this bug before 1.2 with the hope that
5274 nobody is already relying on the buggy behavior described here. Do
5275 shout if you suspect you might be in that position.
5277 The items included in this snapshot (since the 1.1.4 snapshot) are
5282 The long-awaited group-rendering support is now available with the
5283 following function calls:
5286 cairo_push_group_with_content
5288 cairo_pop_group_to_source
5289 cairo_get_group_target
5291 This API provides a much more convenient mechanism for doing rendering
5292 to an intermediate surface without the need to manually create a
5293 temporary cairo_surface_t and a temporary cairo_t and clean them up
5296 Add the following missing get function to complement
5297 cairo_surface_set_device_offset:
5299 cairo_surface_get_device_offset
5301 PDF backend (API addition)
5302 --------------------------
5303 The PDF backend now provides for per-page size changes, (similar to
5304 what the PostScript backend got in the 1.1.4 snapshot). The new API
5307 cairo_pdf_surface_set_size
5309 Xlib backend (API additions)
5310 ----------------------------
5311 The following functions have been added to allow the extraction of
5314 cairo_xlib_surface_get_display
5315 cairo_xlib_surface_get_drawable
5316 cairo_xlib_surface_get_screen
5317 cairo_xlib_surface_get_visual
5318 cairo_xlib_surface_get_depth
5320 XCB backend (experimental)
5321 --------------------------
5322 Update backend so that it now compiles with the recent XCB 0.9 release.
5324 Bug fixes and memory leak cleanup
5325 ---------------------------------
5326 Various little things, nothing too significant though.
5328 Snapshot 1.1.4 (2006-05-03 Carl Worth <cworth@cworth.org>)
5329 ==========================================================
5330 This is the second in a series of snapshots working toward the
5331 upcoming 1.2 release of cairo. For a list of items still needing work
5332 on the cairo 1.2 roadmap, please see:
5334 http://cairographics.org/ROADMAP
5336 The items included in this snapshot (since the 1.1.2 snapshot) are
5339 PostScript backend: new printing-oriented API
5340 ---------------------------------------------
5341 We anticipate that with cairo 1.2, toolkits will begin to use cairo
5342 for printing on systems that use PostScript as the spool format. To
5343 support this use case, we have added 4 new function calls that are
5344 specific to the PostScript backend:
5346 cairo_ps_surface_set_size
5347 cairo_ps_surface_dsc_comment
5348 cairo_ps_surface_dsc_begin_setup
5349 cairo_ps_surface_dsc_begin_page_setup
5351 These functions allow variation of the page size/orientation from one
5352 page to the next in the PostScript output. They also allow the toolkit
5353 to provide per-document and per-page printer control options in a
5354 device-independent way, (for example, by using PPD options and
5355 emitting them as DSC comments into the PostScript output). This should
5356 allow toolkits to provide very fine-grained control of many options
5357 available in printers, (media size, media type, tray selection, etc.).
5359 SVG backend: builds by default, version control
5360 -----------------------------------------------
5361 The SVG backend continues to see major improvements. It is expected
5362 that the SVG backend will be a supported backend in the 1.2
5363 release. This backend will now be built by default if its dependencies
5364 (freetype and libxml2) are met.
5366 Additionally, the SVG backend now has flexibility with regard to what
5367 version of SVG it targets. It will target SVG 1.1 by default, which
5368 will require image fallbacks for some of the "fancier" cairo
5369 compositing operators. Or with the following new function calls:
5371 cairo_svg_surface_restrict_to_version
5372 cairo_svg_get_versions
5373 cairo_svg_version_to_string
5375 it can be made to target SVG 1.2 in which there is native support for
5376 these compositing operators.
5380 At least the following bugs have been fixed since the 1.1.2 snapshot:
5382 crash at XRenderAddGlyphs
5383 https://bugs.freedesktop.org/show_bug.cgi?id=4705
5385 Can't build cairo-1.1.2 on opensolaris due to " void function cannot return value"
5386 https://bugs.freedesktop.org/show_bug.cgi?id=6792
5388 Missing out-of-memory check at gfx/cairo/cairo/src/cairo-atsui-font.c:185
5389 https://bugzilla.mozilla.org/show_bug.cgi?id=336129
5391 A couple of memory leaks.
5393 Snapshot 1.1.2 (2006-04-25 Carl Worth <cworth@cworth.org>)
5394 ==========================================================
5395 This is the first in a series of snapshots working toward the upcoming
5396 1.2 release of cairo. (Subsequent snapshot will use successive even
5397 numbers for the third digit, 1.1.4, 1.1.6, etc.) This snapshot is
5398 backwards-compatible with the 1.0 series---it makes a few API
5399 additions but does not remove any API.
5401 PostScript and PDF backends are no longer "experimental"
5402 --------------------------------------------------------
5403 The major theme of the 1.2 release is improved PostScript and PDF
5404 backends for cairo. Unlike the 1.0 series, in the 1.2 series these
5405 backends will not be marked as experimental and will be enabled by
5406 default. We encourage people to test this snapshot and the PS/PDF
5407 backends in particular as much as possible.
5409 The PostScript and PDF output is not yet ideal.
5411 * One major problem with the PostScript output is that image
5412 fallbacks are used more often than strictly necessary, and the
5413 image fallbacks are at a lower resolution than desired, (the
5414 cairo_ps_surface_set_dpi call is ignored).
5416 * The major drawback of the current PDF backend implementation is
5417 its text support. Every glyph is represented by a filled path in
5418 the PDF file. The causes file sizes to be much larger and
5419 rendering to be much slower than desired.
5421 It is anticipated that both of these shortcomings will see some
5422 improvements before the final 1.2 release.
5424 In spite of those shortcomings, we hope that the PS and PDF backends
5425 will yield faithful results for pretty much any cairo operations you
5426 can throw at them. Please let us know if you are getting obviously
5427 "different" results from the PS/PDF backends than from the image or
5430 Other new experimental backends
5431 -------------------------------
5432 This snapshot includes three new backends that did not exist in the
5441 These are all currently marked "experimental" and are disabled by
5442 default. But the SVG backend in particular has seen a lot of recent
5443 development and is very close to passing the entire cairo test
5444 suite. It is possible that this backend will become a fully supported
5445 backend by the time of the cairo 1.2 release.
5447 Public API additions
5448 --------------------
5449 There have been a few new API functions added to cairo, including:
5451 New get_type functions for querying sub-types of object:
5453 cairo_surface_get_type
5454 cairo_pattern_get_type
5455 cairo_font_face_get_type
5456 cairo_scaled_font_get_type
5458 More convenience in working with cairo_scaled_font_t with new getter
5461 cairo_scaled_font_get_font_face
5462 cairo_scaled_font_get_font_matrix
5463 cairo_scaled_font_get_ctm
5464 cairo_scaled_font_get_font_options
5466 As well as a convenience function for setting a scaled font into a
5469 cairo_set_scaled_font
5471 and a function to allow text extents to be queried directly from a
5472 scaled font, (without requiring a cairo_surface_t or a cairo_t):
5474 cairo_scaled_font_text_extents
5476 These new scaled font functions were motivated by the needs of the
5479 Finally, a new path-construction function was added which clears the
5480 current point in preparation for a new sub path. This makes cairo_arc
5481 easier to use in some situations:
5485 Before the 1.2 release is final we do still plan a few more API
5486 additions specifically motivated by the needs of Mozilla/Firefox.
5488 Optimizations and bug fixes
5489 ---------------------------
5490 Shortly after the 1.0 maintenance series branched off the mainline
5491 there was a major rework of the cairo font internals. This should
5492 provide some good performance benefits, but it's also another area
5493 people should look at closely for potential regressions.
5495 There has not yet been any widespread, systematic optimization of
5496 cairo, but various performance improvements have been made, (and some
5497 of them are fairly significant). So if some things seem faster than
5498 1.0 then things are good. If there are any performance regressions
5499 compared to 1.0 then there is a real problem and we would like to hear
5502 There has been a huge number of bug fixes---too many to mention in
5503 detail. Again, things should be better, and never worse compared to
5504 1.0. Please let us know if your testing shows otherwise.
5506 Release 1.0.2 (2005-10-03 Carl Worth <cworth@cworth.org>)
5507 =========================================================
5508 For each bug number XXXX below, see:
5510 https://bugs.freedesktop.org/show_bug.cgi?id=XXXX
5516 * 4408 - Add support for dashing of stroked curves
5519 * 4409 - Fix dashing so that each dash is capped on both ends
5522 * 4414 - Prevent SIGILL failures (proper use of -mmmx and -msse flags)
5523 (Sebastien Bacher, Billy Biggs)
5525 * 4299 - Fix crashes with text display in multi-threaded program
5526 (Alexey Shabalin, Carl Worth)
5528 * 4401 - Do not use sincos function since it is buggy on some platforms)
5529 (Tim Mooney, Carl Worth)
5531 * 4245 - Fix several bugs in the test suite exposed by amd64 systems
5532 (Seemant Kulleen, Carl Worth)
5534 * 4321 - Add missing byteswapping on GetImage/PutImage
5535 (Sjoerd Simons, Owen Taylor)
5537 * 4220 - Make the check for rectangular trapezoids simpler and more accurate
5538 (Richard Stellingwerff, Owen Taylor)
5540 * 4260 - Add missing channel-order swapping for antialised fonts
5541 (Barbie LeVile, Owen Taylor)
5543 * 4283 - Fix compilation failure with aggressive inlining (gcc -O3)
5544 (Marco Manfredini, Owen Taylor)
5546 * 4208 - Fix some warnings from sparse
5547 (Kjartan Maraas, Billy Biggs)
5549 * 4269 - Fix to not crash when compiled with -fomit-frame-pointer
5550 (Ronald Wahl, Owen Taylor)
5552 * 4263 - Improve performance for vertical gradients
5553 (Richard Stellingwerff, Owen Taylor)
5556 * 4298 - Accomodate gentoo and Mandriva versions in X server vendor string check
5557 (Billy Biggs, Frederic Crozat, Owen Taylor)
5559 win32-specific fixes
5560 --------------------
5561 * 4599 - Fix "missing wedges" on some stroked paths (win32)
5562 (Tim Rowley, Jonathan Watt, Bertram Felgenhauer, Carl Worth, Keith Packard)
5564 * 4612 - Fix disappearing text if first character out of surface (win32)
5567 * 4602 - Fix shutdown of cairo from failing intermediate, size-0 bitmaps (win32)
5568 Aka. the "white rectangles" bug from mozilla-svg testing
5571 * Various portability improvements for win32
5572 (Hans Breuer, Owen Taylor, Carl Worth)
5574 * 4593 - Fix font sizes to match user expectations (win32)
5575 (Tor Lillqvist, Owen Taylor)
5577 * 3927 - Fix to report metrics of size 0 for glyph-not-available (win32)
5578 (Hans Breuer, Owen Taylor, Tor Lillqvist)
5580 * Add locking primitives for win32
5585 * Fix crash from size-0 pixmap due to empty clip region (xlib)
5586 (Radek Doulík, Carl Worth)
5588 Release 1.0.0 (2005-08-24 Carl Worth <cworth@cworth.org>)
5589 =========================================================
5590 Experimental backends
5591 ---------------------
5592 * The Glitz, PS, PDF, Quartz, and XCB backends have been declared
5593 experimental, and are not part of the API guarantees that accompany
5594 this release. They are not built by default, even when the required
5595 libraries are available, and must be enabled explicitly with
5596 --enable-ps, --enable-pdf, --enable-quartz or --enable-xcb.
5598 It is very painful for us to be pushing out a major release without
5599 these backends enabled. There has been a tremendous amount of work
5600 put into each one and all are quite functional to some
5601 extent. However, each also has some limitations. And none of these
5602 backends have been tested to the level of completeness and
5603 correctness that we expect from cairo backends.
5605 We do encourage people to experiment with these backends and report
5606 success, failure, or means of improving them.
5610 * Prior to 0.9.0 the SOURCE, CLEAR and a number of other operators
5611 behaved in an inconsistent and buggy fashion and could affect areas
5612 outside the clip mask. In 0.9.0, these six "unbounded" operators
5613 were fixed to consistently clear areas outside the shape but within
5614 the clip mask. This is useful behavior for an operator such as IN,
5615 but not what was expected for SOURCE and CLEAR. So, in this release
5616 the behavior of SOURCE and CLEAR has been changed again. They now
5617 affect areas only within both the source and shape. We can write
5618 the new operators as:
5620 SOURCE: dest' = (mask IN clip) ? source : dest
5621 CLEAR: dest' = (mask IN clip) ? 0 : dest
5623 Behavior and API changes
5624 ------------------------
5625 * Setting the filter on a gradient pattern would change the
5626 interpolation between color stops away from the normal linear
5627 interpolation. This dubious behavior has been removed.
5629 * The CAIRO_CONTENT_VALID() and CAIRO_FORMAT_VALID() macros --
5630 implementation details that leaked into cairo.h -- have been moved
5631 into an internal header.
5633 * The cairo_show_text function now advances the current point
5634 according to the total advance values of the string.
5638 * cairo_set_dash can now detect error and can set
5639 CAIRO_STATUS_INVALID_DASH.
5643 * When compiled against recent versions of fontconfig and FreeType,
5644 artificial bold fonts can now be turned on from fonts.conf using
5645 the FC_EMBOLDEN fontconfig key.
5649 * The compositing code from the 'xserver' code tree has now been
5650 completely merged into libpixman. This includes MMX optimization of
5653 * The image transformation code in libpixman has been improved and
5654 now performs significantly faster.
5658 * Several crashes related to corruption in the font caches have been
5661 * All test cases now match pixel-for-pixel on x86 and PPC; this
5662 required fixing bugs in the compositing, stroking, and pattern
5665 * Negative dash offsets have been fixed to work correctly.
5667 * The stroking of paths with mutiple subpaths has now been fixed to
5668 apply caps to all subpaths rather than just the last one.
5670 * Many build fixes for better portability on various systems.
5672 * Lots of other bug fixes, but we're too tired to describe them in
5675 Release 0.9.2 (2005-08-13 Carl Worth <cworth@cworth.org>)
5676 =========================================================
5679 * You will notice that this release jumped from 0.9.0 to 0.9.2. We've
5680 decided to use an odd micro version number (eg. 0.9.1) to indicate
5681 in-progress development between releases. As soon as 0.9.2 is
5682 tagged, the version will be incremented in CVS to 0.9.3 where it
5683 will stay until just before 0.9.4 is built, uploaded, and tagged.
5685 So, even-micro == a released version, odd-micro == something in-between.
5687 Libpixman dependency dropped
5688 ----------------------------
5689 * As of this release, the dependency on an external libpixman has
5690 been dropped. Instead, the code from libpixman needed for cairo has
5691 been incorporated into the cairo source tree. The motivation for
5692 this change is that while cairo's API is stable and ready to be
5693 maintained after the 1.0 release, libpixman's API is not, so we do
5694 not want to expose it at this time.
5696 Also, the incorporation of libpixman into cairo also renames all
5697 previously-public libpixman symbols in order to avoid any conflict
5698 with a future release of libpixman
5702 * Macros and functions have been added so that the version of cairo
5703 can be queried at either compile-time or at run-time. The version
5704 is made available as both a human-readable string and as a single
5707 CAIRO_VERSION_STRING eg. "0.9.2"
5708 CAIRO_VERSION eg. 000902
5711 cairo_version_string (void); /* eg. "0.9.2" */
5714 cairo_version (void); /* eg. 000902 */
5716 A macro is provided to convert a three-part component version into
5717 the encoded single-integer form:
5719 CAIRO_VERSION_ENCODE(X,Y,Z)
5721 For example, the CAIRO_VERSION value of 000902 is obtained as
5722 CAIRO_VERSION_ENCODE(0,9,2). The intent is to make version
5723 comparisons easy, either at compile-time:
5725 #if CAIRO_VERSION >= CAIRO_VERSION_ENCODE(0,9,2)
5731 if (cairo_version() >= CAIRO_VERSION_ENCODE(0,9,2)) { /* ... */ }
5735 * This release adds pthread-based locking (when available) to make
5736 the caches used by cairo safe for threaded programs. Some may
5737 remember a failed experiment with this locking between the 0.5.1
5738 and 0.5.2 snapshots, (where even single-threaded programs that
5739 linked with -lpthread would deadlock). We believe that that problem
5740 has been fixed, so we are looking forward to testing and reports
5741 from users with threaded applications.
5745 * The XCB and Quartz backends failed to compiled in the 0.9.0 release
5746 due to minor syntax errors. These have now been fixed.
5748 * Various crashes in glitz and pixman due to size 0 glyphs have been
5751 Release 0.9.0 (2005-08-08 Carl Worth <cworth@cworth.org>)
5752 =========================================================
5755 * In all prior snapshots, the libtool library versioning was set to
5756 1:0:0. As this release is intended to mark the beginning of
5757 backwards-compatible releases, the versioning has been incremented
5758 to 2:0:0. You will notice that the numeric extension on the
5759 installed library filename will change similarly.
5761 This change will also require all cairo-using applications to be
5762 recompiled. We recognize that this may cause some frustration since
5763 this release is backwards-compatible with 0.6.0 and in that sense
5764 "shouldn't" require re-compilation. However, since all historical
5765 snapshots have used the same 1:0:0 version in spite of incompatible
5766 API changes between them, it was essential that the upcoming 1.0
5767 release series have distinct library versioning.
5769 All future releases will use the library versioning to properly
5770 indicate compatibility between releases. So, any application
5771 re-compiled now to work with the 0.9.0 will not need to be
5772 recompiled when a compatible 1.0 release of cairo is made in the
5777 * Add new function calls to set/get the current antialiasing mode in
5783 This call accepts the same modes recently added for font options
5784 (NONE or GRAY) but affects the rendering of geometry other than
5785 text. The intent of this call is to enable more precise control of
5786 which pixels are affected by each operation, for example to allow
5787 for full-scene antialiasing for seam-free rendering. It is not
5788 expected that non-antialiased rendering will perform better than
5789 anti-aliased rendering.
5791 * Three new functions were added to provide support for mixed cairo-
5792 and non-cairo drawing to the same surface:
5794 cairo_surface_mark_dirty
5795 cairo_surface_mark_dirty_rectangle
5798 * The return type of the several "reference" functions was change,
5799 (API compatibly), from void to the same type as the argument. The
5800 affected functions are:
5802 cairo_font_face_reference
5803 cairo_scaled_font_reference
5804 cairo_pattern_reference
5805 cairo_surface_reference
5808 This allows a convenient way to assign and reference in a single
5813 * The behavior of cairo_set_source with a pattern with a non-identity
5814 matrix was previously not well-defined. The new behavior is as
5817 The pattern's transformation matrix will be locked to the
5818 user space in effect at the time of cairo_set_source(). This means
5819 that further modifications of the CTM will not affect the source
5824 * Some portability improvements, (eg. workaround for missing stdint.h).
5828 * Updated to allow compilation with older versions of freetype.
5832 * Fix the unbounded operators to actually produce a correct result,
5833 (previously the results were artificially restricted to the
5834 bounding box of whatever shape was being drawn rather than
5835 extending out infinitely). The fixed operators are:
5837 CAIRO_OPERATOR_CLEAR
5838 CAIRO_OPERATOR_SOURCE
5841 CAIRO_OPERATOR_DEST_IN
5842 CAIRO_OPERATOR_DEST_ATOP
5844 * Fix cairo_mask and cairo_mask_surface to transform the mask by the
5845 current transformation matrix (CTM).
5847 * Fix cairo_set_source to lock the CTM used to transform the pattern.
5849 * Workaround for X server Render bug involving repeating patterns
5850 with a general transformation matrix.
5852 * cairo_get_font_face fixed to return a "nil" font face object rather
5855 * cairo_set_font_face fixed to not crash if given a NULL font face,
5856 (which is the documented interface for restoring the default font
5859 * Fix xlib glyphset caching to not try to free a NULL glyph.
5861 Snapshot 0.6.0 (2005-07-28 Carl Worth <cworth@cworth.org>)
5862 ==========================================================
5865 * The prototypes of the following functions have changed:
5867 cairo_xlib_surface_create_with_xrender_format
5868 cairo_xlib_surface_create_for_bitmap
5870 A Screen* parameter has been added to each. This allows the cairo
5871 xlib backend to work correctly with multi-head X servers.
5873 * The following function has been modified:
5875 cairo_scaled_font_create
5877 to accept a cairo_font_options_t*. See below fore more details.
5879 * All opaque, reference-counted cairo objects have now been moved to a
5880 standard error-handling scheme. The new objects to receive this
5881 treatment are cairo_font_face_t, cairo_scaled_font_t, and
5882 cairo_surface_t. (Previous snapshots already provided this scheme
5883 for cairo_t, cairo_path_t, and cairo_pattern_t.)
5885 This changes two functions to have a return type of void rather than
5888 cairo_scaled_font_extent
5889 cairo_surface_finish
5891 And significantly, none of the create functions for any of the
5892 objects listed above will return NULL. The pointer returned from any
5893 function will now always be a valid pointer and should always be
5894 passed to the corresponding destroy function when finished
5896 The simplest strategy for porting code is to switch from:
5898 object = cairo_<object>_create ();
5904 cairo_<object>_destroy (object);
5908 object = cairo_<object>_create ();
5909 if (cairo_<object>_status (object))
5914 cairo_<object>_destroy (object);
5916 But significantly, it is not required to check for an error status
5917 before the "act on object" portions of the code above. All
5918 operations on an object with an error status are, by definition,
5919 no-ops without side effect. So new code might be written in an
5920 easier-to-read style of:
5922 object = cairo_<object>_create ();
5926 cairo_<object>_destroy (object);
5928 with cairo_<object>_status checks placed only at strategic
5929 locations. For example, passing an error object to another object,
5930 (eg. cairo_set_source with an in-error pattern), will propagate the
5931 error to the subsequent object (eg. the cairo_t). This means that
5932 error checking can often be deferred even beyond the destruction of
5937 * New functions for checking the status of objects that have been
5938 switched to the common error-handling scheme:
5940 cairo_font_face_status
5941 cairo_scaled_font_status
5942 cairo_surface_status
5944 * The _cairo_error function which was added in 0.5.1 has now been made
5945 much more useful. In 0.5.1 only errors on cairo_t objects passed
5946 through _cairo_error. Now, an error on any object should pass
5947 through _cairo_error making it much more reliable as a debugging
5948 mechanism for finding when an error first occurs.
5950 * Added new font options support with a myriad of functions:
5952 cairo_font_options_create
5953 cairo_font_options_copy
5954 cairo_font_options_destroy
5956 cairo_font_options_status
5958 cairo_font_options_merge
5959 cairo_font_options_equal
5960 cairo_font_options_hash
5962 cairo_font_options_set_antialias
5963 cairo_font_options_get_antialias
5964 cairo_font_options_set_subpixel_order
5965 cairo_font_options_get_subpixel_order
5966 cairo_font_options_set_hint_style
5967 cairo_font_options_get_hint_style
5968 cairo_font_options_set_hint_metrics
5969 cairo_font_options_get_hint_metrics
5971 cairo_surface_get_font_options
5973 cairo_ft_font_options_substitute
5975 cairo_set_font_options
5976 cairo_get_font_options
5978 This new font options support allows the application to have much
5979 more fine-grained control over how fonts are rendered.
5980 Significantly, it also allows surface backends to have some
5981 influence over the process. For example, the xlib backend now
5982 queries existing Xft properties to set font option defaults.
5986 cairo_xlib_surface_set_drawable
5988 which allows the target drawable for an xlib cairo_surface_t to be
5989 changed to another with the same format, screen, and display. This
5990 is necessary in certain double-buffering techniques.
5994 * Sub-pixel text antialiasing is now supported.
5998 * Fixed assertion failure in cairo_surface_create_similar when
5999 application commits an error by passing a cairo_format_t rather than
6002 * Avoid division by zero in various places (cairo-ft).
6004 * Fix infinite loop when using non-default visuals (cairo-xlib).
6006 * Eliminate segfault in cairo_image_surface_create_from_png_stream.
6008 * Prevent errant sign-extension of masks on 64-bit architectures
6009 (cairo-xlib and cairo-xcb).
6011 * Other miscellaneous fixes.
6013 Snapshot 0.5.2 (2005-07-18 Carl Worth <cworth@cworth.org>)
6014 ==========================================================
6017 * New functions for creating patterns of a single color:
6019 cairo_pattern_create_rgb
6020 cairo_pattern_create_rgba
6022 * Change cairo_surface_create_similar to accept a new type of
6023 cairo_content_t rather than cairo_format_t:
6025 typedef enum _cairo_content {
6026 CAIRO_CONTENT_COLOR = 0x1000,
6027 CAIRO_CONTENT_ALPHA = 0x2000,
6028 CAIRO_CONTENT_COLOR_ALPHA = 0x3000
6031 * Add new CAIRO_FORMAT_VALID and CAIRO_CONTENT_VALID macros.
6033 * Remove unused status value:
6035 CAIRO_STATUS_NO_TARGET_SURFACE
6037 * Add new status values:
6039 CAIRO_STATUS_INVALID_STATUS
6041 * Require libpixman >= 0.1.5 (for necessary bug fixes)
6045 * Fix cairo_surface_write_to_png for RGB24 images.
6047 * Fix broken metrics and rendering for bitmap fonts. Add mostly
6048 useless bitmap glyph transformation.
6050 * Fix glyph caches to not eject entries that might be immediately
6051 needed, (fixing intermittent crashes when rendering text).
6053 * Fix all memory leaks found by running "make check-valgrind".
6055 ATSUI backend changes
6056 ---------------------
6057 * Allow building against < 10.3 SDK.
6059 * Prevent crash on empty strings.
6061 Glitz backend changes
6062 ---------------------
6063 * Require glitz >= 0.4.4.
6065 * Use frame buffer objects instead of pbuffers for accelerated
6068 * Minor improvement to gradient pattern creation.
6070 PostScript backend fixes
6071 ------------------------
6072 * Rewrite of the PS backend to generate more interesting output that
6073 the old big-image implementation.
6077 * Implement glyph path support.
6079 * Fix swap of blue and green values in the fill_rectangles path.
6083 * Add optimization to use XCopyArea rather than XRenderComposite when
6084 transforming only with an integer translation, and using SOURCE
6085 operator or OVER with a source pattern without alpha.
6087 Snapshot 0.5.1 (2005-06-20 Carl Worth <cworth@cworth.org>)
6088 ==========================================================
6091 * Removed cairo_status_string(cairo_t*) and add
6092 cairo_status_to_string(cairo_status_t) in its place. Code using
6093 cairo_status_string can be ported forward as follows:
6097 cairo_status_to_string (cairo_status (cr));
6099 * Removed the BAD_NESTING restriction which means that two different
6100 cairo_t objects can now interleave drawing to the same
6101 cairo_surface_t without causing an error.
6103 * The following functions which previously had a return type of
6104 cairo_status_t now have a return type of void:
6106 cairo_pattern_add_color_stop_rgba
6107 cairo_pattern_set_matrix
6108 cairo_pattern_get_matrix
6109 cairo_pattern_set_extend
6110 cairo_pattern_set_filter
6112 See discussion of cairo_pattern_status below for more details.
6116 * Improved error handling:
6119 cairo_pattern_status (cairo_pattern_t *pattern);
6121 This snapshot expands the status-based error handling scheme from
6122 cairo_t to cairo_path_t and cairo_pattern_t. It also expands the
6123 scheme so that object-creating functions, (cairo_create,
6124 cairo_pattern_create_*, cairo_copy_path_*), are now guaranteed to
6125 not return NULL. Instead, in the case of out-of-memory these
6126 functions will return a static object with
6127 status==CAIRO_STATUS_NO_MEMORY. The status can be checked with the
6128 functions cairo_status and cairo_pattern_status, or by direct
6129 inspection of the new status field in cairo_path_t.
6131 Please note that some objects, including cairo_surface_t and all of
6132 the font-related objects have not been converted to this
6133 error-handling scheme.
6135 * In addition to the above changes, a new private function has been added:
6139 This function can be used to set a breakpoint in a debugger to make
6140 it easier to find programming error in cairo-using code. (Currently,
6141 _cairo_error is called when any error is detected within a cairo_t
6142 context, but is not called for non-cairo_t errors such as for
6143 cairo_path_t and cairo_pattern_t).
6145 * Fixed cairo_path_data_t so that its enum is visible to C++ code, (as
6146 cairo_path_data_type_t).
6148 Performance improvements
6149 ------------------------
6150 * Made a minor performance improvement for clipping, (restrict clip
6151 surface to the new intersected bounds).
6153 * Optimize rendering of a solid source pattern with a pixel-aligned
6154 rectangular path to use backend clipping rather than rasterization
6155 and backend compositing.
6157 * Optimize cairo_paint_with_alpha to defer to cairo_paint when alpha
6162 * Fixed memory leak in cairo_copy_path.
6164 * A build fix for non-srcdir builds.
6168 * New support for path-based clipping.
6170 * Fix for text rotated to angles other than multiples of π/2.
6174 * Fix for text extents.
6178 * Implemented a complex workaround for X server bug[*] related to
6179 Render-based compositing with untransformed, repeating source
6180 pictures. The workaround uses core Xlib when possible for
6181 performance, (ie. with CAIRO_OPERATOR_SOURCE or CAIRO_OPERATOR_OVER
6182 with an opaque source surface), and falls back to the pixman
6183 image-based compositing otherwise.
6185 [*] https://bugs.freedesktop.org/show_bug.cgi?id=3566
6187 * Various bug fixes, particularly in the fallback paths.
6189 Snapshot 0.5.0 (2005-05-17 Carl Worth <cworth@cworth.org>)
6190 ==========================================================
6191 This is a pretty big, and fairly significant snapshot. It represents
6192 between 2 and 3 months of solid work from a lot of people on improving
6193 the API as much as possible. I'd like to express my appreciation and
6194 congratulations to everyone who has worked on the big API Shakeup,
6195 (whether in email battles over names, or fixing my silly bugs).
6197 This snapshot will require some effort on the part of users, since
6198 there are a _lot_ of API changes (ie. no cairo program ever written is
6199 safe --- they're all broken now in at least one way). But, in spite of
6200 that, we do encourage everyone to move their code to this snapshot as
6201 soon as possible. And we're doing everything we can think of to make
6202 the transition as smooth as possible.
6204 The idea behind 0.5 is that we've tried to make every good API change
6205 we could want now, and get them all done with. That is, between now
6206 and the 1.0 release of cairo, we expect very few new API changes,
6207 (though some will certainly sneak in). We will have some significant
6208 additions, but the pain of moving code from cairo 0.4 to cairo 0.5
6209 should be a one time experience, and things should be much smoother as
6210 we continue to move toward cairo 1.0.
6212 And with so many changes coming out for the first time in this 0.5
6213 release, we really do need a lot of people trying this out to make
6214 sure the ideas are solid before we freeze the API in preparation for
6217 OK, enough introduction. Here is a (not-quite-complete) description of
6218 the API removals, changes and additions in this snapshot, (compared to
6223 The following public functions have been removed:
6225 - cairo_set_target_*
6227 This is a big change. See the description of cairo_create in
6228 the API changes section for how to deal with this.
6232 Alpha blending hasn't gone away; there's just a much more
6233 unified rendering model now. Almost all uses of
6234 cairo_set_alpha will be trivially replaced with
6235 cairo_set_source_rgba and a few others will be replaced just
6236 as easily with cairo_paint_with_alpha.
6238 - cairo_show_surface
6240 Another useful function that we realized was muddling up the
6241 rendering model. The replacement is quite easy:
6242 cairo_set_source_surface and cairo_paint.
6244 - cairo_matrix_create
6245 - cairo_matrix_destroy
6247 - cairo_matrix_get_affine
6249 These functions supported an opaque cairo_matrix_t. We now
6250 have an exposed cairo_matrix_t structure, so these can be
6253 - cairo_surface_set_repeat
6254 - cairo_surface_set_matrix
6255 - cairo_surface_set_filter
6257 These properties don't belong on surfaces. If you were using
6258 them, you'll just want to instead use
6259 cairo_pattern_create_for_surface and then set these properties
6264 This was a confusing function and hopefully nobody will miss
6265 it. But if you really don't find cairo_save/restore adequate,
6266 let us know and we have another idea for a potential
6269 And while we're on the subject of removals, we carefully tightened up
6270 the cairo header files so they no longer gratuitously include header
6271 files that are not strictly necessary, (stdio.h, stdint.h, pixman.h,
6272 Xrender.h, etc. and their dependencies). This may lead to some
6273 surprising errors, so keep your eyes open for that.
6277 Here are some of the API changes that have occurred:
6279 ~ cairo_create(void) -> cairo_create(cairo_surface_t *)
6281 This is the big change that breaks every program. The ability
6282 to re-target a cairo_t was not particularly useful, but it did
6283 introduce a lot of muddy semantic questions. To eliminate
6284 that, cairo_create now requires its target surface to be
6285 passed in at creation time. This isn't too hard to cope with
6286 as the typical first operation after cairo_create was often
6287 cairo_set_target_foo. So the order of those two swap and the
6288 application instead has cairo_foo_surface_create, then
6291 ~ cairo_current_* -> cairo_get_*
6293 We had a strange mixture of cairo_get and cairo_current
6294 functions. They've all been standardized on cairo_get, (though
6295 note one is cairo_get_current_point).
6297 ~ CAIRO_OPERATOR_SRC -> CAIRO_OPERATOR_SOURCE
6298 ~ CAIRO_OPERATOR_OVER_REVERSE -> CAIRO_OPERATOR_DEST_OVER
6300 Many of the cairo_operator_t symbolic values were renamed to
6301 reduce the amount of abbreviation. The confusing "OP_REVERSE"
6302 naming was also changed to use "DEST_OP" instead which is
6303 easier to read and has wider acceptance in other
6304 libraries/languages.
6306 ~ cairo_set_pattern -> cairo_set_source
6307 ~ cairo_set_rgb_color -> cairo_set_source_rgb
6309 All of the various functions that changed the source
6310 color/pattern were unified to use cairo_set_source names to
6311 make the relation more clear.
6313 ~ cairo_transform_point -> cairo_user_to_device
6314 ~ cairo_transform_distance -> cairo_user_to_device_distance
6315 ~ cairo_inverse_transform_point -> cairo_device_to_user
6316 ~ cairo_inverse_transform_distance -> cairo_device_to_user_distance
6318 These names just seemed a lot more clear.
6320 ~ cairo_init_clip -> cairo_reset_clip
6321 ~ cairo_concat_matrix -> cairo_transform
6323 More abbreviation elimination
6325 ~ cairo_current_path -> cairo_copy_path
6326 ~ cairo_current_path_flat -> cairo_copy_path_flat
6328 The former mechanism for examining the current path was a
6329 function that required 3 or 4 callbacks. This was more
6330 complexity than warranted in most situations. The new
6331 cairo_copy_path function copies the current path into an
6332 exposed data structure, and the documentation provides a
6333 convenient idiom for navigating the path data.
6339 A generalized version of the painting operators cairo_stroke
6340 and cairo_fill. The cairo_paint call applies the source paint
6341 everywhere within the current clip region. Very useful for
6342 clearing a surface to a solid color, or painting an image,
6343 (see cairo_set_source_surface).
6345 + cairo_paint_with_alpha
6347 Like cairo_paint but applying some alpha to the source,
6348 (making the source paint translucent, eg. to blend an image on
6353 A more generalized version of cairo_paint_with_alpha which
6354 allows a pattern to specify the amount of translucence at each
6355 point rather than using a constant value everywhere.
6357 + cairo_mask_surface
6359 A convenience function on cairo_mask for when the mask pattern
6360 is already contained within a surface.
6362 + cairo_surface_set_user_data
6363 + cairo_surface_get_user_data
6364 + cairo_font_face_set_user_data
6365 + cairo_font_face_get_user_data
6367 Associate arbitrary data with a surface or font face for later
6368 retrieval. Get notified when a surface or font face object is
6371 + cairo_surface_finish
6373 Allows the user to instruct cairo to finish all of its
6374 operations for a given surface. This provides a safe point for
6375 doing things such as flushing and closing files that the
6376 surface may have had open for writing.
6378 + cairo_fill_preserve
6379 + cairo_stroke_preserve
6380 + cairo_clip_preserve
6382 One interesting change in cairo is that the path is no longer
6383 part of the graphics state managed by
6384 cairo_save/restore. This allows functions to construct paths
6385 without interfering with the graphics state. But it prevents
6386 the traditional idiom for fill-and-stroke:
6388 cairo_save; cairo_fill; cairo_restore; cairo_stroke
6390 Instead we know have alternate versions cairo cairo_fill,
6391 cairo_stroke, and cairo_clip that preserve the current path
6392 rather than consuming it. So the idiom now becomes simply:
6394 cairo_fill_preserve; cairo_stroke
6396 + cairo_surface_write_to_png
6397 + cairo_surface_write_to_png_stream
6399 In place of a single PNG backend, now a surface created
6400 through any backend (except PDF currently) can be written out
6403 + cairo_image_surface_create_from_png
6404 + cairo_image_surface_create_from_png_stream
6406 And its just as easy to load a PNG image into a surface as well.
6410 With the new, exposed path data structure, it's now possible
6411 to append bulk path data to the current path, (rather than
6412 issuing a long sequence of cairo_move_to/line_to/curve_to
6415 Xlib and XCB backends
6416 ---------------------
6418 Any cairo_format_t and Colormap arguments have been dropped from
6419 cairo_xlib_surface_create. There are also two new
6420 cairo_xlib|xcb_surface_create functions:
6422 cairo_xlib|xcb_surface_create_for_bitmap
6423 (Particular for creating A1 surfaces)
6424 cairo_xlib|xcb_surface_create_with_xrender_format
6425 (For any other surface types, not described by a Visual*)
6427 All of these surface create functions now accept width and height. In
6428 addition, there are new cairo_xlib|xcb_surface_set_size functions
6429 which must be called each time a window that is underlying a surface
6432 Print backends (PS and PDF)
6433 ---------------------------
6434 The old FILE* based interfaces have been eliminated. In their place we
6435 have two different functions. One accepts a simple const char
6436 *filename. The other is a more general function which accepts a
6437 callback write function and a void* closure. This should allow the
6438 flexibility needed to hook up with various stream object in many
6441 In addition, when specifying the surface size during construction, the
6442 units are now device-space units (ie. points) rather than inches. This
6443 provides consistency with all the other surface types and also makes
6444 it much easier to reason about the size of the surface when drawing to
6445 it with the default identity matrix.
6447 Finally, the DPI parameters, which are only needed to control the
6448 quality of fallbacks, have been made optional. Nothing is required
6449 during surface_create (300 DPI is assumed) and
6450 cairo_ps|pdf_surface_set_dpi can be used to set alternate values if
6455 Owen very graciously listened to feedback after the big font rework he
6456 had done for 0.4, and came up with way to improve it even more. In 0.4
6457 there was a cairo_font_t that was always pre-scaled. Now, there is an
6458 unscaled cairo_font_face_t which is easier to construct, (eg. no
6459 scaling matrix required) and work with, (it can be scaled and
6460 transformed after being set on the graphics state). And the font size
6461 manipulation functions are much easier. You can set an explicit size
6462 and read/modify/write the font matrix with:
6465 cairo_get_font_matrix
6466 cairo_set_font_matrix
6468 (Previously you could only multiply in a scale factor or a matrix.) A
6469 pleasant side effect is that we can (and do) now have a default font
6470 size that is reasonable, as opposed to the old default height of one
6471 device-space unit which was useless until scaled.
6473 Of course, the old pre-scaled font had allowed some performance
6474 benefits when getting many metrics for a font. Those benefits are
6475 still made available through the new cairo_scaled_font_t. And a
6476 cairo_font_face_t can be "promoted" to a cairo_scaled_font_t by
6477 suppling a font_matrix and the desired CTM.
6481 Tim Rowley put in the work to bring the Quartz backend back after it
6482 had been disabled in the 0.4.0 snapshot. He was not able to bring back
6483 the function that allows one to create a cairo_font_t from an ATSUI
6487 cairo_atsui_font_create (ATSUStyle style);
6489 because he didn't have a test case for it. If you care about this
6490 function, please provide a fairly minimal test and we'll try to bring
6491 it back in an upcoming snapshot.
6493 Snapshot 0.4.0 (2005-03-08 Carl Worth <cworth@cworth.org>)
6494 ==========================================================
6497 Owen Taylor has converted cairo's documentation system to gtk-doc and
6498 has begun some long-needed work on the documentation, which can now be
6501 http://cairographics.org/manual/
6505 This is the first snapshot to include a functional win32 backend,
6506 (thanks to Owen Taylor). The interface is as follows:
6508 #include <cairo-win32.h>
6511 cairo_set_target_win32 (cairo_t *cr,
6515 cairo_win32_surface_create (HDC hdc);
6518 cairo_win32_font_create_for_logfontw (LOGFONTW *logfont,
6519 cairo_matrix_t *scale);
6522 cairo_win32_font_select_font (cairo_font_t *font,
6526 cairo_win32_font_done_font (cairo_font_t *font);
6529 cairo_win32_font_get_scale_factor (cairo_font_t *font);
6531 And see also the documentation at:
6533 http://cairographics.org/manual/cairo-Microsoft-Windows-Backend.html
6535 Disabled backend: quartz
6536 ------------------------
6537 Unfortunately, the quartz backend code is currently out of date with
6538 respect to some recent backend interface changes. So, the quartz
6539 backend is disabled in this snapshot.
6541 If the quartz backend is brought up-to-date before the next snapshot,
6542 we would be glad to make a 0.4.1 snapshot that re-enables it, (we do
6543 not expect many more big backend interface changes).
6547 The font system has been revamped, (as Owen Taylor's work with
6548 integrating pango and cairo gave us the first serious usage of the
6551 One fundamental, user-visible change is that the cairo_font_t object
6552 now represents a font that is scaled to a particular device
6553 resolution. Further changes are described below.
6557 Removed cairo_font_set_transform and cairo_font_current_transform.
6559 Added cairo_font_extents and cairo_font_glyph_extents. See
6560 documentation for details:
6562 http://cairographics.org/manual/cairo-cairo-t.html#cairo-font-extents
6566 The cairo_ft_font API changed considerably. Please see the
6567 documentation for details:
6569 http://cairographics.org/manual/cairo-FreeType-Fonts.html
6573 Make the fast-path clipping (pixel-aligned rectangles) faster.
6575 Add optimization for applying a constant alpha to a pattern.
6577 Optimize gradients that are horizontal or vertical in device space.
6579 Xlib: When RENDER is not available, use image surfaces for
6580 intermediate surfaces rather than xlib surfaces.
6582 Backend-specific changes
6583 ------------------------
6586 Major update to glitz backend. The output quality should now be just
6587 as good as the image and xlib backends.
6589 Track changes to glitz 0.4.0.
6593 Various improvements to produce more conformant output.
6597 David Reveman contributed a large re-work of the cairo_pattern_t
6598 implementation, providing cleaner code and more optimization
6601 Backend interface changes
6602 -------------------------
6603 Rework backend interface to accept patterns, not surfaces for source
6606 Remove set_matrix, set_filter, and set_repeat functions.
6608 More sophisticated backend interface for image fallbacks,
6609 ({acquire,release}_{source,dest}_image() and clone_similar).
6613 Only install header files for backends that have been compiled.
6615 Fixed some rounding errors leading to incorrectly placed glyphs.
6617 Many other minor fixes.
6619 Snapshot 0.3.0 (2005-01-21 Carl Worth <cworth@cworth.org>)
6620 ==========================================================
6623 1) The public header files will no longer be directly installed into
6624 the system include directory. They will now be installed in a
6625 subdirectory named "cairo", (eg. in /usr/include/cairo rather than
6628 As always, the easiest way for applications to discover the
6629 location of the header file is to let pkg-config generate the
6630 necessary -I CFLAGS and -L/-l LDFLAGS. For example:
6632 cc `pkg-config --cflags --libs cairo` -o foo foo.c
6634 IMPORTANT: Users with old versions of cairo installed will need to
6635 manually remove cairo.h and cairo-features.h from the
6636 system include directories in order to prevent the old
6637 headers from being used in preference to the new ones.
6639 2) The backend-specific portions of the old monolithic cairo.h have
6640 been split out into individual public header files. The new files
6653 Applications will need to be modified to explicitly include the new
6654 header files where appropriate.
6656 3) There are two new graphics backends in this snapshot, a PDF
6657 backend, and a Quartz backend. There is also one new font backend,
6662 Kristian Høgsberg has contributed a new backend to allow cairo-based
6663 applications to generate PDF output. The interface for creating a PDF
6664 surface is similar to that of the PS backend, as can be seen in
6668 cairo_set_target_pdf (cairo_t *cr,
6670 double width_inches,
6671 double height_inches,
6672 double x_pixels_per_inch,
6673 double y_pixels_per_inch);
6676 cairo_pdf_surface_create (FILE *file,
6677 double width_inches,
6678 double height_inches,
6679 double x_pixels_per_inch,
6680 double y_pixels_per_inch);
6682 Once a PDF surface has been created, applications can draw to it as
6683 any other cairo surface.
6685 This code is still a bit rough around the edges, and does not yet
6686 support clipping, surface patterns, or transparent gradients. Text
6687 only works with TrueType fonts at this point and only black text is
6688 supported. Also, the size of the generated PDF files is currently
6691 Kristian is still actively developing this backend, so watch this
6692 space for future progress.
6696 Calum Robinson has contributed a new backend to allow cairo
6697 applications to target native Mac OS X windows through the Quartz
6698 API. Geoff Norton integrated this backend into the current
6699 configure-based build system, while Calum also provided Xcode build
6700 support in the separate "macosx" module available in CVS.
6702 The new interface, available in cairo-quartz.h, is as follows:
6705 cairo_set_target_quartz_context (cairo_t *cr,
6706 CGContextRef context,
6711 cairo_quartz_surface_create (CGContextRef context,
6715 There is an example program available in CVS in cairo-demo/quartz. It
6716 is a port of Keith Packard's fdclock program originally written for
6717 the xlib backend. A screenshot of this program running on Mac OS X is
6720 http://cairographics.org/~cworth/images/fdclock-quartz.png
6724 This new font backend complements the Quartz backend by allowing
6725 applications to use native font selection on Mac OS X. The interface
6726 is a single new function:
6729 cairo_atsui_font_create (ATSUStyle style);
6733 Prototype for non-existent function "cairo_ft_font_destroy" removed.
6735 Now depends on libpixman 0.1.2 or newer, (0.1.3 is being released
6736 concurrently and has some useful performance improvements).
6738 Default paint color is now opaque black, (was opaque white). Default
6739 background color is transparent (as before).
6741 Renamed "struct cairo" to "struct _cairo" to free up the word "cairo"
6742 from the C++ identifier name space.
6744 Functions returning multiple return values through provided pointers,
6745 (cairo_matrix_get_affine, cairo_current_point, and
6746 cairo_current_color_rgb), will now accept NULL for values the user
6749 CAIRO_HAS_FREETYPE_FONT has now been renamed to CAIRO_HAS_FT_FONT.
6751 Performance improvements
6752 ------------------------
6753 Alexander Larsson provided some fantastic performance improvements
6754 yielding a 10000% performance improvement in his application, (when
6755 also including his performance work in libpixman-0.1.3). These include
6757 * Fixed handling of cache misses.
6759 * Creating intermediate clip surfaces at the minimal size required.
6761 * Eliminating roundtrips when creating intermediate Xlib surfaces.
6765 Major re-work of font metrics system by Keith Packard. Font metrics
6766 should now be much more reliable.
6770 Updated for glitz-0.3.0.
6771 Bug fixes in reference counting.
6775 New tests for cache crashing, rotating text, improper filling of
6776 complex polygons, and leaky rasterization.
6780 Fixed assertion failure when selecting the same font multiple times in
6783 Fixed reference counting so cache_destroy functions work.
6785 Remove unintended copyright statement from files generated with
6788 Fixed to eliminate new warnings from gcc 3.4 and gcc 4.
6790 Snapshot 0.2.0 (2004-10-27 Carl Worth <cworth@cworth.org>)
6791 ===========================================================
6792 New license: LGPL/MPL
6793 ---------------------
6794 The most significant news with this release is that the license of
6795 cairo has changed. It is now dual-licensed under the LGPL and the
6796 MPL. For details see the COPYING file as well as COPYING-LGPL-2.1 and
6799 I express my thanks to everyone involved in the license change process
6800 for their patience and support!
6802 New font and glyph internals
6803 ----------------------------
6804 Graydon Hoare has put a tremendous amount of work into new internals
6805 for handling fonts and glyphs, including caches where appropriate.
6806 This work has no impact on the user-level API, but should result in
6807 great performance improvements for applications using text.
6811 This snapshot of cairo includes a (small) test suite in
6812 cairo/test. The tests can be run with "make check". The test suite was
6813 designed to make it very easy to add new tests, and we hope to see
6814 many contributions here. As you find bugs, please try adding a minimal
6815 test case to the suite, and submit it with the bug report to the
6816 cairo@cairographics.org mailing list. This will make it much easier
6817 for us to track progress in fixing bugs.
6819 New name for glitz backend
6820 --------------------------
6821 The gl backend has now been renamed to the glitz backend. This means
6822 that the following names have changed:
6824 CAIRO_HAS_GL_SURFACE -> CAIRO_HAS_GLITZ_SURFACE
6825 cairo_set_target_gl -> cairo_set_target_glitz
6826 cairo_gl_surface_create -> cairo_glitz_surface_create
6828 This change obviously breaks backwards compatibility for applications
6829 using the old gl backend.
6831 Up-to-date with latest glitz snapshots
6832 --------------------------------------
6833 This snapshot of cairo is now up to date with the latest glitz
6834 snapshot, (currently 0.2.3). We know that the latest cairo and glitz
6835 snapshots have been incompatible for a very long time. We've finally
6836 fixed that now and we're determined to not let that happen again.
6838 Revert some tessellation regression bugs
6839 ----------------------------------------
6840 People that have been seeing some tessellation bugs, (eg. leaked
6841 fills), in the CVS version of cairo may have better luck with this
6842 release. A change since the last snapshot was identified to trigger
6843 some of these bugs and was reverted before making the snapshot. The
6844 behavior should be the same as the previous (0.1.23) snapshot.
6846 Miscellaneous changes
6847 ---------------------
6848 Changed CAIRO_FILTER_DEFAULT to CAIRO_FILTER_BEST to make gradients
6851 Track XCB API change regarding iterators.
6855 Fix calculation of required number of vertices for pen.
6857 Fix to avoid zero-dimensioned pixmaps.
6859 Fix broken sort of pen vertices.
6861 Fix bug when cairo_show_text called with a NULL string.
6865 Fix bug in computing image length with XCB.
6867 Fix infinite loop bug in cairo_arc.
6869 Fix memory management interactions with libpixman.
6871 Snapshot 0.1.23 (2004-05-11 Carl Worth <cworth@isi.edu>)
6872 ========================================================
6875 Fix prototype mismatches so that cairo can be built by gcc 3.4.
6877 Updates to track glitz
6878 ----------------------
6879 Various fixes to support the latest glitz snapshot (0.1.2).
6883 Radial gradients now support both inner and outer circles.
6884 Transformed linear gradients are now properly handled.
6885 Fixes for extend type reflect.
6889 Converted shading routines to use fixed point values and introduced a
6890 shading operator structure for more efficient shading calculations.
6891 Support compositing with mask surface when mask is solid or
6892 multi-texturing is available.
6894 PNG backend cleanups
6895 --------------------
6896 Fix output to properly compensate for pre-multiplied alpha format in cairo.
6897 Add support for A8 and A1 image formats.
6901 Avoid crash or infinite loop on null strings and degeneratively short
6904 New? bugs in cairo_clip
6905 -----------------------
6906 There are some fairly serious bugs in cairo_clip. It is sometimes
6907 causing an incorrect result. And even when it does work, it is
6908 sometimes so slow as to be unusable. Some of these bugs may not be
6909 new, (indeed cairo_clip has only ever had a braindead-slow
6910 implementation), but I think they're worth mentioning here.
6912 Snapshot 0.1.22 (2004-04-16 Carl Worth <cworth@isi.edu>)
6913 ========================================================
6914 Cairo was updated to track the changes in libpixman, and now depends
6915 on libpixman version 0.1.1.
6917 Snapshot 0.1.21 (2004-04-09 David Reveman <c99drn@cs.umu.se>)
6918 =============================================================
6921 The OpenGL backend provides hardware accelerated output for
6922 X11 and OS X. The significant new functions are:
6925 cairo_gl_surface_create
6927 Automatic detection of available backends
6928 -----------------------------------------
6929 The configure script now automatically detect what backends are
6930 available, (use ./configure --disable-`backend' to prevent
6931 compilation of specific backends).
6933 Snapshot 0.1.20 (2004-04-06 Carl Worth <cworth@isi.edu>)
6934 ========================================================
6937 David Reveman has contributed a new pattern API which enable linear
6938 and radial gradient patterns in addition to the original surface-based
6939 patterns. The significant new top-level functions are:
6941 cairo_pattern_create_linear
6942 cairo_pattern_create_radial
6943 cairo_pattern_create_for_surface
6944 cairo_pattern_add_color_stop
6947 Any code using the old cairo_set_pattern, (which accepted a
6948 cairo_surface_t rather than a cairo_pattern_t), will need to be
6951 Update to XCB backend
6952 ---------------------
6953 The XCB backend is now enabled by default, (use ./configure
6954 --disable-xcb to turn it off).
6958 Graydon Hoare has added optimizations that make cairo_clip much faster
6959 when the path is a pixel-aligned, rectangular region.
6963 Snapshot 0.1.19 (2004-02-24 Carl Worth <cworth@isi.edu>)
6964 ========================================================
6967 Olivier Andrieu contributed a new PNG backend. It builds on the
6968 existing image backend to make it easy to render "directly" to a
6969 .png file. The user never needs to deal with the actual image
6970 buffer. The significant new functions are:
6972 cairo_set_target_png
6973 cairo_png_surface_create
6975 The PNG backend is not enabled by default so that by default there is
6976 not a new dependency on libpng. Use ./configure --enable-png to enable
6979 Snapshot 0.1.18 (2004-02-17 Carl Worth <cworth@isi.edu>)
6980 ========================================================
6981 Path query functionality
6982 ------------------------
6983 It's now possible to query the current path. The two new functions
6987 cairo_current_path_flat
6989 Each function accepts a number of callback functions that will be
6990 called for each element in the path (move_to, line_to, curve_to,
6991 close_path). The cairo_current_path_flat function does not accept a
6992 curve_to callback. Instead, all curved portions of the path will be
6993 converted to line segments, (within the current tolerance value). This
6994 can be handy for doing things like text-on-path without having to
6995 manually interpolate Bézier splines.
6999 Jamey Sharp has contributed a second X backend that uses the new, lean
7000 XCB library rather than Xlib. It cannot currently be compiled at the
7001 same time as the Xlib backend. See ./configure --enable-xcb.
7003 Build fixes for cygwin.
7007 Snapshot 0.1.17 (2003-12-16 Carl Worth <cworth@isi.edu>)
7008 ========================================================
7012 This snapshot provides much better text support by implementing the
7013 following four functions:
7020 The text/glyph_extents functions can be used to determine the bounding
7021 box (and advance) for text as if drawn by show_text/glyphs.
7023 The text/glyph_path objects functions place text shapes on the current
7024 path, where they can be subsequently manipulated. For example,
7025 following these functions with cairo_stroke allows outline text to be
7026 drawn. Calling cairo_clip allows clipping to a text-shaped region.
7028 Combined dependencies
7029 ---------------------
7030 The cairo core now depends only on the libpixman library. This single
7031 library replaces the three previous libraries libic, libpixregion, and
7032 slim. Thanks to Dave Beckett <dave.beckett@bristol.ac.uk> for all of
7033 the heavy lifting with this renaming effort.
7035 Conditional compilation of backends
7036 -----------------------------------
7037 Cairo now allows optional backends to be disabled at compile time. The
7038 following options may now be passed to the configure script:
7043 Note that the first option is a change from the old --without-x option
7044 which will no longer have any effect.
7046 OS X supported - several byte-order issues resolved
7047 ---------------------------------------------------
7048 Cairo has now been successfully compiled under OS X. Testing revealed
7049 that there were some byte-order problems in the PostScript backend and
7050 the PNG generation in the demos. These have now been resolved.
7054 Graydon Hoare <graydon@redhat.com> implemented the first real text
7055 support using Freetype/fontconfig, (previous versions of cairo used
7056 Xft and could only draw text when using an X backend).
7060 Graydon Hoare <graydon@redhat.com> added the first real support for
7061 running cairo with a non-render-aware X server.
7063 Jamey Sharp <jamey@minilop.net> virtualized the backend font and
7064 surface interfaces in September, 2003.
7068 Xr is renamed cairo to avoid confusion since it no longer had a strict
7073 A new image surface backend is added to Xr. Keith Packard
7074 <keithp@keithp.com> wrote the image compositing code in libic that is
7075 used for the image_surface backend. This code was originally written
7076 as the software fallback for the render extension within the X
7081 Carl Worth <cworth@isi.edu> wrote the first lines of Xr, after Keith
7082 Packard <keithp@keithp.com> proposed the plan for a stateful drawing
7083 library in C providing a PostScript-like rendering model.
7085 LocalWords: mutex BeOS extraordinaire distro's URL lcd bool tarball