NAME

       load_txt_font - Loads a font script. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       FONT *load_txt_font(const char *filename, RGB *pal, void *param)

DESCRIPTION

       This  function  can  be  used to load scripted fonts. The script file contains a number of
       lines in the format "filename start end", which specify the source file for that range  of
       characters,  the  Unicode value of the first character in the range, and the end character
       in the range (optional, if left out, the entire  input  file  will  be  grabbed).  If  the
       filename  is replaced by a hyphen, more characters will be grabbed from the previous input
       file.  For example, the script:

          ascii.fnt 0x20 0x7F
          - 0xA0 0xFF
          dingbats.fnt 0x1000

       would import the first 96 characters from ascii.fnt as the range 0x20-0x7F,  the  next  96
       characters  from ascii.fnt as the range 0xA0-0xFF, and the entire contents of dingbats.fnt
       starting at Unicode position 0x1000.

RETURN VALUE

       Returns a pointer to the font or NULL on error. Remember  that  you  are  responsible  for
       destroying the font when you are finished with it to avoid memory leaks.

SEE ALSO

       register_font_file_type(3alleg4), load_font(3alleg4)