public class ColorRenderingIndex extends ColorSpaceDescriptor
It is also informative to test how the illuminant renders other particular colors, namely skin and saturated foliage. For this reason, there are an additional 6 samples that can be reported for illustrative purposes, but which are not included in the CRI value.
The primary source for this implementation is CIE 13.3 1995, with some support from "Measuring Color" by R.W.G. Hunt, 3rd edition, pp. 95-96, "Color Science" by Wyszecki and Stiles, 2nd edition, pp. 173-175, and CIE 15.2 1986.
CRI is only meaningful when applied to emissive color measurements.
The ISBN for "Measuring Color" is 0-86343-387-1.
The ISBN for "Color Science" is 0-471-39918-3.
Constructor and Description |
---|
ColorRenderingIndex(CIEColor emissiveColor)
Creates a new instance of ColorRenderingIndex.
|
Modifier and Type | Method and Description |
---|---|
double |
getColorDelta()
Returns the computed color difference between the test illuminant (k
) and the reference illuminant (r).
|
static ColorSpaceValue[] |
getColorSpaceValues()
Returns an array of ColorSpaceValue objects, each of which can be
displayed in a widget (e.g.
|
double |
getGeneralCRI()
Returns the General Color Rendering Index (CRI).
|
double |
getReferenceColorTemperature()
This provides the correlated color temperature of the reference
illuminant that was used to calculate the CRI.
|
double |
getSpecialCRI(int cieTestColorSample)
Returns the Special Color Rendering Index of the given CIE Test Color
Sample.
|
boolean |
isColorDeltaWithinTolerance()
Tests whether the computed color difference between the sample and the
reference illuminant is small (within 15 microreciprocal kelvins).
|
getAllColorSpaceDescriptors
public ColorRenderingIndex(CIEColor emissiveColor) throws ColorConversionException
emissiveColor
- Emissive color measurement to compute CRI fromColorConversionException
- if a problem occurs while attempting to convert from one color space to
another.public double getGeneralCRI()
public double getSpecialCRI(int cieTestColorSample)
The average of special CRI values 1-8 is equal to the general CRI (see CIE 13.3-1995 p. 8 Section 6.3). The others are provided for reference.
cieTestColorSample
- one of 15 test samples tha are defined by the
CIE, and they must be specified here as 1-15. Any other value will
cause an IllegalArgumentException.public double getColorDelta()
public boolean isColorDeltaWithinTolerance()
public double getReferenceColorTemperature()
public static ColorSpaceValue[] getColorSpaceValues()
NOTE: do not change the name of this method without checking thoroughly for references to it. Other code will need to find this method by name at run-time given only a Class, so simple refactoring won't catch all references.
Copyright 2004-2006 Ocean Optics, Inc. All Rights Reserved.