load_font(3alleg4) [debian man page]

load_font(3alleg4)						  Allegro manual						load_font(3alleg4)

NAME

       load_font - Loads a font from a file. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

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

DESCRIPTION

       Loads  a  font  from  a	file.  At present, this supports loading fonts from a GRX format .fnt file, a 8x8 or 8x16 BIOS format .fnt file, a
       datafile or any bitmap format that can be loaded by load_bitmap().

       If the font contains palette information, then the palette is returned in the second parameter, which should be an array of 256 RGB  struc-
       tures (a PALETTE). The pal argument may be NULL. In this case, the palette data, if present, is simply not returned.

       The  third  parameter  can be used to pass specific information to a custom loader routine. Normally, you can just leave this as NULL. Note
       that another way of loading fonts is embedding them into a datafile and using the datafile related functions.

       Example:

	  FONT *myfont;
	  PALETTE palette;
	  ...
	  myfont = load_font("my_font.pcx", palette, NULL);
	  if (!myfont)
	     abort_on_error("Couldn't load font!");
	  ...
	  textout_centre_ex(screen, myfont, "This is my own pretty font!",
			    SCREEN_W / 2, SCREEN_H / 2, white, black);
	  ...
	  destroy_font(myfont);

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_bitmap(3alleg4),    load_dat_font(3alleg4),	load_bios_font(3alleg4),   load_grx_font(3alleg4),
       load_grx_or_bios_font(3alleg4), load_bitmap_font(3alleg4), load_txt_font(3alleg4), destroy_font(3alleg4), exfont(3alleg4)

Allegro 							   version 4.4.2						load_font(3alleg4)

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)