NEWS.md
Added support for specifying alternative device types, e.g. "png|cairo_png" will use the "png" type if available, otherwise the "cairo_png" type. If neither are available, an informative error message is produced.
Added support for device alias types, e.g. "{png}" expands to "png|cairo_png|CairoPNG|png2".
as.architecture() did not always return the expected arch.as.architecture() for recordedplot would produce “Error in !is.na(arch) && !is.na(arch$arch) : ‘length(x) = 4 > 1’ in coercion to ‘logical(1)’” with environment variable _R_CHECK_LENGTH_1_LOGIC2_=true set.
getDevOption() could produce “Error in is.character(type) && type !=”*” : ‘length(x) = 3 > 1’ in coercion to ‘logical(1)’” with environment variable _R_CHECK_LENGTH_1_LOGIC2_=true set.
Add support for RStudio’s RStudioGD device, e.g. toRStudioGD() and devEval() with type = "RStudioGD".
Added a "null" graphics device, nulldev(), that voids all graphics output. It may also be opened by devNew("nulldev"). devEval("nulldev", <expr>), and toNullDev(<expr>), which will evaluate the expression while at the same time drop any plot output.
Added suppressGraphics().
Calling devNew(type, ..., aspectRatio) with type being a function and neither width nor height could be inferred from the devices type generated an error when trying to generate a warning.
TESTS: Don’t test as.architecture() on recordedplot objects that require coercion between endianess, which is yet not supported.
Printing a plot recorded by capturePlot() now automatically falls back to replaying it coerced to the current machine’s architecture if the default replay fails.
Added as.architecture() for recordedplot objects to make it easy to coerce between 32-bit and 64-bit versions of a serialized recorded plot (e.g. via capturePlot()) so that it can be replotted everywhere.
capturePlot() making it possible to capture low-level plot commands using grDevices::recordPlot() such that the plot can be displayed / regenerated elsewhere, e.g. in a different / future R session. Requires R (>= 3.3.0).requireNamespace().capabilitiesX11().toX11() gave error “Device type ‘X11’ is not known/supported”.
devOptions(grDevices::png) returned devOptions("favicon") - not devOptions("png") as expected.
devEval() on multiple devices then underlying graphics device functions no longer gives an error of unknown arguments, which means it is now possible to pass device specific arguments also when in multi-device calls, e.g. devEval(c("x11", "png"), res = 100, { plot(1:10) }).devNew("quartz", which = "foo") could set the label of device #1(!) when quartz devices was not supported. This was because quartz() only gives a warning (and not an error) when it is not supported, so the internal code thought the devices was successfully opened.
Renaming incomplete files gave an error if there were already files renamed for similar reasons. Added package test.
devEval(type, ...) gave ‘Error in strsplit (type, split = “|”, fixed = TRUE’ if type was a device function. Added package tests showing that it’s possible to do devEval(type = grDevices::png, ext = "png", plot(1:10)) in addition to devEval(type = "png", ext = "png", plot(1:10)).
requireNamespace() instead of require() internally.DEVICES: Added support for all Cairo* devices of the Cairo package.
DEVICES: Added favicon() device, which is a wrapper for png() with bells and whistles. It has its own device options. Updated toFavicon() to use default argument field = "htmlscript", which generates an HTML script that dynamically sets the favicon.
Several functions now supports specifying device type names by regular expressions, e.g. devOptions("cairo_.*") and devEval("cairo_.*", name = "foo", { plot(1:10) }). The latter will output one image file for each available cairo_.* device.
Added support for “global” device options to fall back on if no set for the device type queried, e.g. devOptions("*", pointsize = 14).
Now arguments sep, path, field and force for devEval() and the various toNNN() functions now utilizes getDevOption(), which is still backward compatibility with the old style R options.
Now devIsInteractive() without arguments returns all known interactive devices.
ROBUSTNESS: Now package does a better job of checking whether a particular device is supported on the current system, cf. capabilities() and Cairo::Cairo.capabilities().
Cleanup: Dropped argument field for toNNN(), because the default is now NULL which corresponds to returning a DevEvalProduct object. In turn, this object has the pathname as it’s value, which was the previous default field value. Also, as.character() on this object returns the (relative) pathname.
Cleanup: All old-style R options (e.g. devEval/args/field) have been deprecated. They will still work for a while but it is recommended to set them as devOptions("*", field = ...) instead.
devDone() would close some devices despite them being on screen/interactive devices, e.g. an x11 device.
devNew(x11) on Unix/Linux where the default width or height failed to be inferred would throw an error reporting on “cannot coerce type ‘closure’ to vector of type ‘character’”.
withPar() also resets all the graphical parameters available upon entry even if no explicit ones were specified. This covers the case when expr changes the parameters, e.g. withPar({ par(cex = 2L); plot(1:10) }).Now getPathname(..., relative = FALSE) returns the absolute pathname.
devOptions() returned the incorrect options for device types "eps", "jpg2", and "png2", if package was not attached.
getDevOption().On Windows, devOptions() assumed that the grDevices package was attached.
devOptions(type, name = NULL) did not assign the option NULL.
devDump() fell back on option devDump/args/path, but that would never happen. Dropping that option.
*devEval("cairo_pdf", ...) for generate an image file with a *.cairo_pdf filename extension. Now devEval(..., ext = NULL) does a better job of inferring the default extension from the device type.
devOptions().getData() to DevEvalFileProduct.devEval() to try multiple device types one-by-one until success, e.g. devEval("png|jpg|bmp", ...).field for toNNN() from "fullname" to "pathname" as in getOption("devEval/args/field", "pathname"). This should work for most compilers including LaTeX, although for the latter it is preferred to use "fullname". See the package vignette for details.withPar() for plotting with temporarily set graphical parameters.Added toDefault() for plotting to the default device analogously to how the other toNNN() device functions works. Likewise, added toX11(), toWindows(), toQuartz(), toCairoWin(), toCairoX11(), and toJavaGD() for plotting to interactive/screen devices.
Now it’s possible to use devEval() to open a new or activate an existing interactive/screen device.
Added support for (hidden) argument which to devNew(), such that devNew(type, which = which) avoids opening a new device iff an existing device of the same device type and index/label already is opened. For instance, calling devNew("X11", which = "foo") will open an X11 device and label it foo. Subsequent calls will set the focus that same device.
asDataURI() for converting an image file to an Base64-encoded data URI character string.toFavicon() for outputting figures as HTML favicons.devDump() is in the local one.Added devDump() which is short for calling devEval(c("png", "pdf"), ..., which = devList(interactiveOnly = TRUE)), i.e. it copies the content of open interactive (“screen”) devices.
Added argument interactiveOnly to devList().
If expr is missing, devEval() copies the current active device and devEval(which = devList()) copies all open devices. For example, plot(1:10); devEval(c("png", "jpg", "pdf"), name = "myfig").
devSet(which) where which is a very large number could leave lots of stray temporary devices open when error “too many open devices” occurred. Now all temporary devices are guaranteed to be closed also when there is an error.
devIsOpen(), dev(Get|Set)Label(which) would not handle the case when the device was specified by an numeric which and there is a gap in the device list.
devSet() guarantees to close all temporary devices it opens.devSet().GENERALIZATION: Vectorized devEval(), e.g. it is now possible to do devEval(c("png", "pdf"), name = "MyPlot", { plot(1:10) }). Added arguments initially and finally to devEval(). Contrary to expr which is evaluated for each graphics type/device, these are evaluated only once per call. This makes it possible to avoid repeating expensive computations.
GENERALIZATION: Vectorized devIsInteractive(), devIsOpen(), devGetLabel(), devOff(), and devDone().
Now devOff() and devDone() checks if device is opened before trying to close it. This avoids opening and closing of non-opened devices.
Updated the formal defaults of several devEval() arguments to be NULL. Instead, NULL for such arguments are translated to default internally. This was necessary in order to vectorize devEval().
CONSISTENCY: Now devList() returns an empty integer vector (instead of NULL) if no open devices exists.
ROBUSTNESS: The device functions that are not vectorize do now throw an informative error if passed a vector.
Now the R.devices Package object is also available when the package is only loaded (but not attached).
getDataURI() throws an Exception is suggested package base64enc is not installed.Added support for retrieving a Base64-encoded data URI string from a DevEvalFile.
Added classes DevEvalProduct and DevEvalFileProduct, which are returned by devEval().
ext of devEval() can now be inferred from argument type also when type is passed via a string variable.Added support the win.metafile (WMF) device type and added toWMF() creating (extended) WMF files. Since the file format is extended WMF, which often has file extension .emf, toEMF() was also added. toEMF() uses the same device driver as toWMF() with the only difference that the file extension is .emf instead of *.wmf.
Now devOptions() can query the options of multiple device types. Added arguments options and drop to devOptions().
Now devEval() returns a list of class DevEvalFile.
sep to devEval() together with an option to set its default value.Now devNew() returns the index of the opened device.
Now devEval() and devNew(), and hence toPNG() and so on, can be called without attaching the package, e.g. R.devices::toPNG().
devEval() does a better job of making sure to close the same device as it opened. Previously it would close the current active device, which would not be the correct one if for instance other devices had been open in the meanwhile/in parallel.CONSISTENCY: Now using throw() instead of stop() everywhere.
Only importing what is necessary from R.methodsS3 and R.oo.
Made all integer constants truly integers.
Fixed minor typo in the vignette.
In help(devEval) the link to help(devNew) was broken.
devOptions() returns options invisibly if some options were set, otherwise not, e.g. devOptions() versus devOptions("png", width = 1024).Created package by extracting all methods in R.utils v1.9.1 that are related to graphical devices.
The below change log shows the changes to the device methods while they were in R.utils. For this reason, we choose to set the version of this package such that it starts where we left R.utils.
Added devOptions().
Added default width and height values to eps().
Turned png2() and jpeg2() into plain functions without a generic. This is consistent with how eps() is defined.
Now the default width is inferred from devOptions() if needed.
help(devEval).field to devEval().devNew() no longer gives a warning about argument aspectRatio is specified when both or neither of width and height are given, and aspectRatio == 1.force of devEval() defaults to getOption("devEval/args/force", TRUE).devNew() gained option devNew/args/par, which can be used to specify the default graphical parameters for devNew(). Any additional parameters passed via argument par will override such default ones, if both specifies the same parameter.
The automatic archiving of devEval() is not considered unless the R.archive package is loaded, regardless of option settings.
help(devDone) was incorrect.which to devSet() can be any object. If not a single numeric or a single character string, then a checksum character string is generated using digest::digest(which).type of devNew() did not take function:s.devNew() filters out arguments file and filename if the device is interactive.devGetLabel() and devSetLabel() gets and sets the label of a give device. devList() lists the indices of existing device named by their labels, cf. dev.list(). The functions devSet() and devOff() work like dev.set() and dev.off() but accept labels as well. Furthermore, devSet(idx) will open a device with index idx if it does not exists, and devSet(label) a device with that label if not already opened. The devIsOpen() checks if a device is open or not. The devDone() function calls devOff() except for screen devices.eps() had extension *.ps not *.eps.