The rs-colors Reference Manual

3.1.1 rs-colors/rs-colors.asd

Source

rs-colors.asd.

Parent Component

rs-colors (system).

ASDF Systems

rs-colors.

---

3.1.2 rs-colors-internal/rs-colors-internal.asd

Source

rs-colors-internal.asd.

Parent Component

rs-colors-internal (system).

ASDF Systems

rs-colors-internal.

---

3.1.3 rs-colors/rs-colors.lisp

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Packages

rs-colors.

---

3.1.4 rs-colors/types.lisp

Dependency

rs-colors.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• absolute-color (generic function).
• cmy-color-object (class).
• cmyk-color-object (class).
• coerce-color (function).
• color-coordinates (generic function).
• color-object (class).
• colorp (function).
• copy-color (generic function).
• generic-color-object (class).
• hsl-color-object (class).
• hsv-color-object (class).
• initialize-instance (method).
• make-load-form (method).
• normalize-color (generic function).
• print-object (method).
• rgb-color-object (class).
• white-point (generic function).

Internals

absolute-luminance (generic function).

---

3.1.5 rs-colors/generic-rgb.lisp

Dependency

types.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• generic-hsl-color (class).
• generic-hsl-color-coordinates (generic function).
• generic-hsv-color (class).
• generic-hsv-color-coordinates (generic function).
• generic-rgb-color (class).
• generic-rgb-color-coordinates (generic function).
• make-generic-hsl-color (function).
• make-generic-hsv-color (function).
• make-generic-rgb-color (function).
• make-generic-rgb-color-from-number (function).
• update-instance-for-different-class (method).
• update-instance-for-different-class (method).
• update-instance-for-different-class (method).

Internals

• generic-hsi-from-generic-rgb (function).
• generic-hsl-from-generic-rgb (function).
• generic-hsv-from-generic-rgb (function).
• generic-rgb-from-generic-hsl (function).
• generic-rgb-from-generic-hsv (function).

---

3.1.6 rs-colors/generic-cmy.lisp

Dependency

generic-rgb.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• generic-cmy-color (class).
• generic-cmy-color-coordinates (generic function).
• generic-rgb-color-coordinates (method).
• make-generic-cmy-color (function).
• make-generic-cmy-color-from-number (function).
• update-instance-for-different-class (method).

Internals

• generic-cmy-from-generic-rgb (function).
• generic-rgb-from-generic-cmy (function).

---

3.1.7 rs-colors/generic-cmyk.lisp

Dependency

generic-cmy.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• generic-cmy-color-coordinates (method).
• generic-cmyk-color (class).
• generic-cmyk-color-coordinates (generic function).
• make-generic-cmyk-color (function).
• make-generic-cmyk-color-from-number (function).
• update-instance-for-different-class (method).

Internals

• generic-cmy-from-generic-cmyk (function).
• generic-cmyk-from-generic-cmy (function).

---

3.1.8 rs-colors/ciexyz.lisp

Dependency

generic-cmyk.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• absolute-color (method).
• ciexyz-color (class).
• ciexyz-color-coordinates (generic function).
• color-coordinates (method).
• make-ciexyz-color (function).
• normalize-color (method).
• update-instance-for-different-class (method).

Internals

absolute-luminance (method).

---

3.1.9 rs-colors/ciexyy.lisp

Dependency

ciexyz.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• absolute-color (method).
• ciexyy-color (class).
• ciexyy-color-coordinates (generic function).
• ciexyz-color-coordinates (method).
• color-coordinates (method).
• make-ciexyy-color (function).
• normalize-color (method).
• update-instance-for-different-class (method).

Internals

• absolute-luminance (method).
• ciexyy-from-ciexyz (function).
• ciexyz-from-ciexyy (function).

---

3.1.10 rs-colors/cie-white-points.lisp

Dependency

ciexyy.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• cie-1931-white-point-a (constant).
• cie-1931-white-point-b (constant).
• cie-1931-white-point-c (constant).
• cie-1931-white-point-d50 (constant).
• cie-1931-white-point-d55 (constant).
• cie-1931-white-point-d65 (constant).
• cie-1931-white-point-d75 (constant).
• cie-1931-white-point-e (constant).
• cie-1931-white-point-f1 (constant).
• cie-1931-white-point-f10 (constant).
• cie-1931-white-point-f11 (constant).
• cie-1931-white-point-f12 (constant).
• cie-1931-white-point-f2 (constant).
• cie-1931-white-point-f3 (constant).
• cie-1931-white-point-f4 (constant).
• cie-1931-white-point-f5 (constant).
• cie-1931-white-point-f6 (constant).
• cie-1931-white-point-f7 (constant).
• cie-1931-white-point-f8 (constant).
• cie-1931-white-point-f9 (constant).
• cie-1964-white-point-a (constant).
• cie-1964-white-point-b (constant).
• cie-1964-white-point-c (constant).
• cie-1964-white-point-d50 (constant).
• cie-1964-white-point-d55 (constant).
• cie-1964-white-point-d65 (constant).
• cie-1964-white-point-d75 (constant).
• cie-1964-white-point-e (constant).
• cie-1964-white-point-f1 (constant).
• cie-1964-white-point-f10 (constant).
• cie-1964-white-point-f11 (constant).
• cie-1964-white-point-f12 (constant).
• cie-1964-white-point-f2 (constant).
• cie-1964-white-point-f3 (constant).
• cie-1964-white-point-f4 (constant).
• cie-1964-white-point-f5 (constant).
• cie-1964-white-point-f6 (constant).
• cie-1964-white-point-f7 (constant).
• cie-1964-white-point-f8 (constant).
• cie-1964-white-point-f9 (constant).

---

3.1.11 rs-colors/cieluv.lisp

Dependency

cie-white-points.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• *cieluv-default-white-point* (special variable).
• cieluv-color (class).
• cieluv-color-coordinates (generic function).
• ciexyz-color-coordinates (method).
• color-coordinates (method).
• make-cieluv-color (function).
• update-instance-for-different-class (method).
• white-point (method).

Internals

• cie-uv-from-xy (function).
• cieluv-from-ciexyz (function).
• ciexyz-from-cieluv (function).

---

3.1.12 rs-colors/cielab.lisp

Dependency

cieluv.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• *cielab-default-white-point* (special variable).
• cielab-color (class).
• cielab-color-coordinates (generic function).
• ciexyz-color-coordinates (method).
• color-coordinates (method).
• make-cielab-color (function).
• update-instance-for-different-class (method).
• white-point (method).

