## PostScript Graphics

## Usage

    postscript(file = "Rplots.ps", ...)
    ps.options(..., reset = FALSE, override.check = FALSE)
    .PostScript.Options

## Arguments

`file` | a character string giving the name of the file to print to.
`...` | further options for `postscript()`.
`paper` | the size of paper in the printer. The choices are `"a4"`, `"letter"`, `"legal"` and `"executive"`.
`horizontal` | the orientation of the printed image, a logical.
`width,height` | the width, and height of the graphics region in inches. The default is to use the entire page.
`family` | the font family to be used. This must be one of `"AvantGarde"`, `"Bookman"`, `"Courier"`, `"Helvetica"`, `"Helvetica-Narrow"`, `"NewCenturySchoolbook"`, `"Palatino"` or `"Times"`.
`pointsize` | the default point size to be used.
`bg` | the default background color to be used.
`fg` | the default foreground color to be used.
`onefile, print.it, append` | logical; are currently all disregarded; just there for compatibility reasons.

## Description

`postscript` starts the graphics device driver for producing PostScript graphics. The auxiliary function `ps.options` can be used to set and view (if called without arguments) default values for the arguments to `postscript`.

## Details

`postscript(..)` opens the file `file` and the PostScript commands needed to plot any graphics requested are stored in that file. This file can then be printed on a suitable device to obtain hard copy.

The postscript produced by R is EPS (Encapsulated PostScript) compatible, and can be included into other documents, e.g. into LaTeX, using `\epsfig{file=<filename>}`.

## See Also

`x11`, `macintosh`, `Devices`. {`check.options` which is called from both `ps.options` and `postscript`.}

## Examples

     # open the file "foo.ps" for graphics output
     postscript("foo.ps")

     # open the file "foo.ps" for graphics output
     postscript("foo.ps")

    dev.off()		# turn off the postscript device

    all(unlist(ps.options()) == unlist(.PostScript.Options))
    ps.options(bg = "pink")
    str(ps.options(reset = TRUE))

    ##- error checking of arguments:
    ps.options(width=0:12, onefile=0, bg=pi)

    ## override the check for 'onefile', but not the others:
    str(ps.options(width=0:12, onefile=1, bg=pi, override.check = c(F,T,F)))

    dev.off()		# turn off the postscript device

    all(unlist(ps.options()) == unlist(.PostScript.Options))
    ps.options(bg = "pink")
    str(ps.options(reset = TRUE))

    ##- error checking of arguments:
    ps.options(width=0:12, onefile=0, bg=pi)

    ## override the check for 'onefile', but not the others:
    str(ps.options(width=0:12, onefile=1, bg=pi, override.check = c(F,T,F)))

[Package Contents]