Provided by: allegro4-doc_4.4.3.1-3_all bug

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_bitmap_file_type(3alleg4),
       set_color_depth(3alleg4),                                   set_color_conversion(3alleg4),
       generate_optimized_palette(3alleg4), generate_332_palette(3alleg4)