SDL_pixels.h 17 KB

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