~dkuhlman/python-training-materials/Materials

:mod:`colorsys` --- Conversions between color systems

=====================================================

.. module:: colorsys

   :synopsis: Conversion functions between RGB and other color systems.

.. sectionauthor:: David Ascher <da@python.net>

**Source code:** :source:`Lib/colorsys.py`

--------------

The :mod:`colorsys` module defines bidirectional conversions of color values

between colors expressed in the RGB (Red Green Blue) color space used in

computer monitors and three other coordinate systems: YIQ, HLS (Hue Lightness

Saturation) and HSV (Hue Saturation Value).  Coordinates in all of these color

spaces are floating point values.  In the YIQ space, the Y coordinate is between

0 and 1, but the I and Q coordinates can be positive or negative.  In all other

spaces, the coordinates are all between 0 and 1.

.. seealso::

   More information about color spaces can be found at

   http://www.poynton.com/ColorFAQ.html and

   https://www.cambridgeincolour.com/tutorials/color-spaces.htm.

The :mod:`colorsys` module defines the following functions:

.. function:: rgb_to_yiq(r, g, b)

   Convert the color from RGB coordinates to YIQ coordinates.

.. function:: yiq_to_rgb(y, i, q)

   Convert the color from YIQ coordinates to RGB coordinates.

.. function:: rgb_to_hls(r, g, b)

   Convert the color from RGB coordinates to HLS coordinates.

.. function:: hls_to_rgb(h, l, s)

   Convert the color from HLS coordinates to RGB coordinates.

.. function:: rgb_to_hsv(r, g, b)

   Convert the color from RGB coordinates to HSV coordinates.

.. function:: hsv_to_rgb(h, s, v)

   Convert the color from HSV coordinates to RGB coordinates.

Example::

   >>> import colorsys

   >>> colorsys.rgb_to_hsv(0.2, 0.4, 0.4)

   (0.5, 0.5, 0.4)

   >>> colorsys.hsv_to_rgb(0.5, 0.5, 0.4)

   (0.2, 0.4, 0.4)