NAME

       fixup_datafile - Fixes truecolor images in compiled datafiles. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void fixup_datafile(DATAFILE *data);

DESCRIPTION

       If  you  are  using  compiled  datafiles  (produced  by the dat2s and dat2c utilities) on a platform that
       doesn't support constructors (currently  any  non  GCC-based  platform),  or  if  the  datafiles  contain
       truecolor  images, you must call this function once after your set the video mode that you will be using.
       This will ensure the datafiles are properly initialised in the first case and convert  the  color  values
       into  the  appropriate  format  in  the second case. It handles flipping between RGB and BGR formats, and
       converting between different color depths whenever that can be done without  changing  the  size  of  the
       image  (ie.  changing 15<->16-bit hicolor for both bitmaps and RLE sprites, and 24<->32-bit truecolor for
       RLE sprites).

       Note that you can only call this once and expect it  to  work  correctly,  because  after  the  call  the
       DATAFILE  you  fixed  up  is permanently converted to whatever is the current component ordering for your
       screen mode. If you call fixup_datafile again, the function assumes you have a freshly  loaded  datafile.
       It cannot "undo" the previous conversion.

       If  your  program  supports  changing resolution and/or color depth during runtime, you have two choices:
       either call fixup_datafile() just once and hope that the component ordering and bit depth doesn't  change
       when the screen mode changes (unlikely). Or, you can reload your datafiles when the screen mode changes.

SEE ALSO

       set_gfx_mode(3alleg4), set_color_conversion(3alleg4)