R: Create / Start a New Plot Frame

frame {graphics} | R Documentation

## Create / Start a New Plot Frame

### Description

This function (`frame` is an alias for `plot.new`) causes the completion of plotting in the current plot (if there is one) and an advance to a new graphics frame. This is used in all high-level plotting functions and also useful for skipping plots when a multi-figure region is in use.

### Usage

    plot.new()
    frame()

### Details

The new page is painted with the background colour (`par("bg")`), which is often transparent. For devices with a canvas colour (the on-screen devices `X11`, `windows` and `quartz`), the window is first painted with the canvas colour and then the background colour.

There are two hooks called `"before.plot.new"` and `"plot.new"` (see `setHook`) called immediately before and after advancing the frame. The latter is used in the testing code to annotate the new page. The hook function(s) are called with no argument. (If the value is a character string, `get` is called on it from within the graphics namespace.)

### References

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole. (`frame`.)

### See Also

`plot.window`, `plot.default`.

[Package graphics version 3.1.2 Index]