\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 = ifelse(onefile, "Rplots.fig", "Rplot%03d.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 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 arguments to \code{\Link{ps.options}} accepted by
\code{xfig()}:
\describe{
\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}, \code{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},
\code{\Link{ps.options}}.
\end{SeeAlso}

