The ImageColor module supports the following string formats:
Hexadecimal color specifiers, given as
bis blue and
ais alpha (also called ‘opacity’). For example,
#ff0000specifies pure red, and
#ff0000ccspecifies red with 80% opacity (
ccis 204 in decimal form, and 204 / 255 = 0.8).
RGB functions, given as
rgb(red, green, blue)where the color values are integers in the range 0 to 255. Alternatively, the color values can be given as three percentages (0% to 100%). For example,
rgb(100%,0%,0%)both specify pure red.
Hue-Saturation-Lightness (HSL) functions, given as
hsl(hue, saturation%, lightness%)where hue is the color given as an angle between 0 and 360 (red=0, green=120, blue=240), saturation is a value between 0% and 100% (gray=0%, full color=100%), and lightness is a value between 0% and 100% (black=0%, normal=50%, white=100%). For example,
hsl(0,100%,50%)is pure red.
Hue-Saturation-Value (HSV) functions, given as
hsv(hue, saturation%, value%)where hue and saturation are the same as HSL, and value is between 0% and 100% (black=0%, normal=100%). For example,
hsv(0,100%,100%)is pure red. This format is also known as Hue-Saturation-Brightness (HSB), and can be given as
hsb(hue, saturation%, brightness%), where each of the values are used as they are in HSV.
Common HTML color names. The
ImageColormodule provides some 140 standard color names, based on the colors supported by the X Window system and most web browsers. color names are case insensitive. For example,
Redboth specify pure red.
Convert a color string to an RGB tuple. If the string cannot be parsed, this function raises a
New in version 1.1.4.