Metadata-Version: 2.4
Name: grapefruit
Version: 0.1a4
Summary: A module to manipulate color information easily.
Home-page: http://code.google.com/p/grapefruit/
Download-URL: http://grapefruit.googlecode.com/files/grapefruit-0.1a4.tar.gz
Author: Xavier Basty
Author-email: xbasty@gmail.com
License: Apache License 2.0
Keywords: color conversion
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Graphics
License-File: LICENSE
License-File: COPYING
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: summary

=====================
README for GrapeFruit
=====================

GrapeFruit is a pure Python module that let you easily manipulate and convert color information.
Its Primary goal is to be *natural* and *flexible*.

The following color systems are supported by GrapeFruit:
  * RGB (sRGB)
  * HSL 
  * HSV
  * YIQ
  * YUV
  * CIE-XYZ
  * CIE-LAB (with the illuminant you want)
  * CMY
  * CMYK
  * HTML/CSS color definition (#RRGGBB, #RGB or the X11 color name)
  * RYB (artistic color wheel
Installing
============

**From the sources:**

Download the latest grapefruit library from:

  https://github.com/xav/Grapefruit


Untar the source distribution and run::

  $ python setup.py build
  $ python setup.py install


Testing
=========

With setuptools installed::

  $ python setup.py test

Without setuptools installed::

  $ python grapefruit_test.py


Documentation
===============

You can download a compiled version of the documentation at:

  https://github.com/xav/Grapefruit/downloads

The documentation is generated from reStructuredText sources by Sphinx.
If you need to build it, go into the doc folder and run::

  make <builder>

Or, if you're running windows::

  makedoc.cmd


License
=========

::

  Copyright (c) 2008, Xavier Basty
  
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at
  
  http://www.apache.org/licenses/LICENSE-2.0
  
  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.

2016-08-01
  - Realease 0.1a4
  - Fixed missing attribute grapefruit_test.py

2008-06-15
  - Released 0.1a3
  - Added Gradient

2008-06-01
  - Fixed overflow in alpha blending.

2008-05-29
  - Added Saturate/Desaturate.
  - Added MonochromeScheme
  - Added the mode parameter to the generation methods to choose the
    color wheel use for the generation (ryb/rgb).

2008-05-28
  - Added the RGB<->RYB hue conversion.
  - Added an angle parameter to the tetrad scheme to control the shape of
    the rectangle.

2008-05-27
  - Released 0.1a2

2008-05-24

  - Fixed the HSL->RGB conversion
    (the modulo in the hue conversion was 60 instead of 6.0!)
    Updated the unit tests (which were wrong!)

2008-05-24

  Released 0.1a1
  - Convert the documentation to Sphinx
  - Completed the unit tests
  - Fixed some stupid typos

2008-05-22

  - Refactored pretty much everything to more standard "Python coding style".
  - Replaced the global variables by Color properties.
  - Moved the module functions to static methods of Color.
  - Completed the CIE white point dictionary to include all the standard
    illuminants.
  - Added doctest for all the functions.
  - Fixed the conversions factors to get better results (more exact and
    more symmetric).
  - Changed the range of the L component from [0~1] to [0~100] (as it should
    have been).
  - Added packaging data and setup.
  - Changed the structure of the unit tests.

2008-05-08

  Released 0.1a0
  - Initial checkin of grapefruit
