\Header{xfig}{XFig Graphics Device}
\keyword{device}{xfig}
\begin{Description}\relax
\code{xfig} starts the graphics device driver for producing XFig
(version 3.2) graphics.

The auxiliary function \code{ps.options} can be used to set and view
(if called without arguments) default values for the arguments to
\code{xfig} and \code{postscript}.\end{Description}
\begin{Usage}
\begin{verbatim}
xfig(file = "Rplots.fig", onefile = FALSE, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{file}] a character string giving the name of the file.  If it is
\code{""}, the output is piped to the command given by the argument
\code{command}.  For use with \code{onefile=FALSE} give a
\code{printf} format such as \code{"Rplot\%d.fig"} (the default in
that case).
\item[\code{onefile}] logical: if true (the default) allow multiple figures
in one file. If false, assume only one page per file and generate a
file number containing the page number.
\item[\code{...}] further options for \code{xfig()}, such as:
\item[\code{paper}] the size of paper in the printer.  The choices are
\code{"A4"}, \code{"Letter"} and \code{"Legal"} (and these can be
lowercase).  A further choice is \code{"default"}, which is the
default.  If this is selected, the papersize is taken from the
option \code{"papersize"} if that is set and to \code{"A4"} if it is
unset or empty.
\item[\code{horizontal}] the orientation of the printed image, a logical.
Defaults to true, that is landscape orientation.
\item[\code{width, height}] the width and height of the graphics region in
inches.  The default is to use the entire page less a 0.25 inch
border.
\item[\code{family}] the font family to be used.  This must be one of
\code{"AvantGarde"}, \code{"Bookman"}, \code{"Courier"},
\code{"Helvetica"}, \code{"Helvetica-Narrow"},
\code{"NewCenturySchoolbook"}, \code{"Palatino"} or \code{"Times"}.
\item[\code{pointsize}] the default point size to be used.
\item[\code{bg}] the default background color to be used.
\item[\code{fg}] the default foreground color to be used.
\item[\code{pagecentre}] logical: should the device region be centred on the
page: defaults to \code{TRUE}.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Although \code{xfig} can produce multiple plots in one file, the XFig
format does not say how to separate or view them. So
\code{onefile=FALSE} is the default.\end{Details}
\begin{Note}\relax
On some line textures (\code{0 <= lty > 4}) are used.  Eventually this
will be partially remedied, but the XFig file format does not allow as
general line textures as the \R{} model.  Unimplemented line textures
are displayed as \emph{dash-double-dotted}.

There is a limit of 512 colours (plus white and black) per file.\end{Note}
\begin{SeeAlso}\relax
\code{\Link{Devices}}, \code{postscript}.\end{SeeAlso}

