\HeaderA{frame}{Create / Start a New Plot Frame}{frame}
\aliasA{plot.new}{frame}{plot.new}
\keyword{iplot}{frame}
\keyword{aplot}{frame}
\begin{Description}\relax
This function (\code{frame} is an alias for
\code{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.
\end{Description}
\begin{Usage}
\begin{verbatim}
plot.new()
frame()
\end{verbatim}
\end{Usage}
\begin{Details}\relax
The new page is painted with the background colour
(\code{\LinkA{par}{par}("bg")}), which is often transparent.  For devices
with a \emph{canvas} colour (the on-screen devices \code{X11},
\code{windows} and \code{quartz}), the window is first painted with the
canvas colour and then the background colour.

There is a hook called \code{"plot.new"} (see \code{\LinkA{setHook}{setHook}})
called immediately after advancing the frame, 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{graphics} name space.)
\end{Details}
\begin{References}\relax
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
\emph{The New S Language}.
Wadsworth \& Brooks/Cole. (\code{frame}.)
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{plot.window}{plot.window}}, \code{\LinkA{plot.default}{plot.default}}.
\end{SeeAlso}

