Class ViewingConditions

java.lang.Object
org.glavo.monetfx.internal.hct.ViewingConditions
public final class ViewingConditions extends Object
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)

This class caches intermediate values of the CAM16 conversion process that depend only on viewing conditions, enabling speed ups.

  • Field Details

    • DEFAULT

      public static final ViewingConditions DEFAULT
      sRGB-like viewing conditions.

  • Method Details

    • getAw

      public double getAw()

    • getN

      public double getN()

    • getNbb

      public double getNbb()

    • getRgbD

      public double[] getRgbD()

    • getFlRoot

      public double getFlRoot()

    • make

      public static ViewingConditions make(double[] whitePoint, double adaptingLuminance, double backgroundLstar, double surround, boolean discountingIlluminant)
      Create ViewingConditions from a simple, physically relevant, set of parameters.
      Parameters:
      whitePoint - White point, measured in the XYZ color space. default = D65, or sunny day afternoon
      adaptingLuminance - The luminance of the adapting field. Informally, how bright it is in the room where the color is viewed. Can be calculated from lux by multiplying lux by 0.0586. default = 11.72, or 200 lux.
      backgroundLstar - The lightness of the area surrounding the color. measured by L* in L*a*b*. default = 50.0
      surround - A general description of the lighting surrounding the color. 0 is pitch dark, like watching a movie in a theater. 1.0 is a dimly light room, like watching TV at home at night. 2.0 means there is no difference between the lighting on the color and around it. default = 2.0
      discountingIlluminant - Whether the eye accounts for the tint of the ambient lighting, such as knowing an apple is still red in green light. default = false, the eye does not perform this process on self-luminous objects like displays.

    • defaultWithBackgroundLstar

      public static ViewingConditions defaultWithBackgroundLstar(double lstar)
      Create sRGB-like viewing conditions with a custom background lstar.

      Default viewing conditions have a lstar of 50, midgray.