Provided by: allegro4-doc_4.4.2-10_all bug

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)