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 _A_r_g_u_m_e_n_t _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 and view
     (if called without arguments) default values for 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)

_A_r_g_u_m_e_n_t_s:

     ...: arguments 'paper', 'horizontal', 'width', 'height', 'family',
          'encoding', 'pointsize', 'bg', 'fg', 'onefile' (unused),
          'print.it', 'append' (unused), 'pagecentre', 'command' and
          'colormodel' can be supplied.

reset, override.check: logical arguments passed to 'check.options'. 
          See the Examples.

_D_e_t_a_i_l_s:

     Note that despite the name, these settings also provide the
     defaults for some of the arguments for 'pdf' and 'xfig', although
     not in all cases even when they have arguments of the same name.

     Arguments 'onefile' and 'append' are accepted but are unused in
     any of the graphics devices making use of this function.

     For 'pdf', arguments 'family', 'encoding' 'pointsize', 'bg', 'fg'
     and 'pagecentre' are used.

     For 'xfig', arguments 'paper', 'horizontal', 'width', 'height',
     'family', 'pointsize', 'bg', 'fg' and 'pagecentre' are used.

_V_a_l_u_e:

     A named list of default values for arguments.

_S_e_e _A_l_s_o:

     'postscript'

_E_x_a_m_p_l_e_s:

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

