SDL  2.0
SDL_pixels.h File Reference
#include "SDL_stdinc.h"
#include "SDL_endian.h"
#include "begin_code.h"
#include "close_code.h"
+ Include dependency graph for SDL_pixels.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  SDL_Color
 
struct  SDL_Palette
 
struct  SDL_PixelFormat
 

Transparency definitions

These define alpha as the opacity of a surface.

#define SDL_ALPHA_OPAQUE   255
 
#define SDL_ALPHA_TRANSPARENT   0
 
#define SDL_DEFINE_PIXELFOURCC(A, B, C, D)   SDL_FOURCC(A, B, C, D)
 
#define SDL_DEFINE_PIXELFORMAT(type, order, layout, bits, bytes)
 
#define SDL_PIXELFLAG(X)   (((X) >> 28) & 0x0F)
 
#define SDL_PIXELTYPE(X)   (((X) >> 24) & 0x0F)
 
#define SDL_PIXELORDER(X)   (((X) >> 20) & 0x0F)
 
#define SDL_PIXELLAYOUT(X)   (((X) >> 16) & 0x0F)
 
#define SDL_BITSPERPIXEL(X)   (((X) >> 8) & 0xFF)
 
#define SDL_BYTESPERPIXEL(X)
 
#define SDL_ISPIXELFORMAT_INDEXED(format)
 
#define SDL_ISPIXELFORMAT_PACKED(format)
 
#define SDL_ISPIXELFORMAT_ARRAY(format)
 
#define SDL_ISPIXELFORMAT_ALPHA(format)
 
#define SDL_ISPIXELFORMAT_FOURCC(format)   ((format) && (SDL_PIXELFLAG(format) != 1))
 
#define SDL_Colour   SDL_Color
 
enum  SDL_PixelType {
  SDL_PIXELTYPE_UNKNOWN,
  SDL_PIXELTYPE_INDEX1,
  SDL_PIXELTYPE_INDEX4,
  SDL_PIXELTYPE_INDEX8,
  SDL_PIXELTYPE_PACKED8,
  SDL_PIXELTYPE_PACKED16,
  SDL_PIXELTYPE_PACKED32,
  SDL_PIXELTYPE_ARRAYU8,
  SDL_PIXELTYPE_ARRAYU16,
  SDL_PIXELTYPE_ARRAYU32,
  SDL_PIXELTYPE_ARRAYF16,
  SDL_PIXELTYPE_ARRAYF32
}
 
enum  SDL_BitmapOrder {
  SDL_BITMAPORDER_NONE,
  SDL_BITMAPORDER_4321,
  SDL_BITMAPORDER_1234
}
 
enum  SDL_PackedOrder {
  SDL_PACKEDORDER_NONE,
  SDL_PACKEDORDER_XRGB,
  SDL_PACKEDORDER_RGBX,
  SDL_PACKEDORDER_ARGB,
  SDL_PACKEDORDER_RGBA,
  SDL_PACKEDORDER_XBGR,
  SDL_PACKEDORDER_BGRX,
  SDL_PACKEDORDER_ABGR,
  SDL_PACKEDORDER_BGRA
}
 
enum  SDL_ArrayOrder {
  SDL_ARRAYORDER_NONE,
  SDL_ARRAYORDER_RGB,
  SDL_ARRAYORDER_RGBA,
  SDL_ARRAYORDER_ARGB,
  SDL_ARRAYORDER_BGR,
  SDL_ARRAYORDER_BGRA,
  SDL_ARRAYORDER_ABGR
}
 
enum  SDL_PackedLayout {
  SDL_PACKEDLAYOUT_NONE,
  SDL_PACKEDLAYOUT_332,
  SDL_PACKEDLAYOUT_4444,
  SDL_PACKEDLAYOUT_1555,
  SDL_PACKEDLAYOUT_5551,
  SDL_PACKEDLAYOUT_565,
  SDL_PACKEDLAYOUT_8888,
  SDL_PACKEDLAYOUT_2101010,
  SDL_PACKEDLAYOUT_1010102
}
 
enum  SDL_PixelFormatEnum {
  SDL_PIXELFORMAT_UNKNOWN,
  SDL_PIXELFORMAT_INDEX1LSB,
  SDL_PIXELFORMAT_INDEX1MSB,
  SDL_PIXELFORMAT_INDEX4LSB,
  SDL_PIXELFORMAT_INDEX4MSB,
  SDL_PIXELFORMAT_INDEX8,
  SDL_PIXELFORMAT_RGB332,
  SDL_PIXELFORMAT_RGB444,
  SDL_PIXELFORMAT_BGR444,
  SDL_PIXELFORMAT_RGB555,
  SDL_PIXELFORMAT_BGR555,
  SDL_PIXELFORMAT_ARGB4444,
  SDL_PIXELFORMAT_RGBA4444,
  SDL_PIXELFORMAT_ABGR4444,
  SDL_PIXELFORMAT_BGRA4444,
  SDL_PIXELFORMAT_ARGB1555,
  SDL_PIXELFORMAT_RGBA5551,
  SDL_PIXELFORMAT_ABGR1555,
  SDL_PIXELFORMAT_BGRA5551,
  SDL_PIXELFORMAT_RGB565,
  SDL_PIXELFORMAT_BGR565,
  SDL_PIXELFORMAT_RGB24,
  SDL_PIXELFORMAT_BGR24,
  SDL_PIXELFORMAT_RGB888,
  SDL_PIXELFORMAT_RGBX8888,
  SDL_PIXELFORMAT_BGR888,
  SDL_PIXELFORMAT_BGRX8888,
  SDL_PIXELFORMAT_ARGB8888,
  SDL_PIXELFORMAT_RGBA8888,
  SDL_PIXELFORMAT_ABGR8888,
  SDL_PIXELFORMAT_BGRA8888,
  SDL_PIXELFORMAT_ARGB2101010,
  SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_ABGR8888,
  SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_BGRA8888,
  SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_ARGB8888,
  SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_RGBA8888,
  SDL_PIXELFORMAT_YV12,
  SDL_PIXELFORMAT_IYUV,
  SDL_PIXELFORMAT_YUY2,
  SDL_PIXELFORMAT_UYVY,
  SDL_PIXELFORMAT_YVYU,
  SDL_PIXELFORMAT_NV12,
  SDL_PIXELFORMAT_NV21,
  SDL_PIXELFORMAT_EXTERNAL_OES =
}
 
const char * SDL_GetPixelFormatName (Uint32 format)
 Get the human readable name of a pixel format. More...
 
SDL_bool SDL_PixelFormatEnumToMasks (Uint32 format, int *bpp, Uint32 *Rmask, Uint32 *Gmask, Uint32 *Bmask, Uint32 *Amask)
 Convert one of the enumerated pixel formats to a bpp and RGBA masks. More...
 
Uint32 SDL_MasksToPixelFormatEnum (int bpp, Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 Amask)
 Convert a bpp and RGBA masks to an enumerated pixel format. More...
 
SDL_PixelFormatSDL_AllocFormat (Uint32 pixel_format)
 Create an SDL_PixelFormat structure from a pixel format enum. More...
 
void SDL_FreeFormat (SDL_PixelFormat *format)
 Free an SDL_PixelFormat structure. More...
 
SDL_PaletteSDL_AllocPalette (int ncolors)
 Create a palette structure with the specified number of color entries. More...
 
int SDL_SetPixelFormatPalette (SDL_PixelFormat *format, SDL_Palette *palette)
 Set the palette for a pixel format structure. More...
 
int SDL_SetPaletteColors (SDL_Palette *palette, const SDL_Color *colors, int firstcolor, int ncolors)
 Set a range of colors in a palette. More...
 
void SDL_FreePalette (SDL_Palette *palette)
 Free a palette created with SDL_AllocPalette(). More...
 
Uint32 SDL_MapRGB (const SDL_PixelFormat *format, Uint8 r, Uint8 g, Uint8 b)
 Maps an RGB triple to an opaque pixel value for a given pixel format. More...
 
Uint32 SDL_MapRGBA (const SDL_PixelFormat *format, Uint8 r, Uint8 g, Uint8 b, Uint8 a)
 Maps an RGBA quadruple to a pixel value for a given pixel format. More...
 
void SDL_GetRGB (Uint32 pixel, const SDL_PixelFormat *format, Uint8 *r, Uint8 *g, Uint8 *b)
 Get the RGB components from a pixel of the specified format. More...
 
void SDL_GetRGBA (Uint32 pixel, const SDL_PixelFormat *format, Uint8 *r, Uint8 *g, Uint8 *b, Uint8 *a)
 Get the RGBA components from a pixel of the specified format. More...
 
