extract_font_range

extract_font_range(3alleg4)      Allegro manual      extract_font_range(3alleg4)



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)



Allegro                           version 4.4.3      extract_font_range(3alleg4)