Coloraide

Latest version: v4.2.1

Safety actively analyzes 707009 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 9 of 19

1.4

- **NEW**: A color space can now declare its dynamic range. By default, spaces are assumed to be SDR, but can declare
themselves as HDR, or something else. This allows ColorAide to make decisions based on a color's dynamic range.
- **NEW**: Add channel aliases for IPT and IPT-like color spaces (IgPgTg and ICtCp): `intensity`, `protan`, and
`tritan`.
- **FIX**: The ICtCp and oRGB space would return the Lab-ish equivalents for `a` and `b` in reverse order if calling
`Labish.labish_names`. This was not actually called anywhere in the code, but is now fixed for any future cases that
may require calling it.
- **FIX**: Undefined channels should be ignored when clipping a color.
- **FIX**: Do not apply SDR shortcuts in gamut mapping when fitting in a non-SDR color gamut, such as HDR.

1.3

- **ENHANCE**: Color vision deficiency filters can now be instantiated with different default methods for severe and
anomalous cases.
- **FIX**: Fix premultiplication handling when using `compose`.

1.2

- **NEW**: Add new monotone interpolation method.
- **ENHANCE**: Better extrapolation past end of spline.
- **FIX**: Small speed up in natural spline calculation.
- **FIX**: Fix import that should have been relative, not absolute.

1.1

- **NEW**: Slight refactor of interpolation plugin so that common code does not need to be duplicated, and the
`interpolate` method no longer needs to accept an `easing` parameter as the plugin class exposes a new `ease` method
to automatically acquire the proper, specified easing function and apply it.
- **NEW**: Functions built upon interpolation can now use a new `extrapolate` parameter to enable extrapolation if
interpolation inputs exceed 0 - 1. `point` will be passed to `Interpolator.interpolate` un-clamped if `extrapolate` is
enabled. If a particular interpolation plugin needs to do additional work to handle extrapolation, they can check
`self.extrapolate` to know whether extrapolation is enabled.
- **NEW**: Implement and provide the following easing functions as described in the CSS Easing Level 1 spec:
`cubic_bezier`, `ease`, `ease_in`, `ease_out`, and `ease_in_out`. Also provide a simple `linear` easing function.
- **New**: Add `natural` and `catrom` cubic spline options for interpolation. The `catrom` (Catmull-Rom) spline requires
the plugin to be registered in order to use it.
- **FIX**: Due to floating point math, B-spline could sometimes return an interpolation of fully opaque colors with an
imperceptible amount of transparency. If alpha is very close (`!py3 1e-6`) to being opaque, just round it to opaque.
- **FIX**: An easing function's output should not be clamped, only the input, and that only **needs** to occur on the
the outer range of an entire interpolation.

1.0

> **Note** Stable Release!
> Checkout [migration guide](https://facelessuser.github.io/coloraide/about/releases/1.0/) if you were an early adopter.

- **NEW**: Bezier interpolation dropped for B-spline which provides much better interpolation.
- **NEW**: All new interpolation methods now support hue fix-ups: `shorter`, `longer`, `increasing`, `decreasing`,
and `specified`.
- **NEW**: Interpolation is now exposed as a plugin to allow for expansion.
- **FIX**: Fixed an issue related to premultiplication and undefined alpha channels.

1.0rc1

> **Warning** _Plugin Refactor_
> For more flexibility there was one final rework of plugins. Registering requires all plugins to be instantiated
> before being passed into `Color.register`, but this allows a user redefine some defaults of certain plugins.
>
> `coloraide.ColorAll` was moved to `coloraide.everythng.ColorAll` to avoid allocating plugins when they are not
> desired.
>
> In the process, we also renamed a number of plugin classes for consistency and predictability, details found below.

- **NEW**: Updated some class names for consistency and predictability. `XyY` --> `xyY`, `Din99o` --> `DIN99o`, `SRGB`
--> `sRGB`, and `ORGB` --> `oRGB`.

Lastly, `LCh` should be the default casing convention. This convention will be followed unless a spec mentions
otherwise. Changes: `Lch` --> `LCh`, `LchD65` --> `LChD65`, `Oklch` --> `OkLCh`, `Lchuv` --> `LChuv`, `Lch99o` -->
`LCh99o`, `LchChroma` --> `LChChroma`, `OklchChroma` --> `OkLChChroma`, and `Lchish` --> `LChish`.

- **NEW**: Updated migration guide with recent plugin changes.
- **NEW**: `coloraide.ColorAll` renamed and moved to `coloraide.everything.ColorAll`. This prevents unnecessary
inclusion and allocation of objects that are not desired.
- **NEW**: Default `Color` object now only registers `bradford` CAT by default, all others must be registered
separately, or `coloraide.everything.Color` could be used.
- **NEW**: All plugin classes must be instantiated when being registered. This allows some plugins to be instantiated
with different defaults. This allows some plugins to be configured with different defaults.

py
Before change:
Color.register([Plugin1, Plugin2])

After change:
Color.register([Plugin1(), Plugin2(optional_parm=True)])

Page 9 of 19

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.