load_txt_font(3)                Allegro manual                load_txt_font(3)



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(3), load_font(3)



Allegro                          version 4.2.3                load_txt_font(3)
