Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

load_bitmap_font(3alleg4) [debian man page]

load_bitmap_font(3alleg4)					  Allegro manual					 load_bitmap_font(3alleg4)

NAME

       load_bitmap_font - Grabs a font from a bitmap file. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

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

DESCRIPTION

       Tries to grab a font from a bitmap. The bitmap can be in any format that load_bitmap understands.

       The size of each character is determined by the layout of the image, which should be a rectangular grid containing all the ASCII characters
       from space(32) up to the tilde(126). The way the characters are separated depends on the color depth of the image file:

       paletted (8 bit) image file Use color 0 for the transparent portions of the characters and fill the spaces between each letter  with  color
       255.

       High  (15/16  bit) and true (24/32 bit) color image file Use bright pink (maximum red and blue, zero green) for the transparent portions of
       the characters and fill the spaces between each letter with bright yellow (maximum red and green, zero blue).

       Note that in each horizontal row the bounding boxes around the characters should align and have the same height.

       Probably the easiest way to get to grips with how this works is to load up the `demo.dat' file and export the TITLE_FONT into a	PCX  file.
       Have a look at the resulting picture in your paint program: that is the format a font should be in.

       Take care with high and true color fonts: Allegro will convert these to the current color depth when you load the font. If you try to use a
       font on a bitmap with a different color depth Allegro will do color conversions on the fly, which will be rather slow. For optimal  perfor-
       mance you should set the color depth to the color depth you want to use before loading any fonts.

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), load_bitmap(3alleg4), set_color_depth(3alleg4), grab_font_from_bitmap(3alleg4)

Allegro 							   version 4.4.2					 load_bitmap_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)
Man Page