Internals

• cielab-from-ciexyz (function).
• ciexyz-from-cielab (function).

---

3.1.13 rs-colors/cielch.lisp

Dependency

cielab.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• *cielch-default-white-point* (special variable).
• cielab-color-coordinates (method).
• cielch-color (class).
• cielch-color-coordinates (generic function).
• ciexyz-color-coordinates (method).
• color-coordinates (method).
• make-cielch-color (function).
• update-instance-for-different-class (method).
• white-point (method).

Internals

• cielab-from-cielch (function).
• cielch-from-cielab (function).

---

3.1.14 rs-colors/ciergb.lisp

Dependency

cielch.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• ciergb-color (class).
• ciergb-color-coordinates (generic function).
• ciexyz-color-coordinates (method).
• generic-rgb-color-coordinates (method).
• make-ciergb-color (function).
• update-instance-for-different-class (method).

Internals

• ciergb-from-ciexyz (function).
• ciergb-from-ciexyz-transformation-matrix (constant).
• ciexyz-from-ciergb (function).
• ciexyz-from-ciergb-transformation-matrix (constant).

---

3.1.15 rs-colors/srgb.lisp

Dependency

ciergb.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• ciexyz-color-coordinates (method).
• generic-rgb-color-coordinates (method).
• make-srgb-color (function).
• make-srgb-color-from-number (function).
• srgb-color (class).
• srgb-color-coordinates (generic function).
• srgb-white-point (constant).
• update-instance-for-different-class (method).
• white-point (method).

Internals

• ciexyz-from-srgb (function).
• ciexyz-from-srgb-transformation-matrix (constant).
• srgb-from-ciexyz (function).
• srgb-from-ciexyz-transformation-matrix (constant).
• srgb-gamma-decoding (function).
• srgb-gamma-encoding (function).

---

3.1.16 rs-colors/adobe-rgb.lisp

Dependency

srgb.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• adobe-rgb-color (class).
• adobe-rgb-color-coordinates (generic function).
• adobe-rgb-white-point (constant).
• ciexyz-color-coordinates (method).
• generic-rgb-color-coordinates (method).
• make-adobe-rgb-color (function).
• make-adobe-rgb-color-from-number (function).
• update-instance-for-different-class (method).
• white-point (method).

Internals

• adobe-rgb-from-ciexyz (function).
• adobe-rgb-from-ciexyz-transformation-matrix (constant).
• adobe-rgb-gamma-decoding (function).
• adobe-rgb-gamma-encoding (function).
• ciexyz-from-adobe-rgb (function).
• ciexyz-from-adobe-rgb-transformation-matrix (constant).

---

3.1.17 rs-colors/wide-gamut-rgb.lisp

Dependency

adobe-rgb.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• ciexyz-color-coordinates (method).
• generic-rgb-color-coordinates (method).
• make-wide-gamut-rgb-color (function).
• make-wide-gamut-rgb-color-from-number (function).
• update-instance-for-different-class (method).
• white-point (method).
• wide-gamut-rgb-color (class).
• wide-gamut-rgb-color-coordinates (generic function).
• wide-gamut-rgb-white-point (constant).

Internals

• ciexyz-from-wide-gamut-rgb (function).
• ciexyz-from-wide-gamut-rgb-transformation-matrix (constant).
• wide-gamut-rgb-from-ciexyz (function).
• wide-gamut-rgb-from-ciexyz-transformation-matrix (constant).

---

3.1.18 rs-colors/io.lisp

Dependency

wide-gamut-rgb.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• color-formatter-css3-hsl (constant).
• color-formatter-css3-rgb (constant).
• color-formatter-html (constant).
• color-formatter-xcms-cielab (constant).
• color-formatter-xcms-cielch (constant).
• color-formatter-xcms-cieluv (constant).
• color-formatter-xcms-ciergb (constant).
• color-formatter-xcms-ciexyy (constant).
• color-formatter-xcms-ciexyz (constant).
• color-formatter-xcms-rgb (constant).
• color-formatter-xcms-rgbi (constant).
• define-color-printer (macro).
• define-color-reader (macro).
• print-color-css3-hsl (function).
• print-color-css3-rgb (function).
• print-color-html (function).
• print-color-xcms-cielab (function).
• print-color-xcms-cielch (function).
• print-color-xcms-cieluv (function).
• print-color-xcms-ciergb (function).
• print-color-xcms-ciexyy (function).
• print-color-xcms-ciexyz (function).
• print-color-xcms-rgb (function).
• print-color-xcms-rgbi (function).
• read-color-css3 (function).
• read-color-css3-hsl (function).
• read-color-css3-rgb (function).
• read-color-html (function).
• read-color-xcms (function).
• read-color-xcms-cielab (function).
• read-color-xcms-cielch (function).
• read-color-xcms-cieluv (function).
• read-color-xcms-ciergb (function).
• read-color-xcms-ciexyy (function).
• read-color-xcms-ciexyz (function).
• read-color-xcms-rgb (function).
• read-color-xcms-rgbi (function).

Internals

%read-xcms (function).

---

3.1.19 rs-colors/black-body.lisp

Dependency

io.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• black-body-spectral-radiance (function).
• black-body-spectral-radiant-exitance (function).
• codata-2018-first-radiation-constant (constant).
• codata-2018-first-radiation-constant-for-spectral-radiance (constant).
• codata-2018-second-radiation-constant (constant).

---

3.1.20 rs-colors/color-matching-functions.lisp

Dependency

black-body.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• *color-matching-functions* (special variable).
• *second-radiation-constant* (special variable).
• cie-1931-second-radiation-constant (constant).
• cie-1931-standard-observer (constant).
• cie-1964-standard-observer (constant).
• cie-xy-chromaticity-of-black-body (function).
• cie-xy-chromaticity-of-light (function).
• color-matching-functions (function).

---

3.1.21 rs-colors/color-difference.lisp

Dependency

color-matching-functions.lisp (file).

Source

rs-colors.asd.

Parent Component

rs-colors (system).

Public Interface

• cie76 (function).
• cie94 (function).

---

3.1.22 rs-colors-internal/rs-colors-internal.lisp

Source

rs-colors-internal.asd.

Parent Component

rs-colors-internal (system).

Packages

rs-colors-internal.

---

3.1.23 rs-colors-internal/utilities.lisp

Dependency

rs-colors-internal.lisp (file).

