Introduction - ColorAide Documentation (original) (raw)
What is ColorAide?
ColorAide is a pure Python, object oriented approach to colors.
[](#%5F%5Fcodelineno-0-1)>>> from coloraide import Color [](#%5F%5Fcodelineno-0-2)>>> Color.steps( [](#%5F%5Fcodelineno-0-3)... ['oklch(75% 30% 0)', 'oklch(75% 30% 360)'], [](#%5F%5Fcodelineno-0-4)... steps=8, [](#%5F%5Fcodelineno-0-5)... space='oklch', [](#%5F%5Fcodelineno-0-6)... hue='longer' [](#%5F%5Fcodelineno-0-7)... ) [](#%5F%5Fcodelineno-0-8)[color(--oklch 0.75 0.12 0deg / 1), color(--oklch 0.75 0.12 51.429deg / 1), color(--oklch 0.75 0.12 102.86deg / 1), color(--oklch 0.75 0.12 154.29deg / 1), color(--oklch 0.75 0.12 205.71deg / 1), color(--oklch 0.75 0.12 257.14deg / 1), color(--oklch 0.75 0.12 308.57deg / 1), color(--oklch 0.75 0.12 360deg / 1)]
ColorAide particularly has a focus on the following:
- Accurate colors.
- Proper round tripping (where reasonable).
- Be generally easy to pick up for the average user.
- Support modern CSS color spaces and syntax.
- Make accessible many new and old non-CSS color spaces.
- Provide a number of useful utilities such as interpolation, color distancing, blending, gamut mapping, filters, correlated color temperature, color vision deficiency simulation, color harmonies, etc.
- Provide a plugin API to extend supported color spaces and approaches to various utilities.
- Allow users to configure defaults to their liking.
ColorAide is not meant to be the one library to replace all other color libraries. There are many great libraries out there such as: Colour Science, Colorio, Python Color Math, and many others. Some focus on the scientific aspects of colors and provide a wealth of various spaces, illuminants, access to complex color space visualizers, and numerous esoteric tools. Some are highly focused on speed. Some are powerful, but can be more complex to pick up by the average user.
At its heart, ColorAide was designed for convenience, flexibility, and to be very easy to pick up and work with. There are, of course, some trade offs with speed when using a pure Python, object oriented approach, but there are also many advantages as well. ColorAide might not always be the tool for every job, but hopefully it is a great tool all the same.
Installation
ColorAide can be installed via Python's pip: