\Header{grid.copy}{Make a Copy of a Grid Graphical Object}
\keyword{dplot}{grid.copy}
\begin{Description}\relax
Grid graphical objects are references to list structures, which means
that copies of graphical objects \dQuote{point} to the same list
structure.

This function copies graphical objects by \emph{value}, which means
that the copy \dQuote{points} to a separate list structure.\end{Description}
\begin{Usage}
\begin{verbatim}
grid.copy(grob)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{grob}] An object of class \code{"grob"}.
\end{ldescription}
\end{Arguments}
\begin{Value}
An object of class \code{"grob"}.\end{Value}
\begin{Author}\relax
Paul Murrell\end{Author}
\begin{SeeAlso}\relax
\code{\Link{grid.grob}}.\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"))
## We have modified "l"
grid.get(l)
## Copy by value
l3 <- grid.copy(l)
\end{ExampleCode}
\end{Examples}