Source

rs-colors-internal.asd.

Parent Component

rs-colors-internal (system).

Public Interface

• cie-l*-from-y/yn (function).
• cie-y/yn-from-l* (function).
• collapse (function).
• copy-matrix (function).
• copy-vector (function).
• cube (function).
• cube-root (function).
• decode-quadruple (function).
• decode-triple (function).
• defconst (macro).
• define-color-name (macro).
• define-color-names (macro).
• defsubst (macro).
• degree-from-radian (function).
• encode-quadruple (function).
• encode-triple (function).
• ensure-type (function).
• float-array (function).
• gemm (function).
• gemv (function).
• hypot (function).
• hypot3 (function).
• linear-transformation (function).
• make-matrix (function).
• make-rgb-color (function).
• make-rgb-color-from-number (function).
• make-vector (function).
• matrix-inverse (function).
• multiples (function).
• radian-from-degree (function).
• rgb-transformation-matrices (function).

Internals

• det (function).
• matrix-adjugate (function).
• matrix-cofactors (function).
• matrix-transpose (function).

---

5.1.1 Constants

Constant: adobe-rgb-white-point ¶

White point of the Adobe RGB color space.

Package

rs-colors.

Source

adobe-rgb.lisp.

Constant: cie-1931-second-radiation-constant ¶

Second radiation constant.

Value used by the CIE when defining the CIE 1931 color space.

Package

rs-colors.

Source

color-matching-functions.lisp.

Constant: cie-1931-standard-observer ¶

CIE 1931 standard observer.

Value are the color matching functions x(λ), y(λ), and z(λ). The wavelength λ ranges from 380 nm to 780 nm in steps of 5 nm.

See the ‘*color-matching-functions*’ parameter for more details.

Package

rs-colors.

Source

color-matching-functions.lisp.

Constant: cie-1931-white-point-a ¶

White point of CIE standard illuminant A given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-b ¶

White point of CIE standard illuminant B given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-c ¶

White point of CIE standard illuminant C given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-d50 ¶

White point of CIE standard illuminant D50 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-d55 ¶

White point of CIE standard illuminant D55 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-d65 ¶

White point of CIE standard illuminant D65 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-d75 ¶

White point of CIE standard illuminant D75 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-e ¶

White point of CIE standard illuminant E given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f1 ¶

White point of CIE standard illuminant F1 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f10 ¶

White point of CIE standard illuminant F10 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f11 ¶

White point of CIE standard illuminant F11 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f12 ¶

White point of CIE standard illuminant F12 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f2 ¶

White point of CIE standard illuminant F2 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f3 ¶

White point of CIE standard illuminant F3 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f4 ¶

White point of CIE standard illuminant F4 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f5 ¶

White point of CIE standard illuminant F5 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f6 ¶

White point of CIE standard illuminant F6 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f7 ¶

White point of CIE standard illuminant F7 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f8 ¶

White point of CIE standard illuminant F8 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1931-white-point-f9 ¶

White point of CIE standard illuminant F9 given for the CIE 1931 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-standard-observer ¶

CIE 1964 standard observer.

Value are the color matching functions x(λ), y(λ), and z(λ). The wavelength λ ranges from 380 nm to 780 nm in steps of 5 nm.

See the ‘*color-matching-functions*’ parameter for more details.

Package

rs-colors.

Source

color-matching-functions.lisp.

Constant: cie-1964-white-point-a ¶

White point of CIE standard illuminant A given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-b ¶

White point of CIE standard illuminant B given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-c ¶

White point of CIE standard illuminant C given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-d50 ¶

White point of CIE standard illuminant D50 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-d55 ¶

White point of CIE standard illuminant D55 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-d65 ¶

White point of CIE standard illuminant D65 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-d75 ¶

White point of CIE standard illuminant D75 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-e ¶

White point of CIE standard illuminant E given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f1 ¶

White point of CIE standard illuminant F1 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f10 ¶

White point of CIE standard illuminant F10 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f11 ¶

White point of CIE standard illuminant F11 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f12 ¶

White point of CIE standard illuminant F12 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f2 ¶

White point of CIE standard illuminant F2 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f3 ¶

White point of CIE standard illuminant F3 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f4 ¶

White point of CIE standard illuminant F4 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f5 ¶

White point of CIE standard illuminant F5 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f6 ¶

White point of CIE standard illuminant F6 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f7 ¶

White point of CIE standard illuminant F7 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f8 ¶

White point of CIE standard illuminant F8 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: cie-1964-white-point-f9 ¶

White point of CIE standard illuminant F9 given for the CIE 1964 standard observer.

Package

rs-colors.

Source

cie-white-points.lisp.

Constant: codata-2018-first-radiation-constant ¶

First radiation constant.

2018 CODATA recommended value.

Package

rs-colors.

Source

black-body.lisp.

Constant: codata-2018-first-radiation-constant-for-spectral-radiance ¶

First radiation constant for spectral radiance.

2018 CODATA recommended value.

Package

rs-colors.

Source

black-body.lisp.

Constant: codata-2018-second-radiation-constant ¶

Second radiation constant.

2018 CODATA recommended value.

Package

rs-colors.

Source

black-body.lisp.

Constant: color-formatter-css3-hsl ¶

A format function for printing a color in CSS3 HSL functional notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-css3-rgb ¶

A format function for printing a color in CSS3 RGB functional notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-html ¶

A format function for printing a numerical HTML color value.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-cielab ¶

A format function for printing a color in Xcms CIE L*a*b* notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-cielch ¶

A format function for printing a color in Xcms CIE L*C*h notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-cieluv ¶

A format function for printing a color in Xcms CIE L*u*v* notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-ciergb ¶

A format function for printing a color in Xcms CIE RGB notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-ciexyy ¶

A format function for printing a color in Xcms CIE xyY notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-ciexyz ¶

A format function for printing a color in Xcms CIE XYZ notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-rgb ¶

A format function for printing a color in Xcms RGB notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: color-formatter-xcms-rgbi ¶

A format function for printing a color in Xcms RGBi notation.

Value is a function which has a behavior equivalent to a function returned by the ‘formatter’ macro.

Package

rs-colors.

Source

io.lisp.

Constant: srgb-white-point ¶

White point of the sRGB color space.

Package

rs-colors.

Source

srgb.lisp.

Constant: wide-gamut-rgb-white-point ¶

White point of the wide-gamut RGB color space.

Package

rs-colors.

Source