void SDL_CalculateGammaRamp (float gamma, Uint16 *ramp)
 Calculate a 256 entry gamma ramp for a gamma value. More...
 

Detailed Description

Header for the enumerated pixel format definitions.

Definition in file SDL_pixels.h.

Macro Definition Documentation

◆ SDL_ALPHA_OPAQUE

#define SDL_ALPHA_OPAQUE   255

Definition at line 46 of file SDL_pixels.h.

◆ SDL_ALPHA_TRANSPARENT

#define SDL_ALPHA_TRANSPARENT   0

Definition at line 47 of file SDL_pixels.h.

◆ SDL_BITSPERPIXEL

#define SDL_BITSPERPIXEL (   X)    (((X) >> 8) & 0xFF)

Definition at line 127 of file SDL_pixels.h.

◆ SDL_BYTESPERPIXEL

#define SDL_BYTESPERPIXEL (   X)
Value:
((((X) == SDL_PIXELFORMAT_YUY2) || \
((X) == SDL_PIXELFORMAT_UYVY) || \
((X) == SDL_PIXELFORMAT_YVYU)) ? 2 : 1) : (((X) >> 0) & 0xFF))

Definition at line 128 of file SDL_pixels.h.

◆ SDL_Colour

#define SDL_Colour   SDL_Color

Definition at line 305 of file SDL_pixels.h.

◆ SDL_DEFINE_PIXELFORMAT

#define SDL_DEFINE_PIXELFORMAT (   type,
  order,
  layout,
  bits,
  bytes 
)
Value:
((1 << 28) | ((type) << 24) | ((order) << 20) | ((layout) << 16) | \
((bits) << 8) | ((bytes) << 0))

Definition at line 119 of file SDL_pixels.h.

◆ SDL_DEFINE_PIXELFOURCC

#define SDL_DEFINE_PIXELFOURCC (   A,
  B,
  C,
 
)    SDL_FOURCC(A, B, C, D)

Definition at line 117 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_ALPHA

◆ SDL_ISPIXELFORMAT_ARRAY

◆ SDL_ISPIXELFORMAT_FOURCC

#define SDL_ISPIXELFORMAT_FOURCC (   format)    ((format) && (SDL_PIXELFLAG(format) != 1))

Definition at line 167 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_INDEXED

#define SDL_ISPIXELFORMAT_INDEXED (   format)

◆ SDL_ISPIXELFORMAT_PACKED

#define SDL_ISPIXELFORMAT_PACKED (   format)

◆ SDL_PIXELFLAG

#define SDL_PIXELFLAG (   X)    (((X) >> 28) & 0x0F)

Definition at line 123 of file SDL_pixels.h.

◆ SDL_PIXELLAYOUT

#define SDL_PIXELLAYOUT (   X)    (((X) >> 16) & 0x0F)

Definition at line 126 of file SDL_pixels.h.

◆ SDL_PIXELORDER

#define SDL_PIXELORDER (   X)    (((X) >> 20) & 0x0F)

Definition at line 125 of file SDL_pixels.h.

◆ SDL_PIXELTYPE

#define SDL_PIXELTYPE (   X)    (((X) >> 24) & 0x0F)

Definition at line 124 of file SDL_pixels.h.

Enumeration Type Documentation

◆ SDL_ArrayOrder

Array component order, low byte -> high byte.

Enumerator
SDL_ARRAYORDER_NONE 
SDL_ARRAYORDER_RGB 
SDL_ARRAYORDER_RGBA 
SDL_ARRAYORDER_ARGB 
SDL_ARRAYORDER_BGR 
SDL_ARRAYORDER_BGRA 
SDL_ARRAYORDER_ABGR 

Definition at line 92 of file SDL_pixels.h.

◆ SDL_BitmapOrder

Bitmap pixel order, high bit -> low bit.

Enumerator
SDL_BITMAPORDER_NONE 
SDL_BITMAPORDER_4321 
SDL_BITMAPORDER_1234 

Definition at line 68 of file SDL_pixels.h.

◆ SDL_PackedLayout

Packed component layout.

Enumerator
SDL_PACKEDLAYOUT_NONE 
SDL_PACKEDLAYOUT_332 
SDL_PACKEDLAYOUT_4444 
SDL_PACKEDLAYOUT_1555 
SDL_PACKEDLAYOUT_5551 
SDL_PACKEDLAYOUT_565 
SDL_PACKEDLAYOUT_8888 
SDL_PACKEDLAYOUT_2101010 
SDL_PACKEDLAYOUT_1010102 

Definition at line 104 of file SDL_pixels.h.

◆ SDL_PackedOrder

Packed component order, high bit -> low bit.

Enumerator
SDL_PACKEDORDER_NONE 
SDL_PACKEDORDER_XRGB 
SDL_PACKEDORDER_RGBX 
SDL_PACKEDORDER_ARGB 
SDL_PACKEDORDER_RGBA 
SDL_PACKEDORDER_XBGR 
SDL_PACKEDORDER_BGRX 
SDL_PACKEDORDER_ABGR 
SDL_PACKEDORDER_BGRA 

Definition at line 76 of file SDL_pixels.h.

◆ SDL_PixelFormatEnum

Enumerator
SDL_PIXELFORMAT_UNKNOWN 
SDL_PIXELFORMAT_INDEX1LSB 
SDL_PIXELFORMAT_INDEX1MSB 
SDL_PIXELFORMAT_INDEX4LSB 
SDL_PIXELFORMAT_INDEX4MSB 
SDL_PIXELFORMAT_INDEX8 
SDL_PIXELFORMAT_RGB332 
SDL_PIXELFORMAT_RGB444 
SDL_PIXELFORMAT_BGR444 
SDL_PIXELFORMAT_RGB555 
SDL_PIXELFORMAT_BGR555 
SDL_PIXELFORMAT_ARGB4444 
SDL_PIXELFORMAT_RGBA4444 
SDL_PIXELFORMAT_ABGR4444 
SDL_PIXELFORMAT_BGRA4444 
SDL_PIXELFORMAT_ARGB1555 
SDL_PIXELFORMAT_RGBA5551 
SDL_PIXELFORMAT_ABGR1555 
SDL_PIXELFORMAT_BGRA5551 
SDL_PIXELFORMAT_RGB565 
SDL_PIXELFORMAT_BGR565 
SDL_PIXELFORMAT_RGB24 
SDL_PIXELFORMAT_BGR24 
SDL_PIXELFORMAT_RGB888 
SDL_PIXELFORMAT_RGBX8888 
SDL_PIXELFORMAT_BGR888 
SDL_PIXELFORMAT_BGRX8888 
SDL_PIXELFORMAT_ARGB8888 
SDL_PIXELFORMAT_RGBA8888 
SDL_PIXELFORMAT_ABGR8888 
SDL_PIXELFORMAT_BGRA8888 
SDL_PIXELFORMAT_ARGB2101010 
SDL_PIXELFORMAT_RGBA32 
SDL_PIXELFORMAT_ARGB32 
SDL_PIXELFORMAT_BGRA32 
SDL_PIXELFORMAT_ABGR32 
SDL_PIXELFORMAT_YV12 

Planar mode: Y + V + U (3 planes)

SDL_PIXELFORMAT_IYUV 

Planar mode: Y + U + V (3 planes)

SDL_PIXELFORMAT_YUY2 

Packed mode: Y0+U0+Y1+V0 (1 plane)

SDL_PIXELFORMAT_UYVY 

Packed mode: U0+Y0+V0+Y1 (1 plane)

SDL_PIXELFORMAT_YVYU 

Packed mode: Y0+V0+Y1+U0 (1 plane)

SDL_PIXELFORMAT_NV12 

Planar mode: Y + U/V interleaved (2 planes)

SDL_PIXELFORMAT_NV21 

Planar mode: Y + V/U interleaved (2 planes)

SDL_PIXELFORMAT_EXTERNAL_OES 

Android video texture format

Definition at line 171 of file SDL_pixels.h.

