ggrasterize: Rasterize ggplot panel area

View source: R/plots.R

ggrasterizeR Documentation

Rasterize ggplot panel area

Description

Draws the panel area of a ggplot to a png file, and then re-draws it as raster to the current device. There is also an option to save the result to a file (if filename is not NULL).

Usage

ggrasterize(
  plot = ggplot2::last_plot(),
  filename = NULL,
  device = NULL,
  path = NULL,
  scale = 1,
  width = NA,
  height = NA,
  dpi = 300,
  units = c("in", "cm", "mm"),
  limitsize = TRUE,
  ...
)

Arguments

plot

Plot to save, defaults to last plot displayed.

filename

File name to create on disk.

device

Device to use. Can either be a device function (e.g. png), or one of "eps", "ps", "tex" (pictex), "pdf", "jpeg", "tiff", "png", "bmp", "svg" or "wmf" (windows only). If NULL (default), the device is guessed based on the filename extension.

path

Path of the directory to save plot to: path and filename are combined to create the fully qualified file name. Defaults to the working directory.

scale

Multiplicative scaling factor.

width, height

Plot size in units expressed by the units argument. If not supplied, uses the size of the current graphics device.

dpi

Plot resolution. Also accepts a string input: "retina" (320), "print" (300), or "screen" (72). Applies only to raster output types.

units

One of the following units in which the width and height arguments are expressed: "in", "cm", "mm" or "px".

limitsize

When TRUE (the default), ggsave() will not save images larger than 50x50 inches, to prevent the common error of specifying dimensions in pixels.

...

Other arguments passed on to the graphics device function, as specified by device.

See Also

ggsave

Examples

## Not run: 
library(ggplot2)
p <- ggplot(mtcars, aes(mpg, wt)) +
    geom_point()
ggrasterize(p)

# save to a pdf file
ggrasterize(p, "myfile.pdf")

## End(Not run)


tanaylab/tgutil documentation built on March 16, 2024, 12:07 a.m.