NEWS R Documentation

## NEWS file for the gridSVG package

### Changes in version 1.7-4

• Fix in feColorMatrix() for “length > 1 in coercion to logical” error. Thanks to CRAN testing and Brian Ripley!

### Changes in version 1.7-3

• Internal implementation change to avoid assigning values into baseenv.

### Changes in version 1.7-2

• Simpler and better transformations for exported SVG <image> elements.

• Better protection against NA values in labels in text grobs. Reported by Daniel Barnett.

### Changes in version 1.7-1

• Fix for evaluation of arguments passed to pdf() device within gridsvg().

Patch provided by Philipp Angerer.

• Avoid peeking at internal representation of grid units.

### Changes in version 1.7-0

• Update for addition of pathId argument in grid.path.

### Changes in version 1.6-1

• Additional fix for pch=NA

### Changes in version 1.6-0

• Generation of SVG from grid.export() is now much faster (when you are drawing many rectangles, points, circles, or lines).

### Changes in version 1.5-1

• Fix to ensure that r attribute in radial gradients is non-negative.

• Fix for strict attribute checking now includes presentation attributes.

• Fix for gtable support when grob in table cell has viewport with non-centering alignment (e.g., a ggplot2 plot with more than one legend). Reported by Tauno Metsalu.

• Switched JSON library from RJSONIO to jsonlite. gridSVG no longer needs to compile C code as it can import a base64 encoding method from jsonlite.

• Bug fix to handle exporting par(lty="blank"), e.g., from boxplot() (converted with gridGraphics). Thanks to Volker Sorge.

• Bug fix to handle pch=NA. Thanks to Volker Sorge.

### Changes in version 1.5-0

• Added strict argument for grid.export() and gridsvg() to allow control over whether SVG attributes are checked for validity.

• Added rootAttrs argument for grid.export() and gridsvg() to allow control over attributes of top-level <svg> element. Suggestion and original patch from Thell Fowler.

### Changes in version 1.4-4

• Fixed bug where gpar(col=c(foo="red")) would not work (the name foo is now stripped). Reported by Simon Anders.

• Fixed bug in feColorMatrix(). The color matrix required transposing before export to SVG.

• Fixed bug in feComponentTransfer(). Was generating an feColorMatrix element and was inlining transfer functions as attributes (rather than generating feFunc elements as children).

• Added support for NA values in locations and dimensions of graphical primitives.

### Changes in version 1.4-3

• Non-SVG style attributes are now removed (with a warning) and this is done before checking attributes for length equal to 1.

This was in response to a problem reported by Wolfgang Huber.

• Fix evaluation of arguments when using the 'gridsvg' device. These were not being evaluated before being passed to 'grid.export'.

Also reported by Wolfgang Huber.

### Changes in version 1.4-2

• Fixed export of clip grob (reported by Matthew Plourde).

• Fixed support for primitiveUnits="bbox" in filterEffect().

• Fix memory initialisation problem in base64 C code.

Reported in valgrind testing by Brian Ripley.

### Changes in version 1.4-1

• Fixed raster export so that original raster is never exported at a resolution LOWER than its native resolution.

• Added forceGrob() methods so that animations, garnishing, hyperlinks, etc are retained if a grob is forced.

• Fix for export of downViewport(path) when the depth of the resulting navigation is greater than depth(path).

The visible manifestation of this bug was that <g> elements were generated with an incorrect (too long/wrong depth) 'id' attribute.

### Changes in version 1.4-0

• Bumped R version requirement to R >= 3.1.0 because this version of gridSVG depends on some new exports from 'grid'

• Removed all nasty peeks into grid namespace (hence dependence on R 3.1.0).

• Tweaks to tests/ to make it easier to do QC checks.

### Changes in version 1.3-0

• Added support for rotated viewports (previously, rectangles, text, rasters, and clipping rects did not export properly, if drawn within a rotated viewport)

Includes changes to rendering, animation, and coordinate system export and conversion.

• Fixed bug in viewportConvertWidth() and viewportConvertHeight() when converting from "native".

• Bug fix for positioning grobs with dimensions when a viewport's x-scale or y-scale is "flipped". (Simon)

• Reposition <defs> so that definitions are always available when used. Allows renderers like librsvg to render gridSVG images correctly. For consistency, pch definitions are also pushed into the same <defs> element. (Simon)

• Bug fix for 'lwd'. They are now defined as being 1/96 inches, which matches most graphics devices. (Simon)

