Man Linux: Main Page and Category List

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