2.2.4.1.1.2.1.1 CLEARCODEC_VBAR

The CLEARCODEC_VBAR structure is used to encode a single column of pixels (referred to as a "V-Bar") and is encapsulated inside a CLEARCODEC_BAND (section 2.2.4.1.1.2.1) structure. The xStart, xEnd, yStart and yEnd fields of the CLEARCODEC_BAND structure specify the area within which the V-Bar is contained.


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

vBarHeader (variable)

...

...

shortVBarPixels (variable)

...

...

vBarHeader (variable):  A VBAR_CACHE_HIT (section 2.2.4.1.1.2.1.1.1) structure, SHORT_VBAR_CACHE_HIT (section 2.2.4.1.1.2.1.1.2) structure, or SHORT_VBAR_CACHE_MISS (section 2.2.4.1.1.2.1.1.3) structure.

shortVBarPixels (variable):  An optional variable-length array of bytes that MUST be present only if the vBarHeader field contains a SHORT_VBAR_CACHE_MISS structure. If this field is present, the number of bytes in the field MUST be equal to 3 * (shortVBarYOff - shortVBarYOn): one RGB triplet per pixel where shortVBarYOff and shortVBarYOn are specified in the SHORT_VBAR_CACHE_MISS structure. This field contains raw pixels in top-to-bottom order. The pixels are encoded in little-endian byte order (blue in the first byte, green in the second byte, and red in the third byte).

Each pixel in the V-Bar MUST be placed at position (xPos, yPos) in the image (relative to the top-left corner), where xPos and yPos are calculated as follows:

xPos = xStart + position of the V-Bar in the vBars field of the CLEARCODEC_BAND structure

yPos = yStart + position of the pixel in the V-Bar Storage ADM element