Coloraide

Latest version: v4.0

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

Scan your dependencies

Page 1 of 18

4.0

- **NEW**: Officially support Python 3.13.
- **NEW**: Define HTML output representation for Jupyter via `_repr_html_`.
- **NEW**: `get()`, `coords()`, `alpha()`, `to_dict()` can now return channel values with a specified precision via
the new `precision` parameter. Per channel precision can be controlled if a list of precision is given.
- **NEW**: `to_string()` support for per channel precision was added and `precision` can now accept a list of
precision.
- **NEW**: Remove deprecated `model` parameter from `cam16` ∆E method. Space should be used instead.
- **NEW**: Remove deprecated `algebra.npow` function. `algebra.spow` should be used instead.
- **NEW**: New generic `minde-chroma` gamut mapping method that allows specifying any Lab-ish or LCh-ish space to
operate in. `oklch-chroma`, `lch-chroma`, and `hct-chroma` are now derived from `minde-chroma` and just default to
using the specified color space to provide backwards compatibility. `minde-chroma` defaults to using OkLCh by
default. `lch-chroma` is still ColorAide's default gamut mapping currently.
- **NEW**: All MINDE chroma reduction methods now skip distance checks if a JND of zero is specified. A JND of zero
essentially disables the MINDE behavior and will reduce chroma as close to the gamut boundary as possible faster
than it would previously.
- **NEW**: MINDE chroma reduction plugins now dynamically figures out lightness range instead of requiring it to be
specified as a class attribute.
- **NEW**: MINDE chroma reduction gamut mapping and ray trace gamut mapping now allow for specifying an `adaptive`
option which will bias the chroma reduction by the specified factor in a hue independent way relative to a midpoint
of L = 50%.
- **NEW**: Remove deprecated `lab` parameter from experimental `raytrace` gamut mapping method. Users should use
`pspace` instead to specify the perceptual space to use.
- **NEW**: Class method `layer()` added to replace `compose()` with a multi-color handling similar to other API
methods such as `interpolate()`, etc.
- **NEW**: `compose()` has been deprecated in favor of the new `layer()` method and will be removed at some future
time but is available to help with transition.
- **NEW**: Improve experimental `raytrace` gamut mapping approach when performed in certain perceptual spaces.
- **NEW**: The experimental `raytrace` gamut mapping method now uses OkLCh by default instead of CIELCh (D65). Results
may vary.
- **BREAK**: Pre-configured `oklch-raytrace` and `lch-raytrace` variants of the experimental `raytrace` gamut mapping
method have been removed to reduce included plugins. OkLCh is the default now and users can still specify CIELCh and
other perceptual spaces if desired via the `pspace` parameter. Additionally, documentation has been added so users
can easily recreate the aforementioned pre-configured methods themselves or their own desired variants.
- **BREAK**: MINDE chroma reductions plugin combines the `DE` and `DE_OPTIONS` class attributes under `DE_OPTIONS`.
Users who have a derived gamut mapping class must combined these two options under `DE_OPTIONS`.
- **BREAK**: MINDE chroma reduction plugin now specifies the perceptual space via the `PSPACE` attribute instead of
`SPACE`. Users who have a derived, personal gamut mapping plugin need to update the name accordingly.
- **BREAK**: MINDE chroma reduction plugins now specify the JND under the `JND` class attribute instead of `LIMIT`.
Users who have a derived, personal gamut mapping plugin need to update the name accordingly.
- **BREAK**: Interpolation plugin renamed the parameter `create` to `color_cls` which is a more descriptive and less
confusing name. If a user interpolation plugin is derived and overrides the `__init__` method, it should update to
use `color_cls` instead of `create`.
- **FIX**: HWB and HSV cannot normalize hue and saturation the same way as HSL when saturation is negative.
- **FIX**: Fix corner case in ZCAM that could throw a domain error.
- **FIX**: `Color.new()` was documented as a class method but was internally still an instance method. Ensure it is a
class method.

3.3.1

- **FIX**: Ray trace gamut mapping algorithm will better handle perceptual spaces like CAM16 and HCT which have
atypical achromatic responses. This prevents unexpected cutoff close to white.
- **FIX**: Fix some documentation examples regarding gamut mapping in HCT.

3.3

- **NEW**: Extend the `Cylindrical` mixin class to expose `radial_name()` and `radial_index()` on the color space to
return the default name or default index of the radial coordinate in polar color spaces. It also exposes
`is_polar()` as a simple check to see if the space uses polar coordinates.
- **NEW**: Euclidean distance algorithm will now handle cylindrical color spaces by converting the polar coordinates
to rectangular coordinates in order to return sensible results.
- **NEW**: Allow specifying number of colors to return for monochromatic harmony. When fewer are specified, allow them
to be spaced further apart for better contrast.
- **FIX**: Handle unexpected undefined values in Euclidean distance.

3.2

- **NEW**: Add `zcam-jmh` color model.
- **NEW**: Previously, color spaces such as `cam16-jmh`, `cam16-ucs`, `jzczhz`, etc. would handle achromatic values
absolutely, based on XYZ with the specified white point which could result in values with non-zero chroma. Now they
will be handled relative to the space, meaning colors will be considered achromatic when they are close to zero
chroma. What is considered achromatic is affected by the adapting luminance and other environmental settings.
This simplifies logic making it faster and also easier for users to subclass with their own environmental settings.
- **NEW**: Normalize how color spaces with special viewing conditions are configured. Document configuring viewing
conditions of color models where applicable.
- **NEW**: Add new `space` parameter in `cam16` ∆E method to replace the now deprecate `model` parameter. `space` is
more flexible as users can now create CAM16 UCS spaces with different lighting environments and specify them
instead.
- **NEW**: Remove previously deprecated CAM16 Jab implementation. Use `cam16-ucs` instead.
- **NEW**: Interpolation will now gracefully handle a list of a single color causing the interpolation to just return
the single color.
- **NEW**: More helpful interpolation errors will raise for an empty list.
- **NEW**: Generic ray trace gamut mapping now has a new `pspace` parameter that can be used to specify a perceptual
space in either LCh-ish or Lab-ish form. `lch` parameter is now deprecated, but currently still present, but
`pspace` will take priority if both are defined.
- **NEW**: Rename `algebra.npow` to `algebra.spow` (signed power). `algebra.npow` is now deprecated and will be
removed at some future time.
- **FIX**: Don't force space to clamp negative XYZ when they are absolutizing them in some spaces.
- **FIX**: Ensure ST2084 EOTF implements the `max` step as specified in the spec.

3.1.2

- **ENHANCE**: Further improvements to both speed and accuracy of ray trace gamut mapping.
- **FIX**: Handle gamut mapping HDR spaces via ray trace more sanely.

3.1.1

- **ENHANCE**: Improved performance of ray tracing gamut mapping algorithm.
- **FIX**: Fix corner cases for detecting ray trace hits on gamut.

Page 1 of 18

© 2024 Safety CLI Cybersecurity Inc. All Rights Reserved.