Rendering SVG with CSS in R

The rsvg R package provides bindings to librsvg-2 to render SVG files into bitmaps directly from R. On Linux systems, you need to install librsvg from apt or yum before installing the R package from CRAN. On Windows and MacOS this is not needed.

SVG with embedded CSS

This Mozilla example shows that the SVG specification allows for a style element, which is also supported in all browsers. Embedded CSS is supported in all versions of librsvg, but the quality of css rendering has improved a lot in recent versions of librsvg.

str <- charToRaw('<svg viewBox="0 0 300 300" xmlns="http://www.w3.org/2000/svg">
  <style>
    circle {
      fill: gold;
      stroke: maroon;
      stroke-width: 10px;
    }
  </style>

  <circle cx="150" cy="150" r="100" />
</svg>')
rsvg_png(str, file = 'ex1.png')
Rendering of SVG with embedded CSS

Rendering of SVG with embedded CSS

SVG with external CSS

Recent versions of librsvg can also apply an external CSS file to the SVG. This has the same effect as an external CSS file that is embedded in header of an HTML file.

By using an external CSS, we can split the drawing structure from the styling. The new “css” parameter requires a somewhat recent version of librsvg so it may not work on older Linux systems. It is available on any MacOS or Windows, and the latest versions of Ubuntu, Debian, Fedora, etc.

svg <- charToRaw('<svg viewBox="0 0 300 300" xmlns="http://www.w3.org/2000/svg">
  <circle cx="150" cy="150" r="100" />
</svg>')

# Render without style:
rsvg_png(svg, file = 'ex2.png')
Rendering of SVG without CSS

Rendering of SVG without CSS

css <- charToRaw('circle {
  fill: navy;
  stroke: hotpink;
  stroke-width: 10px;
}')
# Render without style:
rsvg_png(svg, css = css, file = 'ex3.png')
Rendering of SVG with external CSS

Rendering of SVG with external CSS

Bitmap rendering and magick

The examples above write the rendered SVG file directly to a PNG file on disk. But you can also render the SVG to an in-memory bitmap buffer.

bitmap <- rsvg_raw('https://jeroen.github.io/images/tiger.svg', width = 600)
str(bitmap)
##  raw [1:4, 1:600, 1:600] 00 00 00 00 ...

The bitmap object is an array in R that contain the pixels of the image. You can read it for example using the magick package for subsequent image editing, or to save it to a standard format.

magick::image_read(bitmap)
## Warning in knitr::include_graphics(tmp): It is highly recommended to use
## relative paths for images. You had absolute paths: "/private/var/folders/l5/
## gk7g18z52876d4lbk9tjhr0c0000gn/T/RtmptGbpl2/Rbuildce44f4c4351/rsvg/vignettes/
## svg-css_files/figure-html/unnamed-chunk-8-1.png"