1% File src/library/grid/man/grid.display.list.Rd
2% Part of the R package, https://www.R-project.org
3% Copyright 1995-2007 R Core Team
4% Distributed under GPL 2 or later
5
6\name{grid.display.list}
7\alias{grid.display.list}
8\alias{engine.display.list}
9\title{Control the Grid Display List}
10\description{
11  Turn the Grid display list on or off.
12}
13\usage{
14grid.display.list(on=TRUE)
15engine.display.list(on=TRUE)
16}
17\arguments{
18  \item{on}{A logical value to indicate whether the display list
19    should be on or off.}
20}
21\details{
22  All drawing and viewport-setting operations are (by default)
23  recorded in the Grid display list.  This allows redrawing
24  to occur following an editing operation.
25
26  This display list could get very large so it may be useful to
27  turn it off in some cases;  this will of course disable redrawing.
28
29  All graphics output is also recorded on the main display list
30  of the R graphics engine (by default).  This supports redrawing
31  following a device resize and allows copying between devices.
32
33  Turning off this display list means that grid will redraw from its
34  own display list for device resizes and copies.  This will be slower
35  than using the graphics engine display list.
36}
37\value{
38  None.
39}
40\author{Paul Murrell}
41
42\section{WARNING}{
43  Turning the display list on causes the display list to be erased!
44
45  Turning off both the grid display list and the graphics engine
46  display list will result in no redrawing whatsoever.
47}
48\keyword{dplot}
49