Skip to content

Releases

3.6.0

Added

  • Publish artifacts for the watchosArm32 target (thanks @ReneeVandervelde)

Changed

  • Update Kotlin to 2.0.0

3.5.0

Added

  • Publish artifacts for the JS and wasmJs targets for the jetpack-compose extensions.
  • Added support to formatCssString and Color.parse for color spaces added in recent updates to the CSS color spec: oklab, oklch, srgb-linear, xyz-d50 and xyz-d65.
  • Added customColorSpaces for Color.parse and Color.formatCssString to allow non-standard color spaces to be used in color strings.
  • Added min and max properties to ColorComponentInfo to get the reference range for the component.
  • Support percentage format for all values in Color.parse with reference range scaling from the new drafts of CSS Color Module 4.
  • Added clamp() function to all color models to clamp the color components to their valid range.

Changed

  • Color.parse now parses lch() and lab() functions with the with D50 white points instead of D65 in order to comply with the latest draft of CSS Color Module 4.
  • Color.parse no longer clamps out-of-gamut values by default. Use the new clamp method on the returned color if desired.

Fixed

  • ColorSpace.equals will now properly return true when comparing color companions with the space they represent e.g. XYZ == XYZ65
  • Support the CSS “none” keyword for NaN values in Color.parse and Color.formatCssString

3.4.0

Added

  • Publish artifacts for the wasmJs target. This target is experimental.

3.3.3

Changed

  • Use unique namespace for all android extensions and disable BuildConfig generation. Thanks to @frett for the contribution (#45)

3.3.2

Added

  • Publish linuxArm64 target. This target is not tested on CI.

Changed

  • Updated Kotlin to 1.9.0

3.3.1

Changed

  • Publish JVM artifacts with Java 8 bytecode

3.3.0

Added

  • The core module now publishes multiplatform targets for iosSimulatorArm64, tvosSimulatorArm64, and watchosSimulatorArm64.
  • The Jetpack Compose extensions module colormath-ext-jetpack-compose now publishes multiplatform targets for JVM and iOS in addition to the existing android target.

Changed

  • Updated Kotlin to 1.8

3.2.1

Changed

  • Updated Kotlin to 1.7.10

3.2.0

Added

  • hueOr extension to colors like HSV that returns the color’s hue or a fallback value if the hue is undefined.

Changed

  • Updated Kotlin to 1.6.0

3.1.1

Fixed

  • Fix shared immutability for background threads on Kotlin Native

3.1.0

Added

  • Optional modules with extensions for converting between Colormath colors and other platform representations.

Changed

  • Unspecified alpha values now default to fully opaque

3.0.0

Added

  • New color models: Oklab, Oklch, HWB, HPLuv, HSLuv, LCHab, LCHuv, JzAzBz, JzCzHz, ICtCp
  • New RGB color spaces: Linear sRGB, ACES, ACEScc, ACEScct, ACEScg, Adobe RGB, BT.2020, BT.709, DCI P3, Display P3, ProPhoto
  • Other color spaces: LABColorSpace, LCHabColorSpace, LCHuvColorSpace, LUVColorSpace, XYZColorSpace
  • WCAG contrast: wcagLuminance, wcagContrastRatio, mostContrasting, firstWithContrast
  • Color difference: euclideanDistance, differenceCIE76, differenceCIE94, differenceCIE2000, differenceCMC, differenceEz
  • Transforms: Color.map, mix, multiplyAlpha, divideAlpha, createChromaticAdapter, RGBColorSpace.converterTo
  • Interpolation: Color.interpolate, ColorSpace.interpolator
  • Color metadata: ColorSpace, Color.space, Color.toArray, ColorSpace.create
  • CSS parsing and rendering now support all CSS color strings
  • RGBInt: an inline class that stores RGB colors packed in a single Int. Create instances directly, or convert to it with RGB.toRGBInt()
  • Publish macosArm64 target.

Changed

  • All Color classes now store their color components as Float
  • RGB, XYZ, HSV,HSL, andHWBnow store their rectangular components normalized to[0, 1]`.
  • Renamed Color.fromCss to Color.parse.
  • All Color constructors now use alpha as name of their final parameter.
  • Replace toCssRgb and toCssHsl with fromatCssString that supports all color models.
  • All color models moved from the package com.github.ajalt.colormath to com.github.ajalt.colormath.model
  • Updated Kotlin to 1.5.30

Removed

  • Removed the previously deprecated ConvertibleColor typealias.
  • Removed the CssColors object. Use Color.fromCss instead.
  • Removed Ansi16 companion object color constants.
  • Removed Color.toHex(). Use RGB.toHex() instead.

2.1.0

Added

  • Added CIE LUV colorspace support
  • Added CIE LCH(uv) colorspace support
  • Added HWB colorspace support
  • Added lab() and hwb() support to Color.fromCss
  • JS target now publishes IR format in addition to legacy jars

Changed

  • Updated Kotlin to 1.5.0
  • Color.fromCss now clamps out-of-range values in accordance with the CSS Color Module Level 4 spec

2.0.0

Added

  • Added multiplatform support.

Changed

  • Moved maven coordinates to com.github.ajalt.colormath:colormath:2.0.0.

Deprecated

  • Renamed ConvertibleColor to Color. The old name is left as a deprecated type alias.

1.4.1

Fixed

  • Fix RGB(255,255, 255).toLAB() throwing an exception due to rounding precision.

1.4.0

Added

  • hueAsRad(), hueAsGrad(), and hueAsTurns() extensions for HSL and HSV classes.
  • toHex() now has a renderAlpha parameter that lets you render the color’s alpha channel in the hex. By default the alpha will be added if it’s < 1.
  • toCssRgb() and toCssHsl() extensions to render colors as CSS color functions
  • RGB.toPackedInt() to convert a color to a single integer.

Changed

  • withNumberSign parameter of toHex now defaults to true
  • ColorMath.parseCssColor() renamed to ConvertableColor.fromCss() and ColorMath.cssKeywordColors to CssColors.colorsByName

1.3.0

Added

  • All colors now have an alpha channel, defaulting to 1 (fully opaque). For colorspaces that support transparency, you can pass an alpha value into their constructors.
  • ColorMath.parseCssColor() can parse all valid HTML/CSS colors, including rgb, hsl, and named colors.
  • ColorMath.cssKeywordColors is a map of HTML/CSS color names to RGB the colors they represent.

Changed

  • Switch rounding methods to use kotlin.math rounding, which can slightly change conversion results in some cases.

1.2.0

Added

  • Add ability to construct RGB instances from packed integers or Bytes