load_dat_font(3alleg4) [debian man page]

load_dat_font(3alleg4)						  Allegro manual					    load_dat_font(3alleg4)

NAME

       load_dat_font - Loads a FONT from an Allegro datafile.

SYNOPSIS

       #include <allegro.h>

       FONT *load_dat_font(const char *filename, RGB *pal, void *param)

DESCRIPTION

       Loads  a  FONT from an Allegro datafile. You can set param parameter to point to an array that holds two strings that identify the font and
       the palette in the datafile by name.  The first string in this list is the name of the font. You can pass NULL here to just load the  first
       font  found  in	the  datafile.	The  second  string can be used to specify the name of the palette associated with the font.  This is only
       returned if the pal parameter is not NULL. If you pass NULL for the name of the palette, the last palette found before the font	was  found
       is  returned.   You can also pass NULL for param, which is treated as if you had passed NULL for both strings separately. In this case, the
       function will simply load the first font it finds from the datafile and the palette that precedes it.

       For example, suppose you have a datafile named `fonts.dat' with the following contents:

	  FONT	FONT_1_DATA
	  FONT	FONT_2_DATA
	  FONT	FONT_3_DATA
	  PAL	FONT_1_PALETTE
	  PAL	FONT_2_PALETTE

       Then the following code will load FONT_1_DATA as a FONT and return FONT_1_PALETTE as the palette:

	  FONT *f;
	  PALETTE pal;
	  char *names[] = { "FONT_1_DATA", "FONT_1_PALETTE" }

	  f = load_dat_font("fonts.dat", pal, names);

       If instead you want to load the second font, FONT_2, from the datafile, you would use:

	  FONT *f;
	  PALETTE pal;
	  char *names[] = { "FONT_2_DATA", "FONT_2_PALETTE" }

	  f = load_dat_font("fonts.dat", pal, names);

       If you want to load the third font, but not bother with a palette, use:

	  FONT *f;
	  char *names[] = { "FONT_3_DATA", NULL }

	  f = load_dat_font("fonts.dat", NULL, names);

RETURN VALUE

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

       register_font_file_type(3alleg4), load_font(3alleg4)

Allegro 							   version 4.4.2					    load_dat_font(3alleg4)

Check Out this Related Man Page

load_bitmap(3alleg4)						  Allegro manual					      load_bitmap(3alleg4)

NAME

       load_bitmap - Loads any supported bitmap from a file. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       BITMAP *load_bitmap(const char *filename, RGB *pal);

DESCRIPTION

       Loads  a  bitmap  from  a file. The palette data will be stored in the second parameter, which should be an array of 256 RGB structures. At
       present this function supports BMP, LBM, PCX, and TGA files, determining the type from the file extension.

       If the file contains a truecolor image, you must set the video mode or call set_color_conversion() before loading it. In this case, if  the
       destination  color  depth  is  8-bit,  the  palette will be generated by calling generate_optimized_palette() on the bitmap; otherwise, the
       returned palette will be generated by calling generate_332_palette().

       The pal argument may be NULL. In this case, the palette data are simply not returned. Additionally, if the file is a  truecolor	image  and
       the destination color depth is 8-bit, the color conversion process will use the current palette instead of generating an optimized one.

       Example:

	  BITMAP *bmp;
	  PALETTE palette;
	  ...
	  bmp = load_bitmap("image.pcx", palette);
	  if (!bmp)
	     abort_on_error("Couldn't load image.pcx!");
	  ...
	  destroy_bitmap(bmp);

RETURN VALUE

       Returns a pointer to the bitmap or NULL on error. Remember that you are responsible for destroying the bitmap when you are finished with it
       to avoid memory leaks.

SEE ALSO

       load_bmp(3alleg4), load_lbm(3alleg4), load_pcx(3alleg4), load_tga(3alleg4),  destroy_bitmap(3alleg4),  save_bitmap(3alleg4),  register_bit-
       map_file_type(3alleg4),	set_color_depth(3alleg4),  set_color_conversion(3alleg4),  generate_optimized_palette(3alleg4),  generate_332_pal-
       ette(3alleg4)

Allegro 							   version 4.4.2					      load_bitmap(3alleg4)

Linux and UNIX Man Pages

load_dat_font(3alleg4) [debian man page]

Check Out this Related Man Page