\HeaderA{ps.options}{Auxiliary Function to Set/View Argument of postscript}{ps.options}
\keyword{device}{ps.options}
\begin{Description}\relax
The auxiliary function \code{ps.options} can be used to set and view
(if called without arguments) default values for the arguments to
\code{\LinkA{postscript}{postscript}}.

\code{ps.options} needs to be called before calling \code{postscript},
and the default values it sets can be overridden by supplying
arguments to \code{postscript}.
\end{Description}
\begin{Usage}
\begin{verbatim}
ps.options(..., reset = FALSE, override.check = FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{...}] arguments \code{paper}, \code{horizontal}, \code{width},
\code{height}, \code{family}, \code{encoding}, \code{pointsize},
\code{bg}, \code{fg}, \code{onefile} (unused), \code{print.it},
\code{append} (unused), \code{pagecentre},
\code{command} and \code{colormodel} can be supplied.
\item[\code{reset, override.check}] logical arguments passed to
\code{\LinkA{check.options}{check.options}}.  See the Examples.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Note that despite the name, these settings also provide the defaults
for some of the arguments for \code{\LinkA{pdf}{pdf}} and
\code{\LinkA{xfig}{xfig}}, although not in all cases even when they have
arguments of the same name.

Arguments \code{onefile} and \code{append} are accepted but are unused
in any of the graphics devices making use of this function.

For \code{pdf}, arguments \code{family}, \code{encoding}
\code{pointsize}, \code{bg}, \code{fg} and \code{pagecentre} are used.

For \code{xfig}, arguments \code{paper}, \code{horizontal},
\code{width}, \code{height}, \code{family}, \code{pointsize},
\code{bg}, \code{fg} and \code{pagecentre} are used.
\end{Details}
\begin{Value}
A named list of default values for arguments.
\end{Value}
\begin{SeeAlso}\relax
\code{\LinkA{postscript}{postscript}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
ps.options(bg = "pink")
utils::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:
utils::str(ps.options(width=0:12, onefile=1, bg=pi,
                      override.check = c(FALSE,TRUE,FALSE)))
\end{ExampleCode}
\end{Examples}

