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

\code{pdf.options} needs to be called before calling \code{pdf},
and the default values it sets can be overridden by supplying
arguments to \code{pdf}.
\end{Description}
\begin{Usage}
\begin{verbatim}
pdf.options(..., reset = FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{...}] arguments \code{width}, \code{height}, \code{onefile},
\code{family}, \code{title}, \code{fonts}, \code{paper},
\code{encoding}, \code{pointsize}, \code{bg}, \code{fg},
\code{pagecentre}, \code{useDingbats} and \code{colormodel} can be
supplied.
\item[\code{reset}] logical: should the defaults be reset to their
\sQuote{factory-fresh} values?
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
If both \code{reset = TRUE} and \code{...} are supplied the defaults
are first reset to the \sQuote{factory-fresh} values and then the new
values are applied.
\end{Details}
\begin{Value}
A named list of all the defaults.  If any arguments are
supplied the return values are the old values and the result has the
visibility flag turned off.
\end{Value}
\begin{SeeAlso}\relax
\code{\LinkA{pdf}{pdf}}, \code{\LinkA{ps.options}{ps.options}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
pdf.options(bg = "pink")
utils::str(pdf.options())
pdf.options(reset = TRUE) # back to factory-fresh
\end{ExampleCode}
\end{Examples}

