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

FreeBSD Manual Pages

  
 
  

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

NAME
       merge_fonts  - Merges two fonts into one	font. Allegro game programming
       library.

SYNOPSIS
       #include	<allegro.h>

       FONT *merge_fonts(FONT *f1, FONT	*f2)

DESCRIPTION
       This function merges the	character ranges from two fonts	and returns  a
       new  font  containing  all characters in	the old	fonts. In general, you
       cannot merge fonts of different types (eg, TrueType fonts and bitmapped
       fonts),	but  as	a special case,	this function can promote a monochrome
       bitmapped font to a color font and merge	those. Example:

	  FONT *myfont;
	  FONT *myfancy_font;
	  FONT *lower_range;
	  FONT *upper_range;
	  FONT *capitals;
	  FONT *combined_font;
	  FONT *tempfont;
	  ...
	  /* Create a font that	contains the capitals from  */
	  /* the fancy font but	other characters from myfont */
	  lower_range =	extract_font_range(myfont, -1, 'A'-1);
	  upper_range =	extract_font_range(myfont, 'Z'+1, -1);
	  capitals = extract_font_range(myfancy_font, 'A', 'Z');

	  tempfont = merge_fonts(lower_range, capitals);
	  combined_font	= merge_fonts(tempfont,	upper_range);

	  /* Clean up temporary	fonts */
	  destroy_font(lower_range);
	  destroy_font(upper_range);
	  destroy_font(capitals);
	  destroy_font(tempfont);

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
       extract_font_range(3),	    is_trans_font(3),	     is_color_font(3),
       is_mono_font(3),	exfont(3)

Allegro				 version 4.4.2			merge_fonts(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=merge_fonts&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help