| Tizen Native API
    4.0
    | 
Pixel format types and their properties. More...
| Functions | |
| bool | HasAlpha (Format pixelformat) | 
| Whether specified pixel format contains an alpha value. | |
| unsigned int | GetBytesPerPixel (Format pixelFormat) | 
| Returns The number of bytes per pixel for the specified pixel format. | |
| void | GetAlphaOffsetAndMask (Format pixelFormat, int &byteOffset, int &bitMask) | 
| Returns the offset of the byte containing the alpha value from the start of the pixel data and the bitmask of that byte to get the alpha value. | |
| Enumerations | |
| enum | Format | 
| Enumeration for Pixel formats.  More... | |
| Variables | |
| const Format | FIRST_VALID_PIXEL_FORMAT = A8 | 
| For asserting that a variable has a valid pixel format. | |
| const Format | LAST_VALID_PIXEL_FORMAT = RGB32F | 
| For asserting that a variable has a valid pixel format. | |
Detailed Description
Pixel format types and their properties.
- Since:
- 2.4, DALi version 1.0.0
Enumeration Type Documentation
| enum Dali::Pixel::Format | 
Enumeration for Pixel formats.
Pixel format, default color depth is RGBA 32 bit with alpha.
- Since:
- 2.4, DALi version 1.0.0
- Note:
- BufferImage::Update might not work with BGR/BGRA formats!
- Enumerator:
- INVALID - Used to represent an unsupported format. - Since:
- 3.0, DALi version 1.1.17
 - A8 - color depth 8-bit, alpha - Since:
- 2.4, DALi version 1.0.0
 - L8 - color depth 8-bit, luminance - Since:
- 2.4, DALi version 1.0.0
 - LA88 - color depth 16-bit, luminance with 8 bit alpha - Since:
- 2.4, DALi version 1.0.0
 - RGB565 - color depth 16 bit, 5-6-5 - Since:
- 2.4, DALi version 1.0.0
 - BGR565 - color depth 16 bit, 5-6-5 - Since:
- 2.4, DALi version 1.0.0
 - RGBA4444 - color depth 16 bit with alpha, 4-4-4-4 - Since:
- 2.4, DALi version 1.0.0
 - BGRA4444 - color depth 16 bit with alpha, 4-4-4-4 - Since:
- 2.4, DALi version 1.0.0
 - RGBA5551 - color depth 16 bit with alpha, 5-5-5-1 - Since:
- 2.4, DALi version 1.0.0
 - BGRA5551 - color depth 16 bit with alpha, 5-5-5-1 - Since:
- 2.4, DALi version 1.0.0
 - RGB888 - color depth 24 bit, 8-8-8 - Since:
- 2.4, DALi version 1.0.0
 - RGB8888 - color depth 32 bit, alpha is reserved but not used, 8-8-8-8# - Since:
- 2.4, DALi version 1.0.0
 - BGR8888 - color depth 32 bit, alpha is reserved but not used, 8-8-8-8# - Since:
- 2.4, DALi version 1.0.0
 - RGBA8888 - color depth 32 bit with alpha, 8-8-8-8 - Since:
- 2.4, DALi version 1.0.0
 - BGRA8888 - color depth 32 bit with alpha, 8-8-8-8 - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_R11_EAC - ETC2 / EAC single-channel, unsigned. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_SIGNED_R11_EAC - ETC2 / EAC single-channel, signed. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RG11_EAC - ETC2 / EAC dual-channel, unsigned. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_SIGNED_RG11_EAC - ETC2 / EAC dual-channel, signed. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RGB8_ETC2 - ETC2 / EAC RGB. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_SRGB8_ETC2 - ETC2 / EAC RGB using sRGB colourspace. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2 - ETC2 / EAC RGB with single bit per pixel alpha mask. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2 - ETC2 / EAC RGB using sRGB colourspace, with single bit per pixel alpha mask. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RGBA8_ETC2_EAC - ETC2 / EAC RGB plus separate alpha channel. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_SRGB8_ALPHA8_ETC2_EAC - ETC2 / EAC RGB using sRGB colourspace, plus separate alpha channel. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RGB8_ETC1 - ETC1 RGB as defined by GLES 2 extension OES_compressed_ETC1_RGB8_texture: http://www.khronos.org/registry/gles/extensions/OES/OES_compressed_ETC1_RGB8_texture.txt. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RGB_PVRTC_4BPPV1 - PowerVR 4bpp RGB format (v1) as defined by extension IMG_texture_compression_pvrtc: http://www.khronos.org/registry/gles/extensions/IMG/IMG_texture_compression_pvrtc.txt. - Since:
- 2.4, DALi version 1.0.0
 - COMPRESSED_RGBA_ASTC_4x4_KHR - ASTC Linear color space with a 4x4 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_5x4_KHR - ASTC Linear color space with a 5x4 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_5x5_KHR - ASTC Linear color space with a 5x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_6x5_KHR - ASTC Linear color space with a 6x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_6x6_KHR - ASTC Linear color space with a 6x6 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_8x5_KHR - ASTC Linear color space with a 8x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_8x6_KHR - ASTC Linear color space with a 8x6 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_8x8_KHR - ASTC Linear color space with a 8x8 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_10x5_KHR - ASTC Linear color space with a 10x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_10x6_KHR - ASTC Linear color space with a 10x6 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_10x8_KHR - ASTC Linear color space with a 10x8 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_10x10_KHR - ASTC Linear color space with a 10x10 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_12x10_KHR - ASTC Linear color space with a 12x10 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_RGBA_ASTC_12x12_KHR - ASTC Linear color space with a 12x12 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR - ASTC Non-linear (gamma-corrected) color space with a 4x4 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR - ASTC Non-linear (gamma-corrected) color space with a 5x4 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR - ASTC Non-linear (gamma-corrected) color space with a 5x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR - ASTC Non-linear (gamma-corrected) color space with a 6x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR - ASTC Non-linear (gamma-corrected) color space with a 6x6 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR - ASTC Non-linear (gamma-corrected) color space with a 8x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR - ASTC Non-linear (gamma-corrected) color space with a 8x6 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR - ASTC Non-linear (gamma-corrected) color space with a 8x8 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR - ASTC Non-linear (gamma-corrected) color space with a 10x5 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR - ASTC Non-linear (gamma-corrected) color space with a 10x6 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR - ASTC Non-linear (gamma-corrected) color space with a 10x8 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR - ASTC Non-linear (gamma-corrected) color space with a 10x10 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR - ASTC Non-linear (gamma-corrected) color space with a 12x10 block-size. - Since:
- 3.0, DALi version 1.1.17
 - COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR - ASTC Non-linear (gamma-corrected) color space with a 12x12 block-size. - Since:
- 3.0, DALi version 1.1.17
 - RGB16F - Color depth 48-bit, 16-16-16 half floating point. - Since:
- 4.0, DALi version 1.2.60
 - RGB32F - Color depth 96-bit, 32-32-32 floating point. - Since:
- 4.0, DALi version 1.2.60
 
Function Documentation
| void Dali::Pixel::GetAlphaOffsetAndMask | ( | Format | pixelFormat, | 
| int & | byteOffset, | ||
| int & | bitMask | ||
| ) | 
Returns the offset of the byte containing the alpha value from the start of the pixel data and the bitmask of that byte to get the alpha value.
For example, in case of Pixel::RGBA4444, byteOffset value is 1 and bitMask value is 0x0f. It means the second byte contains the alpha value and the last 4 bits of the byte is the alpha value.
Bitmask is zero if the pixelFormat does not support alpha.
- Since:
- 2.4, DALi version 1.0.0
- Parameters:
- 
  [in] pixelFormat The pixel format [out] byteOffset The byte offset of the byte containing the alpha value [out] bitMask The bitmask of the byte to get the alpha value 
| unsigned int Dali::Pixel::GetBytesPerPixel | ( | Format | pixelFormat | ) | 
Returns The number of bytes per pixel for the specified pixel format.
- Since:
- 2.4, DALi version 1.0.0
- Parameters:
- 
  [in] pixelFormat The pixel format 
- Returns:
- The number of bytes per pixel
| bool Dali::Pixel::HasAlpha | ( | Format | pixelformat | ) | 
Whether specified pixel format contains an alpha value.
- Since:
- 2.4, DALi version 1.0.0
- Parameters:
- 
  [in] pixelformat Pixel format 
- Returns:
- trueif format has alpha,- falseotherwise
Variable Documentation
For asserting that a variable has a valid pixel format.
Sync it to the first value above.
For asserting that a variable has a valid pixel format.
Sync it to the last value above.