# R: XFig Graphics Device

xfig {grDevices} | R Documentation

## XFig Graphics Device

### Description

`xfig` starts the graphics device driver for producing XFig (version 3.2) graphics.

The auxiliary function `ps.options` can be used to set and view (if called without arguments) default values for the arguments to `xfig` and `postscript`.

### Usage

    xfig(file = ifelse(onefile, "Rplots.fig", "Rplot%03d.fig"),
         onefile = FALSE, encoding = "none", ...)

### Arguments

`file` | a character string giving the name of the file. For use with `onefile = FALSE` give a C integer format such as `"Rplot%03d.fig"` (the default in that case). (See `postscript` for further details.)
`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.
`encoding` | The encoding in which to write text strings. The default is not to re-encode. This can be any encoding recognized by `iconv`: in a Western UTF-8 locale you probably want to select an 8-bit encoding such as `latin1`, and in an East Asian locale an `EUC` encoding. If re-encoding fails, the text strings will be written in the current encoding with a warning.

`...`

further arguments to `ps.options` accepted by `xfig()`:

`paper`
  the size of paper in the printer. The choices are `"A4"`, `"Letter"` and `"Legal"` (and these can be lowercase). A further choice is `"default"`, which is the default. If this is selected, the papersize is taken from the option `"papersize"` if that is set and to `"A4"` if it is unset or empty.
`horizontal`
  the orientation of the printed image, a logical. Defaults to true, that is landscape orientation.
`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.
`family`
  the font family to be used. This must be one of `"AvantGarde"`, `"Bookman"`, `"Courier"`, `"Helvetica"`, `"Helvetica-Narrow"`, `"NewCenturySchoolbook"`, `"Palatino"` or `"Times"`. Any other value is replaced by `"Helvetica"` with a warning.
`pointsize`
  the default point size to be used.
`bg`
  the default background color to be used.
`fg`
  the default foreground color to be used.
`pagecentre`
  logical: should the device region be centred on the page: defaults to `TRUE`.

### Details

Although `xfig` can produce multiple plots in one file, the XFig format does not say how to separate or view them. So `onefile = FALSE` is the default.

The `file` argument is interpreted as a C integer format as used by `sprintf`, with integer argument the page number. The default gives files ‘Rplot001.fig’, ..., ‘Rplot999.fig’, ‘Rplot1000.fig’, ....

Line widths as controlled by `par(lwd=)` are in multiples of 5/6*1/72 inch. Multiples less than 1 are allowed. `pch="."` with `cex = 1` corresponds to a square of side 1/72 inch.

Windows users can make use of WinFIG (http://www.schmidt-web-berlin.de/WinFIG.htm).

### Note

Only some line textures (`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 dash-double-dotted.

There is a limit of 512 colours (plus white and black) per file.

### See Also

`Devices`, `postscript`, `ps.options`.

[Package grDevices version 2.6.0 Index]