cscg22-gearboy

CSCG 2022 Challenge 'Gearboy'
git clone https://git.sinitax.com/sinitax/cscg22-gearboy
Log | Files | Refs | sfeed.txt

SDL_pixels.h (17474B)


      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
     37extern "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. */
     51typedef 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. */
     68typedef 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. */
     76typedef 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 */
     92typedef 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. */
    104typedef 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() */
    171typedef 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_RGB444 =
    192        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
    193                               SDL_PACKEDLAYOUT_4444, 12, 2),
    194    SDL_PIXELFORMAT_BGR444 =
    195        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
    196                               SDL_PACKEDLAYOUT_4444, 12, 2),
    197    SDL_PIXELFORMAT_RGB555 =
    198        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
    199                               SDL_PACKEDLAYOUT_1555, 15, 2),
    200    SDL_PIXELFORMAT_BGR555 =
    201        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
    202                               SDL_PACKEDLAYOUT_1555, 15, 2),
    203    SDL_PIXELFORMAT_ARGB4444 =
    204        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB,
    205                               SDL_PACKEDLAYOUT_4444, 16, 2),
    206    SDL_PIXELFORMAT_RGBA4444 =
    207        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA,
    208                               SDL_PACKEDLAYOUT_4444, 16, 2),
    209    SDL_PIXELFORMAT_ABGR4444 =
    210        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR,
    211                               SDL_PACKEDLAYOUT_4444, 16, 2),
    212    SDL_PIXELFORMAT_BGRA4444 =
    213        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA,
    214                               SDL_PACKEDLAYOUT_4444, 16, 2),
    215    SDL_PIXELFORMAT_ARGB1555 =
    216        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB,
    217                               SDL_PACKEDLAYOUT_1555, 16, 2),
    218    SDL_PIXELFORMAT_RGBA5551 =
    219        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA,
    220                               SDL_PACKEDLAYOUT_5551, 16, 2),
    221    SDL_PIXELFORMAT_ABGR1555 =
    222        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR,
    223                               SDL_PACKEDLAYOUT_1555, 16, 2),
    224    SDL_PIXELFORMAT_BGRA5551 =
    225        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA,
    226                               SDL_PACKEDLAYOUT_5551, 16, 2),
    227    SDL_PIXELFORMAT_RGB565 =
    228        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB,
    229                               SDL_PACKEDLAYOUT_565, 16, 2),
    230    SDL_PIXELFORMAT_BGR565 =
    231        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR,
    232                               SDL_PACKEDLAYOUT_565, 16, 2),
    233    SDL_PIXELFORMAT_RGB24 =
    234        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_RGB, 0,
    235                               24, 3),
    236    SDL_PIXELFORMAT_BGR24 =
    237        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_BGR, 0,
    238                               24, 3),
    239    SDL_PIXELFORMAT_RGB888 =
    240        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XRGB,
    241                               SDL_PACKEDLAYOUT_8888, 24, 4),
    242    SDL_PIXELFORMAT_RGBX8888 =
    243        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBX,
    244                               SDL_PACKEDLAYOUT_8888, 24, 4),
    245    SDL_PIXELFORMAT_BGR888 =
    246        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XBGR,
    247                               SDL_PACKEDLAYOUT_8888, 24, 4),
    248    SDL_PIXELFORMAT_BGRX8888 =
    249        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRX,
    250                               SDL_PACKEDLAYOUT_8888, 24, 4),
    251    SDL_PIXELFORMAT_ARGB8888 =
    252        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB,
    253                               SDL_PACKEDLAYOUT_8888, 32, 4),
    254    SDL_PIXELFORMAT_RGBA8888 =
    255        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBA,
    256                               SDL_PACKEDLAYOUT_8888, 32, 4),
    257    SDL_PIXELFORMAT_ABGR8888 =
    258        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ABGR,
    259                               SDL_PACKEDLAYOUT_8888, 32, 4),
    260    SDL_PIXELFORMAT_BGRA8888 =
    261        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRA,
    262                               SDL_PACKEDLAYOUT_8888, 32, 4),
    263    SDL_PIXELFORMAT_ARGB2101010 =
    264        SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB,
    265                               SDL_PACKEDLAYOUT_2101010, 32, 4),
    266
    267    /* Aliases for RGBA byte arrays of color data, for the current platform */
    268#if SDL_BYTEORDER == SDL_BIG_ENDIAN
    269    SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_RGBA8888,
    270    SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_ARGB8888,
    271    SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_BGRA8888,
    272    SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_ABGR8888,
    273#else
    274    SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_ABGR8888,
    275    SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_BGRA8888,
    276    SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_ARGB8888,
    277    SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_RGBA8888,
    278#endif
    279
    280    SDL_PIXELFORMAT_YV12 =      /**< Planar mode: Y + V + U  (3 planes) */
    281        SDL_DEFINE_PIXELFOURCC('Y', 'V', '1', '2'),
    282    SDL_PIXELFORMAT_IYUV =      /**< Planar mode: Y + U + V  (3 planes) */
    283        SDL_DEFINE_PIXELFOURCC('I', 'Y', 'U', 'V'),
    284    SDL_PIXELFORMAT_YUY2 =      /**< Packed mode: Y0+U0+Y1+V0 (1 plane) */
    285        SDL_DEFINE_PIXELFOURCC('Y', 'U', 'Y', '2'),
    286    SDL_PIXELFORMAT_UYVY =      /**< Packed mode: U0+Y0+V0+Y1 (1 plane) */
    287        SDL_DEFINE_PIXELFOURCC('U', 'Y', 'V', 'Y'),
    288    SDL_PIXELFORMAT_YVYU =      /**< Packed mode: Y0+V0+Y1+U0 (1 plane) */
    289        SDL_DEFINE_PIXELFOURCC('Y', 'V', 'Y', 'U'),
    290    SDL_PIXELFORMAT_NV12 =      /**< Planar mode: Y + U/V interleaved  (2 planes) */
    291        SDL_DEFINE_PIXELFOURCC('N', 'V', '1', '2'),
    292    SDL_PIXELFORMAT_NV21 =      /**< Planar mode: Y + V/U interleaved  (2 planes) */
    293        SDL_DEFINE_PIXELFOURCC('N', 'V', '2', '1'),
    294    SDL_PIXELFORMAT_EXTERNAL_OES =      /**< Android video texture format */
    295        SDL_DEFINE_PIXELFOURCC('O', 'E', 'S', ' ')
    296} SDL_PixelFormatEnum;
    297
    298typedef struct SDL_Color
    299{
    300    Uint8 r;
    301    Uint8 g;
    302    Uint8 b;
    303    Uint8 a;
    304} SDL_Color;
    305#define SDL_Colour SDL_Color
    306
    307typedef struct SDL_Palette
    308{
    309    int ncolors;
    310    SDL_Color *colors;
    311    Uint32 version;
    312    int refcount;
    313} SDL_Palette;
    314
    315/**
    316 *  \note Everything in the pixel format structure is read-only.
    317 */
    318typedef struct SDL_PixelFormat
    319{
    320    Uint32 format;
    321    SDL_Palette *palette;
    322    Uint8 BitsPerPixel;
    323    Uint8 BytesPerPixel;
    324    Uint8 padding[2];
    325    Uint32 Rmask;
    326    Uint32 Gmask;
    327    Uint32 Bmask;
    328    Uint32 Amask;
    329    Uint8 Rloss;
    330    Uint8 Gloss;
    331    Uint8 Bloss;
    332    Uint8 Aloss;
    333    Uint8 Rshift;
    334    Uint8 Gshift;
    335    Uint8 Bshift;
    336    Uint8 Ashift;
    337    int refcount;
    338    struct SDL_PixelFormat *next;
    339} SDL_PixelFormat;
    340
    341/**
    342 * \brief Get the human readable name of a pixel format
    343 */
    344extern DECLSPEC const char* SDLCALL SDL_GetPixelFormatName(Uint32 format);
    345
    346/**
    347 *  \brief Convert one of the enumerated pixel formats to a bpp and RGBA masks.
    348 *
    349 *  \return SDL_TRUE, or SDL_FALSE if the conversion wasn't possible.
    350 *
    351 *  \sa SDL_MasksToPixelFormatEnum()
    352 */
    353extern DECLSPEC SDL_bool SDLCALL SDL_PixelFormatEnumToMasks(Uint32 format,
    354                                                            int *bpp,
    355                                                            Uint32 * Rmask,
    356                                                            Uint32 * Gmask,
    357                                                            Uint32 * Bmask,
    358                                                            Uint32 * Amask);
    359
    360/**
    361 *  \brief Convert a bpp and RGBA masks to an enumerated pixel format.
    362 *
    363 *  \return The pixel format, or ::SDL_PIXELFORMAT_UNKNOWN if the conversion
    364 *          wasn't possible.
    365 *
    366 *  \sa SDL_PixelFormatEnumToMasks()
    367 */
    368extern DECLSPEC Uint32 SDLCALL SDL_MasksToPixelFormatEnum(int bpp,
    369                                                          Uint32 Rmask,
    370                                                          Uint32 Gmask,
    371                                                          Uint32 Bmask,
    372                                                          Uint32 Amask);
    373
    374/**
    375 *  \brief Create an SDL_PixelFormat structure from a pixel format enum.
    376 */
    377extern DECLSPEC SDL_PixelFormat * SDLCALL SDL_AllocFormat(Uint32 pixel_format);
    378
    379/**
    380 *  \brief Free an SDL_PixelFormat structure.
    381 */
    382extern DECLSPEC void SDLCALL SDL_FreeFormat(SDL_PixelFormat *format);
    383
    384/**
    385 *  \brief Create a palette structure with the specified number of color
    386 *         entries.
    387 *
    388 *  \return A new palette, or NULL if there wasn't enough memory.
    389 *
    390 *  \note The palette entries are initialized to white.
    391 *
    392 *  \sa SDL_FreePalette()
    393 */
    394extern DECLSPEC SDL_Palette *SDLCALL SDL_AllocPalette(int ncolors);
    395
    396/**
    397 *  \brief Set the palette for a pixel format structure.
    398 */
    399extern DECLSPEC int SDLCALL SDL_SetPixelFormatPalette(SDL_PixelFormat * format,
    400                                                      SDL_Palette *palette);
    401
    402/**
    403 *  \brief Set a range of colors in a palette.
    404 *
    405 *  \param palette    The palette to modify.
    406 *  \param colors     An array of colors to copy into the palette.
    407 *  \param firstcolor The index of the first palette entry to modify.
    408 *  \param ncolors    The number of entries to modify.
    409 *
    410 *  \return 0 on success, or -1 if not all of the colors could be set.
    411 */
    412extern DECLSPEC int SDLCALL SDL_SetPaletteColors(SDL_Palette * palette,
    413                                                 const SDL_Color * colors,
    414                                                 int firstcolor, int ncolors);
    415
    416/**
    417 *  \brief Free a palette created with SDL_AllocPalette().
    418 *
    419 *  \sa SDL_AllocPalette()
    420 */
    421extern DECLSPEC void SDLCALL SDL_FreePalette(SDL_Palette * palette);
    422
    423/**
    424 *  \brief Maps an RGB triple to an opaque pixel value for a given pixel format.
    425 *
    426 *  \sa SDL_MapRGBA
    427 */
    428extern DECLSPEC Uint32 SDLCALL SDL_MapRGB(const SDL_PixelFormat * format,
    429                                          Uint8 r, Uint8 g, Uint8 b);
    430
    431/**
    432 *  \brief Maps an RGBA quadruple to a pixel value for a given pixel format.
    433 *
    434 *  \sa SDL_MapRGB
    435 */
    436extern DECLSPEC Uint32 SDLCALL SDL_MapRGBA(const SDL_PixelFormat * format,
    437                                           Uint8 r, Uint8 g, Uint8 b,
    438                                           Uint8 a);
    439
    440/**
    441 *  \brief Get the RGB components from a pixel of the specified format.
    442 *
    443 *  \sa SDL_GetRGBA
    444 */
    445extern DECLSPEC void SDLCALL SDL_GetRGB(Uint32 pixel,
    446                                        const SDL_PixelFormat * format,
    447                                        Uint8 * r, Uint8 * g, Uint8 * b);
    448
    449/**
    450 *  \brief Get the RGBA components from a pixel of the specified format.
    451 *
    452 *  \sa SDL_GetRGB
    453 */
    454extern DECLSPEC void SDLCALL SDL_GetRGBA(Uint32 pixel,
    455                                         const SDL_PixelFormat * format,
    456                                         Uint8 * r, Uint8 * g, Uint8 * b,
    457                                         Uint8 * a);
    458
    459/**
    460 *  \brief Calculate a 256 entry gamma ramp for a gamma value.
    461 */
    462extern DECLSPEC void SDLCALL SDL_CalculateGammaRamp(float gamma, Uint16 * ramp);
    463
    464
    465/* Ends C function definitions when using C++ */
    466#ifdef __cplusplus
    467}
    468#endif
    469#include "close_code.h"
    470
    471#endif /* SDL_pixels_h_ */
    472
    473/* vi: set ts=4 sw=4 expandtab: */