\Header{grid.grob}{Create a Grid Graphical Object}
\keyword{dplot}{grid.grob}
\begin{Description}\relax
Creates a Grid graphical object.\end{Description}
\begin{Usage}
\begin{verbatim}
grid.grob(list.struct, cl = NULL, draw = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{list.struct}] A list (preferably with each element named).
\item[\code{cl}] A string giving the class attribute for the \code{list.struct}
\item[\code{draw}] A logical value to indicate whether to produce
graphical output.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
A Grid graphical object provides a pointer to the
\code{list.struct}.  This has the important consequence that
copies of the graphical object refer to the same \code{list.struct}.

All Grid primitives (\code{grid.lines}, \code{grid.rect}, ...) and
some higher-level Grid functions (e.g., \code{grid.xaxis} and
\code{grid.yaxis}) return graphical objects.

Grid provides several useful functions for graphical objects
(e.g., \code{grid.draw} and \code{grid.edit}) which are designed to make
it easier to produce new graphical objects.\end{Details}
\begin{Value}
An object of class \code{"grob"}.\end{Value}
\begin{Author}\relax
Paul Murrell\end{Author}
\begin{SeeAlso}\relax
\code{\Link{grid.draw}},
\code{\Link{grid.edit}},
\code{\Link{grid.get}},
\code{\Link{grid.copy}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
## Create a graphical object
l <- grid.lines(draw=FALSE)
## View the list.struct
grid.get(l)
## Copy by reference
l2 <- l
## Edit the common list.struct
grid.edit(l2, gp=gpar(col="green"))
## Copy by value
l3 <- grid.copy(l)
\end{ExampleCode}
\end{Examples}