172 {
176  1, 0),
179  1, 0),
182  4, 0),
185  4, 0),
190  SDL_PACKEDLAYOUT_332, 8, 1),
193  SDL_PACKEDLAYOUT_4444, 12, 2),
196  SDL_PACKEDLAYOUT_4444, 12, 2),
199  SDL_PACKEDLAYOUT_1555, 15, 2),
202  SDL_PACKEDLAYOUT_1555, 15, 2),
205  SDL_PACKEDLAYOUT_4444, 16, 2),
208  SDL_PACKEDLAYOUT_4444, 16, 2),
211  SDL_PACKEDLAYOUT_4444, 16, 2),
214  SDL_PACKEDLAYOUT_4444, 16, 2),
217  SDL_PACKEDLAYOUT_1555, 16, 2),
220  SDL_PACKEDLAYOUT_5551, 16, 2),
223  SDL_PACKEDLAYOUT_1555, 16, 2),
226  SDL_PACKEDLAYOUT_5551, 16, 2),
229  SDL_PACKEDLAYOUT_565, 16, 2),
232  SDL_PACKEDLAYOUT_565, 16, 2),
235  24, 3),
238  24, 3),
241  SDL_PACKEDLAYOUT_8888, 24, 4),
244  SDL_PACKEDLAYOUT_8888, 24, 4),
247  SDL_PACKEDLAYOUT_8888, 24, 4),
250  SDL_PACKEDLAYOUT_8888, 24, 4),
253  SDL_PACKEDLAYOUT_8888, 32, 4),
256  SDL_PACKEDLAYOUT_8888, 32, 4),
259  SDL_PACKEDLAYOUT_8888, 32, 4),
262  SDL_PACKEDLAYOUT_8888, 32, 4),
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
273 #else
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', ' ')

◆ SDL_PixelType

Pixel type.

Enumerator
SDL_PIXELTYPE_UNKNOWN 
SDL_PIXELTYPE_INDEX1 
SDL_PIXELTYPE_INDEX4 
SDL_PIXELTYPE_INDEX8 
SDL_PIXELTYPE_PACKED8 
SDL_PIXELTYPE_PACKED16 
SDL_PIXELTYPE_PACKED32 
SDL_PIXELTYPE_ARRAYU8 
SDL_PIXELTYPE_ARRAYU16 
SDL_PIXELTYPE_ARRAYU32 
SDL_PIXELTYPE_ARRAYF16 
SDL_PIXELTYPE_ARRAYF32 

Definition at line 51 of file SDL_pixels.h.

Function Documentation

◆ SDL_AllocFormat()

SDL_PixelFormat* SDL_AllocFormat ( Uint32  pixel_format)

Create an SDL_PixelFormat structure from a pixel format enum.

Definition at line 503 of file SDL_pixels.c.

504 {
506 
508 
509  /* Look it up in our list of previously allocated formats */
510  for (format = formats; format; format = format->next) {
511  if (pixel_format == format->format) {
512  ++format->refcount;
514  return format;
515  }
516  }
517 
518  /* Allocate an empty pixel format structure, and initialize it */
519  format = SDL_malloc(sizeof(*format));
520  if (format == NULL) {
522  SDL_OutOfMemory();
523  return NULL;
524  }
525  if (SDL_InitFormat(format, pixel_format) < 0) {
527  SDL_free(format);
528  SDL_InvalidParamError("format");
529  return NULL;
530  }
531 
532  if (!SDL_ISPIXELFORMAT_INDEXED(pixel_format)) {
533  /* Cache the RGB formats */
534  format->next = formats;
535  formats = format;
536  }
537 
539 
540  return format;
541 }

References formats, formats_lock, NULL, SDL_AtomicLock, SDL_AtomicUnlock, SDL_free, SDL_InitFormat(), SDL_InvalidParamError, SDL_ISPIXELFORMAT_INDEXED, SDL_malloc, and SDL_OutOfMemory.

◆ SDL_AllocPalette()

SDL_Palette* SDL_AllocPalette ( int  ncolors)

Create a palette structure with the specified number of color entries.

Returns
A new palette, or NULL if there wasn't enough memory.
Note
The palette entries are initialized to white.
See also
SDL_FreePalette()

Definition at line 646 of file SDL_pixels.c.

647 {
648  SDL_Palette *palette;
649 
650  /* Input validation */
651  if (ncolors < 1) {
652  SDL_InvalidParamError("ncolors");
653  return NULL;
654  }
655 
656  palette = (SDL_Palette *) SDL_malloc(sizeof(*palette));
657  if (!palette) {
658  SDL_OutOfMemory();
659  return NULL;
660  }
661  palette->colors =
662  (SDL_Color *) SDL_malloc(ncolors * sizeof(*palette->colors));
663  if (!palette->colors) {
664  SDL_free(palette);
665  return NULL;
666  }
667  palette->ncolors = ncolors;
668  palette->version = 1;
669  palette->refcount = 1;
670 
671  SDL_memset(palette->colors, 0xFF, ncolors * sizeof(*palette->colors));
672 
673  return palette;
674 }

References SDL_Palette::colors, SDL_Palette::ncolors, NULL, SDL_Palette::refcount, SDL_free, SDL_InvalidParamError, SDL_malloc, SDL_memset, SDL_OutOfMemory, and SDL_Palette::version.

◆ SDL_CalculateGammaRamp()

void SDL_CalculateGammaRamp ( float  gamma,
Uint16 ramp 
)

Calculate a 256 entry gamma ramp for a gamma value.

Definition at line 1095 of file SDL_pixels.c.

1096 {
1097  int i;
1098 
1099  /* Input validation */
1100  if (gamma < 0.0f ) {
1101  SDL_InvalidParamError("gamma");
1102  return;
1103  }
1104  if (ramp == NULL) {
1105  SDL_InvalidParamError("ramp");
1106  return;
1107  }
1108 
1109  /* 0.0 gamma is all black */
1110  if (gamma == 0.0f) {
1111  SDL_memset(ramp, 0, 256 * sizeof(Uint16));
1112  return;
1113  } else if (gamma == 1.0f) {
1114  /* 1.0 gamma is identity */
1115  for (i = 0; i < 256; ++i) {
1116  ramp[i] = (i << 8) | i;
1117  }
1118  return;
1119  } else {
1120  /* Calculate a real gamma ramp */
1121  int value;
1122  gamma = 1.0f / gamma;
1123  for (i = 0; i < 256; ++i) {
1124  value =
1125  (int) (SDL_pow((double) i / 256.0, gamma) * 65535.0 + 0.5);
1126  if (value > 65535) {
1127  value = 65535;
1128  }
1129  ramp[i] = (Uint16) value;
1130  }
1131  }
1132 }

References i, NULL, SDL_InvalidParamError, SDL_memset, and SDL_pow.

◆ SDL_FreeFormat()

void SDL_FreeFormat ( SDL_PixelFormat format)

Free an SDL_PixelFormat structure.

Definition at line 609 of file SDL_pixels.c.

610 {
611  SDL_PixelFormat *prev;
612 
613  if (!format) {
614  SDL_InvalidParamError("format");
615  return;
616  }
617 
619 
620  if (--format->refcount > 0) {
622  return;
623  }
624 
625  /* Remove this format from our list */
626  if (format == formats) {
627  formats = format->next;
628  } else if (formats) {
629  for (prev = formats; prev->next; prev = prev->next) {
630  if (prev->next == format) {
631  prev->next = format->next;
632  break;
633  }
634  }
635  }
636 
638 
639  if (format->palette) {
640  SDL_FreePalette(format->palette);
641  }
642  SDL_free(format);
643 }

References formats_lock, SDL_PixelFormat::next, SDL_AtomicLock, SDL_AtomicUnlock, SDL_free, SDL_FreePalette(), and SDL_InvalidParamError.

◆ SDL_FreePalette()

void SDL_FreePalette ( SDL_Palette palette)

Free a palette created with SDL_AllocPalette().

See also
SDL_AllocPalette()

Definition at line 732 of file SDL_pixels.c.

733 {
734  if (!palette) {
735  SDL_InvalidParamError("palette");
736  return;
737  }
738  if (--palette->refcount > 0) {
739  return;
740  }
741  SDL_free(palette->colors);
742  SDL_free(palette);
743 }

References SDL_Palette::colors, SDL_Palette::refcount, SDL_free, and SDL_InvalidParamError.

Referenced by SDL_FreeFormat(), and SDL_SetPixelFormatPalette().

◆ SDL_GetPixelFormatName()

const char* SDL_GetPixelFormatName ( Uint32  format)

Get the human readable name of a pixel format.

Definition at line 86 of file SDL_pixels.c.

87 {
88  switch (format) {
89 #define CASE(X) case X: return #X;
128 #undef CASE
129  default:
130  return "SDL_PIXELFORMAT_UNKNOWN";
131  }
132 }

