|
Size: 2777
Comment: content added (still incomplete)
|
Size: 3858
Comment: content added
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 11: | Line 11: |
| ||SDL_PIXELTYPE(X)||(((X) >> 24) & 0x0F)||returns the type of the pixel format; see [[#type|Remarks]] for details|| ||SDL_PIXELORDER(X)||(((X) >> 20) & 0x0F)||the ordering of channels or bits in the pixel format; see [[#order|Remarks]] for details|| ||SDL_PIXELLAYOUT(X)||(((X) >> 16) & 0x0F)||the channel bit pattern of the pixel format; see [[#layout|Remarks]] for details|| ||SDL_BITSPERPIXEL(X)||(((X) >> 8) & 0xFF)|| ||SDL_BYTESPERPIXEL(X)||(((X) >> 0) & 0xFF)|| |
||SDL_PIXELTYPE(format)||the type of the pixel format; see [[#type|Remarks]] for details|| ||SDL_PIXELORDER(format)||the ordering of channels or bits in the pixel format; see [[#order|Remarks]] for details|| ||SDL_PIXELLAYOUT(format)||the channel bit pattern of the pixel format; see [[#layout|Remarks]] for details|| ||SDL_BITSPERPIXEL(format)|||| ||SDL_BYTESPERPIXEL(format)|||| |
| Line 72: | Line 72: |
| <<Anchor(order)>> | <<Anchor(order)>> Depending on the pixel type there are three different types of orderings - bitmapped, packed, or array. ||Bitmap pixel order, high bit -> low bit.|| ||SDL_BITMAPORDER_NONE|| ||SDL_BITMAPORDER_4321|| ||SDL_BITMAPORDER_1234|| ||Packed component order, high bit -> low bit.|| ||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|| ||Array component order, low byte -> high byte.|| ||SDL_ARRAYORDER_NONE|| ||SDL_ARRAYORDER_RGB|| ||SDL_ARRAYORDER_RGBA|| ||SDL_ARRAYORDER_ARGB|| ||SDL_ARRAYORDER_BGR|| ||SDL_ARRAYORDER_BGRA|| ||SDL_ARRAYORDER_ABGR|| |
| Line 74: | Line 96: |
| <<Anchor(layout)>> | <<Anchor(layout)>> Packed pixel formats have one of the following layouts: ||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|| Channel ordering with SDL_``PIXELORDER and component layout using SDL_``PIXELLAYOUT together completely defines a pixel format. |
SDL_PixelFormatEnum
An enumeration of pixel formats.
Contents
Values
Pixel Format Macros
SDL_PIXELTYPE(format) |
the type of the pixel format; see Remarks for details |
SDL_PIXELORDER(format) |
the ordering of channels or bits in the pixel format; see Remarks for details |
SDL_PIXELLAYOUT(format) |
the channel bit pattern of the pixel format; see Remarks for details |
SDL_BITSPERPIXEL(format) |
|
SDL_BYTESPERPIXEL(format) |
|
SDL_ISPIXELFORMAT_INDEXED(format) |
|
SDL_ISPIXELFORMAT_ALPHA(format) |
|
SDL_ISPIXELFORMAT_FOURCC(format) |
Pixel Format Values
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_RGB555 |
|
SDL_PIXELFORMAT_BGR555 |
|
SDL_PIXELFORMAT_ARGB4444 |
|
SDL_PIXELFORMAT_ABGR4444 |
|
SDL_PIXELFORMAT_ARGB1555 |
|
SDL_PIXELFORMAT_ABGR1555 |
|
SDL_PIXELFORMAT_RGB565 |
|
SDL_PIXELFORMAT_BGR565 |
|
SDL_PIXELFORMAT_RGB24 |
|
SDL_PIXELFORMAT_BGR24 |
|
SDL_PIXELFORMAT_RGB888 |
|
SDL_PIXELFORMAT_BGR888 |
|
SDL_PIXELFORMAT_ARGB8888 |
|
SDL_PIXELFORMAT_RGBA8888 |
|
SDL_PIXELFORMAT_ABGR8888 |
|
SDL_PIXELFORMAT_BGRA8888 |
|
SDL_PIXELFORMAT_ARGB2101010 |
|
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) |
Code Examples
You can add your code example here
Remarks
The pixel type is one of the following values:
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 |
Depending on the pixel type there are three different types of orderings - bitmapped, packed, or array.
Bitmap pixel order, high bit -> low bit. |
SDL_BITMAPORDER_NONE |
SDL_BITMAPORDER_4321 |
SDL_BITMAPORDER_1234 |
Packed component order, high bit -> low bit. |
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 |
Array component order, low byte -> high byte. |
SDL_ARRAYORDER_NONE |
SDL_ARRAYORDER_RGB |
SDL_ARRAYORDER_RGBA |
SDL_ARRAYORDER_ARGB |
SDL_ARRAYORDER_BGR |
SDL_ARRAYORDER_BGRA |
SDL_ARRAYORDER_ABGR |
Packed pixel formats have one of the following layouts:
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 |
Channel ordering with SDL_PIXELORDER and component layout using SDL_PIXELLAYOUT together completely defines a pixel format.
Related Structures
