Color

Color spaces and conversions between them

Version on this page:	0.3.3
LTS Haskell 24.24:	0.4.1
Stackage Nightly 2025-12-16:	0.4.1
Latest on Hackage:	0.4.1

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

Graphics
- Graphics.Color
  - Graphics.Color.Adaptation
    - Graphics.Color.Adaptation.VonKries
  - Graphics.Color.Algebra
    - Graphics.Color.Algebra.Binary
  - Graphics.Color.Illuminant
    - Graphics.Color.Illuminant.CIE1931
    - Graphics.Color.Illuminant.CIE1964
    - Graphics.Color.Illuminant.ICC
      - Graphics.Color.Illuminant.ICC.PCS
    - Graphics.Color.Illuminant.ITU
      - Graphics.Color.Illuminant.ITU.Rec470
      - Graphics.Color.Illuminant.ITU.Rec601
    - Graphics.Color.Illuminant.Wikipedia
  - Graphics.Color.Model
  - Graphics.Color.Space
    - Graphics.Color.Space.CIE1931
      - Graphics.Color.Space.CIE1931.RGB
      - Graphics.Color.Space.CIE1931.XYZ
    - Graphics.Color.Space.CIE1976
      - Graphics.Color.Space.CIE1976.LAB
        Graphics.Color.Space.CIE1976.LAB.LCH
      - Graphics.Color.Space.CIE1976.LUV
        Graphics.Color.Space.CIE1976.LUV.LCH
    - Graphics.Color.Space.RGB
      - Graphics.Color.Space.RGB.AdobeRGB
      - Graphics.Color.Space.RGB.Alternative
        Graphics.Color.Space.RGB.Alternative.CMYK
        
        Graphics.Color.Space.RGB.Alternative.HSI
        
        Graphics.Color.Space.RGB.Alternative.HSL
        
        Graphics.Color.Space.RGB.Alternative.HSV
        
        Graphics.Color.Space.RGB.Alternative.YCbCr
      - Graphics.Color.Space.RGB.CIERGB
      - Graphics.Color.Space.RGB.Derived
        Graphics.Color.Space.RGB.Derived.AdobeRGB
        
        Graphics.Color.Space.RGB.Derived.CIERGB
        
        Graphics.Color.Space.RGB.Derived.SRGB
      - Graphics.Color.Space.RGB.ITU
        Graphics.Color.Space.RGB.ITU.Rec470
        
        Graphics.Color.Space.RGB.ITU.Rec601
        
        Graphics.Color.Space.RGB.ITU.Rec709
      - Graphics.Color.Space.RGB.Luma
      - Graphics.Color.Space.RGB.SRGB
  - Graphics.Color.Standard
    - Graphics.Color.Standard.RAL
    - Graphics.Color.Standard.SVG
- Graphics.Pixel
  - Graphics.Pixel.ColorSpace
  - Graphics.Pixel.Internal

Depends on 4 packages(full list with versions):

base, data-default-class, deepseq, vector

Used by 1 package in nightly-2024-01-16(full list with versions):

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

Package	Hackage	Nightly	LTS
`Color`

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

Color is on a list of curated Awesome Colour resources.
While working on this library the colour-science.org and their Python implementation of colour was used extensively as a reference.

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