Tizen Native API  6.5
Functions | Enumerations | Variables
Dali::Pixel Namespace Reference
Images

Pixel format types and their properties. More...

Functions

DALI_CORE_API bool HasAlpha (Format pixelformat)
 Whether specified pixel format contains an alpha value.
DALI_CORE_API uint32_t GetBytesPerPixel (Format pixelFormat)
 Returns The number of bytes per pixel for the specified pixel format.
DALI_CORE_API 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 = DEPTH_STENCIL
 For asserting that a variable has a valid pixel format.

Detailed Description

Pixel format types and their properties.

Since:
3.0, 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:
3.0, 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:
3.0, DALi version 1.0.0
L8 

color depth 8-bit, luminance

Since:
3.0, DALi version 1.0.0
LA88 

color depth 16-bit, luminance with 8 bit alpha

Since:
3.0, DALi version 1.0.0
RGB565 

color depth 16 bit, 5-6-5

Since:
3.0, DALi version 1.0.0
BGR565 

color depth 16 bit, 5-6-5

Since:
3.0, DALi version 1.0.0
RGBA4444 

color depth 16 bit with alpha, 4-4-4-4

Since:
3.0, DALi version 1.0.0
BGRA4444 

color depth 16 bit with alpha, 4-4-4-4

Since:
3.0, DALi version 1.0.0
RGBA5551 

color depth 16 bit with alpha, 5-5-5-1

Since:
3.0, DALi version 1.0.0
BGRA5551 

color depth 16 bit with alpha, 5-5-5-1

Since:
3.0, DALi version 1.0.0
RGB888 

color depth 24 bit, 8-8-8

Since:
3.0, DALi version 1.0.0
RGB8888 

color depth 32 bit, alpha is reserved but not used, 8-8-8-8#

Since:
3.0, DALi version 1.0.0
BGR8888 

color depth 32 bit, alpha is reserved but not used, 8-8-8-8#

Since:
3.0, DALi version 1.0.0
RGBA8888 

color depth 32 bit with alpha, 8-8-8-8

Since:
3.0, DALi version 1.0.0
BGRA8888 

color depth 32 bit with alpha, 8-8-8-8

Since:
3.0, DALi version 1.0.0
COMPRESSED_R11_EAC 

ETC2 / EAC single-channel, unsigned.

Since:
3.0, DALi version 1.0.0
COMPRESSED_SIGNED_R11_EAC 

ETC2 / EAC single-channel, signed.

Since:
3.0, DALi version 1.0.0
COMPRESSED_RG11_EAC 

ETC2 / EAC dual-channel, unsigned.

Since:
3.0, DALi version 1.0.0
COMPRESSED_SIGNED_RG11_EAC 

ETC2 / EAC dual-channel, signed.

Since:
3.0, DALi version 1.0.0
COMPRESSED_RGB8_ETC2 

ETC2 / EAC RGB.

Since:
3.0, DALi version 1.0.0
COMPRESSED_SRGB8_ETC2 

ETC2 / EAC RGB using sRGB colourspace.

Since:
3.0, DALi version 1.0.0
COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2 

ETC2 / EAC RGB with single bit per pixel alpha mask.

Since:
3.0, DALi version 1.0.0
COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2 

ETC2 / EAC RGB using sRGB colourspace, with single bit per pixel alpha mask.

Since:
3.0, DALi version 1.0.0
COMPRESSED_RGBA8_ETC2_EAC 

ETC2 / EAC RGB plus separate alpha channel.

Since:
3.0, DALi version 1.0.0
COMPRESSED_SRGB8_ALPHA8_ETC2_EAC 

ETC2 / EAC RGB using sRGB colourspace, plus separate alpha channel.

Since:
3.0, 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:
3.0, 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:
3.0, 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
DEPTH_UNSIGNED_INT 

Unsigned int depth format 32-bit.

Since:
5.5, DALi version 1.5.9
DEPTH_FLOAT 

Float depth format 32-bit.

Since:
5.5, DALi version 1.5.9
DEPTH_STENCIL 

! Update LAST_VALID_PIXEL_FORMAT below if you add an enum value here.

Depth stencil 32-bit, 24 bit for depth, 8 bit for stencil.

Since:
5.5, DALi version 1.5.9

Function Documentation

DALI_CORE_API 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:
3.0, DALi version 1.0.0
Parameters:
[in]pixelFormatThe pixel format
[out]byteOffsetThe byte offset of the byte containing the alpha value
[out]bitMaskThe bitmask of the byte to get the alpha value
DALI_CORE_API uint32_t Dali::Pixel::GetBytesPerPixel ( Format  pixelFormat)

Returns The number of bytes per pixel for the specified pixel format.

Since:
3.0, DALi version 1.0.0
Parameters:
[in]pixelFormatThe pixel format
Returns:
The number of bytes per pixel
DALI_CORE_API bool Dali::Pixel::HasAlpha ( Format  pixelformat)

Whether specified pixel format contains an alpha value.

Since:
3.0, DALi version 1.0.0
Parameters:
[in]pixelformatPixel format
Returns:
true if format has alpha, false otherwise

Variable Documentation

const Format Dali::Pixel::FIRST_VALID_PIXEL_FORMAT = A8

For asserting that a variable has a valid pixel format.

Sync it to the first value above.

const Format Dali::Pixel::LAST_VALID_PIXEL_FORMAT = DEPTH_STENCIL

For asserting that a variable has a valid pixel format.

Sync it to the last value above.