\HeaderA{symbolize}{Convert a Picture into a Grid Grob}{symbolize}
\keyword{dplot}{symbolize}
\begin{Description}\relax
Converts an entire \code{"Picture"} object, or
a path element thereof,
into an appropriate grid grob.  Not usually called directly
by the user;  usually called by \code{grid.picture}.
\end{Description}
\begin{Usage}
\begin{verbatim}
symbolize(object, x = unit(0.5, "npc"), y = unit(0.5, "npc"),
          size = unit(1, "npc"), units = "npc", ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{object}] A \code{"Picture"} object. 
\item[\code{x}] A numeric vector or unit object specifying x-values.
\item[\code{y}] A numeric vector or unit object specifying y-values.
\item[\code{size}] A numeric vector or unit object specifying symbol size.
\item[\code{units}] The default units to use if \code{x}, \code{y},
or \code{size} are specified as simple numeric values.
\item[\code{...}] Arguments passed on to the relevant
grid grob constructor function. 
\end{ldescription}
\end{Arguments}
\begin{Value}
A grid gTree (when given a whole \code{"Picture"})
or a \code{"symbolFill"} or \code{"symbolStroke"} object
(when given a single picture path).
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{grid.picture}{grid.picture}} and  
\code{\LinkA{symbolize}{symbolize}}
\end{SeeAlso}

