\HeaderA{grid.display.list}{Control the Grid Display List}{grid.display.list}
\aliasA{engine.display.list}{grid.display.list}{engine.display.list}
\keyword{dplot}{grid.display.list}
\begin{Description}\relax
Turn the Grid display list on or off.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.display.list(on=TRUE)
engine.display.list(on=TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{on}] A logical value to indicate whether the display list
should be on or off.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
All drawing and viewport-setting operations are (by default)
recorded in the Grid display list.  This allows redrawing
to occur following an editing operation.

This display list could get very large so it may be useful to
turn it off in some cases;  this will of course disable redrawing.

All graphics output is also recorded on the main display list
of the R graphics engine (by default).  This supports redrawing
following a device resize and allows copying between devices.

Turning off this display list means that grid will redraw from its
own display list for device resizes and copies.  This will be slower
than using the graphics engine display list.
\end{Details}
\begin{Value}
None.
\end{Value}
\begin{Section}{WARNING}
Turning the display list on causes the display list to be erased!

Turning off both the grid display list and the graphics engine
display list will result in no redrawing whatsoever.
\end{Section}
\begin{Author}\relax
Paul Murrell
\end{Author}

