1 :mod:`colorsys` --- Conversions between color systems
2 =====================================================
5 :synopsis: Conversion functions between RGB and other color systems.
6 .. sectionauthor:: David Ascher <da@python.net>
9 The :mod:`colorsys` module defines bidirectional conversions of color values
10 between colors expressed in the RGB (Red Green Blue) color space used in
11 computer monitors and three other coordinate systems: YIQ, HLS (Hue Lightness
12 Saturation) and HSV (Hue Saturation Value). Coordinates in all of these color
13 spaces are floating point values. In the YIQ space, the Y coordinate is between
14 0 and 1, but the I and Q coordinates can be positive or negative. In all other
15 spaces, the coordinates are all between 0 and 1.
19 More information about color spaces can be found at
20 http://www.poynton.com/ColorFAQ.html and
21 http://www.cambridgeincolour.com/tutorials/color-spaces.htm.
23 The :mod:`colorsys` module defines the following functions:
26 .. function:: rgb_to_yiq(r, g, b)
28 Convert the color from RGB coordinates to YIQ coordinates.
31 .. function:: yiq_to_rgb(y, i, q)
33 Convert the color from YIQ coordinates to RGB coordinates.
36 .. function:: rgb_to_hls(r, g, b)
38 Convert the color from RGB coordinates to HLS coordinates.
41 .. function:: hls_to_rgb(h, l, s)
43 Convert the color from HLS coordinates to RGB coordinates.
46 .. function:: rgb_to_hsv(r, g, b)
48 Convert the color from RGB coordinates to HSV coordinates.
51 .. function:: hsv_to_rgb(h, s, v)
53 Convert the color from HSV coordinates to RGB coordinates.
58 >>> colorsys.rgb_to_hsv(.3, .4, .2)
60 >>> colorsys.hsv_to_rgb(0.25, 0.5, 0.4)