NAME

       libhersheyfont - Hershey vector fonts library

SYNOPSIS

       #include <hersheyfont.h>

       struct hershey_font *hershey_font_load(const char *fontname);
       struct hershey_font *hershey_jhf_font_load(const char *jhffile);

       struct hershey_glyph *hershey_font_glyph(struct hershey_font *hf, unsigned char c);

       void hershey_font_free(struct hershey_font *hf);

DESCRIPTION

       The  Hershey  fonts  are  a  collection  of vector fonts developed circa 1967 by Dr. A. V.
       Hershey.  libhersheyfont provides C routines to load and process .jhf format Hershey  font
       files.

       A  Hershey  font may be loaded with herhsey_font_load() or herhsey_font_jhf_load(), either
       of which returns a pointer to a  newly  allocated  struct  hershey_font.   This  structure
       should be freed after use with a call to herhsey_font_free().

       The   glyph   line   segment   data   for  each  ASCII  character  may  be  accessed  with
       herhsey_font_glyph().

       See the hersheyfont.h header file for the details of the structure members.

FONTS

       hershey_font_load()'s fontname parameter must be the name of  a  system-installed  Hershey
       font.  The Hershey fonts likely to be installed are:

       astrology,  cursive,  cyrillic,  futural, futuram, gothgbt, gothgrt, gothiceng, gothicger,
       gothicita,  gothitt,  greekc,  greek,  greeks,  japanese,   markers,   mathlow,   mathupp,
       meteorology,  music,  rowmand,  rowmans,  rowmant,  scriptc,  scripts,  symbolic,  timesg,
       timesib, timesi, timesrb, timesr

       herhsey_font_jhf_load()'s jhffile parameter must be the filename of a  Hershey  font  .jhf
       file.

ENVIRONMENT VARIABLE

       HERSHEY_FONTS_DIR
              The  directory  in  which  herhsey_font_load() expects to find .jhf font files (The
              default directory is likely /usr/share/hershey-fonts/ or  /usr/local/share/hershey-
              fonts/ depending on the build configuration).

EXAMPLE

       See hershey-font-example.c for a complete working example program, including code to parse
       the glyph data.  Likely location:
       /usr/share/doc/libhersheyfont/examples/hershey-font-example.c

AUTHOR

       libhersheyfont was written by Kamal Mostafa <kamal@whence.com>.

                                         2 December 2013                        LIBHERSHEYFONT(3)