wide-gamut-rgb.lisp.

---

5.1.2 Special variables

Special Variable: *cielab-default-white-point* ¶

The default white point for colors in the CIE L*a*b* color space. Default value is the CIE 1931 D50 standard illuminant.

Package

rs-colors.

Source

cielab.lisp.

Special Variable: *cielch-default-white-point* ¶

The default white point for colors in the CIE L*C*h color space. Default value is the CIE 1931 D50 standard illuminant.

Package

rs-colors.

Source

cielch.lisp.

Special Variable: *cieluv-default-white-point* ¶

The default white point for colors in the CIE L*u*v* color space. Default value is the CIE 1931 D50 standard illuminant.

Package

rs-colors.

Source

cieluv.lisp.

Special Variable: *color-matching-functions* ¶

A list of three color matching functions.
Default is the CIE 1931 standard observer.

Value is an alist of cons cells of the form ‘(L . (X Y Z))’. Key L is the wavelength λ in nanometer and values X, Y, and Z are the discrete values of the color matching functions x(λ), y(λ), and z(λ) respectively. The list elements have to be sorted in strictly increasing order of the wavelength.

Value can also be a list of three functions, i.e. ‘(X Y Z)’, where X, Y, and Z are the color matching functions x(λ), y(λ), and z(λ) respectively.

Use the ‘color-matching-functions’ function to evaluate the color matching functions.

Package

rs-colors.

Source

color-matching-functions.lisp.

Special Variable: *second-radiation-constant* ¶

Second radiation constant.

Package

rs-colors.

Source

color-matching-functions.lisp.

---

5.1.3 Macros

Macro: defconst (name value &optional doc) ¶

Define a constant variable.

This is like ‘defconstant’ except that the initially set value is reused when the ‘defconst’ form is evaluated again.

Package

rs-colors-internal.

Source

utilities.lisp.

Macro: define-color-name (name value &optional doc) ¶

Package

rs-colors-internal.

Source

utilities.lisp.

Macro: define-color-names ((name &rest aliases) value &optional doc) ¶

Package

rs-colors-internal.

Source

utilities.lisp.

Macro: define-color-printer (style (color stream &key export inline) &body body) ¶

Argument STYLE is a string designator.

Package

rs-colors.

Source

io.lisp.

Macro: define-color-reader (style (stream &key export inline) &body body) ¶

Argument STYLE is a string designator.

Package

rs-colors.

Source

io.lisp.

Macro: defsubst (name arg-list &body body) ¶

Define an inline function.

This is like ‘defun’ except that the function is globally marked for inline expansion by the compiler.

Package

rs-colors-internal.

Source

utilities.lisp.

---

5.1.4 Ordinary functions

Function: black-body-spectral-radiance (wavelength temperature) ¶

Calculate the spectral radiance of a black body.

First argument WAVELENGTH is the wavelength of the light in meter. Second argument TEMPERATURE is the temperature of the black body in kelvin.

Return value is the spectral radiance of a black body around the given wavelength.

Package

rs-colors.

Source

black-body.lisp.

Function: black-body-spectral-radiant-exitance (wavelength temperature) ¶

Calculate the spectral radiant exitance of a black body.

First argument WAVELENGTH is the wavelength of the light in meter. Second argument TEMPERATURE is the temperature of the black body in kelvin.

Return value is the spectral radiant exitance of a black body around the given wavelength.

Package

rs-colors.

Source

black-body.lisp.

Function: cie-l*-from-y/yn (y/yn) ¶

Map relative luminance Y/Yn to lightness L*.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: cie-xy-chromaticity-of-black-body (temperature &key from to by) ¶

Calculate the chromaticity coordinates of a Planckian radiator. These chromaticity coordinates define the Planckian locus in a chromaticity diagram.

Argument TEMPERATURE is the temperature of the black body in kelvin. Keyword arguments FROM, TO, and BY define the boundaries and step size for the wavelength λ of the light in nanometer.

Return values are the CIE xyY color space chromaticity coordinates x and y as multiple values.

The three color matching functions x(λ), y(λ), and z(λ) are defined by the ‘*color-matching-functions*’ special variable. The second radiation constant is defined by the ‘*second-radiation-constant*’ special variable.

Package

rs-colors.

Source

color-matching-functions.lisp.

Function: cie-xy-chromaticity-of-light (wavelength) ¶

Calculate the chromaticity coordinates of a single color of light. These chromaticity coordinates define the border of the chromaticity space in a chromaticity diagram.

Argument WAVELENGTH is the wavelength λ of the light in nanometer.

Return values are the CIE xyY color space chromaticity coordinates x and y as multiple values.

The three color matching functions x(λ), y(λ), and z(λ) are defined by the ‘*color-matching-functions*’ special variable.

Package

rs-colors.

Source

color-matching-functions.lisp.

Function: cie-y/yn-from-l* (l*) ¶

Map lightness L* to relative luminance Y/Yn.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: cie76 (first-color second-color) ¶

Calculate the CIE76 color difference between two colors.

Value is the Euclidean distance between the two colors in the CIE L*a*b* color space. The CIE76 color difference is symmetric, i.e. CIE76(a,b) = CIE76(b,a).

Package

rs-colors.

Source

color-difference.lisp.

Function: cie94 (reference other &optional textile lightness chroma hue) ¶

Calculate the CIE94 color difference between two colors.

First argument REFERENCE is the reference color.
Second argument OTHER is the other color.
If optional third argument TEXTILE is non-null, use parameters
for calculating the color difference for textiles. Default is
to calculate the color difference for graphic arts.
Optional fourth to sixth argument LIGHTNESS, CHROMA, and HUE are the weighting factors for differences in lightness, chroma, and hue respectively. Higher value means less weight. Default is
one for all weighting factors (if TEXTILE is true, the default
for LIGHTNESS is two).

The CIE94 color difference is asymmetric, i.e. CIE94(a,b) ≠ CIE94(b,a).

Package

rs-colors.

Source

color-difference.lisp.

Function: coerce-color (color color-type) ¶

Coerce the color object into the specified color type.

First argument COLOR is a color object.
Second argument COLOR-TYPE is a color data type.

If argument COLOR is already a color of the requested color data type, return COLOR as is (no conversion). Otherwise, return a new color with the color coordinates of COLOR converted into the color space denoted by COLOR-TYPE.

Package

rs-colors.

Source

types.lisp.

Function: collapse (string &optional char) ¶

