2.2.4.1.1.2.1 CLEARCODEC_BAND

The CLEARCODEC_BAND structure specifies a horizontal band that is composed of columns of pixels. Each of these columns is referred to as a "V-Bar". The maximum height of a band is 52 pixels.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

xStart

xEnd

yStart

yEnd

blueBkg

greenBkg

redBkg

vBars (variable)

...

...

xStart (2 bytes):  A 16-bit unsigned integer that specifies the horizontal position (relative to the left edge of the bitmap) where the band starts.

xEnd (2 bytes):  A 16-bit unsigned integer that specifies the horizontal position (relative to the left edge of the bitmap) where the band ends. This is an inclusive coordinate.

yStart (2 bytes):  A 16-bit unsigned integer that specifies the vertical position (relative to the top edge of the bitmap) where the band starts.

yEnd (2 bytes):  A 16-bit unsigned integer that specifies the vertical position (relative to the top edge of the bitmap) where the band ends. This is an inclusive coordinate.

blueBkg (1 byte):  An 8-bit unsigned integer that specifies the blue value of the background for this band.

greenBkg (1 byte):  An 8-bit unsigned integer that specifies the green value of the background for this band.

redBkg (1 byte):  An 8-bit unsigned integer that specifies the red value of the background for this band.

vBars (variable):  A variable-length array of CLEARCODEC_VBAR (section 2.2.4.1.1.2.1.1) structures. The total count of CLEARCODEC_VBAR structures MUST be equal to (xEnd - xStart + 1), one per x-coordinate in the band. The V-Bars are encoded from left to right, with the first V-Bar corresponding to the xStart field and the last corresponding to the xEnd field.