2.2.2 OfficeArtCOLORREF

Referenced by: borderBottomColor, borderLeftColor, borderRightColor, borderTopColor, c3DCrMod, c3DExtrusionColor, c3DExtrusionColorExt, fillBackColor, fillBackColorExt, fillColor, fillColorExt, fillCrMod, lineBackColor, lineBackColorExt, lineBottomBackColor, lineBottomBackColorExt, lineBottomColor, lineBottomColorExt, lineBottomCrMod, lineColor, lineColorExt, lineCrMod, lineLeftBackColor, lineLeftBackColorExt, lineLeftColor, lineLeftColorExt, lineLeftCrMod, lineRightBackColor, lineRightBackColorExt, lineRightColor, lineRightColorExt, lineRightCrMod, lineTopBackColor, lineTopBackColorExt, lineTopColor, lineTopColorExt, lineTopCrMod, MSOSHADECOLOR, pictureDblCrMod, pictureFillCrMod, pictureLineCrMod, pictureRecolor, pictureRecolorExt, pictureTransparent, pictureTransparentExt, reserved1370, reserved1374, reserved1377, reserved1378, reserved1434, reserved1438, reserved1441, reserved1442, reserved1498, reserved1502, reserved1505, reserved1506, reserved1562, reserved1566, reserved1569, reserved1570, reserved278, reserved281, reserved284, reserved287, reserved415, reserved419, reserved422, reserved423, reserved474, reserved478, reserved481, reserved482, reserved531, reserved535, reserved538, reserved539, reserved650, reserved653, shadowColor, shadowColorExt, shadowCrMod, shadowHighlight, shadowHighlightExt

The OfficeArtCOLORREF structure specifies a color. The high 8 bits MAY be set to 0xFF, in which case the color MUST be ignored.

The color properties that are specified in the following table have a set of extended-color properties. The color property specifies the main color. The colorExt and colorExtMod properties specify the extended colors that can be used to define the main color more precisely.

If neither extended-color property is set, the main color property contains the full color definition. Otherwise, the colorExt property specifies the base color, and the colorExtMod property specifies a tint or shade modification that is applied to the colorExt property. In this case, the main color property contains the flattened RGB color that is computed by applying the specified tint or shade modification to the specified base color.

A - unused1 (1 bit): A bit that is undefined and MUST be ignored.

B - unused2 (1 bit): A bit that is undefined and MUST be ignored.

C - unused3 (1 bit): A bit that is undefined and MUST be ignored.

D - fSysIndex (1 bit): A bit that specifies whether the system color scheme will be used to determine the color. A value of 0x1 specifies that green and red will be treated as an unsigned 16-bit index into the system color table. Values less than 0x00F0 map directly to system colors. For more information, see [MSDN-GetSysColor].

The following table specifies values that have special meaning.

Value	Meaning
0x00F0	Use the fill color of the shape.
0x00F1	If the shape contains a line, use the line color of the shape. Otherwise, use the fill color.
0x00F2	Use the line color of the shape.
0x00F3	Use the shadow color of the shape.
0x00F4	Use the current, or last-used, color.
0x00F5	Use the fill background color of the shape.
0x00F6	Use the line background color of the shape.
0x00F7	If the shape contains a fill, use the fill color of the shape. Otherwise, use the line color.

The following table specifies values that indicate special procedural properties that are used to modify the color components of another color. These values are combined with those in the preceding table or with a user-specified color. The first six values are mutually exclusive.

Value	Meaning
0x0100	Darken the color by the value that is specified in the blue field. A blue value of 0xFF specifies that the color is to be left unchanged, whereas a blue value of 0x00 specifies that the color is to be completely darkened.
0x0200	Lighten the color by the value that is specified in the blue field. A blue value of 0xFF specifies that the color is to be left unchanged, whereas a blue value of 0x00 specifies that the color is to be completely lightened.
0x0300	Add a gray level RGB value. The blue field contains the gray level to add: NewColor = SourceColor + gray
0x0400	Subtract a gray level RGB value. The blue field contains the gray level to subtract: NewColor = SourceColor - gray
0x0500	Reverse-subtract a gray level RGB value. The blue field contains the gray level from which to subtract: NewColor = gray - SourceColor
0x0600	If the color component being modified is less than the parameter contained in the blue field, set it to the minimum intensity. If the color component being modified is greater than or equal to the parameter, set it to the maximum intensity.
0x2000	After making other modifications, invert the color.
0x4000	After making other modifications, invert the color by toggling just the high bit of each color channel.
0x8000	Before making other modifications, convert the color to grayscale.

E - fSchemeIndex (1 bit): A bit that specifies whether the current application-defined color scheme will be used to determine the color. A value of 0x1 specifies that red will be treated as an index into the current color scheme table. If this value is 0x1, green and blue MUST be 0x00.

F - fSystemRGB (1 bit): A bit that specifies whether the color is a standard RGB color. The following table specifies the meaning of each value for this field.

Value	Meaning
0x0	The RGB color MAY use halftone dithering to display.
0x1	The color MUST be a solid color.

G - fPaletteRGB (1 bit): A bit that specifies whether the current palette will be used to determine the color. A value of 0x1 specifies that red, green, and blue contain an RGB value that will be matched in the current color palette. This color MUST be solid.

H - fPaletteIndex (1 bit): A bit that specifies whether the current palette will be used to determine the color. A value of 0x1 specifies that green and red will be treated as an unsigned 16-bit index into the current color palette. This color MAY<1> be dithered. If this value is 0x1, blue MUST be 0x00.

blue (1 byte): An unsigned integer that specifies the intensity of the blue color channel. A value of 0x00 has the minimum blue intensity. A value of 0xFF has the maximum blue intensity.

green (1 byte): An unsigned integer that specifies the intensity of the green color channel. A value of 0x00 has the minimum green intensity. A value of 0xFF has the maximum green intensity.

red (1 byte): An unsigned integer that specifies the intensity of the red color channel. A value of 0x00 has the minimum red intensity. A value of 0xFF has the maximum red intensity.