pdf                   package:base                   R Documentation

_P_D_F _G_r_a_p_h_i_c_s _D_e_v_i_c_e

_D_e_s_c_r_i_p_t_i_o_n:

     `pdf' starts the graphics device driver for producing PDF
     graphics.

_U_s_a_g_e:

     pdf(file = ifelse(onefile, "Rplots.pdf", "Rplot%03d.pdf"),
         width = 6, height = 6, onefile = TRUE, family = "Helvetica",
         encoding, bg, fg, pointsize)

_A_r_g_u_m_e_n_t_s:

    file: a character string giving the name of the file.

width, height: the width and height of the graphics region in inches.

 onefile: logical: if true (the default) allow multiple figures in one
          file.  If false, generate a file name containing the page
          number.

  family: the font family to be used, one of `"AvantGarde"',
          `"Bookman"', `"Courier"', `"Helvetica"',
          `"Helvetica-Narrow"', `"NewCenturySchoolbook"', `"Palatino"'
          or `"Times"'. 

encoding: the name of an encoding file.  Defaults to `"ISOLatin1.enc"'
          in the `R_HOME/afm' directory, which is used if the path does
          not contain a path separator.  An extension `".enc"' can be
          omitted.

pointsize: the default point size to be used.

      bg: the default background color to be used.

      fg: the default foreground color to be used.

_D_e_t_a_i_l_s:

     `pdf()' opens the file `file' and the PDF commands needed to plot
     any graphics requested are sent to that file.

     See `postscript' for details of encodings, as the internal code is
     shared between the drivers.  The native PDF encoding is given in
     file `PDFDoc.enc'.

     `pdf' writes uncompressed PDF.  It is primarily intended for
     producing PDF graphics for inclusion in other documents, and
     PDF-includers such as `pdftex' are usually able to handle
     compression.

     At present the PDF is fairly simple, with each page being
     represented as a single stream.  The R graphics model does not
     distinguish graphics objects at the level of the driver interface.

_N_o_t_e:

     Acrobat Reader does not use the fonts specified but rather
     emulates them from multiple-master fonts.  This can be seen in
     imprecise centring of characters, for example the multiply and
     divide signs in Helvetica.

_S_e_e _A_l_s_o:

     `Devices', `postscript'

_E_x_a_m_p_l_e_s:

     ## Test function for encodings
     TestChars <- function(encoding="ISOLatin1")
     {
         pdf(encoding=encoding)
         par(pty="s")
         plot(c(0,15), c(0,15), type="n", xlab="", ylab="")
         title(paste("Centred chars in encoding", encoding))
         grid(15, 15, lty=1)
         for(i in c(32:255)) {
             x <- i 
             y <- i 
             points(x, y, pch=i)
         }
         dev.off()
     }
     ## there will be many warnings.
     TestChars("ISOLatin2")
     ## doesn't view properly in US-spec Acrobat 5.05, but gs7.04 works.
     ## Lots of characters are not centred.

