.\" Generated by the Allegro makedoc utility
.TH extract_font_range 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
extract_font_range \- Extracts a range of characters from a font. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B FONT *extract_font_range(FONT *f, int begin, int end)
.SH 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:

.nf
   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);
.fi
.SH "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.

.SH SEE ALSO
.BR get_font_range_begin (3alleg4),
.BR get_font_range_end (3alleg4),
.BR merge_fonts (3alleg4),
.BR transpose_font (3alleg4),
.BR exfont (3alleg4)