\HeaderA{pictex}{A PicTeX Graphics Driver}{pictex}
\keyword{device}{pictex}
\begin{Description}\relax
This function produces graphics suitable for inclusion in TeX and
LaTeX documents.
\end{Description}
\begin{Usage}
\begin{verbatim}
pictex(file = "Rplots.tex", width = 5, height = 4, debug = FALSE,
       bg = "white", fg = "black")
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{file}] the file where output will appear.
\item[\code{width}] The width of the plot in inches.
\item[\code{height}] the height of the plot in inches.
\item[\code{debug}] should debugging information be printed.
\item[\code{bg}] the background color for the plot.  Ignored.
\item[\code{fg}] the foreground color for the plot.  Ignored.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This driver does not have any font metric information, so the use of
\code{\LinkA{plotmath}{plotmath}} is not supported.

Multiple plots will be placed as separate environments in the output file.

Line widths are ignored except when setting the spacing of line textures.
\code{pch="."} corresponds to a square of side 1pt.

This device does not support colour (nor does the PicTeX package),
and all colour settings are ignored.
\end{Details}
\begin{Section}{Conventions}
This section describes the implementation of the conventions for
graphics devices set out in the \dQuote{R Internals Manual}.

\Itemize{
\item The default device size is 5 inches by 5 inches.
\item There is no \code{pointsize} argument: the default size is
interpreted as 10 point.
\item The only font family is \code{cmss10}.
\item Line widths are only used when setting the spacing on line textures.
\item Circle of any radius are allowed.
\item Colour is not supported.
}
\end{Section}
\begin{Author}\relax
This driver was provided by Valerio Aimale
\email{valerio@svpop.com.dist.unige.it}
of the Department of Internal Medicine, University of Genoa, Italy.
\end{Author}
\begin{References}\relax
Knuth, D. E. (1984)
\emph{The TeXbook.}
Reading, MA: Addison-Wesley.

Lamport, L. (1994)
\emph{LATEX: A Document Preparation System.}
Reading, MA: Addison-Wesley.

Goossens, M., Mittelbach, F. and Samarin, A. (1994)
\emph{The LATEX Companion.}
Reading, MA: Addison-Wesley.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{postscript}{postscript}}, \code{\LinkA{Devices}{Devices}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
require(graphics)

pictex()
plot(1:11,(-5:5)^2, type='b', main="Simple Example Plot")
dev.off()
##--------------------
## Not run: 
%% LaTeX Example
\documentclass{article}
\usepackage{pictex}
\begin{document}
%...
\begin{figure}[h]
  \centerline{\input{Rplots.tex}}
  \caption{}
\end{figure}
%...
\end{document}

%%-- plain TeX Example --
\input pictex
$$ \input Rplots.tex $$
## End(Not run)
##--------------------
unlink("Rplots.tex")
\end{ExampleCode}
\end{Examples}

