ST_ColorType (Color Type)

This simple type specifies a color. Colors are specified in one of three ways - named color, hexadecimal RGB or color palette entry. One of two optional descriptors may follow the color and a space: a number in square brackets or a recoloring instruction. [Rationale: An application might store the color's index in a system color palette using the numeric storage. An application might choose to make one color dependent on another using a recoloring instruction. end rationale] In cases where it is appropriate for an application to indicate that no color exists, the value none may be used.

A named color is specified using the name of the color. The following named colors are supported:

• Black (#000000)

• Silver (#C0C0C0)

• Gray (#808080)

• White (#FFFFFF)

• Maroon (#800000)

• Red (#FF0000)

• Purple (#800080)

• Fuchsia (#FF00FF)

• Green (#008000)

• Lime (#00FF00)

• Olive (#808000)

• Yellow (#FFFF00)

• Navy (#000080)

• Blue (#0000FF)

• Teal (#008080)

• Aqua (#00FFFF)

[Example:

<... color="red" ... >

end example]

Hexadecimal RGB is specified using a hash symbol (#) followed by six hexadecimal characters, where each pair represents the red, green and blue component of the color.

[Example:

<... color="#5f2726" ... >

end example]

Hexadecimal RGB is also optionally be specified using a hash symbol followed by three hexadecimal characters, where each character stands in for two characters in each of the red, green and blue components. For clarity, applications should use the full six character representation rather than this short form.

[Example: The following two representations are equivalent:

<... color="ff4400" ... >

<... color="f40" ... >

end example]

A color palette entry is specified using the name of the color in the palette.

[Example: This example also demonstrates the optional numeric storage:

<... color="buttonFace [67]" ... >

end example]

Recoloring instructions indicate that the given color is to be modified a particular amount. The instruction consists of a named instruction followed by the amount, a number in the range 0-255, in parenthesis. There are no required implementations for these recoloring instructions - applications are free to implement their own versions of each. A particular implementation should achieve the result implied by the instruction name. The instructions are:

• darken

• lighten

• add

• subtract

• reverseSubtract

• blackWhite

• invert

• invert128

• grayScale

[Example: The color is darker than the fill color by 50 units:

<... color="fill darken(50)">

end example]

This simple type's contents are a restriction of the XML Schema string datatype.

Referenced By

bottom@color (§6.2.2.1); bottom@color2 (§6.2.2.1); colormenu@extrusioncolor (§6.2.2.4); colormenu@fillcolor (§6.2.2.4); colormenu@shadowcolor (§6.2.2.4); colormenu@strokecolor (§6.2.2.4); column@color (§6.2.2.6); column@color2 (§6.2.2.6); extrusion@color (§6.2.2.10); left@color (§6.2.2.15); left@color2 (§6.2.2.15); right@color (§6.2.2.25); right@color2 (§6.2.2.25); shapedefaults@fillcolor (§6.2.2.27); shapedefaults@strokecolor (§6.2.2.27); top@color (§6.2.2.31); top@color2 (§6.2.2.31)

The following XML Schema fragment defines the contents of this simple type:

</simpleType>