Member attributes: ColorChannelsOrder

This attribute controls the color conversion of bitmap resources when generating code for a particular profile member.

Syntax

color‑channel‑name,color‑channel‑name, ...

Discussion

The attribute ColorChannelsOrder determines in which order the target system expects the color channels to be stored within the memory of a pixel beginning with the least significant bit. The setting affects directly the format of how bitmap resources are converted and stored in the generated code. However, it has an effect only when the related attribute FormatOfBitmapResources is configured with the value DirectAccess. Otherwise the setting of ColorChannelsOrder is ignored.

A valid value for this attribute is composed of color channel names separated by , (comma) signs. Which color channel names are in fact available depends on the base color format of the Platform Package selected in the a particular profile member. Following is an overview of possible color channel names:

Color format

Channel names

Comments and example

RGBA8888

Red

Green

Blue

Alpha

For example: the attribute value Blue,Green,Red,Alpha determines, that the blue color channel is stored in the least significant bits of the pixel memory. Then follow the channels green and red. The alpha color channel, in turn, occupies the most significant bits.

RGBA4444

Red

Green

Blue

Alpha

For example: the attribute value Alpha,Blue,Green,Red determines, that the alpha color channel is stored in the least significant bits of the pixel memory. Then follow the channels blue and green. The red color channel, in turn, occupies the most significant bits.

RGB565A8

Red

Green

Blue

Since this color format stores the alpha information in a separate memory area, it is not necessary to configure the alpha channel. Moreover, the channel green is expected to lie between the both remaining channels red and blue.

For example: the attribute value Blue,Green,Red determines, that the blue color channel is stored in the least significant bits of the pixel memory, followed by the channels green and red.

RGB555A8

Red

Green

Blue

Const_0

Const_1

Alpha_8

The names Const_0, Const_1 and Alpha_8 determine the function of the most significant bit in the pixel memory (bit 15). This bit can be configured to always contain a constant value or to correspond to the most significant bit from the 8-bit alpha channel. Since this color format stores the alpha information in a separate memory area, it is not necessary to configure the alpha channel.

For example: the attribute value Blue,Green,Red,Alpha_8 determines, that the blue color channel is stored in the least significant bits of the pixel memory, followed by the channels green and red. The remaining most significant bit is initialized with the value of the bit 8 from the corresponding alpha channel.

LumA44

Lum

Alpha

For example: the attribute value Lum,Alpha determines, that the luminance channel is stored in the least significant bits and the alpha channel occupies the most significant bits in the pixel memory.

YUVA8888

Y

U

V

Alpha

For example: the attribute value Y,U,V,Alpha determines, that the Y color channel is stored in the least significant bits of the pixel memory. Then follow the channels U and V. The alpha color channel, in turn, occupies the most significant bits.

Modify the attribute

To inspect or modify the value of a ColorChannelsOrder attribute, select first the affected profile member. Thereupon, the attribute is listed in the middle area of Inspector. Please note the available assistant you can activate by clicking on the button right to the attribute:

Please note, the attribute can be hidden if the Platform Package selected in the particular profile member doesn't support the direct-access format for generated bitmap data (see FormatOfBitmapResources) or the layout of how pixel data are stored in the target device is fixed and can't be configured.