| grid.newpage {grid} | R Documentation |
Move to a New Page on a Grid Device
Description
This function erases the current device or moves to a new page.
Usage
grid.newpage(recording = TRUE, clearGroups = TRUE)
Arguments
recording |
A logical value to indicate whether the new-page operation should be saved onto the Grid display list. |
clearGroups |
A logical value indicating whether any groups
that have been defined on the current page should be
released (see |
Details
The new page is painted with the fill colour
(gpar("fill")), which is often transparent. For devices
with a canvas colour (the on-screen devices X11,
windows and quartz), the page is first painted with the
canvas colour and then the background colour.
There are two hooks called "before.grid.newpage" and
"grid.newpage" (see setHook). 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 grid
namespace.)
Value
None.
Author(s)
Paul Murrell