mirror of https://github.com/python/cpython
66 lines
1.8 KiB
ReStructuredText
66 lines
1.8 KiB
ReStructuredText
: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
|
|
https://poynton.ca/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)
|