fixup_datafile(3alleg4)                                           Allegro manual                                           fixup_datafile(3alleg4)

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 when-
       ever  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 con-
       verted  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)

Allegro                                                            version 4.4.2                                           fixup_datafile(3alleg4)