


GSFTOPK(1)                                             GSFTOPK(1)


NNAAMMEE
       gsftopk - render a ghostscript font in TeX pk format

SSYYNNOOPPSSIISS
       ggssffttooppkk   [-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

AARRGGUUMMEENNTTSS
       _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.

DDEESSCCRRIIPPTTIIOONN
       ggssffttooppkk is a program which calls up the  ghostscript  pro-
       gram  ggss(1)  to render a given font at a given resolution.
       It packs the resulting characters into the ppkk 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 mmkktteexxppkk, to create fonts on demand.

       ggssffttooppkk  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
       ppssffoonnttss..mmaapp),  formatted  as  in  ddvviippss(1)),  unless   the
       ----mmaapplliinnee  option  is used.  The set of map files is given
       by the  ----mmaappffiillee  option,  or  in  the  files  ccoonnffiigg..ppss,
       $$HHOOMMEE//..ddvviippssrrcc,  and  ccoonnffiigg..ggssffttooppkk  (as would be used by
       ddvviippss --PPggssffttooppkk).

       The following ppkk "specials" are added at the  end  of  the
       output  file, to provide an internal check on the contents
       of the file: "jjoobbnnaammee==_f_o_n_t", "mmaagg==11", "mmooddee==mmooddeelleessss", and
       "ppiixxeellss__ppeerr__iinncchh==_d_p_i".  This is in accordance with the TeX
       Directory Standard (TDS).

OOPPTTIIOONNSS
       ----ddoossnnaammeess
              Use  a  name  of  the  form  _f_o_n_t..ppkk   instead   of
              _f_o_n_t.._d_p_ippkk.

       --hh, ----hheellpp
              Print a brief help synopsis and exit.

       --ii _p_a_t_h, ----iinntteerrpprreetteerr==_p_a_t_h
              Use _p_a_t_h as the Ghostscript interpreter.

       ----mmaappffiillee==_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).

       ----mmaapplliinnee==_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.

       --qq, ----qquuiieett
              Operate quietly; i.e., without writing any messages
              to the standard output.

       --tt, ----tteesstt
              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).

       --vv, ----vveerrssiioonn
              Print the version number and exit.

EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
       DDVVIIPPSSRRCC         Name   of   file   to   read   instead  of
                       $$HHOOMMEE//..ddvviippssrrcc.  This should be  the  full
                       name  of the file (in other words, no path
                       searching algorithms are applied).

       GGSSFFTTOOPPKKFFOONNTTSS    See TTEEXXFFOONNTTSS..

       GGSSFFTTOOPPKKHHEEAADDEERRSS  See TTEEXXPPSSHHEEAADDEERRSS..

       PPSSHHEEAADDEERRSS       See TTEEXXPPSSHHEEAADDEERRSS..

       TTEEXXCCOONNFFIIGG       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.

       TTEEXXFFOONNTTSS        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 TTEEXXCCOONNFFIIGG..   This  informa-
                       tion  may  also  be  supplied by using the
                       environment variables TTFFMMFFOONNTTSS or GGSSFFTTOOPPKK--
                       FFOONNTTSS..   These  environment  variables are
                       checked in the  order  GGSSFFTTOOPPKKFFOONNTTSS,,  TTFFMM--
                       FFOONNTTSS,,  TTEEXXFFOONNTTSS;;  the  first one (if any)
                       having a value is used.

       TTEEXXPPSSHHEEAADDEERRSS    Colon-separated list of  paths  to  search
                       for  the Ghostscript driver file rreennddeerr..ppss
                       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 TTEEXXCCOONNFFIIGG..  This informa-
                       tion may also be  supplied  by  using  the
                       environment variables PPSSHHEEAADDEERRSS or GGSSFFTTOOPP--
                       KKHHEEAADDEERRSS..  These environment variables are
                       checked in the order GGSSFFTTOOPPKKHHEEAADDEERRSS,, TTEEXXPP--
                       SSHHEEAADDEERRSS,, PPSSHHEEAADDEERRSS;;  the  first  one  (if
                       any) having a value is used.

       TTFFMMFFOONNTTSS        See TTEEXXFFOONNTTSS..

CCOONNFFIIGGUURRAATTIIOONN
       In  order to determine the set of map files to be used and
       the path for finding PostScript files, ggssffttooppkk  reads,  in
       order,  the files ccoonnffiigg..ppss, ..ddvviippssrrcc, and ccoonnffiigg..ggssffttooppkk.
       The files ccoonnffiigg..ppss and ccoonnffiigg..ggssffttooppkk  are  searched  for
       using  the environment variable TTEEXXCCOONNFFIIGG or the compiled-
       in default paths.  The file ..ddvviippssrrcc is  searched  for  in
       the user's home directory.

       These  files  are in the same format as for ddvviippss (as well
       as being in the same  locations).   The  entries  used  by
       ggssffttooppkk are as follows.

       H _p_a_t_h Indicates  that  the  Ghostscript  driver file rreenn--
              ddeerr..ppss 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 ddvviippss --PPggssffttooppkk.

BBUUGGSS
       ggssffttooppkk sometimes has trouble with fonts with very compli-
       cated  characters  (such  as the Seal of the University of
       California).  This is because ggssffttooppkk  uses  the  cchhaarrppaatthh
       operator  to determine the bounding box of each character.
       If the character is too complicated, then old versions  of
       Ghostscript  fail,  causing  ggssffttooppkk  to terminate with an
       error message

              CCaallll ttoo ggss ssttooppppeedd bbyy ssiiggnnaall 1100

       (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, ggssffttooppkk 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

              //uusseeffoonnttbbbbooxx ttrruuee ddeeff

       in the font map file; _e_._g_.,

              uuccsseeaall ""//uusseeffoonnttbbbbooxx ttrruuee ddeeff""

       This will not affect use of the font by ddvviippss.

SSEEEE AALLSSOO
       ggss(1), ggffttooppkk(1), tteexx(1), xxddvvii(1), ddvviippss(1)

AAUUTTHHOORR
       Written by Paul Vojta.  This program was inspired by  Karl
       Berry's ggssrreennddeerrffoonntt.





































                         28 November 1998                       4


