2.4.334 BrtColor
The BrtColor record specifies a color.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
A |
xColorType |
index |
nTintAndShade |
||||||||||||||||||||||||||||
|
bRed |
bGreen |
bBlue |
bAlpha |
||||||||||||||||||||||||||||
A - fValidRGB (1 bit): A bit that specifies whether the color specified by index matches the color specified by bRed, bGreen, bBlue, and bAlpha. This value MUST be 1 if xColorType is 2. Possible values for this field and their meanings are listed in the following table.
-
Value
Meaning
0
The color specified by index does not match the color specified by bRed, bGreen, bBlue, and bAlpha. bRed, bGreen, bBlue, and bAlpha MUST be ignored.
1
The color specified by index matches the color specified by bRed, bGreen, bBlue, and bAlpha.
xColorType (7 bits): An unsigned integer that specifies the type of color information contained in this record. This value MUST be a value from the following table.
-
Value
Meaning
0x00
Color information is automatically determined by the application.
0x01
This color is a color from a color palette and is specified by index.
0x02
This color is a standard ARGB color and is specified by the values in bRed, bGreen, bBlue, and bAlpha.
0x03
This color is a theme color and is specified by index.
index (1 byte): A value that specifies the index of a color from a collection of colors. The type and meaning of this field depends on the value of xColorType and is specified by the following table.
-
Value of xColorType
Meaning of index field
0x00
Undefined and MUST be ignored.
0x01
An Icv (section 2.5.76) that specifies a color from a color palette.
0x02
Undefined and MUST be ignored.
0x03
An unsigned integer that specifies a subelement of the clrScheme element in the Theme (section 2.1.7.52) part that specifies a color. The following lists which subelement of clrScheme to use for each legal value of index:
Index = 0x00, subelement = dk1
Index = 0x01, subelement = lt1
Index = 0x02, subelement = dk2
Index = 0x03, subelement = lt2
Index = 0x04, subelement = accent1
Index = 0x05, subelement = accent2
Index = 0x06, subelement = accent3
Index = 0x07, subelement = accent4
Index = 0x08, subelement = accent5
Index = 0x09, subelement = accent6
Index = 0x0A, subelement = hlink
Index = 0x0B, subelement = folHlink
nTintAndShade (2 bytes): A signed integer that specifies the amount of tint or shade applied to the color specified by index or bRed, bGreen, bBlue, and bAlpha. The maximum possible positive value means 100% lightening, the maximum possible negative value means 100% darkening, and 0 means no change.
bRed (1 byte): An unsigned integer that specifies the intensity of red in this color, where 0 is no red and 255 is maximum red.
bGreen (1 byte): An unsigned integer that specifies the intensity of green in this color, where 0 is no green and 255 is maximum green.
bBlue (1 byte): An unsigned integer that specifies the intensity of blue in this color, where 0 is no blue and 255 is maximum blue.
bAlpha (1 byte): An unsigned integer that specifies the transparency of this color, where 0 is completely transparent and 255 is completely opaque.