Remove consecutive duplicate characters.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: color-matching-functions (wavelength) ¶

Evaluate the color matching functions.

The three color matching functions x(λ), y(λ), and z(λ) are defined by the ‘*color-matching-functions*’ special variable.

Argument WAVELENGTH is the wavelength λ in nanometer.

Values are the values of the color matching functions for the wavelength λ.

Package

rs-colors.

Source

color-matching-functions.lisp.

Function: colorp (object) ¶

Return true if OBJECT is a color object.

Package

rs-colors.

Source

types.lisp.

Function: copy-matrix (a) ¶

Return a copy of matrix A.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: copy-vector (x) ¶

Return a copy of vector X.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: cube (z) ¶

Return Z cubed, that is Z raised to the power three.

Argument Z has to be a real number.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: cube-root (z) ¶

Return the cube root of Z.

Argument Z has to be a real number.

If argument Z is zero, value is zero. If argument Z is a real number, value is the real cube root of Z.

The ‘cube-root’ function attempts to propagate the type of the argument Z to its value.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: decode-quadruple (value &optional byte-size) ¶

Package

rs-colors-internal.

Source

utilities.lisp.

Function: decode-triple (value &optional byte-size) ¶

Package

rs-colors-internal.

Source

utilities.lisp.

Function: degree-from-radian (rad) ¶

Convert a plane angle from radian to degree.

Argument RAD is the angle given in radian.

Value is the corresponding angle given in degree.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: encode-quadruple (a b c d &optional byte-size) ¶

Package

rs-colors-internal.

Source

utilities.lisp.

Function: encode-triple (a b c &optional byte-size) ¶

Package

rs-colors-internal.

Source

utilities.lisp.

Function: ensure-type (object type) ¶

Signal a type error if OBJECT is not of the type TYPE. Otherwise, return OBJECT.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: float-array (a &optional prototype) ¶

Convert elements of a numeric array to floating-point numbers.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: gemm (a b &optional c) ¶

General matrix/matrix multiplication.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: gemv (a x &optional y) ¶

General matrix/vector multiplication.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: hypot (x y) ¶

Return the distance between a point and the origin in a two-dimensional Cartesian coordinate system.

Arguments X and Y have to be real numbers.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: hypot3 (x y z) ¶

Return the distance between a point and the origin in a three-dimensional Cartesian coordinate system.

Arguments X, Y, and Z have to be real numbers.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: linear-transformation (a x1 x2 x3) ¶

Perform a linear transformation.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: make-adobe-rgb-color (red green blue &key byte-size) ¶

Create a new color in the Adobe RGB color space.

First argument RED is the intensity of the red primary.
Second argument GREEN is the intensity of the green primary. Third argument BLUE is the intensity of the blue primary.

Arguments RED, GREEN, and BLUE have to be normalized intensity values in the closed interval [0, 1].

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. If specified, arguments RED, GREEN, and BLUE are scaled accordingly.

Example:

(make-adobe-rgb-color 252/255 175/255 62/255) (make-adobe-rgb-color 252 175 62 :byte-size 8)

Package

rs-colors.

Source

adobe-rgb.lisp.

Function: make-adobe-rgb-color-from-number (value &key byte-size) ¶

Create a new color in the Adobe RGB color space.

Argument VALUE is a non-negative integral number.

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. Default is eight bit (one byte). The most significant bits denote the intensity of the red primary.

Example:

