png                package:grDevices                R Documentation

_J_P_E_G _a_n_d _P_N_G _g_r_a_p_h_i_c_s _d_e_v_i_c_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     A graphics device for JPEG or PNG format bitmap files.

_U_s_a_g_e:

     jpeg(filename = "Rplot%03d.jpeg", width = 480, height = 480,
          pointsize = 12, quality = 75, bg = "white", res = NA, ...)

     png(filename = "Rplot%03d.png", width = 480, height = 480,
         pointsize = 12, bg = "white",  res = NA,...)

_A_r_g_u_m_e_n_t_s:

filename: the name of the output file. The page number is substituted
          if an integer format is included in the character string.
          (The result must be less than 'PATH_MAX' characters long, and
          may be truncated if not.) Tilde expansion is performed where
          supported by the platform.

   width: the width of the device in pixels.

  height: the height of the device in pixels.

pointsize: the default pointsize of plotted text.

 quality: the 'quality' of the JPEG image, as a percentage.  Smaller
          values will give more compression but also more degradation
          of the image.

      bg: default background colour.

     res: The nominal resolution in dpi which will be recorded in the
          bitmap file, if a positive integer.

     ...: additional arguments to the 'X11' device.

_D_e_t_a_i_l_s:

     Plots in PNG and JPEG format can easily be converted to many other
     bitmap formats, and both can be displayed in most modern web
     browsers. The PNG format is lossless and is best for line diagrams
     and blocks of solid colour. The JPEG format is lossy, but may be
     useful for image plots, for example.

     'png' supports transparent backgrounds: use 'bg = "transparent"'.
     Not all PNG viewers render files with transparency correctly. When
     transparency is in use a very light grey is used as the background
     and so will appear as transparent if used in the plot. This allows
     opaque white to be used, as on the example.

     R can be compiled without support for either or both of these
     devices: this will be reported if you attempt to use them on a
     system where they are not supported.  They will not be available
     if R has been started with '--gui=none' (and will give a different
     error message), and they may not be usable unless the X11 display
     is available to the owner of the R process.

     By default no resolution is recorded in the file.  Readers will
     often assume nominal resolution of 72dpi when none is recorded. 
     As resolutions in PNG files are recorded in pixels/metre, the dpi
     value will be changed slightly.

_V_a_l_u_e:

     A plot device is opened: nothing is returned to the R interpreter.

_W_a_r_n_i_n_g:

     If you plot more than one page on one of these devices and do not
     include something like '%d' for the sequence number in 'file', the
     file will contain the last page plotted.

_N_o_t_e:

     These are based on the 'X11' device, so the additional arguments
     to that device work, but are rarely appropriate.  The colour
     handling will be that of the 'X11' device in use.

_A_u_t_h_o_r(_s):

     Guido Masarotto and Brian Ripley

_S_e_e _A_l_s_o:

     'Devices', 'dev.print'

     'capabilities' to see if these devices are supported by this build
     of R.

     'bitmap' provides an alternative way to generate PNG and JPEG
     plots that does not depend on accessing the X11 display but does
     depend on having GhostScript installed.

_E_x_a_m_p_l_e_s:

     ## these examples will work only if the devices are available
     ## and the X11 display is available.

     ## copy current plot to a PNG file
     ## Not run: dev.print(png, file="myplot.png", width=480, height=480)

     png(file="myplot.png", bg="transparent")
     plot(1:10)
     rect(1, 5, 3, 7, col="white")
     dev.off()

     jpeg(file="myplot.jpeg")
     example(rect)
     dev.off()
     ## End(Not run)

