NEWS in package ‘Cairo’

---

Changes in version 1.6-2 (2023-11-28)

• Minor bugfixes: invalid format specified in UBiDi error string, incorrect font name passed if the font family name is too long.
• Update Windows build to use pkg-config (Thanks to Tomáš Kalibera!) (#43)

Changes in version 1.6-1 (2023-08-17)

• The following additional arguments can be used to set PDF metadata: title, author, subject, creator, keywords, create.date and modify.date if cairo version 1.16 or higher is used. (#15)
• The 'version' argument for PDF back-end is now honored and defaults to 1.4. Note that currently cairo library only supports PDF target versions 1.4 or 1.5.
• The xlib back-end no longer requires headers from Xt. (#39)

Changes in version 1.6-0 (2022-07-05)

• Added text drawing using Harfbuzz and ICU. This significantly improves the quality of text rendeded by Cairo and enables support for right-to-left and bi-directional text. (#23) It also enables the use of ligatures. (#18) This feature is only enabled if 'pkg-config' is present and knows how to use the 'harfbuzz-icu' module.
• The 'family=' argument in text drawing is now honored also for FreeType and Harfbuzz back-ends.
• configure gains two arguments: '--with-freetype' and '--with-harfbuzz'. They both default to 'auto' which means FreeType and Harfbuzz will be used if present. If set to 'yes' then the support is required. If set to 'no' (or the '--without' form is used) then the corresponding support is explicitly disabled. Note that Harfbuzz requires FreeType.
• added '--enable-debug' argument to configure which will make Cairo extremely chatty on the console.
• By default 'cairo-ft' will be ignored on Windows, becasue it it does not work without associated FontConfig configuration files and font cache. (#37) This behavior can be changed by using '-DUSE_CAIRO_FT=1' to force the use of 'cairo-ft' unconditionally.
• Cairo.capabilities() now also reports two capabilities which are not format-related: "freetype" and "harfbuzz". The former indicates whether 'cairo-ft' is used and the later indicates whether the newly introduced Harfbuzz + ICU bi-directional rendering support is present.

Changes in version 1.5-15 (2022-03-16)

• CairoX11 (xlib back-end): install an X11 I/O error handler while processing events such that broken connections are detected and don't kill R.
• added the option to license under GPL v3. All original authors explicitly agreed and included code based on R is licensed under GPL-2+ allowing this.

Changes in version 1.5-14 (2021-12-21)

• update configure/autoconf, some dependencies such as libtiff are now also detected using pkg-config. Tests are now correctly using CPPFLAGS from R.
• add entry points for GE version 13 (needed for R 4.1.0) Note that this is just a port of CRAN NMU which was posted as version 1.15-12.2 on CRAN, but was not an actual Cairo version.

Changes in version 1.5-13 (2020-04-15)

• add support for CairoFont(usePUA=FALSE) to support regular fonts without Adobe Symbol Encoding as symbol fonts in R 4.0.0 and higher. Setting usePUA=FALSE in older versions of R will issue a warning.

Changes in version 1.5-12 (2020-04-11)

• use pkg-config --static --libs when needed
• adapt to API changes in R 4.0.0, also improves symbol placement in recent R versions

Changes in version 1.5-11 (2020-02-26)

• fixed missing PROTECT() (thanks to Tomáš Kalibera)
• minor changes to remove R CMD check warnings

Changes in version 1.5-10 (2019-03-27)

• support compilation with C++11-only compilers (#19)
• add path.expand() for filenames (#12)
• add C symbol registration
• update configure.ac to be more compliant

Changes in version 1.5-9 (2015-09-25)

• work around bug #45376 in freetype 2.6.0 causing compilation failure

Changes in version 1.5-8 (2015-07-29)

• fix a premature memory release in locator handling for raster back-ends.

Changes in version 1.5-7 (2015-07-27)

• fix a segfault in CairoFontMatch() in case FcNameParse() fails (closes #10)
• image back-end can now provide custom locator if a ‘locator' argument is passed to 'Cairo()' with the desired callback function. The callback function accepts 'dev' argument and should return either a numeric vector of length 2 (x, y) or 'NULL'. This is mainly useful for 'type=’raster'' passed to external UI where that UI can provide locator capability.
• add Cairo.snapshot() which is similar to recordPlot() but also allows the retrieval of the last snapshot.

Changes in version 1.5-6 (2014-06-26)

• scale line width by the same amount as fonts such that resolution changes are consistent even in that respect

Changes in version 1.5-5 (2013-12-23)

• fix onSave reporting incorrect page number for the last page (introduced in 1.5-4, closes #6)
• scale fonts unconditionally according to the dpi adjustment (fixes issues with grid graphics and dpi changes)

Changes in version 1.5-4 (2013-12-12)

• fix invalid pointsize scaling if dpi auto-detection is used (closes #1)
• fix failure to emit final page in some multi-page settings (closes #4)
• the ‘res’ parameter in CairoPNG(), CairoTIFF() and CairoJPEG() it now passed down to Cairo() which now accepts ‘res’ to override the value of ‘dpi’ if ‘res’ is set to anyhting other than NA or NULL. (closes #3)
• release onSave callback function on close (closes #2)

Changes in version 1.5-3 (2013-12-03)

• remove compatibility layers to make R 3.x happy
• adjust pointsize according to the dpi setting

Changes in version 1.5-2 (2012-11-05)

• added Cairo.onSave() callback which allows R code to be run when Cairo finishes a page
• added Cairo.serial() function which allows user code to check whether the graphics have been updated
• bugfix/update in Cairo connection patch (by Karl Millar)

Changes in version 1.5-1 (2011-12-10)

• add support for dev.hold()/dev.flush()
• use new R 2.14.0 device capabilities advertizing feature
• fix memory leak when setting fonts via CairoFonts()
• explicitly request font anti-aliasing even if it is not the surface default - in particular Windows has disabled font anti-aliasing by default

Changes in version 1.5-0 (2011-09-30)

• fix swapped bold vs italic traits if freetype is not available
• use Times font for symbols on Windows because Symbol font doesn't seem to support Unicode
• add support for poly-paths
• add support for dev.capture()/grid.cap()
• added new type "raster" that creates an image back-end without any output file. It can be used in conjunction with dev.capture() to create in-memory image representations, e.g.: Cairo(type='raster') plot(1:10, col=2) p = writePNG(dev.capture(native=TRUE), raw()) will create a raw vector containg a PNG image.

Changes in version 1.4-9 (2011-04-06)

• force static built-in libraries on Windows to prevent Cairo from picking up broken system libraries

Changes in version 1.4-8 (2011-03-07)

• spurious character in the 1.4-7 w32-backed source has made it unusable on Windows. This is a re-packaging of 1.4-7 without that spurious character.

Changes in version 1.4-7 (2011-03-07)

• fix a bug in raster support causing raster to be usable only once
• win backend: release and re-get DC on resize -- fixes resizing issues in CairoWin() for some Windows versions

Changes in version 1.4-6 (2011-02-10)

• adds raster image support (courtesy of R core)
• update Windows libcairo binary to cairo 1.10.2, use static build to avoid DLL issues and add 64-bit binary

Changes in version 1.4-5 (2009-07-16)

• minor Windows configuration change
• fix SET_VECTOR_ELT issue for R 2.9.0+

Changes in version 1.4-4 (2008-10-17)

• adapt to changes in R-devel (2.9.0-to-be), clean up warnings

Changes in version 1.4-3 (2008-07-21)

• make the use of an invalid font non-fatal
• allow Cairo to compile on some older systems that don't have trunc()
• updated libcairo binary for Windows to 1.6.4 (from GTK+)

Changes in version 1.4-2 (2008-04-03)

• adapt to even more changes in R 2.7

Changes in version 1.4-1 (2008-03-14)

• adapt to R 2.7 changes

Changes in version 1.4-0

• fix DPI detection in X11 back-end and use 90dpi as a fallback
• fix cra settings to be closer to what other devices use
• CairoX11 no longer fixes DPI to 72, "auto" is now the default. In addition, CairoWin and CairoX11 allow additional arguments to ba passed to Cairo.

Changes in version 1.3-5 (2007-08-27)

• adapt to const char* CHARs in R-devel
• fix a bug in CairoSVG (wrong argument name)
• fix a bug in CairoPS (units were not set to "in" and width/height had no defaults)
• fix unintentional doubling of the .ps suffix

Changes in version 1.3-4 (2007-05-10)

• more fixes in flag-guessing
• some vector backends (e.g. PDF, SVG) were falling back to bitamp rasterization, we try to prevent this
• address expose issues with some X11 servers
• add CairoSVG wrapper
• add an unified way to register back-ends and get a list of all supported types.
• add Cairo.capabilities() function

Changes in version 1.3-3 (2007-04-25)

• improve detection of cairo and its dependencies
• work around missing API such that cairo 1.0 can be used. However, it is strongly encouraged to use cairo 1.2 or possibly 1.4 as they contain important bugfixes.
• fix page numbering to start at 1 (was 0) and update documentation correspondingly

Changes in version 1.3-2 (2007-04-18)

• added format autodetection for tiff and png. The 32-bit version of either format is used if the background is not opaque.
• fixed bug in the value returned by Cairo
• added type and file attributes to the Cairo object
• added (hidden, experimental) functions that allow direct modification of image content in Cairo (.image, .ptr.to.raw and .raw.to.ptr)

Changes in version 1.3-1

• change semantics of canvas and bg to match other devices: canvas is used by devices that don't support any kind of transparency in case bg is translucent
• fixed data ordering issues in TIFF and JPEG output
• added "compression" parameter to TIFF back-end which now defaults to LZW compression

Changes in version 1.3-0

• add support for canvas and dpi specification
• allow backends to detect native resolution
• add support for custom parameters (e.g. quality for jpeg)

Changes in version 1.2-1

• improve rendering on bitmap devices by aligning straight lines to the pixel grid and adding bleed to such fills.
• added wrappers that take exactly the same parameters as existing devices such as png, jpeg, pdf, postscript, X11 or windows and map them to calls to Cairo. They can be used to replace native devices by Cairo without the need to change existing code.
• added namespace

Changes in version 1.2-0

• additional interactive back ends: X11 (XLib) and win (Win32)
• enhanced back-end API to support interactive back-ends
• change default backgroud color to "white", because alpha-blending doesn't work properly in cairo when painting on purely transparent background.
• change the way filenames are interpreted, use multi-file printf convention as other devices do.
• added support for jpeg and tiff image formats

Changes in version 1.1-0

• additional file/stream back-ends: svg, ps
• enhanced back-end API

Changes in version 1.0-0

• fixed function names to not conflict with GDD

Changes in version 0.1-5

• added R connections patch support at config time. see http://wiki.r-project.org/rwiki/doku.php?id=developers:r_connections_api

Changes in version 0.1-4 (2006-12-07)

• add pdf backend (Jeff Horner)
• fix up backend infrastructure (Jeff Horner)

Changes in version 0.1-3 (2006-12-06)

• add freetype and fontconfig support (Jeff Horner)
• fix memory leaks (Jeff Horner)
• make transparent background default with bg="transparent"

Changes in version 0.1-2 (2006-12-05)

• add support for caps/joints (patch by Jeff Horner)
• make rectangels to snap to grid (patch by Jeff Horner)
• use transparent image background by default

Changes in version 0.1-1 (2005-12-23)

• first official release, image backend works, others are waiting to be implemented by volunteers