include/SDL_hints.h
changeset 10404 a990b0da18cc
parent 10378 cb7f88c92a2e
child 10455 19b0a2227da1
     1.1 --- a/include/SDL_hints.h	Sat Oct 01 11:22:39 2016 -0700
     1.2 +++ b/include/SDL_hints.h	Sat Oct 01 11:29:13 2016 -0700
     1.3 @@ -670,6 +670,25 @@
     1.4  #define SDL_HINT_WINDOWS_NO_CLOSE_ON_ALT_F4	"SDL_WINDOWS_NO_CLOSE_ON_ALT_F4"
     1.5  
     1.6  /**
     1.7 + *  \brief Prevent SDL from using version 4 of the bitmap header when saving BMPs.
     1.8 + *
     1.9 + * The bitmap header version 4 is required for proper alpha channel support and
    1.10 + * SDL will use it when required. Should this not be desired, this hint can
    1.11 + * force the use of the 40 byte header version which is supported everywhere.
    1.12 + *
    1.13 + * The variable can be set to the following values:
    1.14 + *   "0"       - Surfaces with a colorkey or an alpha channel are saved to a
    1.15 + *               32-bit BMP file with an alpha mask. SDL will use the bitmap
    1.16 + *               header version 4 and set the alpha mask accordingly.
    1.17 + *   "1"       - Surfaces with a colorkey or an alpha channel are saved to a
    1.18 + *               32-bit BMP file without an alpha mask. The alpha channel data
    1.19 + *               will be in the file, but applications are going to ignore it.
    1.20 + *
    1.21 + * The default value is "0".
    1.22 + */
    1.23 +#define SDL_HINT_BMP_SAVE_LEGACY_FORMAT "SDL_BMP_SAVE_LEGACY_FORMAT"
    1.24 +
    1.25 +/**
    1.26   *  \brief  An enumeration of hint priorities
    1.27   */
    1.28  typedef enum