``ll.color`` provides classes and functions for handling RGB colors.


============================
class ``Color``​(``tuple``):
============================

A ``Color`` object represents a color with red, green and blue components.


def ``__new__``​(``cls``, ``r``=``0``, ``g``=``0``, ``b``=``0``, ``a``=``255``):
--------------------------------------------------------------------------------

Create a ``Color`` with the 8 bit red, green, blue and alpha components ``r``, ``g``, ``b`` and ``a``. Values will be clipped to the range [0; 255].


def ``__repr__``​(``self``):
----------------------------


def ``__str__``​(``self``):
---------------------------

``self`` formatted as a CSS color string.


def ``r``​(``self``):
---------------------

The red value as an int between 0 and 255.


def ``g``​(``self``):
---------------------

The green value as an int between 0 and 255.


def ``b``​(``self``):
---------------------

The blue value as an int between 0 and 255.


def ``a``​(``self``):
---------------------

The alpha value as an int between 0 and 255.


def ``rgb``​(``self``):
-----------------------

The red, green and blue value as a float tuple with values between 0.0 and 1.0.


def ``rgba``​(``self``):
------------------------

The red, green, blue and alpha value as a float tuple with values between 0.0 and 1.0.


def ``hsv``​(``self``):
-----------------------

``self`` as a HSV tuple ("hue, saturation, value"). All three values are between 0.0 and 1.0.


def ``hsva``​(``self``):
------------------------

``self`` as a HSV+alpha tuple ("hue, saturation, value, alpha"). All four values are between 0.0 and 1.0.


def ``hls``​(``self``):
-----------------------

``self`` as a HLS tuple ("hue, luminance, saturation"). All three values are between 0.0 and 1.0.


def ``hlsa``​(``self``):
------------------------

``self`` as a HLS+alpha tuple ("hue, luminance, saturation, alpha"). All four values are between 0.0 and 1.0.


def ``lum``​(``self``):
-----------------------

The luminance value from ``hls``.


def ``combine``​(``self``, ``r``=``None``, ``g``=``None``, ``b``=``None``, ``a``=``None``):
-------------------------------------------------------------------------------------------

Return a copy of ``self`` with some of the values replaced by the arguments.


def ``witha``​(``self``, ``a``):
--------------------------------

Return a copy of ``self`` with the alpha value replaced with ``a``.


def ``withlum``​(``self``, ``lum``):
------------------------------------

Return a copy of ``self`` with the luminosity replaced with ``lum``.


def ``abslum``​(``self``, ``f``):
---------------------------------

Return a copy of ``self`` with ``f`` added to the luminocity.


def ``rellum``​(``self``, ``f``):
---------------------------------

Return a copy of ``self`` where the luminocity has been modified: If ``f`` if positive the luminocity will be increased, with ``f==1`` giving a luminocity of 1. If ``f`` is negative, the luminocity will be decreased with ``f==-1`` giving a luminocity of 0. ``f==0`` will leave the luminocity unchanged.


def ``__add__``​(``self``, ``other``):
--------------------------------------


def ``__mul__``​(``self``, ``factor``):
---------------------------------------


def ``__rmul__``​(``self``, ``factor``):
----------------------------------------


def ``__truediv__``​(``self``, ``factor``):
-------------------------------------------


def ``__floordiv__``​(``self``, ``factor``):
--------------------------------------------


def ``__mod__``​(``self``, ``other``):
--------------------------------------

Blends ``self`` with the background color ``other`` according to the CSS specification


========================
def ``css``​(``value``):
========================


==============================
def ``dist``​(``c1``, ``c2``):
==============================

Return the distance between two colors.


==================================
def ``multiply``​(``c1``, ``c2``):
==================================

Multiplies the colors ``c1`` and ``c2``.


================================
def ``screen``​(``c1``, ``c2``):
================================

Does a negative multiplication of the colors ``c1`` and ``c2``.


========================
def ``mix``​(*``args``):
========================

Calculates a weighted mix of the colors from ``args``. Items in ``args`` are either colors or weights. The following example mixes two parts black with one part white:

   >>> from ll import color
   >>> color.mix(2, color.black, 1, color.white)
   Color(0x55, 0x55, 0x55)