References CASE, SDL_PIXELFORMAT_ABGR1555, SDL_PIXELFORMAT_ABGR4444, SDL_PIXELFORMAT_ABGR8888, SDL_PIXELFORMAT_ARGB1555, SDL_PIXELFORMAT_ARGB2101010, SDL_PIXELFORMAT_ARGB4444, SDL_PIXELFORMAT_ARGB8888, SDL_PIXELFORMAT_BGR24, SDL_PIXELFORMAT_BGR444, SDL_PIXELFORMAT_BGR555, SDL_PIXELFORMAT_BGR565, SDL_PIXELFORMAT_BGR888, SDL_PIXELFORMAT_BGRA4444, SDL_PIXELFORMAT_BGRA5551, SDL_PIXELFORMAT_BGRA8888, SDL_PIXELFORMAT_BGRX8888, SDL_PIXELFORMAT_INDEX1LSB, SDL_PIXELFORMAT_INDEX1MSB, SDL_PIXELFORMAT_INDEX4LSB, SDL_PIXELFORMAT_INDEX4MSB, SDL_PIXELFORMAT_INDEX8, SDL_PIXELFORMAT_IYUV, SDL_PIXELFORMAT_NV12, SDL_PIXELFORMAT_NV21, SDL_PIXELFORMAT_RGB24, SDL_PIXELFORMAT_RGB332, SDL_PIXELFORMAT_RGB444, SDL_PIXELFORMAT_RGB555, SDL_PIXELFORMAT_RGB565, SDL_PIXELFORMAT_RGB888, SDL_PIXELFORMAT_RGBA4444, SDL_PIXELFORMAT_RGBA5551, SDL_PIXELFORMAT_RGBA8888, SDL_PIXELFORMAT_RGBX8888, SDL_PIXELFORMAT_UYVY, SDL_PIXELFORMAT_YUY2, SDL_PIXELFORMAT_YV12, and SDL_PIXELFORMAT_YVYU.

◆ SDL_GetRGB()

void SDL_GetRGB ( Uint32  pixel,
const SDL_PixelFormat format,
Uint8 r,
Uint8 g,
Uint8 b 
)

Get the RGB components from a pixel of the specified format.

See also
SDL_GetRGBA

Definition at line 833 of file SDL_pixels.c.

835 {
836  if (format->palette == NULL) {
837  unsigned v;
838  v = (pixel & format->Rmask) >> format->Rshift;
839  *r = SDL_expand_byte[format->Rloss][v];
840  v = (pixel & format->Gmask) >> format->Gshift;
841  *g = SDL_expand_byte[format->Gloss][v];
842  v = (pixel & format->Bmask) >> format->Bshift;
843  *b = SDL_expand_byte[format->Bloss][v];
844  } else {
845  if (pixel < (unsigned)format->palette->ncolors) {
846  *r = format->palette->colors[pixel].r;
847  *g = format->palette->colors[pixel].g;
848  *b = format->palette->colors[pixel].b;
849  } else {
850  *r = *g = *b = 0;
851  }
852  }
853 }

References NULL, and SDL_expand_byte.

◆ SDL_GetRGBA()

void SDL_GetRGBA ( Uint32  pixel,
const SDL_PixelFormat format,
Uint8 r,
Uint8 g,
Uint8 b,
Uint8 a 
)

Get the RGBA components from a pixel of the specified format.

See also
SDL_GetRGB

Definition at line 856 of file SDL_pixels.c.

858 {
859  if (format->palette == NULL) {
860  unsigned v;
861  v = (pixel & format->Rmask) >> format->Rshift;
862  *r = SDL_expand_byte[format->Rloss][v];
863  v = (pixel & format->Gmask) >> format->Gshift;
864  *g = SDL_expand_byte[format->Gloss][v];
865  v = (pixel & format->Bmask) >> format->Bshift;
866  *b = SDL_expand_byte[format->Bloss][v];
867  v = (pixel & format->Amask) >> format->Ashift;
868  *a = SDL_expand_byte[format->Aloss][v];
869  } else {
870  if (pixel < (unsigned)format->palette->ncolors) {
871  *r = format->palette->colors[pixel].r;
872  *g = format->palette->colors[pixel].g;
873  *b = format->palette->colors[pixel].b;
874  *a = format->palette->colors[pixel].a;
875  } else {
876  *r = *g = *b = *a = 0;
877  }
878  }
879 }

References NULL, and SDL_expand_byte.

◆ SDL_MapRGB()

Uint32 SDL_MapRGB ( const SDL_PixelFormat format,
Uint8  r,
Uint8  g,
Uint8  b 
)

Maps an RGB triple to an opaque pixel value for a given pixel format.

See also
SDL_MapRGBA

Definition at line 806 of file SDL_pixels.c.

807 {
808  if (format->palette == NULL) {
809  return (r >> format->Rloss) << format->Rshift
810  | (g >> format->Gloss) << format->Gshift
811  | (b >> format->Bloss) << format->Bshift | format->Amask;
812  } else {
813  return SDL_FindColor(format->palette, r, g, b, SDL_ALPHA_OPAQUE);
814  }
815 }

References NULL, SDL_ALPHA_OPAQUE, and SDL_FindColor().

◆ SDL_MapRGBA()

Uint32 SDL_MapRGBA ( const SDL_PixelFormat format,
Uint8  r,
Uint8  g,
Uint8  b,
Uint8  a 
)

Maps an RGBA quadruple to a pixel value for a given pixel format.

See also
SDL_MapRGB

Definition at line 819 of file SDL_pixels.c.

821 {
822  if (format->palette == NULL) {
823  return (r >> format->Rloss) << format->Rshift
824  | (g >> format->Gloss) << format->Gshift
825  | (b >> format->Bloss) << format->Bshift
826  | ((a >> format->Aloss) << format->Ashift & format->Amask);
827  } else {
828  return SDL_FindColor(format->palette, r, g, b, a);
829  }
830 }

References NULL, and SDL_FindColor().

◆ SDL_MasksToPixelFormatEnum()

Uint32 SDL_MasksToPixelFormatEnum ( int  bpp,
Uint32  Rmask,
Uint32  Gmask,
Uint32  Bmask,
Uint32  Amask 
)

Convert a bpp and RGBA masks to an enumerated pixel format.

Returns
The pixel format, or SDL_PIXELFORMAT_UNKNOWN if the conversion wasn't possible.
See also
SDL_PixelFormatEnumToMasks()

Definition at line 294 of file SDL_pixels.c.

