2.4.334 BrtColor

The BrtColor record specifies a color.


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

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.