\HeaderA{grid.newpage}{Move to a New Page on a Grid Device}{grid.newpage}
\keyword{dplot}{grid.newpage}
\begin{Description}\relax
This function erases the current device or moves to a new page.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.newpage(recording = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{recording}] A logical value to indicate whether the new-page
operation should be saved onto the Grid display list.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The new page is painted with the fill colour
(\code{\LinkA{gpar}{gpar}("fill")}), which is often transparent.  For devices
with a \emph{canvas} colour (the on-screen devices \code{X11},
\code{windows} and \code{quartz}), the page is first painted with the
canvas colour and then the background colour.

There is a hook called \code{"grid.newpage"} (see \code{\LinkA{setHook}{setHook}})
which 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, \code{get} is called on it from within the \pkg{grid}
name space.)
\end{Details}
\begin{Value}
None.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\LinkA{Grid}{Grid}
\end{SeeAlso}

