\HeaderA{push.viewport}{Push a Viewport onto the Grid Viewport Stack}{push.viewport}
\keyword{dplot}{push.viewport}
\begin{Description}\relax
Grid maintains a viewport stack --- a list of nested drawing
contexts.

This function makes the specified viewport the default viewport
and makes its parent the previous default viewport (i.e.,
nests the specified context within the previous default context).
\end{Description}
\begin{Usage}
\begin{verbatim}
push.viewport(..., recording=TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{...}] One or more objects of class \code{"viewport"}, or
\code{NULL}.
\item[\code{recording}] A logical value to indicate whether the set-viewport
operation should be recorded on the Grid display list.
\end{ldescription}
\end{Arguments}
\begin{Value}
None.
\end{Value}
\begin{Section}{Warning}
This function has been deprecated.  Please use \code{pushViewport}
instead.
\end{Section}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{pop.viewport}{pop.viewport}}.
\end{SeeAlso}

