


GSFTOPK(1)                                             GSFTOPK(1)


NNAAMMEE
       gsftopk - render a ghostscript font in TeX pk format

SSYYNNOOPPSSIISS
       ggssffttooppkk   [-i   _p_a_t_h]  [-q]  [-t]  [--dosnames]  [--inter-
       preter=_p_a_t_h] [--mapline=_l_i_n_e]  [--mapfile=_f_i_l_e]  [--quiet]
       [--test] [--help] [--version] _f_o_n_t _d_p_i

AARRGGUUMMEENNTTSS
       _f_o_n_t  Name of the font to be created.

       _d_p_i   Desired  resolution  of  the  font to be created, in
             dots per inch.  This may be a real number.

DDEESSCCRRIIPPTTIIOONN
       ggssffttooppkk is a program which calls up the  ghostscript  pro-
       gram  ggss(1)  to render a given font at a given resolution.
       It packs the resulting characters into the ppkk file  format
       and  writes  them  to a file whose name is formed from the
       font name and the resolution (rounded to the nearest inte-
       ger).   The  font  may  be  in  any  format  acceptable to
       Ghostscript, including ._p_f_a, ._p_f_b, ._g_s_f, and ._t_t_f files.

       This program should normally be called by a  script,  such
       as mmkktteexxppkk, to create fonts on demand.

       ggssffttooppkk  obtains  the character widths from the ._t_f_m file,
       which must exist in the standard  search  path.   It  also
       must  be  able  to  find  the  font in a map file (such as
       ppssffoonnttss..mmaapp),  formatted  as  in  ddvviippss(1)),  unless   the
       ----mmaapplliinnee  option  is used.  The set of map files is given
       by the  ----mmaappffiillee  option,  or  in  the  files  ccoonnffiigg..ppss,
       $$HHOOMMEE//..ddvviippssrrcc,  and  ccoonnffiigg..ggssffttooppkk  (as would be used by
       ddvviippss --PPggssffttooppkk).

       The following ppkk "specials" are added at the  end  of  the
       output  file, to provide an internal check on the contents
       of the file: "jjoobbnnaammee==_f_o_n_t", "mmaagg==11", "mmooddee==mmooddeelleessss", and
       "ppiixxeellss__ppeerr__iinncchh==_d_p_i".  This is in accordance with the TeX
       Directory Standard (TDS).

OOPPTTIIOONNSS
       ----ddoossnnaammeess
              Use  a  name  of  the  form  _f_o_n_t..ppkk   instead   of
              _f_o_n_t.._d_p_ippkk.

       --hh, ----hheellpp
              Print a brief help synopsis and exit.

       --ii _p_a_t_h, ----iinntteerrpprreetteerr==_p_a_t_h
              Use _p_a_t_h as the Ghostscript interpreter.

       ----mmaappffiillee==_f_i_l_e
              Use  _f_i_l_e to look for the map information for _f_o_n_t.



                         28 November 1998                       1





GSFTOPK(1)                                             GSFTOPK(1)


              This should be the full name of the file (in  other
              words, no path searching algorithms are applied).

       ----mmaapplliinnee==_l_i_n_e
              Use  _l_i_n_e  instead of looking for an entry in a map
              file.  The first word of _l_i_n_e must match _f_o_n_t.

       --qq, ----qquuiieett
              Operate quietly; i.e., without writing any messages
              to the standard output.

       --tt, ----tteesstt
              Test  run:   return  zero status if the font can be
              found in the map file(s), and nonzero status if  it
              cannot.   If this option is specified, then the _d_p_i
              argument is optional (since the font  will  not  be
              generated).

       --vv, ----vveerrssiioonn
              Print the version number and exit.

EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
       DDVVIIPPSSRRCC         Name   of   file   to   read   instead  of
                       $$HHOOMMEE//..ddvviippssrrcc.  This should be  the  full
                       name  of the file (in other words, no path
                       searching algorithms are applied).

       GGSSFFTTOOPPKKFFOONNTTSS    See TTEEXXFFOONNTTSS..

       GGSSFFTTOOPPKKHHEEAADDEERRSS  See TTEEXXPPSSHHEEAADDEERRSS..

       PPSSHHEEAADDEERRSS       See TTEEXXPPSSHHEEAADDEERRSS..

       TTEEXXCCOONNFFIIGG       Colon-separated list of  paths  to  search
                       for map files.  An extra colon in the list
                       will include the compiled-in default paths
                       at that point.  A double slash will enable
                       recursive subdirectory searching  at  that
                       point in the path.

       TTEEXXFFOONNTTSS        Colon-separated  list  of  paths to search
                       for the  ._t_f_m  file  associated  with  the
                       font.   Double  slashes  and  extra colons
                       behave as with TTEEXXCCOONNFFIIGG..   This  informa-
                       tion  may  also  be  supplied by using the
                       environment variables TTFFMMFFOONNTTSS or GGSSFFTTOOPPKK--
                       FFOONNTTSS..   These  environment  variables are
                       checked in the  order  GGSSFFTTOOPPKKFFOONNTTSS,,  TTFFMM--
                       FFOONNTTSS,,  TTEEXXFFOONNTTSS;;  the  first one (if any)
                       having a value is used.

       TTEEXXPPSSHHEEAADDEERRSS    Colon-separated list of  paths  to  search
                       for  the Ghostscript driver file rreennddeerr..ppss
                       and for  any  PostScript  header  or  font



                         28 November 1998                       2





