Yet another Python color library
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file colorzero-2.0.tar.gz
.
File metadata
- Download URL: colorzero-2.0.tar.gz
- Upload date:
- Size: 25.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.4.2 requests/2.23.0 setuptools/49.3.1 requests-toolbelt/0.8.0 tqdm/4.48.2 CPython/3.8.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7d5a5c26cd0dc37b164ebefc609f388de24f8593b659191e12d85f8f9d5eb58 |
|
MD5 | e7f71e181b94754bcc5ca7c92c52c0d7 |
|
BLAKE2b-256 | b3ca688824a06e8c4d04c7d2fd2af2d8da27bed51af20ee5f094154e1d680334 |
Provenance
File details
Details for the file colorzero-2.0-py2.py3-none-any.whl
.
File metadata
- Download URL: colorzero-2.0-py2.py3-none-any.whl
- Upload date:
- Size: 26.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.4.2 requests/2.23.0 setuptools/49.3.1 requests-toolbelt/0.8.0 tqdm/4.48.2 CPython/3.8.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e60d743a6b8071498a56465f7719c96a5e92928f858bab1be2a0d606c9aa0f8 |
|
MD5 | 4968a244470e83be63d5034ec0dee797 |
|
BLAKE2b-256 | 7ea6ddd0f130e44a7593ac6c55aa93f6e256d2270fd88e9d1b64ab7f22ab8fde |