296 {
297  switch (bpp) {
298  case 1:
299  /* SDL defaults to MSB ordering */
301  case 4:
302  /* SDL defaults to MSB ordering */
304  case 8:
305  if (Rmask == 0) {
306  return SDL_PIXELFORMAT_INDEX8;
307  }
308  if (Rmask == 0xE0 &&
309  Gmask == 0x1C &&
310  Bmask == 0x03 &&
311  Amask == 0x00) {
312  return SDL_PIXELFORMAT_RGB332;
313  }
314  break;
315  case 12:
316  if (Rmask == 0) {
317  return SDL_PIXELFORMAT_RGB444;
318  }
319  if (Rmask == 0x0F00 &&
320  Gmask == 0x00F0 &&
321  Bmask == 0x000F &&
322  Amask == 0x0000) {
323  return SDL_PIXELFORMAT_RGB444;
324  }
325  if (Rmask == 0x000F &&
326  Gmask == 0x00F0 &&
327  Bmask == 0x0F00 &&
328  Amask == 0x0000) {
329  return SDL_PIXELFORMAT_BGR444;
330  }
331  break;
332  case 15:
333  if (Rmask == 0) {
334  return SDL_PIXELFORMAT_RGB555;
335  }
336  /* fallthrough */
337  case 16:
338  if (Rmask == 0) {
339  return SDL_PIXELFORMAT_RGB565;
340  }
341  if (Rmask == 0x7C00 &&
342  Gmask == 0x03E0 &&
343  Bmask == 0x001F &&
344  Amask == 0x0000) {
345  return SDL_PIXELFORMAT_RGB555;
346  }
347  if (Rmask == 0x001F &&
348  Gmask == 0x03E0 &&
349  Bmask == 0x7C00 &&
350  Amask == 0x0000) {
351  return SDL_PIXELFORMAT_BGR555;
352  }
353  if (Rmask == 0x0F00 &&
354  Gmask == 0x00F0 &&
355  Bmask == 0x000F &&
356  Amask == 0xF000) {
358  }
359  if (Rmask == 0xF000 &&
360  Gmask == 0x0F00 &&
361  Bmask == 0x00F0 &&
362  Amask == 0x000F) {
364  }
365  if (Rmask == 0x000F &&
366  Gmask == 0x00F0 &&
367  Bmask == 0x0F00 &&
368  Amask == 0xF000) {
370  }
371  if (Rmask == 0x00F0 &&
372  Gmask == 0x0F00 &&
373  Bmask == 0xF000 &&
374  Amask == 0x000F) {
376  }
377  if (Rmask == 0x7C00 &&
378  Gmask == 0x03E0 &&
379  Bmask == 0x001F &&
380  Amask == 0x8000) {
382  }
383  if (Rmask == 0xF800 &&
384  Gmask == 0x07C0 &&
385  Bmask == 0x003E &&
386  Amask == 0x0001) {
388  }
389  if (Rmask == 0x001F &&
390  Gmask == 0x03E0 &&
391  Bmask == 0x7C00 &&
392  Amask == 0x8000) {
394  }
395  if (Rmask == 0x003E &&
396  Gmask == 0x07C0 &&
397  Bmask == 0xF800 &&
398  Amask == 0x0001) {
400  }
401  if (Rmask == 0xF800 &&
402  Gmask == 0x07E0 &&
403  Bmask == 0x001F &&
404  Amask == 0x0000) {
405  return SDL_PIXELFORMAT_RGB565;
406  }
407  if (Rmask == 0x001F &&
408  Gmask == 0x07E0 &&
409  Bmask == 0xF800 &&
410  Amask == 0x0000) {
411  return SDL_PIXELFORMAT_BGR565;
412  }
413  if (Rmask == 0x003F &&
414  Gmask == 0x07C0 &&
415  Bmask == 0xF800 &&
416  Amask == 0x0000) {
417  /* Technically this would be BGR556, but Witek says this works in bug 3158 */
418  return SDL_PIXELFORMAT_RGB565;
419  }
420  break;
421  case 24:
422  switch (Rmask) {
423  case 0:
424  case 0x00FF0000:
425 #if SDL_BYTEORDER == SDL_BIG_ENDIAN
426  return SDL_PIXELFORMAT_RGB24;
427 #else
428  return SDL_PIXELFORMAT_BGR24;
429 #endif
430  case 0x000000FF:
431 #if SDL_BYTEORDER == SDL_BIG_ENDIAN
432  return SDL_PIXELFORMAT_BGR24;
433 #else
434  return SDL_PIXELFORMAT_RGB24;
435 #endif
436  }
437  case 32:
438  if (Rmask == 0) {
439  return SDL_PIXELFORMAT_RGB888;
440  }
441  if (Rmask == 0x00FF0000 &&
442  Gmask == 0x0000FF00 &&
443  Bmask == 0x000000FF &&
444  Amask == 0x00000000) {
445  return SDL_PIXELFORMAT_RGB888;
446  }
447  if (Rmask == 0xFF000000 &&
448  Gmask == 0x00FF0000 &&
449  Bmask == 0x0000FF00 &&
450  Amask == 0x00000000) {
452  }
453  if (Rmask == 0x000000FF &&
454  Gmask == 0x0000FF00 &&
455  Bmask == 0x00FF0000 &&
456  Amask == 0x00000000) {
457  return SDL_PIXELFORMAT_BGR888;
458  }
459  if (Rmask == 0x0000FF00 &&
460  Gmask == 0x00FF0000 &&
461  Bmask == 0xFF000000 &&
462  Amask == 0x00000000) {
464  }
465  if (Rmask == 0x00FF0000 &&
466  Gmask == 0x0000FF00 &&
467  Bmask == 0x000000FF &&
468  Amask == 0xFF000000) {
470  }
471  if (Rmask == 0xFF000000 &&
472  Gmask == 0x00FF0000 &&
473  Bmask == 0x0000FF00 &&
474  Amask == 0x000000FF) {
476  }
477  if (Rmask == 0x000000FF &&
478  Gmask == 0x0000FF00 &&
479  Bmask == 0x00FF0000 &&
480  Amask == 0xFF000000) {
482  }
483  if (Rmask == 0x0000FF00 &&
484  Gmask == 0x00FF0000 &&
485  Bmask == 0xFF000000 &&
486  Amask == 0x000000FF) {
488  }
489  if (Rmask == 0x3FF00000 &&
490  Gmask == 0x000FFC00 &&
491  Bmask == 0x000003FF &&
492  Amask == 0xC0000000) {
494  }
495  }
497 }

References bpp, SDL_PIXELFORMAT_ABGR1555, SDL_PIXELFORMAT_ABGR4444, SDL_PIXELFORMAT_ABGR8888, SDL_PIXELFORMAT_ARGB1555, SDL_PIXELFORMAT_ARGB2101010, SDL_PIXELFORMAT_ARGB4444, SDL_PIXELFORMAT_ARGB8888, SDL_PIXELFORMAT_BGR24, SDL_PIXELFORMAT_BGR444, SDL_PIXELFORMAT_BGR555, SDL_PIXELFORMAT_BGR565, SDL_PIXELFORMAT_BGR888, SDL_PIXELFORMAT_BGRA4444, SDL_PIXELFORMAT_BGRA5551, SDL_PIXELFORMAT_BGRA8888, SDL_PIXELFORMAT_BGRX8888, SDL_PIXELFORMAT_INDEX1MSB, SDL_PIXELFORMAT_INDEX4MSB, SDL_PIXELFORMAT_INDEX8, SDL_PIXELFORMAT_RGB24, SDL_PIXELFORMAT_RGB332, SDL_PIXELFORMAT_RGB444, SDL_PIXELFORMAT_RGB555, SDL_PIXELFORMAT_RGB565, SDL_PIXELFORMAT_RGB888, SDL_PIXELFORMAT_RGBA4444, SDL_PIXELFORMAT_RGBA5551, SDL_PIXELFORMAT_RGBA8888, SDL_PIXELFORMAT_RGBX8888, and SDL_PIXELFORMAT_UNKNOWN.

◆ SDL_PixelFormatEnumToMasks()

SDL_bool SDL_PixelFormatEnumToMasks ( Uint32  format,
int *  bpp,
Uint32 Rmask,
Uint32 Gmask,
Uint32 Bmask,
Uint32 Amask 
)

Convert one of the enumerated pixel formats to a bpp and RGBA masks.

Returns
SDL_TRUE, or SDL_FALSE if the conversion wasn't possible.
See also
SDL_MasksToPixelFormatEnum()

Definition at line 135 of file SDL_pixels.c.

137 {
138  Uint32 masks[4];
139 
140  /* This function doesn't work with FourCC pixel formats */
142  SDL_SetError("FOURCC pixel formats are not supported");
143  return SDL_FALSE;
144  }
145 
146  /* Initialize the values here */
147  if (SDL_BYTESPERPIXEL(format) <= 2) {
149  } else {
150  *bpp = SDL_BYTESPERPIXEL(format) * 8;
151  }
152  *Rmask = *Gmask = *Bmask = *Amask = 0;
153 
154  if (format == SDL_PIXELFORMAT_RGB24) {
155 #if SDL_BYTEORDER == SDL_BIG_ENDIAN
156  *Rmask = 0x00FF0000;
157  *Gmask = 0x0000FF00;
158  *Bmask = 0x000000FF;
159 #else
160  *Rmask = 0x000000FF;
161  *Gmask = 0x0000FF00;
162  *Bmask = 0x00FF0000;
163 #endif
164  return SDL_TRUE;
165  }
166 
167  if (format == SDL_PIXELFORMAT_BGR24) {
168 #if SDL_BYTEORDER == SDL_BIG_ENDIAN
169  *Rmask = 0x000000FF;
170  *Gmask = 0x0000FF00;
171  *Bmask = 0x00FF0000;
172 #else
173  *Rmask = 0x00FF0000;
174  *Gmask = 0x0000FF00;
175  *Bmask = 0x000000FF;
176 #endif
177  return SDL_TRUE;
178  }
179 
183  /* Not a format that uses masks */
184  return SDL_TRUE;
185  }
186 
187  switch (SDL_PIXELLAYOUT(format)) {
189  masks[0] = 0x00000000;
190  masks[1] = 0x000000E0;
191  masks[2] = 0x0000001C;
192  masks[3] = 0x00000003;
193  break;
195  masks[0] = 0x0000F000;
196  masks[1] = 0x00000F00;
197  masks[2] = 0x000000F0;
198  masks[3] = 0x0000000F;
199  break;
201  masks[0] = 0x00008000;
202  masks[1] = 0x00007C00;
203  masks[2] = 0x000003E0;
204  masks[3] = 0x0000001F;
205  break;
207  masks[0] = 0x0000F800;
208  masks[1] = 0x000007C0;
209  masks[2] = 0x0000003E;
210  masks[3] = 0x00000001;
211  break;
213  masks[0] = 0x00000000;
214  masks[1] = 0x0000F800;
215  masks[2] = 0x000007E0;
216  masks[3] = 0x0000001F;
217  break;
219  masks[0] = 0xFF000000;
220  masks[1] = 0x00FF0000;
221  masks[2] = 0x0000FF00;
222  masks[3] = 0x000000FF;
223  break;
225  masks[0] = 0xC0000000;
226  masks[1] = 0x3FF00000;
227  masks[2] = 0x000FFC00;
228  masks[3] = 0x000003FF;
229  break;
231  masks[0] = 0xFFC00000;
232  masks[1] = 0x003FF000;
233  masks[2] = 0x00000FFC;
234  masks[3] = 0x00000003;
235  break;
236  default:
237  SDL_SetError("Unknown pixel format");
238  return SDL_FALSE;
239  }
240 
241  switch (SDL_PIXELORDER(format)) {
243  *Rmask = masks[1];
244  *Gmask = masks[2];
245  *Bmask = masks[3];
246  break;
248  *Rmask = masks[0];
249  *Gmask = masks[1];
250  *Bmask = masks[2];
251  break;
253  *Amask = masks[0];
254  *Rmask = masks[1];
255  *Gmask = masks[2];
256  *Bmask = masks[3];
257  break;
259  *Rmask = masks[0];
260  *Gmask = masks[1];
261  *Bmask = masks[2];
262  *Amask = masks[3];
263  break;
265  *Bmask = masks[1];
266  *Gmask = masks[2];
267  *Rmask = masks[3];
268  break;
270  *Bmask = masks[0];
271  *Gmask = masks[1];
272  *Rmask = masks[2];
273  break;
275  *Bmask = masks[0];
276  *Gmask = masks[1];
277  *Rmask = masks[2];
278  *Amask = masks[3];
279  break;
281  *Amask = masks[0];
282  *Bmask = masks[1];
283  *Gmask = masks[2];
284  *Rmask = masks[3];
285  break;
286  default:
287  SDL_SetError("Unknown pixel format");
288  return SDL_FALSE;
289  }
290  return SDL_TRUE;
291 }

