2.4.16 BopPopCustom
This record specifies which data points in the series are contained in the secondary bar/pie, instead of the primary pie. MUST follow a BopPop record that contains a split field that is set to "Custom (0x0003)".
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
cxi |
rggrbit (variable) |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
cxi (2 bytes): An unsigned integer that specifies the number of data points in the series plus 1. MUST be less than 0x0FA0.
rggrbit (variable): A sequence of bits that specifies whether each data point in the series is contained in the primary pie or the secondary bar/pie. For each data point, a corresponding bit specifies whether a data point is contained in the secondary bar/pie or the primary pie, as specified in the following table.
-
Value
Meaning
0
The data point is in the primary pie.
1
The data point is in the secondary bar/pie.
-
The size of this field, in bytes, is calculated by using the following formula:
-
size of rggrbit in bytes = 1 + floor(cxi / 8)
-
The padding of this field, in bits, is calculated by using the following formula:
-
padding = size of rggrbit in bits - cxi
-
The position of each bit in the sequence corresponds to the position of each data point in the series, arranged as follows:
Any padding is placed in the most significant bits of the first byte. The next most significant bit of the first byte corresponds to the first data point in the series. If there are any more unused bits in the first byte, the next most significant bit corresponds to the second data point in the series. This pattern continues until there are no remaining unused bits in the first byte.
The most significant bit of the next byte corresponds to the next data point in the series. The next most significant bit contains the next data point in the series. This pattern continues for each byte in the sequence.
The least significant bit of the final byte is an additional bit that specifies whether the secondary bar/pie does not contain data points. If the additional bit is 1, the value of every other bit MUST be 0.
The following figure demonstrates this order.
Figure 2: Bit arrangement in this field