embedFonts             package:grDevices             R Documentation

_E_m_b_e_d _F_o_n_t_s _i_n _P_o_s_t_S_c_r_i_p_t _a_n_d _P_D_F

_D_e_s_c_r_i_p_t_i_o_n:

     Runs Ghostscript to process a PDF or PostScript file and embed all
     fonts in the file.

_U_s_a_g_e:

     embedFonts(file, format, outfile = file, fontpaths = "",
                options = "")

_A_r_g_u_m_e_n_t_s:

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

  format: either '"pswrite"' or '"pdfwrite"'. If not specified, it is
          guessed from the suffix of 'file'.

 outfile: the name of the new file (with fonts embedded).

fontpaths: a character vector giving directories that Ghostscript will
          search for fonts.

 options: a character string containing further options to Ghostscript.

_D_e_t_a_i_l_s:

     This function is not necessary if you just use the standard
     default fonts for PostScript and PDF output.

     If you use a special font, this function is useful for embedding
     that font in your PostScript or PDF document so that it can be
     shared with others without them having to install your special
     font (provided the font licence allows this).

     If the special font is not installed for Ghostscript, you will
     need to tell Ghostscript where the font is, using something like
     'options="-sFONTPATH=path/to/font"'.

     This function relies on a suitable Ghostscript executable being in
     your path, or the environment variable 'R_GSCMD' (the same as
     'bitmap') being set as the full path to the Ghostscript
     executable. This defaults to '"gs"'.

     Note that Ghostscript may do font substitution, so the font
     embedded may differ from that specified in the original file.

_V_a_l_u_e:

     The shell command used to invoke Ghostscript is returned
     invisibly. This may be useful for debugging purposes as you can
     run the command by hand in a shell to look for problems.

_S_e_e _A_l_s_o:

     'postscriptFonts', 'Devices'.

     Paul Murrell and Brian Ripley (2006) Non-standard fonts in
     PostScript and PDF graphics. _R News_, 6(2):41-47. <URL:
     http://cran.r-project.org/doc/Rnews/Rnews_2006-2.pdf>.

