ggSave: Save a ggplot with specific defaults

In ufs: A Collection of Utilities

Save a ggplot with specific defaults

Description

This function is vectorized over all argument except 'plot': so if you want to save multiple versions, simply provide vectors. Vectors of length 1 will be recycled using rep(); otherwise vectors have to all be the same length as file.

Usage

ggSave(
  file = NULL,
  plot = ggplot2::last_plot(),
  width = ufs::opts$get("ggSaveFigWidth"),
  height = ufs::opts$get("ggSaveFigHeight"),
  units = ufs::opts$get("ggSaveUnits"),
  dpi = ufs::opts$get("ggSaveDPI"),
  device = NULL,
  type = NULL,
  bg = "transparent",
  preventType = ufs::opts$get("ggSavePreventType"),
  ...
)

Arguments

file	The file where to save to.
plot	The plot to save; if omitted, the last drawn plot is saved.
height, width	The dimensions of the plot, specified in units.
units	The units, 'cm', 'mm', or 'in'.
dpi	The resolution (dots per inch). This argument is vectorized.
device	The graphic device; is inferred from the file if not specified.
type	An additional arguments for the graphic device.
bg	The background (e.g. 'white').
preventType	Whether to prevent passing a value for the type argument to ggplot2::ggsave(). This is prevented by default since ggplot2::ggplot() switched to using the ragg device by default, resulting in throwing a warning ("Warning: Using ragg device as default. Ignoring type and antialias arguments") if something if passed for 'type'.
...	Any additional arguments are passed on to ggplot2::ggsave().

Value

The plot, invisibly.

Examples

plot <- ufs::ggBoxplot(mtcars, 'mpg');
ggSave(file=tempfile(fileext=".png"), plot=plot);

ufs documentation built on May 29, 2024, 10:30 a.m.