• Only one 'gridsvg' device can now be open at once. This is because referenced content (like gradients, masks, etc) can have side effects across multiple 'gridsvg' devices. (Simon)

• New argument for 'grid.export()', 'progress'. When this argument is 'TRUE', messages will be printed to the console that show how far gridSVG is through processing an image. Additionally, progress bars are drawn to aid in estimation of progress. (Simon)

• New argument for 'grid.export()', 'compression'. This can take an integer value between 0 and 9 that describes the level of (gzip) compression applied to the exported image. (Simon)

• Added 'group', 'strict', 'grep', and 'global' arguments to grid.animate() (to bring it into line with grid.hyperlink() and grid.garnish().

• Now Import rather than Depend on other packages.

### Changes in version 1.2-0

• The main change in this version involves taking advantage of changes in R version 3.0.0, which introduced a grid.force() function. This reduces the need for special methods in this package to draw custom grobs.

• Renamed 'gridToSVG' to 'grid.export'. 'gridToSVG' is now deprecated and will produce a warning but will still work. 'grid.export' should be used from now on. (Simon)

• Renamed 'grid.export' arguments for consistency. 'export.coords', 'export.mappings', and 'export.js' are now camelCased to 'exportCoords', 'exportMappings', 'exportJS' respectively. (Simon)

• Bumped R version dependency to R >= 3.0.0 because gridToSVG() now calls grid.force() before export

• Removed several primToDev() methods:

• primToDev.xaxis()

• primToDev.yaxis()

• grobToDev.roundrect()

• grobToDev.frame()

• grobToDev.cellGrob()

• Bug fix for multi-line text when cex != 1

• Initial implementation of pattern fills. Define pattern fills using 'pattern' and 'registerPatternFill' (and also 'registerPatternFillRef' to reuse an existing definition). These can then be applied to grobs using 'grid.patternFill' and 'patternFillGrob'. (Simon)

• Add a graphics device-like interface to gridSVG. Use 'gridsvg' to open a gridSVG device, and 'dev.off' to close it. (Simon)

• Added new 'gridSVG.newpage' function. It will clear all definitions of referenced content as well as calling 'grid.newpage'. (Simon)

• Now allowing for a prefix to be applied to all SVG ID attributes. Particularly useful when including multiple gridSVG images in the same document as it ensures uniqueness of IDs between documents. This can be used by specifying the 'prefix' argument to 'grid.export'. (Simon)

• New optional parameter to 'grid.export', 'addClasses'. If this argument is 'TRUE', then gridSVG will add an SVG class attribute to each grob or viewport it draws. The value of this attribute is what is produced by calling 'class' on the object. This is useful for allowing a convenient way of selecting more than one type of grob (e.g. the '.axis' CSS selector will select all axis grobs). (Simon)

• Bug fix for pointsGrobs. 'size' units were unnecessarily being manipulated. They should now be sized more accurately. (Simon & Paul)

• Added support for non-rectangular clipping paths. Use 'grid.clipPath' and 'clipPathGrob' for applying clipping paths to grobs. Use 'pushClipPath' for applying to the current viewport, which behaves similarly to 'grid.clip'. Uses an object produced by 'clipPath' as the definition for the clipping path and is registered by calling 'registerClipPath'. (Simon)

• New function 'popContext', which stops the effect of 'pushMask' and 'pushClipPath'. (Simon)

• Bug fix for 'clipGrob's. Now unwinds only when a viewport is popped and just not any grouped content. (Simon)

• Added support for SVG filter effects. Create a filter effect by calling 'filterEffect' and adding as its children some of the various filter effect primitives by calling 'fe*' functions. Some of these filter effects are quite complicated so reading the function documentation and the SVG specification is required. Apply filter effects to grobs using 'grid.filter' and 'filterGrob'. (Simon)

• Bugfix for unit conversion functions. "svg" was not being handled correctly. (Simon)

• Bugfix for arrows. Definition now matches 'grid'. Now also handles the case when an arrow's line width is greater than its width/height (Firefox would not show the arrow prior to this fix). (Simon)

• Bugfix for polygons and xsplines. They should now handle the case where an 'id.length' is 0. (Simon)

• Plain SVG text can now be inserted into the image (in a similar manner to 'grid.element') using 'grid.textNode'. (Simon)

• Bugfix 'childrenOrder' is now respected for gTrees.

• Bugfix for colours. 0 is now valid (but transparent). (Simon)

• Fix for garnishing. They should now always be applied over the top of existing SVG attributes. (Simon)

• Bug fix for fill in arrow heads on xsplines (was being forced to transparent)

• Bug fix to trim identical values from start and end of xspline points (otherwise auto calculation of arrow orientation can get confused)

### Changes in version 1.1-0

• Added options for 'vpPath' and 'gPath' separators. This allows for easier manipulation in JavaScript as the separators no longer need to be the troublesome '::' (which require escaping with CSS selectors). (Simon)

• Exporting HTML files is now optional. (Simon)

• Always return a named list with the output of 'gridToSVG()'. This is invisibly returned when an SVG file is saved to disk. (Simon)

• Added 'usePaths' option for determining whether to use vpPaths and gPaths SVG IDs. (Simon)

• Added 'uniqueNames' option for generating unique names for SVG IDs from grob and viewport names. This further distances ourselves from the original grid names. (Simon)

• Added 'export.mappings' option for exporting name mapping information. This allows us to keep track of names and how they have been modified by gridSVG. (Simon)

• Added 'gridSVGMappings' function to import mapping information. (Simon)

• Added 'getSVGMappings' function to retrieve IDs generated for an image from a grob or a viewport name. Also exported are CSS selectors and XPath expressions. These can also be retrieved by 'getSVGMappings'. (Simon)

• Added new generic element interface, 'grid.element'. Allows any arbitrary SVG element (or tree of elements) to be inserted into the resulting SVG image. (Simon)

• When using the 'grep' argument for 'grid.hyperlink' and 'grid.garnish', we can now apply effects to multiple grobs where gPaths are regular expressions. (Simon)

• Added a new optional argument to 'gridToSVG', called 'annotate'. If 'TRUE', adds an SVG 'metadata' element below the root '<svg>' element that provides information on how 'gridToSVG' was called, along with metadata about gridSVG itself. Potentially useful for debugging. (Simon)

• Including support for 'clipGrob's. (Simon)

• Add support for 'gpar()'s 'lex' parameter. (Simon)

### Changes in version 1.0-0

• Initial implementation of viewport coordinate information exporting. (Simon)

• Added support for coordinate system importing and unit conversion. (Simon)

• Added support for exporting a JS file with utility functions present. Of note is that these include JS implementations of unit conversion routines. (Simon)

• Using viewport paths instead of viewport names for group elements. This causes us to refer to clipping paths and coordinate information based on the path. Viewport paths still have a numeric suffix. (Simon)

• Script MIME type updated to be more compatible with the SVG spec. (Simon)

• Added call to 'grid.refresh()' when running 'gridToSVG()' in order to avoid seeing a blank page. (Simon)

• Axis sub-grobs now adhere to the common gridSVG naming scheme. (Simon)

• All markup-based output is now written using the 'XML' package. (Simon)

• Added a new option to 'gridToSVG()', 'res'. This sets the device resolution so that we can reproduce plots regardless of the source device that 'gridToSVG()' grabs a grid scene from. (Simon)

• Added a new option to 'gridToSVG()', 'indent'. This either exports SVG with hierarchical indentation, or none at all. All output occurs in one line in the case that the 'indent' option is 'FALSE'. (Simon)

• Making the XML declaration optional. This means that inserting SVG straight into an HTML5 document is more easily done because the declaration is not necessary with inline SVG. (Simon)

• When the filename is set to 'NULL' or '""' return the SVG document as a list containing the root SVG node reference, coordinate data (list) and JS utility functions (character vector). (Simon)

• Use 'person()' in the DESCRIPTION file. (Simon)

• Reimplement 'pointsGrob's as SVG '<symbol>'s, referenced by '<use>' elements. Many more 'pch's are now animatable and drawable. Furthermore, the definitions of 'pch's now matches R's. (Simon)

• Use data URIs for 'rasterGrob's to embed images inline in SVG. Allows us to truly create standalone SVG files, rather than SVG with a lot of referenced PNGs. Lifted C code from the 'markdown' package (permissive licence) to do the job. Just keeping a very small subset of the C code ('markdown' does a lot of cool stuff that we don't need). (Simon)

• Bug-fix for 'gpar()'s, support 'font' as an alias for 'fontface'. In particular it affected some 'ggplot2' plots. (Simon)

• Adding in support for 'gtable' grobs as 'ggplot2' uses them. Requires borrowing code from 'gtable' to keep the package checker happy. (Simon)

• Small fix to avoid error from text justification outside the 0 to 1 range (by clamping justifications to the 0 to 1 range).

• Added 'viewBox' attribute to top-level <svg> element.

• Adding 'show' argument to 'grid.hyperlink()'. Allows links to opened in another window/tab rather than the current window/tab. (Simon).

• Added new functions to support global package options, plus created a global option to control the separator used when appending a number suffix to grob names for SVG element ids.

### Changes in version 0.9-4

• Added dependency on R >= 2.15.0

(plotmath location depends on 'grobAscent()')

• 'gridToSVG()' now copes with empty text, e.g., 'grid.text("")'.

SVG elements are still produced (so that there is something in the SVG doc that corresponds to the original grid grob), but nothing should be drawn when the SVG doc is viewed.

Reported by Gabriel Becker.

• 'gridToSVG()' no longer ignores 'hjust' and 'vjust' in 'grid.rect()'.

Reported by Gabriel Becker.

• Conversion of points grobs for 'pch=15:20' now sets colours correctly (used to be wrong if points grob did not have explicit 'gpar(col)' setting).

• Improved animation of x/y/size for points grobs.

Now works for pch=0,1,2, 5,6, 15–25

(i.e., does not work yet on symbols that are combinations of shapes)

• Fixed problem with raster aspect ratio.

• Fixed problem with animating raster grobs when width and/or height are not specified.

• Fixed bug in animating segments grobs (used to just not work).

• Added support for 'roundrect' grobs.

• Added support for 'move.to' and 'line.to' grobs.

• Rounding more SVG attributes to 2dp, only a few were missed earlier. (Simon)

• Points grobs for 'pch=15:20' now check whether there is an explicit 'gpar(col)'. If so, the fill is set to that, otherwise this is retrieved from the viewport. (Simon)

### Changes in version 0.9-0

• Added dependency on R >= 2.13.0

('grid.grab(wrap=true)' only works with bug fix in r54813).

• Replaced partially matching arguments with full argument names. (Simon)

• Added plotmath support (outputs MathML).

Note that positioning of MathML output is VERY unlikely to be accurate because there is not only the problem of font differences BUT ALSO the problem of a different math formula layout engine!

• Changed 'x11()' to 'dev.new()' in 'tests/*.R' code.

• Added animation support for polygon grobs and path grobs.

• Changed translation of rasterGrob grobs to SVG elements. They are now an '<image>' wrapped in two '<g>'s.

The outer '<g>' provides a translation; the inner '<g>' provides a scaling; and the image is at (0, 0) and size (1, 1). This allows for ...

• Added animation support for 'rasterGrob' grobs.

• Added animation support for 'xsplineGrob' grobs.

Note that closed xsplines are unlikely to animate smoothly (because the result is an animated '<path>' with a variable number of operations).

### Changes in version 0.8-0

• Started rounding all numeric values to 2 dp (in SVG output).

• Added 'animValue' and 'animUnit' classes to somewhat formalise the specification of animation values for attributes.

• Removed the 'id' argument from 'grid.animate()'.

• Added 'begin' argument to 'grid.animate()'.

• Added 'animation' vignette, which describes how to specify animation values for 'grid.animate()'.

• Named top-level gTree 'gridSVG' (and therefore '<g id="gridSVG">').

• Added 'inline' argument to 'grid.script()'.

• Added 'group' argument to 'grid.garnish()' so that attributes can be applied EITHER to the parent '<g>' (the default) OR to the individual child elements.

• Changed conversion of graphical parameters.

Instead of creating a single 'style' attribute in each element, now create individual SVG presentation attributes, like 'fill' and 'fill-opacity'.

Also, ONLY record explicit 'gp' settings, rather than ALWAYS recording ALL current settings for ALL elements.

• Modified 'grid.garnish()' so that we can garnish the same grob multiple times (without overwriting previous garnish).

• Modified 'grid.animate()' so that we can animate the same grob multiple times (without overwriting previous animation).

• Added 'group' argument to 'grid.animate()' so that animation can apply EITHER to the individual child elements (the default) OR to the parent '<g>'.

• Added vignette on extending the 'gridSVG' package.

'vignette("extensibility")'

• Added 'interpolate' argument to 'grid.animate()' (only currently supports 'linear' or 'discrete').

• Implemented animation for segments grobs.

• Improved recording of viewports and vpPaths, when depth is greater than 1 (e.g., a vpStack). Now all viewports (not just the last one) are recorded as '<g>' elements.

### Changes in version 0.7-0

• Added support for polyline grobs (Simon)

• Polygon grobs now respect the 'id' parameter (Simon)

• Semi-transparent colours can now be applied, making use of SVG's 'fill-opacity', 'stroke-opacity' and 'opacity' attributes. (Simon)

• xsplines can be drawn. Currently uses the '<polyline>' or '<path>' elements depending on whether the xspline is open or closed. (Simon)

• Lines, segments, polylines and xsplines now support the arrow parameter. (Simon)

• Grobs that produce multiple SVG elements now wrap the multiple elements in a '<g>' with the original grob name on the '<g>' and the multiple elements name-mangled with an integer suffix. (Simon)

• Multiline text support added. (Simon)

• Text with multiple labels no longer draw all labels at each location. (Simon)

• Line properties such as 'linejoin' and 'lineend' are now understood. (Simon)

• The 'gpar()' properties 'font'/'fontface' and 'fontfamily' are now supported. 'fontface' has a direct mapping to CSS, but 'fontfamily' is a little bit more messy. 'fontfamily' has to specify fallback fonts if none are present in the browser. The 'serif', 'sans' and 'mono' families are given a reasonable attempt. (Simon)

• Naming of grobs has been refactored into a function call 'subGrobName()'. To get the base name of the grob again, use 'baseGrobName()'. This allows an easier switch to a different naming scheme if necessary. (Simon)

• Initial support for 'frameGrob's (and 'cellGrob's). (Simon)

• Numerical justification of text is supported. Justification parameters are rounded so they belong to one of 0, 0.5, 1. (Simon)

• 'gTree' support has been improved, all 'lattice' demos can now be drawn, along with some 'ggplot2' plots (assuming 'pch's are supported). (Simon)

• The HTML file that is produced now rounds the 'height' and 'width' attributes to the nearest integer to avoid scrollbars becoming visible. (Simon)

• Warnings are no longer produced regarding unclosed connections. (Simon)

• 'pch's 0:25 and 32:127 are supported. (Simon)

• Clipping to viewports is now possible. This occurs at the group level so that when a viewport is pushed to, its name is now suffixed with the number of the viewport that has been pushed to. (Simon)

### Changes in version 0.6-0

• Updated for the fact that the R graphics engine now supports complex paths.

• Removed 'grid.path()' and 'pathGrob' from this package (now in 'grid' package).

• Removed 'svgGrobify()' (the normal 'grobify()' in 'grImport' now handles complex paths).

• Tweaked passage of 'grid' pathgrob through generic device to SVG device.

### Changes in version 0.5-10

• Conversion of 'gpar()' to SVG CSS now recognises 'fillrule' (so that pathgrobs [and polygons] can specify "nonzero" or "evenodd")

• 'svgGrobify()' passes 'object@rule' from PictureFill objects to 'gpar()' so that 'fill' and 'eofill' from imported images will be represented by appropriate paths in SVG.

• The current locale encoding (i.e., the encoding used to write the SVG file) is now recorded in the SVG file.

### Changes in version 0.5-8

The following changes occurred between versions 0.5-3 and 0.5-8.

• Added 'redraw' argument to 'grid.garnish()'

• Improved sizing of text (especially when it is controlled via 'cex')

• Correction for rotated text (SVG measures angles clock-wise)

• Improved recording of SVG 'style' attribute so that it handles vectorized settings better.

• Improved recording of 'lty' setting in SVG output.

• Forced ALL gpar settings from grid to SVG output (i.e., no longer have to EXPLICITLY set gpars).

• Added checks for XML specials when producing SVG output.

• Improved sizing of text (and line widths) to be responsive to device resolution.

• Added 'grid.path()' and 'pathGrob()' which can be used to draw polygons with holes (when producing SVG output).

• Added 'svgGrobify()' which uses 'pathGrob()' when converting a Picture from 'grImport' to grobs.

### Changes in version 0.4

• Updated properly for R 2.0.0

Hyperlinks work the same as before, but Animation now works differently: you animate an entire grob rather than an individual unit.

• Integrated changes from Nathan Whitehouse and colleagues to support arbitrary SVG attributes and script chunks.

• SVG shape chunks now use grid grob names for the id attribute.

If more than one chunk is produced then a 1:n suffix is attached. For example, 'grid.circle(r=1:4/8, name="circgrob")' produces four '<circle>' chunks with id's "circle1" to "circle4", but 'grid.rect(name="rectgrob")' produces a single '<rect>' chunk with id "rectgrob".