References bpp, SDL_BITSPERPIXEL, SDL_BYTESPERPIXEL, SDL_FALSE, SDL_ISPIXELFORMAT_FOURCC, SDL_PACKEDLAYOUT_1010102, SDL_PACKEDLAYOUT_1555, SDL_PACKEDLAYOUT_2101010, SDL_PACKEDLAYOUT_332, SDL_PACKEDLAYOUT_4444, SDL_PACKEDLAYOUT_5551, SDL_PACKEDLAYOUT_565, SDL_PACKEDLAYOUT_8888, SDL_PACKEDORDER_ABGR, SDL_PACKEDORDER_ARGB, SDL_PACKEDORDER_BGRA, SDL_PACKEDORDER_BGRX, SDL_PACKEDORDER_RGBA, SDL_PACKEDORDER_RGBX, SDL_PACKEDORDER_XBGR, SDL_PACKEDORDER_XRGB, SDL_PIXELFORMAT_BGR24, SDL_PIXELFORMAT_RGB24, SDL_PIXELLAYOUT, SDL_PIXELORDER, SDL_PIXELTYPE, SDL_PIXELTYPE_PACKED16, SDL_PIXELTYPE_PACKED32, SDL_PIXELTYPE_PACKED8, SDL_SetError, and SDL_TRUE.

Referenced by SDL_InitFormat().

◆ SDL_SetPaletteColors()

int SDL_SetPaletteColors ( SDL_Palette palette,
const SDL_Color colors,
int  firstcolor,
int  ncolors 
)

Set a range of colors in a palette.

Parameters
paletteThe palette to modify.
colorsAn array of colors to copy into the palette.
firstcolorThe index of the first palette entry to modify.
ncolorsThe number of entries to modify.
Returns
0 on success, or -1 if not all of the colors could be set.

Definition at line 705 of file SDL_pixels.c.

707 {
708  int status = 0;
709 
710  /* Verify the parameters */
711  if (!palette) {
712  return -1;
713  }
714  if (ncolors > (palette->ncolors - firstcolor)) {
715  ncolors = (palette->ncolors - firstcolor);
716  status = -1;
717  }
718 
719  if (colors != (palette->colors + firstcolor)) {
720  SDL_memcpy(palette->colors + firstcolor, colors,
721  ncolors * sizeof(*colors));
722  }
723  ++palette->version;
724  if (!palette->version) {
725  palette->version = 1;
726  }
727 
728  return status;
729 }

References colors, SDL_Palette::colors, SDL_Palette::ncolors, SDL_memcpy, and SDL_Palette::version.

◆ SDL_SetPixelFormatPalette()

int SDL_SetPixelFormatPalette ( SDL_PixelFormat format,
SDL_Palette palette 
)

Set the palette for a pixel format structure.

Definition at line 677 of file SDL_pixels.c.

678 {
679  if (!format) {
680  return SDL_SetError("SDL_SetPixelFormatPalette() passed NULL format");
681  }
682 
683  if (palette && palette->ncolors > (1 << format->BitsPerPixel)) {
684  return SDL_SetError("SDL_SetPixelFormatPalette() passed a palette that doesn't match the format");
685  }
686 
687  if (format->palette == palette) {
688  return 0;
689  }
690 
691  if (format->palette) {
692  SDL_FreePalette(format->palette);
693  }
694 
695  format->palette = palette;
696 
697  if (format->palette) {
698  ++format->palette->refcount;
699  }
700 
701  return 0;
702 }

References SDL_Palette::ncolors, SDL_Palette::refcount, SDL_FreePalette(), and SDL_SetError.

