include/SDL_pixels.h
author Sam Lantinga
Mon, 23 Nov 2020 23:03:55 -0800
changeset 14366 aab8e1ec22e4
parent 13911 2aa5945a2336
permissions -rw-r--r--
Fixed bug 5335 - Patch: enable joystick/haptic/evdev support by default on FreeBSD

Alex S

Ah, that's not quite enough. You need to:
1. rename src/joystick/bsd/SDL_sysjoystick.c to something;
2. regenerate configure.
     1 /*
     2   Simple DirectMedia Layer
     3   Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
     4 
     5   This software is provided 'as-is', without any express or implied
     6   warranty.  In no event will the authors be held liable for any damages
     7   arising from the use of this software.
     8 
     9   Permission is granted to anyone to use this software for any purpose,
    10   including commercial applications, and to alter it and redistribute it
    11   freely, subject to the following restrictions:
    12 
    13   1. The origin of this software must not be misrepresented; you must not
    14      claim that you wrote the original software. If you use this software
    15      in a product, an acknowledgment in the product documentation would be
    16      appreciated but is not required.
    17   2. Altered source versions must be plainly marked as such, and must not be
    18      misrepresented as being the original software.
    19   3. This notice may not be removed or altered from any source distribution.
    20 */
    21 
    22 /**
    23  *  \file SDL_pixels.h
    24  *
    25  *  Header for the enumerated pixel format definitions.
    26  */
    27 
    28 #ifndef SDL_pixels_h_
    29 #define SDL_pixels_h_
    30 
    31 #include "SDL_stdinc.h"
    32 #include "SDL_endian.h"
    33 
    34 #include "begin_code.h"
    35 /* Set up for C function definitions, even when using C++ */
    36 #ifdef __cplusplus
    37 extern "C" {
    38 #endif
    39 
    40 /**
    41  *  \name Transparency definitions
    42  *
    43  *  These define alpha as the opacity of a surface.
    44  */
    45 /* @{ */
    46 #define SDL_ALPHA_OPAQUE 255
    47 #define SDL_ALPHA_TRANSPARENT 0
    48 /* @} */
    49 
    50 /** Pixel type. */
    51 typedef enum
    52 {
    53     SDL_PIXELTYPE_UNKNOWN,
    54     SDL_PIXELTYPE_INDEX1,
    55     SDL_PIXELTYPE_INDEX4,
    56     SDL_PIXELTYPE_INDEX8,
    57     SDL_PIXELTYPE_PACKED8,
    58     SDL_PIXELTYPE_PACKED16,
    59     SDL_PIXELTYPE_PACKED32,
    60     SDL_PIXELTYPE_ARRAYU8,
    61     SDL_PIXELTYPE_ARRAYU16,
    62     SDL_PIXELTYPE_ARRAYU32,
    63     SDL_PIXELTYPE_ARRAYF16,
    64     SDL_PIXELTYPE_ARRAYF32
    65 } SDL_PixelType;
    66 
    67 /** Bitmap pixel order, high bit -> low bit. */
    68 typedef enum
    69 {
    70     SDL_BITMAPORDER_NONE,
    71     SDL_BITMAPORDER_4321,
    72     SDL_BITMAPORDER_1234
    73 } SDL_BitmapOrder;
    74 
    75 /** Packed component order, high bit -> low bit. */
    76 typedef enum
    77 {
    78     SDL_PACKEDORDER_NONE,
    79     SDL_PACKEDORDER_XRGB,
    80     SDL_PACKEDORDER_RGBX,
    81     SDL_PACKEDORDER_ARGB,
    82     SDL_PACKEDORDER_RGBA,
    83     SDL_PACKEDORDER_XBGR,
    84     SDL_PACKEDORDER_BGRX,
    85     SDL_PACKEDORDER_ABGR,
    86     SDL_PACKEDORDER_BGRA
    87 } SDL_PackedOrder;
    88 
    89 /** Array component order, low byte -> high byte. */
    90 /* !!! FIXME: in 2.1, make these not overlap differently with
    91    !!! FIXME:  SDL_PACKEDORDER_*, so we can simplify SDL_ISPIXELFORMAT_ALPHA */
    92 typedef enum
    93 {
    94     SDL_ARRAYORDER_NONE,
    95     SDL_ARRAYORDER_RGB,
    96     SDL_ARRAYORDER_RGBA,
    97     SDL_ARRAYORDER_ARGB,
    98     SDL_ARRAYORDER_BGR,
    99     SDL_ARRAYORDER_BGRA,
   100     SDL_ARRAYORDER_ABGR
   101 } SDL_ArrayOrder;
   102 
   103 /** Packed component layout. */
   104 typedef enum
   105 {
   106     SDL_PACKEDLAYOUT_NONE,
   107     SDL_PACKEDLAYOUT_332,
   108     SDL_PACKEDLAYOUT_4444,
   109     SDL_PACKEDLAYOUT_1555,
   110     SDL_PACKEDLAYOUT_5551,
   111     SDL_PACKEDLAYOUT_565,
   112     SDL_PACKEDLAYOUT_8888,
   113     SDL_PACKEDLAYOUT_2101010,
   114     SDL_PACKEDLAYOUT_1010102
   115 } SDL_PackedLayout;
   116 
   117 #define SDL_DEFINE_PIXELFOURCC(A, B, C, D) SDL_FOURCC(A, B, C, D)
   118 
   119 #define SDL_DEFINE_PIXELFORMAT(type, order, layout, bits, bytes) \
   120     ((1 << 28) | ((type) << 24) | ((order) << 20) | ((layout) << 16) | \
   121      ((bits) << 8) | ((bytes) << 0))
   122 
   123 #define SDL_PIXELFLAG(X)    (((X) >> 28) & 0x0F)
   124 #define SDL_PIXELTYPE(X)    (((X) >> 24) & 0x0F)
   125 #define SDL_PIXELORDER(X)   (((X) >> 20) & 0x0F)
   126 #define SDL_PIXELLAYOUT(X)  (((X) >> 16) & 0x0F)
   127 #define SDL_BITSPERPIXEL(X) (((X) >> 8) & 0xFF)
   128 #define SDL_BYTESPERPIXEL(X) \
   129     (SDL_ISPIXELFORMAT_FOURCC(X) ? \
   130         ((((X) == SDL_PIXELFORMAT_YUY2) || \
   131           ((X) == SDL_PIXELFORMAT_UYVY) || \
   132           ((X) == SDL_PIXELFORMAT_YVYU)) ? 2 : 1) : (((X) >> 0) & 0xFF))
   133 
   134 #define SDL_ISPIXELFORMAT_INDEXED(format)   \
   135     (!SDL_ISPIXELFORMAT_FOURCC(format) && \
   136      ((SDL_PIXELTYPE(format) == SDL_PIXELTYPE_INDEX1) || \
   137       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_INDEX4) || \
   138       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_INDEX8)))
   139 
   140 #define SDL_ISPIXELFORMAT_PACKED(format) \
   141     (!SDL_ISPIXELFORMAT_FOURCC(format) && \
   142      ((SDL_PIXELTYPE(format) == SDL_PIXELTYPE_PACKED8) || \
   143       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_PACKED16) || \
   144       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_PACKED32)))
   145 
   146 #define SDL_ISPIXELFORMAT_ARRAY(format) \
   147     (!SDL_ISPIXELFORMAT_FOURCC(format) && \
   148      ((SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYU8) || \
   149       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYU16) || \
   150       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYU32) || \
   151       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYF16) || \
   152       (SDL_PIXELTYPE(format) == SDL_PIXELTYPE_ARRAYF32)))
   153 
   154 #define SDL_ISPIXELFORMAT_ALPHA(format)   \
   155     ((SDL_ISPIXELFORMAT_PACKED(format) && \
   156      ((SDL_PIXELORDER(format) == SDL_PACKEDORDER_ARGB) || \
   157       (SDL_PIXELORDER(format) == SDL_PACKEDORDER_RGBA) || \
   158       (SDL_PIXELORDER(format) == SDL_PACKEDORDER_ABGR) || \
   159       (SDL_PIXELORDER(format) == SDL_PACKEDORDER_BGRA))) || \
   160     (SDL_ISPIXELFORMAT_ARRAY(format) && \
   161      ((SDL_PIXELORDER(format) == SDL_ARRAYORDER_ARGB) || \
   162       (SDL_PIXELORDER(format) == SDL_ARRAYORDER_RGBA) || \
   163       (SDL_PIXELORDER(format) == SDL_ARRAYORDER_ABGR) || \
   164       (SDL_PIXELORDER(format) == SDL_ARRAYORDER_BGRA))))
   165 
   166 /* The flag is set to 1 because 0x1? is not in the printable ASCII range */
   167 #define SDL_ISPIXELFORMAT_FOURCC(format)    \
   168     ((format) && (SDL_PIXELFLAG(format) != 1))
   169 
   170 /* Note: If you modify this list, update SDL_GetPixelFormatName() */
   171 typedef enum
   172 {
   173     SDL_PIXELFORMAT_UNKNOWN,
   174     SDL_PIXELFORMAT_INDEX1LSB =
   175         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX1, SDL_BITMAPORDER_4321, 0,
   176                                1, 0),
   177     SDL_PIXELFORMAT_INDEX1MSB =
   178         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX1, SDL_BITMAPORDER_1234, 0,
   179                                1, 0),
   180     SDL_PIXELFORMAT_INDEX4LSB =
   181         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX4, SDL_BITMAPORDER_4321, 0,
   182                                4, 0),
   183     SDL_PIXELFORMAT_INDEX4MSB =
   184         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX4, SDL_BITMAPORDER_1234, 0,
   185                                4, 0),
   186     SDL_PIXELFORMAT_INDEX8 =
   187         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX8, 0, 0, 8, 1),
   188     SDL_PIXELFORMAT_RGB332 =
   189         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED8, SDL_PACKEDORDER_XRGB,
   190                                SDL_PACKEDLAYOUT_332, 8, 1),
   191     SDL_PIXELFORMAT_XRGB4444 =
   192         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
   193                                SDL_PACKEDLAYOUT_4444, 12, 2),
   194     SDL_PIXELFORMAT_RGB444 = SDL_PIXELFORMAT_XRGB4444,
   195     SDL_PIXELFORMAT_XBGR4444 =
   196         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
   197                                SDL_PACKEDLAYOUT_4444, 12, 2),
   198     SDL_PIXELFORMAT_BGR444 = SDL_PIXELFORMAT_XBGR4444,
   199     SDL_PIXELFORMAT_XRGB1555 =
   200         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
   201                                SDL_PACKEDLAYOUT_1555, 15, 2),
   202     SDL_PIXELFORMAT_RGB555 = SDL_PIXELFORMAT_XRGB1555,
   203     SDL_PIXELFORMAT_XBGR1555 =
   204         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
   205                                SDL_PACKEDLAYOUT_1555, 15, 2),
   206     SDL_PIXELFORMAT_BGR555 = SDL_PIXELFORMAT_XBGR1555,
   207     SDL_PIXELFORMAT_ARGB4444 =
   208         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB,
   209                                SDL_PACKEDLAYOUT_4444, 16, 2),
   210     SDL_PIXELFORMAT_RGBA4444 =
   211         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA,
   212                                SDL_PACKEDLAYOUT_4444, 16, 2),
   213     SDL_PIXELFORMAT_ABGR4444 =
   214         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR,
   215                                SDL_PACKEDLAYOUT_4444, 16, 2),
   216     SDL_PIXELFORMAT_BGRA4444 =
   217         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA,
   218                                SDL_PACKEDLAYOUT_4444, 16, 2),
   219     SDL_PIXELFORMAT_ARGB1555 =
   220         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB,
   221                                SDL_PACKEDLAYOUT_1555, 16, 2),
   222     SDL_PIXELFORMAT_RGBA5551 =
   223         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA,
   224                                SDL_PACKEDLAYOUT_5551, 16, 2),
   225     SDL_PIXELFORMAT_ABGR1555 =
   226         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR,
   227                                SDL_PACKEDLAYOUT_1555, 16, 2),
   228     SDL_PIXELFORMAT_BGRA5551 =
   229         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA,
   230                                SDL_PACKEDLAYOUT_5551, 16, 2),
   231     SDL_PIXELFORMAT_RGB565 =
   232         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
   233                                SDL_PACKEDLAYOUT_565, 16, 2),
   234     SDL_PIXELFORMAT_BGR565 =
   235         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
   236                                SDL_PACKEDLAYOUT_565, 16, 2),
   237     SDL_PIXELFORMAT_RGB24 =
   238         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_RGB, 0,
   239                                24, 3),
   240     SDL_PIXELFORMAT_BGR24 =
   241         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_BGR, 0,
   242                                24, 3),
   243     SDL_PIXELFORMAT_XRGB8888 =
   244         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XRGB,
   245                                SDL_PACKEDLAYOUT_8888, 24, 4),
   246     SDL_PIXELFORMAT_RGB888 = SDL_PIXELFORMAT_XRGB8888,
   247     SDL_PIXELFORMAT_RGBX8888 =
   248         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBX,
   249                                SDL_PACKEDLAYOUT_8888, 24, 4),
   250     SDL_PIXELFORMAT_XBGR8888 =
   251         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XBGR,
   252                                SDL_PACKEDLAYOUT_8888, 24, 4),
   253     SDL_PIXELFORMAT_BGR888 = SDL_PIXELFORMAT_XBGR8888,
   254     SDL_PIXELFORMAT_BGRX8888 =
   255         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRX,
   256                                SDL_PACKEDLAYOUT_8888, 24, 4),
   257     SDL_PIXELFORMAT_ARGB8888 =
   258         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB,
   259                                SDL_PACKEDLAYOUT_8888, 32, 4),
   260     SDL_PIXELFORMAT_RGBA8888 =
   261         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBA,
   262                                SDL_PACKEDLAYOUT_8888, 32, 4),
   263     SDL_PIXELFORMAT_ABGR8888 =
   264         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ABGR,
   265                                SDL_PACKEDLAYOUT_8888, 32, 4),
   266     SDL_PIXELFORMAT_BGRA8888 =
   267         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRA,
   268                                SDL_PACKEDLAYOUT_8888, 32, 4),
   269     SDL_PIXELFORMAT_ARGB2101010 =
   270         SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB,
   271                                SDL_PACKEDLAYOUT_2101010, 32, 4),
   272 
   273     /* Aliases for RGBA byte arrays of color data, for the current platform */
   274 #if SDL_BYTEORDER == SDL_BIG_ENDIAN
   275     SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_RGBA8888,
   276     SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_ARGB8888,
   277     SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_BGRA8888,
   278     SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_ABGR8888,
   279 #else
   280     SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_ABGR8888,
   281     SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_BGRA8888,
   282     SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_ARGB8888,
   283     SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_RGBA8888,
   284 #endif
   285 
   286     SDL_PIXELFORMAT_YV12 =      /**< Planar mode: Y + V + U  (3 planes) */
   287         SDL_DEFINE_PIXELFOURCC('Y', 'V', '1', '2'),
   288     SDL_PIXELFORMAT_IYUV =      /**< Planar mode: Y + U + V  (3 planes) */
   289         SDL_DEFINE_PIXELFOURCC('I', 'Y', 'U', 'V'),
   290     SDL_PIXELFORMAT_YUY2 =      /**< Packed mode: Y0+U0+Y1+V0 (1 plane) */
   291         SDL_DEFINE_PIXELFOURCC('Y', 'U', 'Y', '2'),
   292     SDL_PIXELFORMAT_UYVY =      /**< Packed mode: U0+Y0+V0+Y1 (1 plane) */
   293         SDL_DEFINE_PIXELFOURCC('U', 'Y', 'V', 'Y'),
   294     SDL_PIXELFORMAT_YVYU =      /**< Packed mode: Y0+V0+Y1+U0 (1 plane) */
   295         SDL_DEFINE_PIXELFOURCC('Y', 'V', 'Y', 'U'),
   296     SDL_PIXELFORMAT_NV12 =      /**< Planar mode: Y + U/V interleaved  (2 planes) */
   297         SDL_DEFINE_PIXELFOURCC('N', 'V', '1', '2'),
   298     SDL_PIXELFORMAT_NV21 =      /**< Planar mode: Y + V/U interleaved  (2 planes) */
   299         SDL_DEFINE_PIXELFOURCC('N', 'V', '2', '1'),
   300     SDL_PIXELFORMAT_EXTERNAL_OES =      /**< Android video texture format */
   301         SDL_DEFINE_PIXELFOURCC('O', 'E', 'S', ' ')
   302 } SDL_PixelFormatEnum;
   303 
   304 typedef struct SDL_Color
   305 {
   306     Uint8 r;
   307     Uint8 g;
   308     Uint8 b;
   309     Uint8 a;
   310 } SDL_Color;
   311 #define SDL_Colour SDL_Color
   312 
   313 typedef struct SDL_Palette
   314 {
   315     int ncolors;
   316     SDL_Color *colors;
   317     Uint32 version;
   318     int refcount;
   319 } SDL_Palette;
   320 
   321 /**
   322  *  \note Everything in the pixel format structure is read-only.
   323  */
   324 typedef struct SDL_PixelFormat
   325 {
   326     Uint32 format;
   327     SDL_Palette *palette;
   328     Uint8 BitsPerPixel;
   329     Uint8 BytesPerPixel;
   330     Uint8 padding[2];
   331     Uint32 Rmask;
   332     Uint32 Gmask;
   333     Uint32 Bmask;
   334     Uint32 Amask;
   335     Uint8 Rloss;
   336     Uint8 Gloss;
   337     Uint8 Bloss;
   338     Uint8 Aloss;
   339     Uint8 Rshift;
   340     Uint8 Gshift;
   341     Uint8 Bshift;
   342     Uint8 Ashift;
   343     int refcount;
   344     struct SDL_PixelFormat *next;
   345 } SDL_PixelFormat;
   346 
   347 /**
   348  * \brief Get the human readable name of a pixel format
   349  */
   350 extern DECLSPEC const char* SDLCALL SDL_GetPixelFormatName(Uint32 format);
   351 
   352 /**
   353  *  \brief Convert one of the enumerated pixel formats to a bpp and RGBA masks.
   354  *
   355  *  \return SDL_TRUE, or SDL_FALSE if the conversion wasn't possible.
   356  *
   357  *  \sa SDL_MasksToPixelFormatEnum()
   358  */
   359 extern DECLSPEC SDL_bool SDLCALL SDL_PixelFormatEnumToMasks(Uint32 format,
   360                                                             int *bpp,
   361                                                             Uint32 * Rmask,
   362                                                             Uint32 * Gmask,
   363                                                             Uint32 * Bmask,
   364                                                             Uint32 * Amask);
   365 
   366 /**
   367  *  \brief Convert a bpp and RGBA masks to an enumerated pixel format.
   368  *
   369  *  \return The pixel format, or ::SDL_PIXELFORMAT_UNKNOWN if the conversion
   370  *          wasn't possible.
   371  *
   372  *  \sa SDL_PixelFormatEnumToMasks()
   373  */
   374 extern DECLSPEC Uint32 SDLCALL SDL_MasksToPixelFormatEnum(int bpp,
   375                                                           Uint32 Rmask,
   376                                                           Uint32 Gmask,
   377                                                           Uint32 Bmask,
   378                                                           Uint32 Amask);
   379 
   380 /**
   381  *  \brief Create an SDL_PixelFormat structure from a pixel format enum.
   382  */
   383 extern DECLSPEC SDL_PixelFormat * SDLCALL SDL_AllocFormat(Uint32 pixel_format);
   384 
   385 /**
   386  *  \brief Free an SDL_PixelFormat structure.
   387  */
   388 extern DECLSPEC void SDLCALL SDL_FreeFormat(SDL_PixelFormat *format);
   389 
   390 /**
   391  *  \brief Create a palette structure with the specified number of color
   392  *         entries.
   393  *
   394  *  \return A new palette, or NULL if there wasn't enough memory.
   395  *
   396  *  \note The palette entries are initialized to white.
   397  *
   398  *  \sa SDL_FreePalette()
   399  */
   400 extern DECLSPEC SDL_Palette *SDLCALL SDL_AllocPalette(int ncolors);
   401 
   402 /**
   403  *  \brief Set the palette for a pixel format structure.
   404  */
   405 extern DECLSPEC int SDLCALL SDL_SetPixelFormatPalette(SDL_PixelFormat * format,
   406                                                       SDL_Palette *palette);
   407 
   408 /**
   409  *  \brief Set a range of colors in a palette.
   410  *
   411  *  \param palette    The palette to modify.
   412  *  \param colors     An array of colors to copy into the palette.
   413  *  \param firstcolor The index of the first palette entry to modify.
   414  *  \param ncolors    The number of entries to modify.
   415  *
   416  *  \return 0 on success, or -1 if not all of the colors could be set.
   417  */
   418 extern DECLSPEC int SDLCALL SDL_SetPaletteColors(SDL_Palette * palette,
   419                                                  const SDL_Color * colors,
   420                                                  int firstcolor, int ncolors);
   421 
   422 /**
   423  *  \brief Free a palette created with SDL_AllocPalette().
   424  *
   425  *  \sa SDL_AllocPalette()
   426  */
   427 extern DECLSPEC void SDLCALL SDL_FreePalette(SDL_Palette * palette);
   428 
   429 /**
   430  *  \brief Maps an RGB triple to an opaque pixel value for a given pixel format.
   431  *
   432  *  \sa SDL_MapRGBA
   433  */
   434 extern DECLSPEC Uint32 SDLCALL SDL_MapRGB(const SDL_PixelFormat * format,
   435                                           Uint8 r, Uint8 g, Uint8 b);
   436 
   437 /**
   438  *  \brief Maps an RGBA quadruple to a pixel value for a given pixel format.
   439  *
   440  *  \sa SDL_MapRGB
   441  */
   442 extern DECLSPEC Uint32 SDLCALL SDL_MapRGBA(const SDL_PixelFormat * format,
   443                                            Uint8 r, Uint8 g, Uint8 b,
   444                                            Uint8 a);
   445 
   446 /**
   447  *  \brief Get the RGB components from a pixel of the specified format.
   448  *
   449  *  \sa SDL_GetRGBA
   450  */
   451 extern DECLSPEC void SDLCALL SDL_GetRGB(Uint32 pixel,
   452                                         const SDL_PixelFormat * format,
   453                                         Uint8 * r, Uint8 * g, Uint8 * b);
   454 
   455 /**
   456  *  \brief Get the RGBA components from a pixel of the specified format.
   457  *
   458  *  \sa SDL_GetRGB
   459  */
   460 extern DECLSPEC void SDLCALL SDL_GetRGBA(Uint32 pixel,
   461                                          const SDL_PixelFormat * format,
   462                                          Uint8 * r, Uint8 * g, Uint8 * b,
   463                                          Uint8 * a);
   464 
   465 /**
   466  *  \brief Calculate a 256 entry gamma ramp for a gamma value.
   467  */
   468 extern DECLSPEC void SDLCALL SDL_CalculateGammaRamp(float gamma, Uint16 * ramp);
   469 
   470 
   471 /* Ends C function definitions when using C++ */
   472 #ifdef __cplusplus
   473 }
   474 #endif
   475 #include "close_code.h"
   476 
   477 #endif /* SDL_pixels_h_ */
   478 
   479 /* vi: set ts=4 sw=4 expandtab: */