R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Save the contents of the current graphics device to a file

savepng

R Documentation

Save the contents of the current graphics device to a file

Description

Save the contents of the current graphics device to file

Usage

  savepdf(fn, dir, width=6, asp=1)
  saveeps(fn, dir, width=6, asp=1) 
  savepng(fn, dir, width=480, asp=1)
  savetiff(fn, dir, density=360, keeppdf=TRUE, ...)

Arguments

`fn`	character: name of the output file (without extension). An extension `.pdf`, `.eps`, `.png`, or `.tiff` will be added automatically.
`dir`	character: directory to which the file should be written.
`width`	numeric: width of the image in pixels (png) or inches (pdf, eps).
`asp`	numeric: aspect ratio; height=width*asp.
`density`	pixels per inch (see Details).
`keeppdf`	Should the intermediate PDF file (see Details) be kept? If `FALSE`, it is deleted before the function returns.
`...`	Further arguments that are passed on to `savepdf` (see Details).

Details

The functions are called for their side effect, writing a graphics file.

savepdf, savepng, and saveeps use the devices pdf, png, and postscript, respectively.

There is currently no TIFF device for R, so savetiff works differently. It relies on the external tool convert from the ImageMagick software package. First, savetiff produces a PDF files with savepdf, then uses system to invoke convert with the parameter density. savetiff does not check for the existence of convert or the success of the system call, and returns silently no matter what.

Value

Character: name of the file that was written.

Author(s)

Wolfgang Huber http://www.dkfz.de/abt0840/whuber

Examples

  x = seq(0, 20*pi, len=1000)
  plot(x*sin(x), x*cos(x), type="l")

  try({   ## on some machines, some of the devices may not be available
    c(
      savepdf("spiral", dir=tempdir()),
      savepng("spiral", dir=tempdir()),
      saveeps("spiral", dir=tempdir()),
      savetiff("spiral", dir=tempdir())
     )
  })

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(geneplotter)
Loading required package: Biobase
Loading required package: BiocGenerics
Loading required package: parallel

Attaching package: 'BiocGenerics'

The following objects are masked from 'package:parallel':

    clusterApply, clusterApplyLB, clusterCall, clusterEvalQ,
    clusterExport, clusterMap, parApply, parCapply, parLapply,
    parLapplyLB, parRapply, parSapply, parSapplyLB

The following objects are masked from 'package:stats':

    IQR, mad, xtabs

The following objects are masked from 'package:base':

    Filter, Find, Map, Position, Reduce, anyDuplicated, append,
    as.data.frame, cbind, colnames, do.call, duplicated, eval, evalq,
    get, grep, grepl, intersect, is.unsorted, lapply, lengths, mapply,
    match, mget, order, paste, pmax, pmax.int, pmin, pmin.int, rank,
    rbind, rownames, sapply, setdiff, sort, table, tapply, union,
    unique, unsplit

Welcome to Bioconductor

    Vignettes contain introductory material; view with
    'browseVignettes()'. To cite Bioconductor, see
    'citation("Biobase")', and for packages 'citation("pkgname")'.

Loading required package: lattice
Loading required package: annotate
Loading required package: AnnotationDbi
Loading required package: stats4
Loading required package: IRanges
Loading required package: S4Vectors

Attaching package: 'S4Vectors'

The following objects are masked from 'package:base':

    colMeans, colSums, expand.grid, rowMeans, rowSums

Loading required package: XML
> png(filename="/home/ddbj/snapshot/RGM3/R_BC/result/geneplotter/savepng.Rd_%03d_medium.png", width=480, height=480)
> ### Name: savepng
> ### Title: Save the contents of the current graphics device to a file
> ### Aliases: savepdf saveeps savepng savetiff
> ### Keywords: programming error
> 
> ### ** Examples
> 
>   x = seq(0, 20*pi, len=1000)
>   plot(x*sin(x), x*cos(x), type="l")
> 
>   try({   ## on some machines, some of the devices may not be available
+     c(
+       savepdf("spiral", dir=tempdir()),
+       savepng("spiral", dir=tempdir()),
+       saveeps("spiral", dir=tempdir()),
+       savetiff("spiral", dir=tempdir())
+      )
+   })    
   **** Warning:  Invalid Page count.
   **** Warning:  Invalid Page count.
   No pages will be processed (FirstPage > LastPage).

   **** This file had errors that were repaired or ignored.
   **** The file was produced by: 
   **** >>>> R 3.3.1 <<<<
   **** Please notify the author of the software that produced this
   **** file that it does not conform to Adobe's published PDF
   **** specification.

convert: no images defined `/tmp/RtmpQbV9Bs/spiral.tiff' @ error/convert.c/ConvertImageCommand/3210.
[1] "/tmp/RtmpQbV9Bs/spiral.pdf"  "/tmp/RtmpQbV9Bs/spiral.png" 
[3] "/tmp/RtmpQbV9Bs/spiral.eps"  "/tmp/RtmpQbV9Bs/spiral.tiff"
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>