

   PPoossttSSccrriipptt GGrraapphhiiccss

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

   AArrgguummeennttss::

       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"', `"Hel-
             vetica"', `"Helvetica-Narrow"', `"NewCentu-
             rySchoolbook"', `"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 disre-
             garded; just there for compatibility reasons.

   DDeessccrriippttiioonn::

        `postscript' starts the graphics device driver for pro-
        ducing 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'.

   DDeettaaiillss::

        `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 `\psfig{file=<file-
        name>}'.

   SSeeee AAllssoo::

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

   EExxaammpplleess::

         # 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)))

