Provided by: allegro4-doc_4.4.3.1-3_all bug

NAME

       extract_font_range  - Extracts a range of characters from a font. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       FONT *extract_font_range(FONT *f, int begin, int end)

DESCRIPTION

       This function extracts a character range from a font and returns a new font that  contains
       only  the  range  of  characters selected by this function. You can pass -1 for either the
       lower or upper bound if you want to select all characters from the start or to the end  of
       the font.  Example:

          FONT *myfont;
          FONT *capitals;
          FONT *fontcopy;
          ...
          /* Create a font of only capital letters */
          capitals = extract_font_range(myfont, 'A', 'Z');

          /* Create a copy of the font */
          fontcopy = extract_font_range(myfont, -1, -1);
          ...
          destroy_font(capitals);
          destroy_font(fontcopy);

RETURN VALUE

       Returns  a pointer to the new 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

       get_font_range_begin(3alleg4),     get_font_range_end(3alleg4),      merge_fonts(3alleg4),
       transpose_font(3alleg4), exfont(3alleg4)