Metadata-Version: 1.1
Name: colorzero
Version: 1.1
Summary: Yet another Python color library.
Home-page: http://colorzero.readthedocs.io/
Author: Dave Jones
Author-email: dave@waveform.org.uk
License: BSD License
Description: .. -*- rst -*-
        
        =========
        colorzero
        =========
        
        colorzero is a color manipulation library for Python (yes, *another* one) which
        aims to be reasonably simple to use and "pythonic" in nature.
        
        It does *not* aim to be as comprehensive, powerful, or that matter as *correct*
        as, say, `colormath`_.  colorzero originally grew out of work on my `picamera`_
        project, hence it's intended to be sufficiently simple that school children can
        use it without having to explain color spaces and illuminants. However, it does
        aim to be useful to a wide range of skills, hence it does include basic
        facilities for `CIE Lab`_ representations, and `Delta-E`_ calculations should
        you need them.
        
        The major difference between colorzero and other libraries (`grapefruit`_,
        `colormath`_, etc.) is that its ``Color`` class is a ``namedtuple`` descendent.
        This means it is immutable; you cannot *directly* change the attributes of a
        ``Color`` instance. The major advantage of this is that instances can be used
        as keys in dictionaries (for simple `LUTs`_), or placed in sets.
        
        Manipulation of ``Color`` instances is done by typical operations with other
        classes the result of which is a new ``Color`` instance. For example::
        
            >>> Color('red') + Color('blue')
            <Color html='#ff00ff' rgb=(1, 0, 1)>
            >>> Color('magenta') - Color('red')
            <Color html='#0000ff' rgb=(0, 0, 1)>
            >>> Color('red') - Red(0.5)
            <Color html='#800000' rgb=(0.5, 0, 0)>
            >>> Color('green') + Color('grey').red
            <Color html='#808000' rgb=(0.501961, 0.501961, 0)>
            >>> Color.from_hls(0.5, 0.5, 1.0)
            <Color html='#00ffff' rgb=(0, 1, 1)>
            >>> Color.from_hls(0.5, 0.5, 1.0) * Lightness(0.8)
            <Color html='#00cccc' rgb=(0, 0.8, 0.8)>
            >>> (Color.from_hls(0.5, 0.5, 1.0) * Lightness(0.8)).hls
            HLS(h=0.5, l=0.4, s=1.0)
        
        Links
        =====
        
        * The code is licensed under the `BSD license`_
        * The `source code`_ can be obtained from GitHub, which also hosts the `bug
          tracker`_
        * The `documentation`_ (which includes installation, quick-start examples, and
          lots of code recipes) can be read on ReadTheDocs
        * Packages can be downloaded from `PyPI`_, but reading the installation
          instructions is more likely to be useful
        
        
        .. _picamera: https://picamera.readthedocs.io/
        .. _colormath: https://python-colormath.readthedocs.io/
        .. _grapefruit: https://grapefruit.readthedocs.io/
        .. _CIE Lab: https://en.wikipedia.org/wiki/Lab_color_space
        .. _Delta-E: https://en.wikipedia.org/wiki/Color_difference
        .. _PyPI: http://pypi.python.org/pypi/colorzero/
        .. _documentation: http://colorzero.readthedocs.io/
        .. _source code: https://github.com/waveform80/colorzero
        .. _bug tracker: https://github.com/waveform80/colorzero/issues
        .. _BSD license: http://opensource.org/licenses/BSD-3-Clause
        .. _LUTs: https://en.wikipedia.org/wiki/Lookup_table#Lookup_tables_in_image_processing
        
Keywords: color
Platform: ALL
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: Topic :: Education
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: PyPy
