\HeaderA{PostScriptTrace}{Convert PostScript file to RGML file}{PostScriptTrace}
\keyword{dplot}{PostScriptTrace}
\begin{Description}\relax
Converts a PostScript file into an RGML file, which is
an XML document describing an image that can be read into R.
\end{Description}
\begin{Usage}
\begin{verbatim}PostScriptTrace(file, outfilename,
                       charpath=TRUE, setflat=NULL)\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{file}] The name of the PostScript file.
\item[\code{outfilename}] The name of the XML document.
\item[\code{charpath}] A boolean indicating whether text in the PostScript
file should be converted to vector outlines, or left as just text.
\item[\code{setflat}] A number that controls how many straight lines a curve
is broken into.  Lower values break a curve into more lines. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This function calls ghostscript to do the conversion,
so will only work if ghostscript is installed on your system.

If text is converted to outlines, it can be drawn as outlines,
or filled using a crude algorithm which may or may not work
(see \code{grid.picture}).  On the other hand, if text is left
as just text, font information is not stored so the text may
not end up looking much like the original.
\end{Details}
\begin{References}\relax
\url{http://www.cs.wisc.edu/~ghost/}
\end{References}

