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