

   postscript {base}                            R Documentation

   PPoossttSSccrriipptt GGrraapphhiiccss

   DDeessccrriippttiioonn::

        `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'.

   UUssaaggee::

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

   AArrgguummeennttss::

       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"'.
             Also, `"special"' can be used, when the width and
             height specify the paper size.

   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"', `"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: logical: if true (the default) allow multiple fig-
             ures in one file. If false, assume only one figure
             and give EPSF header and no `DocumentMedia' com-
             ment.

   pagecentre: logical: should the device region be centred on
             the page: defaults to true.

   print.it, append: logical; are currently disregarded; just
             there for compatibility reasons.

   DDeettaaiillss::

        `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>}'. For use in this way you will proabbly want to
        set `horizontal=FALSE, onefile=FALSE, paper="special"'.

   SSeeee AAllssoo::

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

   EExxaammpplleess::

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

