Cam16 class

CAM16, a color appearance model. Colors are not just defined by their hex code, but rather, a hex code and viewing conditions.

CAM16 instances also have coordinates in the CAM16-UCS space, called J*, a*, b*, or jstar, astar, bstar in code. CAM16-UCS is included in the CAM16 specification, and should be used when measuring distances between colors.

In traditional color spaces, a color can be identified solely by the observer's measurement of the color. Color appearance models such as CAM16 also use information about the environment where the color was observed, known as the viewing conditions.

For example, white under the traditional assumption of a midday sun white point is accurately measured as a slightly chromatic blue by CAM16. (roughly, hue 203, chroma 3, lightness 100) CAM16, a color appearance model. Colors are not just defined by their hex code, but rather, a hex code and viewing conditions.

CAM16 instances also have coordinates in the CAM16-UCS space, called J*, a*, b*, or jstar, astar, bstar in code. CAM16-UCS is included in the CAM16 specification, and should be used when measuring distances between colors.

In traditional color spaces, a color can be identified solely by the observer's measurement of the color. Color appearance models such as CAM16 also use information about the environment where the color was observed, known as the viewing conditions.

For example, white under the traditional assumption of a midday sun white point is accurately measured as a slightly chromatic blue by CAM16. (roughly, hue 203, chroma 3, lightness 100)

Constructors

Cam16(double hue, double chroma, double j, double q, double m, double s, double jstar, double astar, double bstar)
All of the CAM16 dimensions can be calculated from 3 of the dimensions, in the following combinations: - {j or q} and {c, m, or s} and hue - jstar, astar, bstar Prefer using a static method that constructs from 3 of those dimensions. This constructor is intended for those methods to use to return all possible dimensions.

Properties

astar double
CAM16-UCS a coordinate
final
bstar double
CAM16-UCS b coordinate
final
chroma double
Informally, colorfulness / color intensity. Like saturation in HSL, except perceptually accurate.
final
hashCode int
The hash code for this object.
no setterinherited
hue double
Like red, orange, yellow, green, etc.
final
j double
Lightness
final
jstar double
CAM16-UCS J coordinate
final
m double
Colorfulness
final
q double
Brightness; ratio of lightness to white point's lightness
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
s double
Saturation; ratio of chroma to white point's chroma
final

Methods

distance(Cam16 other) double
CAM16 instances also have coordinates in the CAM16-UCS space, called J*, a*, b*, or jstar, astar, bstar in code. CAM16-UCS is included in the CAM16 specification, and should be used when measuring distances between colors.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toInt() int
ARGB representation of color, assuming the color was viewed in default viewing conditions.
toString() String
A string representation of this object.
inherited
viewed(ViewingConditions viewingConditions) int
ARGB representation of a color, given the color was viewed in viewingConditions
xyzInViewingConditions(ViewingConditions viewingConditions, {List<double>? array}) List<double>
XYZ representation of CAM16 seen in viewingConditions.

Operators

operator ==(Object other) bool
The equality operator.
inherited

Static Methods

fromInt(int argb) Cam16
Convert argb to CAM16, assuming the color was viewed in default viewing conditions.
fromIntInViewingConditions(int argb, ViewingConditions viewingConditions) Cam16
Given viewingConditions, convert argb to CAM16.
fromJch(double j, double c, double h) Cam16
Create a CAM16 color from lightness j, chroma c, and hue h, assuming the color was viewed in default viewing conditions.
fromJchInViewingConditions(double J, double C, double h, ViewingConditions viewingConditions) Cam16
Create a CAM16 color from lightness j, chroma c, and hue h, in viewingConditions.
fromUcs(double jstar, double astar, double bstar) Cam16
Create a CAM16 color from CAM16-UCS coordinates jstar, astar, bstar. assuming the color was viewed in default viewing conditions.
fromUcsInViewingConditions(double jstar, double astar, double bstar, ViewingConditions viewingConditions) Cam16
Create a CAM16 color from CAM16-UCS coordinates jstar, astar, bstar. in viewingConditions.
fromXyzInViewingConditions(double x, double y, double z, ViewingConditions viewingConditions) Cam16
Given color expressed in XYZ and viewed in viewingConditions, convert to CAM16.