The :pyImageColor
module contains color tables and converters from CSS3-style color specifiers to RGB tuples. This module is used by :pyPIL.Image.Image.new
and the :py~PIL.ImageDraw
module, among others.
The ImageColor module supports the following string formats:
- Hexadecimal color specifiers, given as
#rgb
or#rrggbb
. For example,#ff0000
specifies pure red. - 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(255,0,0)
andrgb(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. - Common HTML color names. The :py
~PIL.ImageColor
module 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,red
andRed
both specify pure red.
getrgb
getcolor