\HeaderA{grid.picture}{Draw a Picture Object}{grid.picture}
\aliasA{pictureGrob}{grid.picture}{pictureGrob}
\keyword{dplot}{grid.picture}
\begin{Description}\relax
These function take a \code{"Picture"} object and
either draw the picture or create a grid graphical object
representing the picture.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.picture(...)
pictureGrob(picture, x = 0.5, y = 0.5,
            width = 1, height = 1, just = "centre",
            exp = 0.05, xscale = NULL, yscale = NULL,
            distort = FALSE,
            FUN = grobify, ..., name = NULL, gp = gpar())

\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{picture}] A \code{"Picture"} object.
\item[\code{x}] A single numeric value or unit object specifying an x-value.
\item[\code{y}] A single numeric value or unit object specifying a y-value.
\item[\code{width}] A single numeric value or unit object specifying a width.
\item[\code{height}] A single numeric value or unit object specifying a
height.
\item[\code{just}] The justification of the picture
relative to its (x, y) location.  If there are two values, the first
value specifes horizontal justification and the second value specifies
vertical justification.  Possible string values are: \code{"left"},
\code{"right"}, \code{"centre"}, \code{"center"}, \code{"bottom"},
and \code{"top"}.  For numeric values, 0 means left alignment
and 1 means right alignment.

\item[\code{exp}] An expansion factor;  determines whether any space
is left between the extent of the picture and the bounding
rectangle it is drawn within.
\item[\code{xscale}] A numeric vector of length two indicating the minimum and
maximum on the x-scale.
\item[\code{yscale}] A numeric vector of length two indicating the minimum
and maximum on the y-scale.
\item[\code{distort}] A logical value indicating whether the image
should preserve its aspect ratio or distort to fit the
area it is being drawn within. 
\item[\code{FUN}] The function used to convert paths within the picture
to grid grobs.
\item[\code{...}] For \code{grid.picture} arguments to be passed to
\code{pictureGrob}.  For \code{pictureGrob}, arguments to be
passed to \code{grobify}.
\item[\code{name}] A character identifier. 
\item[\code{gp}] An object of class \code{gpar}, typically the output
from a call to the function \code{gpar}.  This is basically
a list of graphical parameter settings.
\end{ldescription}
\end{Arguments}
\begin{Value}
A grid gTree.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{grobify}{grobify}} and 
\code{\LinkA{grid.symbols}{grid.symbols}}
\end{SeeAlso}

