ps.options             package:grDevices             R Documentation

_A_u_x_i_l_i_a_r_y _F_u_n_c_t_i_o_n _t_o _S_e_t/_V_i_e_w _D_e_f_a_u_l_t_s _f_o_r _A_r_g_u_m_e_n_t_s _o_f _p_o_s_t_s_c_r_i_p_t

_D_e_s_c_r_i_p_t_i_o_n:

     The auxiliary function 'ps.options' can be used to set or view (if
     called without arguments) the default values for some of the
     arguments to 'postscript'.

     'ps.options' needs to be called before calling 'postscript', and
     the default values it sets can be overridden by supplying
     arguments to 'postscript'.

_U_s_a_g_e:

     ps.options(..., reset = FALSE, override.check = FALSE)

     setEPS(...)
     setPS(...)

_A_r_g_u_m_e_n_t_s:

     ...: arguments 'onefile', 'family', 'title', 'fonts', 'encoding',
          'bg', 'fg', 'width', 'height', 'horizontal', 'pointsize', 
          'paper', 'pagecentre', 'print.it', 'command' and 'colormodel'
          can be supplied.  'onefile', 'horizontal' and 'paper' are
          _ignored_ for 'setEPS' and 'setPS'.

   reset: logical: should the defaults be reset to their
          'factory-fresh' values?

override.check: logical argument passed to 'check.options'.  See the
          Examples.

_D_e_t_a_i_l_s:

     If both 'reset = TRUE' and '...' are supplied the defaults are
     first reset to the 'factory-fresh' values and then the new values
     are applied.

     For backwards compatibility argument 'append' is accepted but
     ignored with a warning.

     'setEPS' and 'setPS' are wrappers to set defaults appropriate for
     figures for inclusion in documents (the default size is 7 inches
     square unless 'width' or 'height' is supplied) and for spooling to
     a PostScript printer respectively.  For historical reasons the
     latter is the ultimate default.

_V_a_l_u_e:

     A named list of all the previous defaults.  If '...' or 'reset =
     TRUE' is supplied the result has the visibility flag turned off.

_S_e_e _A_l_s_o:

     'postscript', 'pdf.options'

_E_x_a_m_p_l_e_s:

     ps.options(bg = "pink")
     utils::str(ps.options())

     ### ---- error checking of arguments: ----
     ps.options(width=0:12, onefile=0, bg=pi)
     # override the check for 'width', but not 'bg':
     ps.options(width=0:12, bg=pi, override.check = c(TRUE,FALSE))
     utils::str(ps.options())
     ps.options(reset = TRUE) # back to factory-fresh

