Color

Color spaces and conversions between them

https://github.com/lehins/Color

LTS Haskell 23.1:0.3.3
Stackage Nightly 2024-12-26:0.3.3
Latest on Hackage:0.3.3

See all snapshots Color appears in

BSD-3-Clause licensed by Alexey Kuleshevich
Maintained by [email protected]
This version can be pinned in stack with:Color-0.3.3@sha256:857fd235bdc50411586d035f59829c7c7b9326f61d19847f1bc76c36714e701a,8737

Module documentation for 0.3.3

Used by 2 packages in nightly-2024-12-15(full list with versions):
chart-svg, massiv-io

Color

A library for dealing with Colors and pixels. It implements arbitrary color space conversion, chromatic adaptation and other color manipulations.

Status

Language Github Actions Coveralls Gitter.im
GitHub top language Build Status Coverage Status Join the chat at https://gitter.im/haskell-massiv/Lobby
Package Hackage Nightly LTS
Color Hackage Nightly Nightly

Description

There is a clear separation between color models, color spaces and alternative representations of color spaces. All are distinct at the type level. The goal is to prevent mixups of incompatible color types as well as utilize type information for conversion between them.

Currently supported:

  • Color models:

    • Y
    • RGB
    • HSI
    • HSL
    • HSV
    • YCbCr
    • CMYK

  • Color spaces and arbitrary conversions between them:

    • Y - luminance

    • Y' - luma

    • CIE XYZ

    • CIE L*a*b*

    • RGB:

      • sRGB - both standardized and derived

      • AdobeRGB - both standardized and derived

      • ITU: Rec470, Rec601 and Rec709

      • Alternative representations:

        • HSI
        • HSL
        • HSV
        • YCbCr
        • CMYK

  • Illuminants:

    • CIE1931 - 2 degree observer
    • CIE1964 - 10 degree observer
    • Some common alternatives

  • Chromatic adaptation:

    • VonKries adaptation with transformations:

      • VonKries
      • Bradford (default)
      • Fairchild
      • CIECAM02
      • CMCCAT2000

  • Color Standards:

    • RAL
    • SVG

External resources

Changes

Changelog for Color

0.3.3

Addition of SVG colors

0.3.2

  • Addition of CIEL*u*v* colorspace and LCh views of both CIEL*a*b* and L*u*v*.

0.3.1

  • Remove RealFloat constraint from ColorSpace for Y'

0.3.0

  • Rename Y color model into X to avoid the annoying name conflict.

  • Add ColorSpace instance for Y' and enrich it with base space info

  • Rename YCbCr -> Y'CbCr and remove explicit linearity from its base space

  • Fix BT470 transfer function. ecctf and dcctf were mixed up.

  • Move transfer and itransfer functions into the RedGreenBlue class

  • Move out ecctf and dcctf functions outside of RedGreenBlue class

  • Remove all customized functions from RGB modules in favor of their respective class implementations:

    • primaries (standalone) -> gamut (in class)
    • transfer (standalone) -> transfer (in class)
    • itransfer (standalone) -> itransfer (in class)
    • npmStandard (standalone) -> npm (in class)
    • inpmStandard (standalone) -> inpm (in class)

  • Addition of coerceGamut

  • Fix re-export of vector’s MVector, Vector type families.

  • Re-arrange how modules are exported a little bit.

0.2.0

  • Addition of CIE1931 RGB color space
  • Add Linearity kind to RedGreenBlue color spaces.
  • Add Default instance for Pixel
  • Addition of universal division (//) to Elevator
  • Addition of CIE1931 RGB color space.
  • Fix show instance for floating point colors: adjust formatting in Elevator for Float and Double
  • Add record accessor functions: chromaticityCIExyY, whitePointChromaticity
  • Fix show instance for Gamut
  • Remove deprecated: CIECAM02 and ciecam02Adaptation

0.1.4

  • Export pixelColor
  • Add luma related patterns: PixelY', PixelY'A, Y' and Y'A. Also rgbPixelLuma

0.1.3.1

  • Fix introduced in 0.1.2 for Alpha cs was incomplete and is fixed in this version without breakage.

0.1.3 (deprecated)

  • Addition of CMCCAT2000.
  • Rename CIECAM02 to CIECAT02 with a fallback synonym for backwards compatibility
  • Fix ColorSpace instance for Alpha cs
  • Add ColorSpace instances for YCbCr cs color spaces that have Luma instance: BT709, BT601_525 and BT601_625

0.1.2

  • Fix YCbCr conversion to derived RGB color spaces
  • Fix conversion of toWord64 (1 :: Double) and toWord632 (1 :: Float).
  • Addition of xyzColorMatchingFunctions and spectralPowerDistributions

0.1.1

  • Addition of Graphics.Color.Illuminant.Wikipedia module
  • Addition of convertColor and convertColorFloat functions

0.1.0

Initial alpha release