R: Record and Replay Plots

recordPlot {grDevices} | R Documentation

## Record and Replay Plots

### Description

Functions to save the current plot in an R variable, and to replay it.

### Usage

    recordPlot()
    replayPlot(x)

### Arguments

`x` | A saved plot.

### Details

These functions record and replay the displaylist of the current graphics device. The returned object is of class `"recordedplot"`, and `replayPlot` acts as a `print` method for that class.

The returned object is stored as a pairlist, but the usual methods for examining R objects such as `deparse` and `str` are liable to mislead.

### Value

`recordPlot` returns an object of class `"recordedplot"`.

`replayPlot` has no return value.

### Warning

The format of recorded plots may change between R versions. Recorded plots can not be used as a permanent storage format for R plots. There were extensive changes in R 3.0.0, and now only plots from the current session can be replayed.

### See Also

The displaylist can be turned on and off using `dev.control`. Initially recording is on for screen devices, and off for print devices.

[Package grDevices version 3.1.2 Index]