(make-adobe-rgb-color-from-number #XFCAF3E)

Package

rs-colors.

Source

adobe-rgb.lisp.

Function: make-cielab-color (l* a* b* &optional white-point) ¶

Create a new color in the CIE L*a*b* color space.

Package

rs-colors.

Source

cielab.lisp.

Function: make-cielch-color (l* c* h &optional white-point) ¶

Create a new color in the CIE L*C*h color space.

Package

rs-colors.

Source

cielch.lisp.

Function: make-cieluv-color (l* u* v* &optional white-point) ¶

Create a new color in the CIE L*u*v* color space.

Package

rs-colors.

Source

cieluv.lisp.

Function: make-ciergb-color (red green blue) ¶

Create a new color in the CIE RGB color space.

First argument RED is the intensity of the red primary.
Second argument GREEN is the intensity green primary.
Third argument BLUE is the intensity of the blue primary.

Arguments RED, GREEN, and BLUE have to be normalized intensity values in the closed interval [0, 1].

Package

rs-colors.

Source

ciergb.lisp.

Function: make-ciexyy-color (x* y* y) ¶

Create a new color in the CIE xyY color space.

Arguments X* and Y* are the chromaticity coordinates. Argument Y is the second tristimulus value (luminance).

Package

rs-colors.

Source

ciexyy.lisp.

Function: make-ciexyz-color (x y z) ¶

Create a new color in the CIE XYZ color space.

Arguments X, Y, and Z are the tristimulus values.

Package

rs-colors.

Source

ciexyz.lisp.

Function: make-generic-cmy-color (cyan magenta yellow &key byte-size) ¶

Create a new color in the generic CMY color space.

First argument CYAN is the intensity of the cyan ink.
Second argument MAGENTA is the intensity of the magenta ink.
Third argument YELLOW is the intensity of the yellow ink.

Arguments CYAN, MAGENTA, and YELLOW have to be normalized color values in the closed interval [0, 1].

Keyword argument BYTE-SIZE is the number of bits used to represent a color value. If specified, arguments CYAN, MAGENTA, and YELLOW are scaled accordingly.

Example:

(make-generic-cmy-color 3/255 80/255 193/255) (make-generic-cmy-color 3 80 193 :byte-size 8)

Package

rs-colors.

Source

generic-cmy.lisp.

Function: make-generic-cmy-color-from-number (value &key byte-size) ¶

Create a new color in the generic CMY color space.

Argument VALUE is a non-negative integral number.

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. Default is eight bit (one byte). The most significant bits denote the intensity of the cyan primary.

Example:

(make-generic-cmy-color-from-number #X0350C1)

Package

rs-colors.

Source

generic-cmy.lisp.

Function: make-generic-cmyk-color (cyan magenta yellow black &key byte-size) ¶

Create a new color in the generic CMYK color space.

First argument CYAN is the intensity of the cyan ink.
Second argument MAGENTA is the intensity of the magenta ink.
Third argument YELLOW is the intensity of the yellow ink.
Fourth argument BLACK is the intensity of the black ink.

Arguments CYAN, MAGENTA, YELLOW, and BLACK have to be normalized intensity values in the closed interval [0, 1].

Keyword argument BYTE-SIZE is the number of bits used to represent a color value. If specified, arguments CYAN, MAGENTA, YELLOW, and BLACK are scaled accordingly.

Example:

(make-generic-cmyk-color 3/255 80/255 193/255 0) (make-generic-cmyk-color 3 80 193 0 :byte-size 8)

Package

rs-colors.

Source

generic-cmyk.lisp.

Function: make-generic-cmyk-color-from-number (value &key byte-size) ¶

Create a new color in the generic CMYK color space.

Argument VALUE is a non-negative integral number.

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. Default is eight bit (one byte). The most significant bits denote the intensity of the cyan primary.

Example:

(make-generic-cmyk-color-from-number #X0350C100)

Package

rs-colors.

Source

generic-cmyk.lisp.

Function: make-generic-hsl-color (hue saturation lightness) ¶

Create a new color in the generic HSL color space.

First argument HUE is the angle of the RGB color wheel. Second argument SATURATION is the saturation.
Third argument LIGHTNESS is the lightness.

Arguments SATURATION and LIGHTNESS have to be real numbers in the closed interval [0, 1].

Package

rs-colors.

Source

generic-rgb.lisp.

Function: make-generic-hsv-color (hue saturation value) ¶

Create a new color in the generic HSV color space.

First argument HUE is the angle of the RGB color wheel. Second argument SATURATION is the saturation.
Third argument VALUE is the brightness.

Arguments SATURATION and VALUE have to be real numbers in the closed interval [0, 1].

Package

rs-colors.

Source

generic-rgb.lisp.

Function: make-generic-rgb-color (red green blue &key byte-size) ¶

Create a new color in the generic RGB color space.

First argument RED is the intensity of the red primary.
Second argument GREEN is the intensity of the green primary. Third argument BLUE is the intensity of the blue primary.

Arguments RED, GREEN, and BLUE have to be normalized intensity values in the closed interval [0, 1].

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. If specified, arguments RED, GREEN, and BLUE are scaled accordingly.

Example:

(make-generic-rgb-color 252/255 175/255 62/255) (make-generic-rgb-color 252 175 62 :byte-size 8)

Package

rs-colors.

Source

generic-rgb.lisp.

Function: make-generic-rgb-color-from-number (value &key byte-size) ¶

Create a new color in the generic RGB color space.

Argument VALUE is a non-negative integral number.

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. Default is eight bit (one byte). The most significant bits denote the intensity of the red primary.

Example:

(make-generic-rgb-color-from-number #XFCAF3E)

Package

rs-colors.

Source

generic-rgb.lisp.

Function: make-matrix (&optional a11 a12 a13 a21 a22 a23 a31 a32 a33) ¶

Create a matrix.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: make-rgb-color (color-type red green blue &optional byte-size) ¶

Create a new color in an RGB color space.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: make-rgb-color-from-number (color-type value &optional byte-size) ¶

Create a new color in an RGB color space.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: make-srgb-color (red green blue &key byte-size) ¶

Create a new color in the sRGB color space.

First argument RED is the intensity of the red primary.
Second argument GREEN is the intensity of the green primary. Third argument BLUE is the intensity of the blue primary.

Arguments RED, GREEN, and BLUE have to be normalized intensity values in the closed interval [0, 1].

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. If specified, arguments RED, GREEN, and BLUE are scaled accordingly.

Example:

(make-srgb-color 252/255 175/255 62/255)
(make-srgb-color 252 175 62 :byte-size 8)

Package

rs-colors.

Source

srgb.lisp.

Function: make-srgb-color-from-number (value &key byte-size) ¶

Create a new color in the sRGB color space.

Argument VALUE is a non-negative integral number.

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. Default is eight bit (one byte). The most significant bits denote the intensity of the red primary.

Example:

(make-srgb-color-from-number #XFCAF3E)

Package

rs-colors.

Source

srgb.lisp.

Function: make-vector (&optional x1 x2 x3) ¶

Create a vector.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: make-wide-gamut-rgb-color (red green blue &key byte-size) ¶

Create a new color in the wide-gamut RGB color space.

First argument RED is the intensity of the red primary.
Second argument GREEN is the intensity of the green primary. Third argument BLUE is the intensity of the blue primary.

Arguments RED, GREEN, and BLUE have to be normalized intensity values in the closed interval [0, 1].

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. If specified, arguments RED, GREEN, and BLUE are scaled accordingly.

Example:

(make-wide-gamut-rgb-color 252/255 175/255 62/255) (make-wide-gamut-rgb-color 252 175 62 :byte-size 8)

Package

rs-colors.

Source

wide-gamut-rgb.lisp.

Function: make-wide-gamut-rgb-color-from-number (value &key byte-size) ¶

Create a new color in the wide-gamut RGB color space.

Argument VALUE is a non-negative integral number.

Keyword argument BYTE-SIZE is the number of bits used to represent a primary. Default is eight bit (one byte). The most significant bits denote the intensity of the red primary.

Example:

(make-wide-gamut-rgb-color-from-number #XFCAF3E)

Package

rs-colors.

Source

wide-gamut-rgb.lisp.

Function: matrix-inverse (a) ¶

Calculate inverse matrix of matrix A in place.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: multiples (number 1/fraction) ¶

Return NUMBER/FRACTION if NUMBER is a multiple of 1/FRACTION. Otherwise, return null.

First argument NUMBER has to be a number.
Second argument 1/FRACTION has to be a positive number.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: print-color-css3-hsl (color &optional stream) ¶

Print a color in CSS3 HSL functional notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-css3-rgb (color &optional stream) ¶

Print a color in CSS3 RGB functional notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-html (color &optional stream) ¶

Print a numerical HTML color value.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-cielab (color &optional stream) ¶

Print a color in Xcms CIE L*a*b* notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-cielch (color &optional stream) ¶

Print a color in Xcms CIE L*C*h notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-cieluv (color &optional stream) ¶

Print a color in Xcms CIE L*u*v* notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-ciergb (color &optional stream) ¶

Print a color in Xcms CIE RGB notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-ciexyy (color &optional stream) ¶

Print a color in Xcms CIE xyY notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-ciexyz (color &optional stream) ¶

Print a color in Xcms CIE XYZ notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-rgb (color &optional stream) ¶

Print a color in Xcms RGB notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: print-color-xcms-rgbi (color &optional stream) ¶

Print a color in Xcms RGBi notation.

First argument COLOR is a color object.
Optional second argument STREAM is an output stream. Default is to print to ‘*standard-output*’.

Value is the color object.

Package

rs-colors.

Source

io.lisp.

Function: radian-from-degree (deg) ¶

Convert a plane angle from degree to radian.

Argument DEG is the angle given in degree.

Value is the corresponding angle given in radian.

Package

rs-colors-internal.

Source

utilities.lisp.

Function: read-color-css3 (&optional stream) ¶

Read a CSS3 color value, i.e. either a numerical HTML color definition or a RGB value or HSL value in functional notation.

Optional argument STREAM is an input stream.
Default is to read from ‘*standard-input*’.

Value is a color object in the sRGB color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-css3-hsl (&optional stream) ¶

Read a color in CSS3 HSL functional notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the sRGB color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-css3-rgb (&optional stream) ¶

Read a color in CSS3 RGB functional notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the sRGB color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-html (&optional stream) ¶

Read a numerical HTML color value.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the sRGB color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms (&optional stream) ¶

Read a color in Xcms notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the color space indicated by the Xcms prefix.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-cielab (&optional stream) ¶

Read a color in Xcms CIE L*a*b* notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the CIE L*a*b* color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-cielch (&optional stream) ¶

Read a color in Xcms CIE L*C*h notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the CIE L*C*h color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-cieluv (&optional stream) ¶

Read a color in Xcms CIE L*u*v* notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the CIE L*u*v* color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-ciergb (&optional stream) ¶

Read a color in Xcms CIE RGB notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the CIE RGB color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-ciexyy (&optional stream) ¶

Read a color in Xcms CIE xyY notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the CIE xyY color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-ciexyz (&optional stream) ¶

Read a color in Xcms CIE XYZ notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the CIE XYZ color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-rgb (&optional stream) ¶

Read a color in Xcms RGB notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the generic RGB color space.

Package

rs-colors.

Source

io.lisp.

Function: read-color-xcms-rgbi (&optional stream) ¶

Read a color in Xcms RGBi notation.

Optional argument STREAM is an input stream. Default is to read from ‘*standard-input*’.

Value is a color object in the generic RGB color space.

Package

rs-colors.

Source

io.lisp.

Function: rgb-transformation-matrices (red green blue white) ¶

Return the transformation matrix for converting CIE XYZ color space coordinates into RGB color space coordinates and vice versa.

Arguments RED, GREEN, BLUE, and WHITE are the chromaticity coordinates of the red primary, the green primary, the blue primary, and the white point respectively.

First value is the transformation matrix for converting CIE XYZ color space coordinates into RGB color space coordinates. Second value is the inverse matrix.

Package

rs-colors-internal.

Source

utilities.lisp.

---

5.1.5 Generic functions

Generic Function: absolute-color (color &key white black) ¶

Convert from normalized color coordinates to absolute color coordinates.

Package

rs-colors.

Source

types.lisp.

Methods

Method: absolute-color ((color ciexyy-color) &key white black) ¶

Source

ciexyy.lisp.

Method: absolute-color ((color ciexyz-color) &key white black) ¶

Source

ciexyz.lisp.

Generic Function: adobe-rgb-color-coordinates (color) ¶

Return the Adobe RGB color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the red, green, and blue primary.

Package

rs-colors.

Source

adobe-rgb.lisp.

Methods

Method: adobe-rgb-color-coordinates ((color adobe-rgb-color)) ¶

Method: adobe-rgb-color-coordinates ((color generic-color-object)) ¶

Method: adobe-rgb-color-coordinates ((color color-object)) ¶

Generic Function: cielab-color-coordinates (color) ¶

Return the CIE L*a*b* color space coordinates of the color.

Argument COLOR is a color object.

Package

rs-colors.

Source

cielab.lisp.

Methods

Method: cielab-color-coordinates ((color cielch-color)) ¶

Source

cielch.lisp.

Method: cielab-color-coordinates ((color cielab-color)) ¶

Method: cielab-color-coordinates ((color color-object)) ¶

Generic Function: cielch-color-coordinates (color) ¶

Return the CIE L*C*h color space coordinates of the color.

Argument COLOR is a color object.

Package

rs-colors.

Source

cielch.lisp.

Methods

Method: cielch-color-coordinates ((color cielch-color)) ¶

Method: cielch-color-coordinates ((color color-object)) ¶

Generic Function: cieluv-color-coordinates (color) ¶

Return the CIE L*u*v* color space coordinates of the color.

Argument COLOR is a color object.

Package

rs-colors.

Source

cieluv.lisp.

Methods

Method: cieluv-color-coordinates ((color cieluv-color)) ¶

Method: cieluv-color-coordinates ((color color-object)) ¶

Generic Function: ciergb-color-coordinates (color) ¶

Return the CIE RGB color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the red, green, and blue primary.

Package

rs-colors.

Source

ciergb.lisp.

Methods

Method: ciergb-color-coordinates ((color ciergb-color)) ¶

Method: ciergb-color-coordinates ((color generic-color-object)) ¶

Method: ciergb-color-coordinates ((color color-object)) ¶

Generic Function: ciexyy-color-coordinates (color) ¶

Return the CIE xyY color space coordinates of the color.

Argument COLOR is a color object.

Values are the X and Y chromaticity coordinates and the Y tristimulus value (luminance).

Package

rs-colors.

Source

ciexyy.lisp.

Methods

Method: ciexyy-color-coordinates ((color ciexyy-color)) ¶

Method: ciexyy-color-coordinates ((color color-object)) ¶

Generic Function: ciexyz-color-coordinates (color) ¶

Return the CIE XYZ color space coordinates of the color.

Argument COLOR is a color object.

Values are the X, Y, and Z tristimulus values.

Package

rs-colors.

Source

ciexyz.lisp.

Methods

Method: ciexyz-color-coordinates ((color wide-gamut-rgb-color)) ¶

Source

wide-gamut-rgb.lisp.

Method: ciexyz-color-coordinates ((color adobe-rgb-color)) ¶

Source

adobe-rgb.lisp.

Method: ciexyz-color-coordinates ((color srgb-color)) ¶

Source

srgb.lisp.

Method: ciexyz-color-coordinates ((color ciergb-color)) ¶

Source

ciergb.lisp.

Method: ciexyz-color-coordinates ((color cielch-color)) ¶

Source

cielch.lisp.

Method: ciexyz-color-coordinates ((color cielab-color)) ¶

Source

cielab.lisp.

Method: ciexyz-color-coordinates ((color cieluv-color)) ¶

Source

cieluv.lisp.

Method: ciexyz-color-coordinates ((color ciexyy-color)) ¶

Source

ciexyy.lisp.

Method: ciexyz-color-coordinates ((color ciexyz-color)) ¶

Generic Function: color-coordinates (color) ¶

Return the color space coordinates of the color.

Argument COLOR is a color object.

Package

rs-colors.

Source

types.lisp.

Methods

Method: color-coordinates ((color cielch-color)) ¶

Source

cielch.lisp.

Method: color-coordinates ((color cielab-color)) ¶

Source

cielab.lisp.

Method: color-coordinates ((color cieluv-color)) ¶

Source

cieluv.lisp.

Method: color-coordinates ((color ciexyy-color)) ¶

Source

ciexyy.lisp.

Method: color-coordinates ((color ciexyz-color)) ¶

Source

ciexyz.lisp.

Method: color-coordinates ((color cmyk-color-object)) ¶

Method: color-coordinates ((color cmy-color-object)) ¶

Method: color-coordinates ((color hsl-color-object)) ¶

Method: color-coordinates ((color hsv-color-object)) ¶

Method: color-coordinates ((color rgb-color-object)) ¶

Method: color-coordinates ((color color-object)) ¶

Generic Function: copy-color (color) ¶

Return a shallow copy of the color.

Argument COLOR is a color object.

Package

rs-colors.

Source

types.lisp.

Methods

Method: copy-color ((color color-object)) ¶

Generic Function: generic-cmy-color-coordinates (color) ¶

Return the CMY color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the cyan, magenta, and yellow ink.

Package

rs-colors.

Source

generic-cmy.lisp.

Methods

Method: generic-cmy-color-coordinates ((color generic-cmyk-color)) ¶

Source

generic-cmyk.lisp.

Method: generic-cmy-color-coordinates ((color generic-cmy-color)) ¶

Method: generic-cmy-color-coordinates ((color color-object)) ¶

Generic Function: generic-cmyk-color-coordinates (color) ¶

Return the CMYK color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the cyan, magenta, yellow, and black ink.

Package

rs-colors.

Source

generic-cmyk.lisp.

Methods

Method: generic-cmyk-color-coordinates ((color generic-cmyk-color)) ¶

Method: generic-cmyk-color-coordinates ((color color-object)) ¶

Generic Function: generic-hsl-color-coordinates (color) ¶

Return the HSL color space coordinates of the color.

Argument COLOR is a color object.

Values are the hue, saturation, and lightness.

Package

rs-colors.

Source

generic-rgb.lisp.

Methods

Method: generic-hsl-color-coordinates ((color generic-hsl-color)) ¶

Method: generic-hsl-color-coordinates ((color color-object)) ¶

Generic Function: generic-hsv-color-coordinates (color) ¶

Return the HSV color space coordinates of the color.

Argument COLOR is a color object.

Values are the hue, saturation, and value (brightness).

Package

rs-colors.

Source

generic-rgb.lisp.

Methods

Method: generic-hsv-color-coordinates ((color generic-hsv-color)) ¶

Method: generic-hsv-color-coordinates ((color color-object)) ¶

Generic Function: generic-rgb-color-coordinates (color) ¶

Return the RGB color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the red, green, and blue primary.

Package

rs-colors.

Source

generic-rgb.lisp.

Methods

Method: generic-rgb-color-coordinates ((color wide-gamut-rgb-color)) ¶

Source

wide-gamut-rgb.lisp.

Method: generic-rgb-color-coordinates ((color adobe-rgb-color)) ¶

Source

adobe-rgb.lisp.

Method: generic-rgb-color-coordinates ((color srgb-color)) ¶

Source

srgb.lisp.

Method: generic-rgb-color-coordinates ((color ciergb-color)) ¶

Source

ciergb.lisp.

Method: generic-rgb-color-coordinates ((color generic-cmy-color)) ¶

Source

generic-cmy.lisp.

Method: generic-rgb-color-coordinates ((color generic-rgb-color)) ¶

Method: generic-rgb-color-coordinates ((color generic-hsv-color)) ¶

Method: generic-rgb-color-coordinates ((color generic-hsl-color)) ¶

Generic Function: normalize-color (color &key white black) ¶

Convert from absolute color coordinates to normalized color coordinates.

Package

rs-colors.

Source

types.lisp.

Methods

Method: normalize-color ((color ciexyy-color) &key white black) ¶

Source

ciexyy.lisp.

Method: normalize-color ((color ciexyz-color) &key white black) ¶

Source

ciexyz.lisp.

Generic Function: srgb-color-coordinates (color) ¶

Return the sRGB color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the red, green, and blue primary.

Package

rs-colors.

Source

srgb.lisp.

Methods

Method: srgb-color-coordinates ((color srgb-color)) ¶

Method: srgb-color-coordinates ((color generic-color-object)) ¶

Method: srgb-color-coordinates ((color color-object)) ¶

Generic Function: white-point (color) ¶

Return the white point of the color.

Argument COLOR is a color object.

Value is the color object of the color’s white point, or nil if the white point is not defined or if multiple white points exist.

Package

rs-colors.

Source

types.lisp.

Methods

Method: white-point ((color wide-gamut-rgb-color)) ¶

Source

wide-gamut-rgb.lisp.

Method: white-point ((color adobe-rgb-color)) ¶

Source

adobe-rgb.lisp.

Method: white-point ((color srgb-color)) ¶

Source

srgb.lisp.

Method: white-point ((color cielch-color)) ¶

Source

cielch.lisp.

Method: white-point ((color cielab-color)) ¶

Source

cielab.lisp.

Method: white-point ((color cieluv-color)) ¶

Source

cieluv.lisp.

Method: white-point ((color color-object)) ¶

Generic Function: wide-gamut-rgb-color-coordinates (color) ¶

Return the wide-gamut RGB color space coordinates of the color.

Argument COLOR is a color object.

Values are the intensities of the red, green, and blue primary.

Package

rs-colors.

Source

wide-gamut-rgb.lisp.

Methods

Method: wide-gamut-rgb-color-coordinates ((color wide-gamut-rgb-color)) ¶

Method: wide-gamut-rgb-color-coordinates ((color generic-color-object)) ¶

Method: wide-gamut-rgb-color-coordinates ((color color-object)) ¶

---