CASE
#define CASE(X)
format
GLint GLint GLsizei GLsizei GLsizei GLint GLenum format
Definition: SDL_opengl.h:1572
SDL_memset
#define SDL_memset
Definition: SDL_dynapi_overrides.h:386
SDL_PIXELFORMAT_ABGR32
@ SDL_PIXELFORMAT_ABGR32
Definition: SDL_pixels.h:277
SDL_ARRAYORDER_BGRA
@ SDL_ARRAYORDER_BGRA
Definition: SDL_pixels.h:99
SDL_PIXELFORMAT_ARGB1555
@ SDL_PIXELFORMAT_ARGB1555
Definition: SDL_pixels.h:215
SDL_BITSPERPIXEL
#define SDL_BITSPERPIXEL(X)
Definition: SDL_pixels.h:127
SDL_ISPIXELFORMAT_ARRAY
#define SDL_ISPIXELFORMAT_ARRAY(format)
Definition: SDL_pixels.h:146
Uint32
uint32_t Uint32
Definition: SDL_stdinc.h:203
SDL_PIXELFORMAT_BGRA4444
@ SDL_PIXELFORMAT_BGRA4444
Definition: SDL_pixels.h:212
SDL_PACKEDORDER_NONE
@ SDL_PACKEDORDER_NONE
Definition: SDL_pixels.h:78
SDL_PACKEDLAYOUT_8888
@ SDL_PACKEDLAYOUT_8888
Definition: SDL_pixels.h:112
SDL_Palette::ncolors
int ncolors
Definition: SDL_pixels.h:309
SDL_PIXELFORMAT_INDEX1LSB
@ SDL_PIXELFORMAT_INDEX1LSB
Definition: SDL_pixels.h:174
SDL_PIXELFORMAT_RGB888
@ SDL_PIXELFORMAT_RGB888
Definition: SDL_pixels.h:239
SDL_ARRAYORDER_ABGR
@ SDL_ARRAYORDER_ABGR
Definition: SDL_pixels.h:100
SDL_PIXELTYPE_ARRAYF32
@ SDL_PIXELTYPE_ARRAYF32
Definition: SDL_pixels.h:64
SDL_PIXELFORMAT_NV21
@ SDL_PIXELFORMAT_NV21
Definition: SDL_pixels.h:292
SDL_PIXELFORMAT_UYVY
@ SDL_PIXELFORMAT_UYVY
Definition: SDL_pixels.h:286
SDL_PIXELFORMAT_RGBX8888
@ SDL_PIXELFORMAT_RGBX8888
Definition: SDL_pixels.h:242
NULL
#define NULL
Definition: begin_code.h:167
SDL_ALPHA_OPAQUE
#define SDL_ALPHA_OPAQUE
Definition: SDL_pixels.h:46
b
GLboolean GLboolean GLboolean b
Definition: SDL_opengl_glext.h:1112
g
GLboolean GLboolean g
Definition: SDL_opengl_glext.h:1112
SDL_PACKEDLAYOUT_NONE
@ SDL_PACKEDLAYOUT_NONE
Definition: SDL_pixels.h:106
SDL_PIXELTYPE_INDEX8
@ SDL_PIXELTYPE_INDEX8
Definition: SDL_pixels.h:56
SDL_PIXELLAYOUT
#define SDL_PIXELLAYOUT(X)
Definition: SDL_pixels.h:126
SDL_AtomicLock
#define SDL_AtomicLock
Definition: SDL_dynapi_overrides.h:64
SDL_PIXELFORMAT_YUY2
@ SDL_PIXELFORMAT_YUY2
Definition: SDL_pixels.h:284
SDL_BITMAPORDER_1234
@ SDL_BITMAPORDER_1234
Definition: SDL_pixels.h:72
SDL_PIXELFORMAT_BGR888
@ SDL_PIXELFORMAT_BGR888
Definition: SDL_pixels.h:245
SDL_PixelFormat::next
struct SDL_PixelFormat * next
Definition: SDL_pixels.h:338
SDL_PIXELTYPE_UNKNOWN
@ SDL_PIXELTYPE_UNKNOWN
Definition: SDL_pixels.h:53
SDL_PIXELTYPE_INDEX4
@ SDL_PIXELTYPE_INDEX4
Definition: SDL_pixels.h:55
SDL_PIXELFORMAT_BGR565
@ SDL_PIXELFORMAT_BGR565
Definition: SDL_pixels.h:230
r
GLdouble GLdouble GLdouble r
Definition: SDL_opengl.h:2079
SDL_PIXELFORMAT_EXTERNAL_OES
@ SDL_PIXELFORMAT_EXTERNAL_OES
Definition: SDL_pixels.h:294
SDL_PACKEDLAYOUT_565
@ SDL_PACKEDLAYOUT_565
Definition: SDL_pixels.h:111
SDL_InvalidParamError
#define SDL_InvalidParamError(param)
Definition: SDL_error.h:54
SDL_PACKEDLAYOUT_4444
@ SDL_PACKEDLAYOUT_4444
Definition: SDL_pixels.h:108
SDL_PACKEDORDER_XRGB
@ SDL_PACKEDORDER_XRGB
Definition: SDL_pixels.h:79
SDL_ARRAYORDER_ARGB
@ SDL_ARRAYORDER_ARGB
Definition: SDL_pixels.h:97
SDL_PIXELTYPE_ARRAYU32
@ SDL_PIXELTYPE_ARRAYU32
Definition: SDL_pixels.h:62
SDL_DEFINE_PIXELFOURCC
#define SDL_DEFINE_PIXELFOURCC(A, B, C, D)
Definition: SDL_pixels.h:117
SDL_ISPIXELFORMAT_INDEXED
#define SDL_ISPIXELFORMAT_INDEXED(format)
Definition: SDL_pixels.h:134
SDL_PIXELFORMAT_RGB565
@ SDL_PIXELFORMAT_RGB565
Definition: SDL_pixels.h:227
a
GLboolean GLboolean GLboolean GLboolean a
Definition: SDL_opengl_glext.h:1112
v
const GLdouble * v
Definition: SDL_opengl.h:2064
SDL_PIXELFORMAT_BGRX8888
@ SDL_PIXELFORMAT_BGRX8888
Definition: SDL_pixels.h:248
SDL_PACKEDLAYOUT_1010102
@ SDL_PACKEDLAYOUT_1010102
Definition: SDL_pixels.h:114
SDL_ISPIXELFORMAT_PACKED
#define SDL_ISPIXELFORMAT_PACKED(format)
Definition: SDL_pixels.h:140
SDL_PIXELFORMAT_IYUV
@ SDL_PIXELFORMAT_IYUV
Definition: SDL_pixels.h:282
SDL_BITMAPORDER_NONE
@ SDL_BITMAPORDER_NONE
Definition: SDL_pixels.h:70
SDL_PIXELFORMAT_RGB332
@ SDL_PIXELFORMAT_RGB332
Definition: SDL_pixels.h:188
SDL_PACKEDLAYOUT_5551
@ SDL_PACKEDLAYOUT_5551
Definition: SDL_pixels.h:110
SDL_PackedLayout
SDL_PackedLayout
Definition: SDL_pixels.h:104
SDL_PIXELTYPE_ARRAYU16
@ SDL_PIXELTYPE_ARRAYU16
Definition: SDL_pixels.h:61
SDL_PACKEDORDER_XBGR
@ SDL_PACKEDORDER_XBGR
Definition: SDL_pixels.h:83
SDL_PIXELFORMAT_BGR555
@ SDL_PIXELFORMAT_BGR555
Definition: SDL_pixels.h:200
SDL_memcpy
#define SDL_memcpy
Definition: SDL_dynapi_overrides.h:387
SDL_FALSE
@ SDL_FALSE
Definition: SDL_stdinc.h:163
SDL_Palette::colors
SDL_Color * colors
Definition: SDL_pixels.h:310
SDL_PACKEDORDER_RGBX
@ SDL_PACKEDORDER_RGBX
Definition: SDL_pixels.h:80
SDL_PIXELTYPE_ARRAYU8
@ SDL_PIXELTYPE_ARRAYU8
Definition: SDL_pixels.h:60
SDL_PIXELFORMAT_YVYU
@ SDL_PIXELFORMAT_YVYU
Definition: SDL_pixels.h:288
SDL_AtomicUnlock
#define SDL_AtomicUnlock
Definition: SDL_dynapi_overrides.h:65
formats_lock
static SDL_SpinLock formats_lock
Definition: SDL_pixels.c:500
SDL_PIXELTYPE_PACKED16
@ SDL_PIXELTYPE_PACKED16
Definition: SDL_pixels.h:58
SDL_PIXELFORMAT_ARGB4444
@ SDL_PIXELFORMAT_ARGB4444
Definition: SDL_pixels.h:203
SDL_PIXELTYPE_PACKED32
@ SDL_PIXELTYPE_PACKED32
Definition: SDL_pixels.h:59
SDL_ArrayOrder
SDL_ArrayOrder
Definition: SDL_pixels.h:92
SDL_PIXELFORMAT_RGBA5551
@ SDL_PIXELFORMAT_RGBA5551
Definition: SDL_pixels.h:218
SDL_BitmapOrder
SDL_BitmapOrder
Definition: SDL_pixels.h:68
SDL_free
#define SDL_free
Definition: SDL_dynapi_overrides.h:377
SDL_PIXELFORMAT_RGB444
@ SDL_PIXELFORMAT_RGB444
Definition: SDL_pixels.h:191
f
GLfloat f
Definition: SDL_opengl_glext.h:1873
SDL_PIXELFORMAT_BGRA32
@ SDL_PIXELFORMAT_BGRA32
Definition: SDL_pixels.h:276
SDL_PIXELFORMAT_BGR444
@ SDL_PIXELFORMAT_BGR444
Definition: SDL_pixels.h:194
SDL_PIXELFORMAT_ARGB2101010
@ SDL_PIXELFORMAT_ARGB2101010
Definition: SDL_pixels.h:263
X
set set set set set set set set set set set set set set set set set set set set *set set set macro pixldst op &r &cond WK op &r &cond WK op &r &cond WK else op &m &cond &ia op &r &cond WK else op &m &cond &ia elseif elseif else error unsupported base if elseif elseif else error unsupported unaligned pixldst unaligned endm macro pixst base base else pixldst base endif endm macro PF base if bpp PF set rept prefetch_distance PF set OFFSET endr endif endm macro preload_leading_step2 base if bpp ifc DST PF PF else if bpp lsl PF PF lsl PF PF lsl PF PF PF else PF lsl PF lsl PF lsl PF endif SIZE macro preload_middle scratch_holds_offset if bpp if else PF PF endif endif endif endm macro preload_trailing base if bpp if bpp *pix_per_block PF PF lsl PF PF PF PF PF else PF lsl PF X
Definition: pixman-arm-simd-asm.h:255
SDL_PIXELFORMAT_ABGR1555
@ SDL_PIXELFORMAT_ABGR1555
Definition: SDL_pixels.h:221
SDL_PACKEDORDER_BGRX
@ SDL_PACKEDORDER_BGRX
Definition: SDL_pixels.h:84
Uint16
uint16_t Uint16
Definition: SDL_stdinc.h:191
SDL_FindColor
Uint8 SDL_FindColor(SDL_Palette *pal, Uint8 r, Uint8 g, Uint8 b, Uint8 a)
Definition: SDL_pixels.c:777
SDL_expand_byte
Uint8 * SDL_expand_byte[9]
Definition: SDL_pixels.c:71
SDL_FreePalette
void SDL_FreePalette(SDL_Palette *palette)
Free a palette created with SDL_AllocPalette().
Definition: SDL_pixels.c:732
SDL_PixelType
SDL_PixelType
Definition: SDL_pixels.h:51
SDL_pow
#define SDL_pow
Definition: SDL_dynapi_overrides.h:433
SDL_ARRAYORDER_RGB
@ SDL_ARRAYORDER_RGB
Definition: SDL_pixels.h:95
SDL_PIXELFORMAT_ABGR4444
@ SDL_PIXELFORMAT_ABGR4444
Definition: SDL_pixels.h:209
SDL_PIXELFORMAT_ARGB8888
@ SDL_PIXELFORMAT_ARGB8888
Definition: SDL_pixels.h:251
order
GLfixed GLfixed GLint GLint order
Definition: SDL_opengl_glext.h:4561
SDL_PixelFormat
Definition: SDL_pixels.h:318
formats
EGLint EGLint * formats
Definition: eglext.h:718
SDL_PACKEDLAYOUT_332
@ SDL_PACKEDLAYOUT_332
Definition: SDL_pixels.h:107
SDL_Palette::refcount
int refcount
Definition: SDL_pixels.h:312
SDL_PIXELFORMAT_RGBA4444
@ SDL_PIXELFORMAT_RGBA4444
Definition: SDL_pixels.h:206
SDL_OutOfMemory
#define SDL_OutOfMemory()
Definition: SDL_error.h:52
bpp
set set set set set set set macro pixldst1 abits if abits op else op endif endm macro pixldst2 abits if abits op else op endif endm macro pixldst4 abits if abits op else op endif endm macro pixldst0 abits op endm macro pixldst3 mem_operand op endm macro pixldst30 mem_operand op endm macro pixldst abits if abits elseif abits elseif abits elseif abits elseif abits pixldst0 abits else pixldst0 abits pixldst0 abits pixldst0 abits pixldst0 abits endif elseif abits else pixldst0 abits pixldst0 abits endif elseif abits else error unsupported bpp
Definition: pixman-arm-neon-asm.h:146
SDL_ARRAYORDER_BGR
@ SDL_ARRAYORDER_BGR
Definition: SDL_pixels.h:98
SDL_PIXELFORMAT_INDEX1MSB
@ SDL_PIXELFORMAT_INDEX1MSB
Definition: SDL_pixels.h:177
SDL_PACKEDLAYOUT_1555
@ SDL_PACKEDLAYOUT_1555
Definition: SDL_pixels.h:109
SDL_PIXELFORMAT_RGB555
@ SDL_PIXELFORMAT_RGB555
Definition: SDL_pixels.h:197
SDL_PIXELORDER
#define SDL_PIXELORDER(X)
Definition: SDL_pixels.h:125
SDL_Palette
Definition: SDL_pixels.h:307
SDL_PIXELTYPE_ARRAYF16
@ SDL_PIXELTYPE_ARRAYF16
Definition: SDL_pixels.h:63
SDL_TRUE
@ SDL_TRUE
Definition: SDL_stdinc.h:164
SDL_DEFINE_PIXELFORMAT
#define SDL_DEFINE_PIXELFORMAT(type, order, layout, bits, bytes)
Definition: SDL_pixels.h:119
SDL_PIXELFORMAT_INDEX4LSB
@ SDL_PIXELFORMAT_INDEX4LSB
Definition: SDL_pixels.h:180
SDL_ISPIXELFORMAT_FOURCC
#define SDL_ISPIXELFORMAT_FOURCC(format)
Definition: SDL_pixels.h:167
value
GLsizei const GLfloat * value
Definition: SDL_opengl_glext.h:701
SDL_PIXELFORMAT_RGBA8888
@ SDL_PIXELFORMAT_RGBA8888
Definition: SDL_pixels.h:254
SDL_PACKEDORDER_BGRA
@ SDL_PACKEDORDER_BGRA
Definition: SDL_pixels.h:86
SDL_SetError
#define SDL_SetError
Definition: SDL_dynapi_overrides.h:30
SDL_BYTESPERPIXEL
#define SDL_BYTESPERPIXEL(X)
Definition: SDL_pixels.h:128
formats
static SDL_PixelFormat * formats
Definition: SDL_pixels.c:499
SDL_Palette::version
Uint32 version
Definition: SDL_pixels.h:311
SDL_PIXELFORMAT_RGB24
@ SDL_PIXELFORMAT_RGB24
Definition: SDL_pixels.h:233
SDL_PIXELFORMAT_NV12
@ SDL_PIXELFORMAT_NV12
Definition: SDL_pixels.h:290
SDL_PIXELTYPE
#define SDL_PIXELTYPE(X)
Definition: SDL_pixels.h:124
SDL_PIXELFORMAT_UNKNOWN
@ SDL_PIXELFORMAT_UNKNOWN
Definition: SDL_pixels.h:173
SDL_PIXELFORMAT_BGRA5551
@ SDL_PIXELFORMAT_BGRA5551
Definition: SDL_pixels.h:224
SDL_PIXELTYPE_PACKED8
@ SDL_PIXELTYPE_PACKED8
Definition: SDL_pixels.h:57
SDL_PIXELTYPE_INDEX1
@ SDL_PIXELTYPE_INDEX1
Definition: SDL_pixels.h:54
SDL_PIXELFORMAT_BGRA8888
@ SDL_PIXELFORMAT_BGRA8888
Definition: SDL_pixels.h:260
SDL_PIXELFORMAT_RGBA32
@ SDL_PIXELFORMAT_RGBA32
Definition: SDL_pixels.h:274
SDL_Color
Definition: SDL_pixels.h:298
SDL_PIXELFORMAT_ARGB32
@ SDL_PIXELFORMAT_ARGB32
Definition: SDL_pixels.h:275
SDL_PIXELFORMAT_BGR24
@ SDL_PIXELFORMAT_BGR24
Definition: SDL_pixels.h:236
SDL_PackedOrder
SDL_PackedOrder
Definition: SDL_pixels.h:76
bits
GLenum GLint GLenum GLsizei GLsizei GLsizei GLint GLsizei const void * bits
Definition: SDL_opengl_glext.h:6179
SDL_PIXELFORMAT_INDEX4MSB
@ SDL_PIXELFORMAT_INDEX4MSB
Definition: SDL_pixels.h:183
SDL_PIXELFORMAT_INDEX8
@ SDL_PIXELFORMAT_INDEX8
Definition: SDL_pixels.h:186
SDL_ARRAYORDER_RGBA
@ SDL_ARRAYORDER_RGBA
Definition: SDL_pixels.h:96
SDL_PACKEDLAYOUT_2101010
@ SDL_PACKEDLAYOUT_2101010
Definition: SDL_pixels.h:113
SDL_BITMAPORDER_4321
@ SDL_BITMAPORDER_4321
Definition: SDL_pixels.h:71
SDL_malloc
#define SDL_malloc
Definition: SDL_dynapi_overrides.h:374
SDL_PIXELFORMAT_YV12
@ SDL_PIXELFORMAT_YV12
Definition: SDL_pixels.h:280
SDL_PIXELFORMAT_ABGR8888
@ SDL_PIXELFORMAT_ABGR8888
Definition: SDL_pixels.h:257
type
GLuint GLuint GLsizei GLenum type
Definition: SDL_opengl.h:1571
SDL_PACKEDORDER_RGBA
@ SDL_PACKEDORDER_RGBA
Definition: SDL_pixels.h:82
i
return Display return Display Bool Bool int int int return Display XEvent Bool(*) XPointer return Display return Display Drawable _Xconst char unsigned int unsigned int return Display Pixmap Pixmap XColor XColor unsigned int unsigned int return Display _Xconst char char int char return Display Visual unsigned int int int char unsigned int unsigned int in i)
Definition: SDL_x11sym.h:50
SDL_PixelFormatEnum
SDL_PixelFormatEnum
Definition: SDL_pixels.h:171
SDL_PACKEDORDER_ABGR
@ SDL_PACKEDORDER_ABGR
Definition: SDL_pixels.h:85
colors
static int colors[7]
Definition: testgesture.c:41
SDL_PACKEDORDER_ARGB
@ SDL_PACKEDORDER_ARGB
Definition: SDL_pixels.h:81
SDL_ARRAYORDER_NONE
@ SDL_ARRAYORDER_NONE
Definition: SDL_pixels.h:94
SDL_InitFormat
int SDL_InitFormat(SDL_PixelFormat *format, Uint32 pixel_format)
Definition: SDL_pixels.c:544