Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
extract_font_range(3)		Allegro	manual		 extract_font_range(3)

NAME
       extract_font_range  - Extracts a	range of characters from a font. Alle-
       gro 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 func-
       tion. 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.  Ex-
       ample:

	  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(3),	 get_font_range_end(3),	merge_fonts(3),	trans-
       pose_font(3), exfont(3)

Allegro				 version 4.4.3		 extract_font_range(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=extract_font_range&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help