GSFTOPK(1)                                             GSFTOPK(1)


                       files  (._e_n_c,  ._p_f_a,  ._p_f_b,  ._g_s_f, or ._t_t_f
                       files).  Double slashes and  extra  colons
                       behave  as  with TTEEXXCCOONNFFIIGG..  This informa-
                       tion may also be  supplied  by  using  the
                       environment variables PPSSHHEEAADDEERRSS or GGSSFFTTOOPP--
                       KKHHEEAADDEERRSS..  These environment variables are
                       checked in the order GGSSFFTTOOPPKKHHEEAADDEERRSS,, TTEEXXPP--
                       SSHHEEAADDEERRSS,, PPSSHHEEAADDEERRSS;;  the  first  one  (if
                       any) having a value is used.

       TTFFMMFFOONNTTSS        See TTEEXXFFOONNTTSS..

CCOONNFFIIGGUURRAATTIIOONN
       In  order to determine the set of map files to be used and
       the path for finding PostScript files, ggssffttooppkk  reads,  in
       order,  the files ccoonnffiigg..ppss, ..ddvviippssrrcc, and ccoonnffiigg..ggssffttooppkk.
       The files ccoonnffiigg..ppss and ccoonnffiigg..ggssffttooppkk  are  searched  for
       using  the environment variable TTEEXXCCOONNFFIIGG or the compiled-
       in default paths.  The file ..ddvviippssrrcc is  searched  for  in
       the user's home directory.

       These  files  are in the same format as for ddvviippss (as well
       as being in the same  locations).   The  entries  used  by
       ggssffttooppkk are as follows.

       H _p_a_t_h Indicates  that  the  Ghostscript  driver file rreenn--
              ddeerr..ppss and the PostScript header and font files are
              to be searched for using _p_a_t_h.

       p _f_i_l_e Indicates  that  the  list  of  map  files is to be
              erased and replaced by _f_i_l_e.

       p +_f_i_l_e
              Indicates that _f_i_l_e is to be added to the  list  of
              map files.

       All other entries are ignored.

       This is similar to the handling of these options when run-
       ning ddvviippss --PPggssffttooppkk.

BBUUGGSS
       ggssffttooppkk sometimes has trouble with fonts with very compli-
       cated  characters  (such  as the Seal of the University of
       California).  This is because ggssffttooppkk  uses  the  cchhaarrppaatthh
       operator  to determine the bounding box of each character.
       If the character is too complicated, then old versions  of
       Ghostscript  fail,  causing  ggssffttooppkk  to terminate with an
       error message

              CCaallll ttoo ggss ssttooppppeedd bbyy ssiiggnnaall 1100

       (The number may vary from system to system; it corresponds
       to  a bus error or a segmentation fault.)  The best way to



                         28 November 1998                       3





GSFTOPK(1)                                             GSFTOPK(1)


       fix  this  bug  is  to  install  a  current   version   of
       ghostscript.  As an alternative, ggssffttooppkk can be instructed
       to use the bounding box provided with  the  font  (if  one
       exists) instead of finding a bounding box for each charac-
       ter.  To do this, include the string

              //uusseeffoonnttbbbbooxx ttrruuee ddeeff

       in the font map file; _e_._g_.,

              uuccsseeaall ""//uusseeffoonnttbbbbooxx ttrruuee ddeeff""

       This will not affect use of the font by ddvviippss.

SSEEEE AALLSSOO
       ggss(1), ggffttooppkk(1), tteexx(1), xxddvvii(1), ddvviippss(1)

AAUUTTHHOORR
       Written by Paul Vojta.  This program was inspired by  Karl
       Berry's ggssrreennddeerrffoonntt.





































                         28 November 1998                       4


