One guint16 value; for alpha.
One half-float value; for alpha.
One float value; for alpha.
One byte; for alpha.
4 bytes; for alpha, blue, green, red.
4 bytes; for alpha, blue, green, red, The color values are premultiplied with the alpha value.
4 bytes; for alpha, red, green, blue.
4 bytes; for alpha, red, green, blue. The color values are premultiplied with the alpha value.
4 bytes per pixel
Bits 31..30 contain the alpha channel, 29..20 blue, 19..10 green and 9..0 red.
4 bytes per pixel
Bits 31..30 contain the alpha channel, 29..20 red, 19..10 green and 9..0 blue.
4 bytes per pixel
Bits 31..30 contain the alpha channel, 29..20 red, 19..10 green and 9..0 blue.
The color values are premultiplied with the alpha value.
3 bytes; for blue, green, red. The data is opaque.
4 bytes; for blue, green, red, alpha.
4 bytes; for blue, green, red, alpha. The color values are premultiplied with the alpha value.
Packed format with subsampled channels.
Each channel is a 8 bit integer. The red and blue/chroma channels are subsampled and interleaved with the green/luma channel.
Each block contains 2 pixels, so the width must be a multiple of 2.
Commonly known by the fourcc "UYVY".
4 bytes; for blue, green, red, unused.
Multiplane format with 2 planes.
Each channel is a 16 bit integer, but only the highest 10 bits are used.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cr followed by Cb. This format is not subsampled.
Commonly known by the fourcc "P010".
Multiplane format with 2 planes.
Each channel is a 16 bit integer, but only the highest 10 bits are used.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cr followed by Cb. This format is not subsampled.
Commonly known by the fourcc "P012".
One guint16 value; for grayscale. The data is opaque.
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in both the X and Y direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in both the X and Y direction. It is mapped into the 1st channel.
Commonly known by the fourcc "S016".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in the X direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in the X direction. It is mapped into the 1st channel.
Commonly known by the fourcc "S216".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. It is mapped into the 1st channel.
Commonly known by the fourcc "S416".
Multiplane format with 2 planes.
Each channel is a 16 bit integer.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cr followed by Cb. This format is not subsampled.
Commonly known by the fourcc "P016".
2 guint16 values; for grayscale, alpha.
2 guint16 values; for grayscale, alpha. The color values are premultiplied with the alpha value.
One byte; for grayscale. The data is opaque.
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in both the X and Y direction with 4:1 ratio. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in both the X and Y direction with 4:1 ratio. It is mapped into the 1st channel.
Commonly known by the fourcc "YUV410".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in the X direction with 4:1 ratio. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in the X direction with 4:1 ratio. It is mapped into the 1st channel.
Commonly known by the fourcc "YUV411".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in both the X and Y direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in both the X and Y direction. It is mapped into the 1st channel.
Commonly known by the fourcc "YUV420".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in the X direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in the X direction. It is mapped into the 1st channel.
Commonly known by the fourcc "YUV422".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. It is mapped into the 1st channel.
Commonly known by the fourcc "YUV444".
Multiplane format with 2 planes.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cb followed by Cr. Subsampled in both the X and Y direction.
Commonly known by the fourcc "NV12".
Multiplane format with 2 planes.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cb followed by Cr. Subsampled in the X direction.
Commonly known by the fourcc "NV16".
Multiplane format with 2 planes.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cb followed by Cr. This format is not subsampled.
Commonly known by the fourcc "NV24".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the second chroma chanel. Subsampled in both the X and Y direction with 4:1 ratio. It is mapped into the 1st channel.
The third plane usually contains the first chroma channel. Subsampled in both the X and Y direction with 4:1 ratio. It is mapped into the 3rd channel.
Commonly known by the fourcc "YVU410".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the second chroma chanel. Subsampled in the X direction with 4:1 ratio. It is mapped into the 1st channel.
The third plane usually contains the first chroma channel. Subsampled in the X direction with 4:1 ratio. It is mapped into the 3rd channel.
Commonly known by the fourcc "YVU411".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the second chroma chanel. Subsampled in both the X and Y direction. It is mapped into the 1st channel.
The third plane usually contains the first chroma channel. Subsampled in both the X and Y direction. It is mapped into the 3rd channel.
Commonly known by the fourcc "YVU420".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the second chroma chanel. Subsampled in the X direction. It is mapped into the 1st channel.
The third plane usually contains the first chroma channel. Subsampled in the X direction. It is mapped into the 3rd channel.
Commonly known by the fourcc "YVU422".
Multiplane format with 3 planes.
Each channel is a 8 bit integer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the second chroma chanel. Subsampled in the X direction. It is mapped into the 1st channel.
The third plane usually contains the first chroma channel. Subsampled in the X direction. It is mapped into the 3rd channel.
Commonly known by the fourcc "YVU444".
Multiplane format with 2 planes.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cr followed by Cb. Subsampled in both the X and Y direction.
Commonly known by the fourcc "NV21".
Multiplane format with 2 planes.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cr followed by Cb. Subsampled in the X direction.
Commonly known by the fourcc "NV61".
Multiplane format with 2 planes.
The first plane contains the first channel, usually containing luma values. The second plane with interleaved chroma values, Cr followed by Cb. This format is not subsampled.
Commonly known by the fourcc "NV42".
2 bytes; for grayscale, alpha.
2 bytes; for grayscale, alpha. The color values are premultiplied with the alpha value.
Packed format with subsampled channels.
Each channel is a 8 bit integer. The red and blue/chroma channels are subsampled and interleaved with the green/luma channel.
Each block contains 2 pixels, so the width must be a multiple of 2.
Commonly known by the fourcc "YUYV".
Packed format with subsampled channels.
Each channel is a 8 bit integer. The red and blue/chroma channels are subsampled and interleaved with the green/luma channel.
Each block contains 2 pixels, so the width must be a multiple of 2.
Commonly known by the fourcc "YVYU".
The number of formats. This value will change as more formats get added, so do not rely on its concrete integer.
3 guint16 values; for red, green, blue.
3 half-float values; for red, green, blue. The data is opaque.
4 guint16 values; for red, green, blue, alpha.
4 half-float values; for red, green, blue and alpha.
4 half-float values; for red, green, blue and alpha. The color values are premultiplied with the alpha value.
4 guint16 values; for red, green, blue, alpha. The color values are premultiplied with the alpha value.
3 float values; for red, green, blue.
4 float values; for red, green, blue and alpha.
4 float values; for red, green, blue and alpha. The color values are premultiplied with the alpha value.
3 bytes; for red, green, blue. The data is opaque.
4 bytes; for red, green, blue, alpha.
4 bytes; for red, green, blue, alpha The color values are premultiplied with the alpha value.
Packed format with subsampled channels.
Each channel is a 8 bit integer. The red and blue/chroma channels are subsampled and interleaved with the green/luma channel.
Each block contains 2 pixels, so the width must be a multiple of 2.
Commonly known by the fourcc "VYUY".
4 bytes; for red, green, blue, unused.
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
Only the 12 lower bits are used. The remaining ones must be set to 0 by the producer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in both the X and Y direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in both the X and Y direction. It is mapped into the 1st channel.
Commonly known by the fourcc "S012".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
Only the 12 lower bits are used. The remaining ones must be set to 0 by the producer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in the X direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in the X direction. It is mapped into the 1st channel.
Commonly known by the fourcc "S212".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
Only the 12 lower bits are used. The remaining ones must be set to 0 by the producer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. It is mapped into the 1st channel.
Commonly known by the fourcc "S412".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
Only the 10 lower bits are used. The remaining ones must be set to 0 by the producer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in both the X and Y direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in both the X and Y direction. It is mapped into the 1st channel.
Commonly known by the fourcc "S010".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
Only the 10 lower bits are used. The remaining ones must be set to 0 by the producer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. Subsampled in the X direction. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. Subsampled in the X direction. It is mapped into the 1st channel.
Commonly known by the fourcc "S210".
Multiplane format with 3 planes.
Each channel is a 16 bit integer.
Only the 10 lower bits are used. The remaining ones must be set to 0 by the producer.
The first plane usually contains the luma channel. It is mapped into the 2nd channel.
The second plane usually contains the first chroma chanel. It is mapped into the 3rd channel.
The third plane usually contains the second chroma channel. It is mapped into the 1st channel.
Commonly known by the fourcc "S410".
4 bytes; for unused, blue, green, red.
4 bytes; for unused, red, green, blue.
4 bytes per pixel
Bits 31..30 are padding, bits 29..20 contain blue, 19..10 green and 9..0 red.
The format is opaque.
4 bytes per pixel
Bits 31..30 are padding, bits 29..20 contain red, 19..10 green and 9..0 blue.
The format is opaque.
Describes formats that image data can have in memory.
It describes formats by listing the contents of the memory passed to it. So
GDK_MEMORY_A8R8G8B8will be 1 byte (8 bits) of alpha, followed by a byte each of red, green and blue. It is not endian-dependent, soCAIRO_FORMAT_ARGB32is represented by differentGdkMemoryFormatson architectures with different endiannesses.A note on naming
The format names are roughly modelled after VkFormat. A name follows
GDK_MEMORY_<CHANNELS>_<DATA_TYPE>_<SUBSAMPLING> <PREMULTIPLIED>where CHANNELS describe how the RGBA channels are layed out in memory, with an X denoting padding. DATA_TYPE is unsigned normalized integer if not present, or otherwise FLOAT. The optional SUBSAMPLING defines the subsampling method used. The optional ENDIAN term describes the endianness if it is not host-endian. Finally, an optional PREMULTIPLIED term indicates that the color channels are premultiplied with the alpha value, if it is omitted, the data is not premultiplied or there is no alpha channel.The CHANNELS are given as a list of planes seperated by underscores where each plane is split into multiple elements describing one or more bytes of memory. Each element is given as the list of channels folowed by the amount of bits taken up.
So the fictional format
RGB565_A8_PREMULTIPLIEDwould describe a format with 2 planes where the first plane is an unsigned 16 bit integer containing the RGB channels with 5, 6, and 5 bits respectively while the 2nd plane contains the alpha channel as an unisnged 8bit integer.