GFTODVI(1)                                             GFTODVI(1)


NAME
       gftodvi - make proofsheets from generic font files

SYNOPSIS
       gftodvi      [-verbose]      [-overflow-label-offset=real]
       [gf_file_name]

DESCRIPTION
       The gftodvi program converts a generic font (GF) file out-
       put  by, for example, mf(1), to a device independent (DVI)
       file (that can then be typeset using  same  software  that
       has  already  been written for TeX). The characters in the
       GF file will appear one per page, with labels, titles, and
       annotations  as  specified in Appendix H (Hardcopy Proofs)
       of The METAFONTbook.

       GFtoDVI uses other fonts in addition to the main GF  file.
       A  `gray' font is used to typeset the pixels that actually
       make up the character. (We wouldn't want all the pixels to
       be  simply black, since then labels, key points, and other
       information would be lost.) A `title' font is used for the
       information at the top of the page. A `label' font is used
       for the labels on key points of the figure. A `slant' font
       is used to typeset diagonal lines, which otherwise have to
       be simulated using horizontal  and  vertical  rules.   The
       default  gray,  title, and label fonts are gray, cmr8, and
       cmtt10, respectively; there is no default slant font.

       To change the default fonts, you can give special commands
       in  your Metafont source file, or you can change the fonts
       online.  An  online  dialog  ensues   if   you   end   the
       gffilename with a `/'. For example,
         gftodvi io.300gf/
         Special font substitution: grayfont black
         OK; any more? grayfontarea /home/art/don/
         OK; any more? slantfont /home/fonts/slantimagen6
         OK; any more? <RET>
       will  use  /home/art/don/black  as  the  `gray'  font  and
       /home/fonts/slantimagen6 as the `slant'  font  (this  name
       indicates  a  font for lines with slope 1/6 at the resolu-
       tion of an Imagen printer).

       The gffilename on the command  line  must  be  complete.
       (The  program  prompts  you  for it if you don't give it.)
       Because the resolution is part of the extension, it  would
       not  make  sense  to add on a default extension as is done
       with TeX or DVI-reading software.  The  output  file  name
       defaults  to  the same root as the gf file, with the `dvi'
       extension added. For example,  the  input  file  io.2602gf
       would become io.dvi.

OPTIONS
       Without  the  -verbose  option, gftodvi operates silently.
       With it, a banner  and  progress  report  are  printed  on



                             7 Jan 92                           1

GFTODVI(1)                                             GFTODVI(1)


       stdout.

       The  argument to -overflow-label-offset specifies the dis-
       tance from the right edge of the character bounding box at
       which  the  overflow  equations (if any) are typeset.  The
       value is given in TeX points.  The  default  is  a  little
       over two inches.

       See tex(1) for the details of specifying options.

ENVIRONMENT
       gftodvi looks for gffilename first in the current direc-
       tory.  If it is not present there, it uses the environment
       variable  GFFONTS.   If that is not set, it uses the vari-
       able  TEXFONTS.  If  this  is  set,  it  uses  the  system
       defaults:
       TEXFONTS: /usr/contrib/lib/tex/fonts//:.     /*TFMfont*/,
       See tex(1) for the details of the searching.

FILES
       /usr/contrib/lib/tex/fonts/{gray.tfm,...}
                                               the default fonts

       /usr/contrib/lib/mf/inputs/{gray.mf,...}
                                               the       Metafont
                                               sources (perhaps)

SEE ALSO
       tex(1), mf(1)
       Donald Knuth, The METAFONTbook
       Donald Knuth et al., METAFONTware

AUTHORS
       Donald Knuth wrote the program. It was published  as  part
       of  the  METAFONTware technical report, available from the
       TeX Users Group.  Paul Richards ported it to Unix.





















                             7 Jan 92                           2