graph2bitmap: Save currently active R graph to bitmap format

In export: Streamlined Export of Graphs and Data Tables

Save currently active R graph to bitmap format

Description

Save the currently active R graph or a graph passed as an object or function to bitmap format with sensible defaults

Usage

graph2bitmap(
  x = NULL,
  file = "Rplot",
  fun = NULL,
  type = c("PNG", "JPG", "TIF"),
  aspectr = NULL,
  width = NULL,
  height = NULL,
  dpi = 300,
  scaling = 100,
  font = ifelse(Sys.info()["sysname"] == "Windows", "Arial", "Helvetica")[[1]],
  bg = "white",
  cairo = TRUE,
  tiffcompression = c("lzw", "rle", "jpeg", "zip", "lzw+p", "zip+p"),
  jpegquality = 99,
  ...
)

graph2png(...)

graph2tif(...)

graph2jpg(...)

Arguments

x	given ggplot2 plot or lattice plot object to export; if set to NULL the currently active R graph will be exported; not supported for base R plots.
file	name of output file. Any extension is ignored and added according to the requested output type. If file already exists it is overwritten.
fun	plot passed on as a function used to create it; useful especially for base R plots.
type	desired output type - PNG, TIF or JPG are currently supported. PNG is the preferred format, as it is a lossless format, and compresses better than TIF.
aspectr	desired width to height aspect ratio. If set to NULL, the aspect ratio of the graphics device is used. Can also be combined with one value for either the desired width or height of the graph.
width	desired width in inches; can be combined with a desired aspect ratio aspectr.
height	desired height in inches; can be combined with a desired aspect ratio aspectr.
dpi	desired output in dpi; defaults to 600 dpi.
scaling	scale width & height by a certain percentage.
font	desired font to use for labels in PNG and TIFF output; defaults to "Arial" on Windows systems and to "Helvetica" on other systems.
bg	desired background colour, e.g. "white" or "transparent".
cairo	logical, specifying whether or not to use Cairographics for export.
tiffcompression	compression to use for TIF files.
jpegquality	quality of JPEG compression.
...	any other options are passed on to grDevices' png, tiff, or jpeg function (according to the supplied type).

Value

No return value

Functions

• graph2png(): Save currently active R graph to png file

• graph2tif(): Save currently active R graph to TIF file

• graph2jpg(): Save currently active R graph to JPEG file

Author(s)

Tom Wenseleers

See Also

graph2office, graph2vector, graph2svg, graph2pdf, graph2eps

Examples

# Create a file name
filen <- tempfile(pattern = "ggplot") 
# or 
# filen <- paste("YOUR_DIR/ggplot")

# Generate graphical output
library(ggplot2)
library(datasets)
x <- qplot(Sepal.Length, Petal.Length, data = iris, 
           color = Species, size = Petal.Width, alpha = I(0.7))
plot.fun <- function() {
  print(qplot(Sepal.Length, Petal.Length, data = iris, 
              color = Species, size = Petal.Width, alpha = 0.7))
}

# There are 3 ways to use graph2bitmap():
### 1. Pass the plot as an object
graph2png(x = x, file = filen, dpi = 400, height = 5, aspectr = 4)
graph2tif(x = x, file = filen, dpi = 400, height = 5, aspectr = 4)
graph2jpg(x = x, file = filen, dpi = 400, height = 5, aspectr = 4)
### 2. Get the plot from current screen device
x
graph2png(file = filen, dpi = 400, height = 5, aspectr = 4)
graph2tif(file = filen, dpi = 400, height = 5, aspectr = 4)
graph2jpg(file = filen, dpi = 400, height = 5, aspectr = 4)
### 3. Pass the plot as a function
graph2png(file = filen, fun = plot.fun, dpi = 400, height = 5, aspectr = 4)
graph2tif(file = filen, fun = plot.fun, dpi = 400, height = 5, aspectr = 4)
graph2jpg(file = filen, fun = plot.fun, dpi = 400, height = 5, aspectr = 4)

export documentation built on Dec. 7, 2022, 5:13 p.m.