Miguel Ruiz / SDL_lib2

SDL Library

Dependents:   H261_decoder

SDL_pixels.h@0:7fb6877b5d7c, 2016-09-22 (annotated)

Committer:
miruga27
Date:
Thu Sep 22 00:03:09 2016 +0000
Revision:
0:7fb6877b5d7c
SDL

Who changed what in which revision?

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