/*
 * @(#)CIELABColorSpace.java
 * 
 * Copyright (c) 2010 by the original authors of JHotDraw and all its
 * contributors. All rights reserved.
 * 
 * You may not use, copy or modify this file, except in compliance with the 
 * license agreement you entered into with the copyright holders. For details
 * see accompanying license terms.
 */
package org.jhotdraw.color;

import java.awt.color.ColorSpace;

/**
 * The 1976 CIE L*a*b* color space (CIELAB).
 * 

* The L* coordinate of an object is the lightness intensity as measured on a * scale from 0 to 100, where 0 represents black and 100 represents white. *

* The a* coordinate of an object represents the position of the object’s color * on a pure green and pure red scale, where -127 represents pure green and +127 * represents pure red. *

* The b* coordinate represents the position of the object’s color on a pure * blue and pure yellow scale, where -127 represents pure blue and +127 * represents pure yellow. *

* The distance that can be calculated between two colors, is directly * proportional to the difference between the two colors as perceived by the * human eye. *

* The above description has been derived from * * http://www.optelvision.com/documents/optel-vision-s-explanation-on-cielab-color-space.pdf * * * @author Werner Randelshofer * @version $Id: CIELABColorSpace.java 717 2010-11-21 12:30:57Z rawcoder $ */ public class CIELABColorSpace extends ColorSpace implements NamedColorSpace { /** The XYZ coordinates of the CIE Standard Illuminant D65 reference white.*/ private final static double[] D65 = {0.9505d, 1d, 1.0890d}; /** The X coordinate of the reference white.*/ private double Xw; /** The Y coordinate of the reference white.*/ private double Yw; /** The Z coordinate of the reference white.*/ private double Zw; /** Epsilon */ private final static double eps = 216d / 24389d; private final static double k = 24389d / 27d; private final static ColorSpace sRGB = ColorSpace.getInstance(ColorSpace.CS_sRGB); public enum OutsideGamutHandling { CLAMP, LEAVE_OUTSIDE }; /** By default, clamps non-displayable RGB values. */ private OutsideGamutHandling outsideGamutHandling = OutsideGamutHandling.CLAMP; public CIELABColorSpace() { super(ColorSpace.TYPE_Lab, 3); Xw = D65[0]; Yw = D65[1]; Zw = D65[2]; } @Override public float[] toRGB(float[] colorvalue) { float[] ciexyz = toCIEXYZ(colorvalue); // Convert to sRGB as described in // http://www.w3.org/Graphics/Color/sRGB.html double X = ciexyz[0]; double Y = ciexyz[1]; double Z = ciexyz[2]; double Rs = 3.2410 * X + -1.5374 * Y + -0.4986 * Z; double Gs = -0.9692 * X + 1.8760 * Y + -0.0416 * Z; double Bs = 0.0556 * X + -0.2040 * Y + 1.0570 * Z; if (Rs <= 0.00304) { Rs = 12.92 * Rs; } else { Rs = 1.055 * Math.pow(Rs, 1d / 2.4) - 0.055; } if (Gs <= 0.00304) { Gs = 12.92 * Gs; } else { Gs = 1.055 * Math.pow(Gs, 1d / 2.4) - 0.055; } if (Bs <= 0.00304) { Bs = 12.92 * Bs; } else { Bs = 1.055 * Math.pow(Bs, 1d / 2.4) - 0.055; } switch (outsideGamutHandling) { case CLAMP: Rs = Math.min(1, Math.max(0, Rs)); Gs = Math.min(1, Math.max(0, Gs)); Bs = Math.min(1, Math.max(0, Bs)); break; } return new float[]{(float) Rs, (float) Gs, (float) Bs}; // return sRGB.fromCIEXYZ(ciexyz); } @Override public float[] fromRGB(float[] rgbvalue) { float[] ciexyz = sRGB.fromRGB(rgbvalue); return fromCIEXYZ(ciexyz); } /** * Lab to XYZ. *

     * X = xr*Xw;
     * Y = yr*Yw;
     * Z = zr*Zw;
     * 
* where *
     * xr = fx^3, if fx^3 > eps
     *    = (116*fx - 16)/k, if fx^3 <= eps
     *
     * yr = ((L+16)/116)^3, if L > k*eps
     *    = L/k, if L <= k*eps
     *
     * zr = fz^3, if fz^3 > eps
     *    = (116*fz - 16)/k, if fz^3 <= eps
     *
     * fx = a/500+fy
     *
     * fz = fy - b / 200
     *
     * fy = (L+16)/116
     *
     * eps = 216/24389
     * k = 24389/27
     * 
* * Source: http://www.brucelindbloom.com/index.html?Equations.html * * @param colorvalue Lab color value. * @return CIEXYZ color value. */ @Override public float[] toCIEXYZ(float[] colorvalue) { double L = colorvalue[0]; double a = colorvalue[1]; double b = colorvalue[2]; double fy = (L + 16d) / 116d; double fx = a / 500d + fy; double fz = fy - b / 200d; double xr, yr, zr; double fxp3 = fx * fx * fx; if (fxp3 > eps) { xr = fxp3; } else { xr = (116d * fx - 16d) / k; } if (L > k * eps) { yr = ((L + 16d) / 116d); yr = yr * yr * yr; } else { yr = L / k; } double fzp3 = fz * fz * fz; if (fzp3 > eps) { zr = fzp3; } else { zr = (116d * fz - 16f) / k; } double X = xr * Xw; double Y = yr * Yw; double Z = zr * Zw; return new float[]{(float) X, (float) Y, (float) Z}; } /** * XYT to Lab. *
     * L = 116*fy - 16
     * a = 500 * (fx - fy)
     * b = 200 * (fy - fz)
     * 
* where *
     * fx = xr^(1/3), if xr > eps
     *    = (k*xr + 16) / 116 if xr <= eps
     *
     * fy = yr^(1/3), if yr > eps
     *    = (k*yr + 16) / 116 if yr <= eps
     *
     * fz = zr^(1/3), if zr > eps
     *    = (k*zr + 16) / 116 if zr <= eps
     *
     * xr = X / Xw
     * yr = Y / Yw
     * zr = Z / Zw
     *
     * eps = 216/24389
     * k = 24389/27
     * 
* * Source: http://www.brucelindbloom.com/index.html?Equations.html * * @param colorvalue CIEXYZ color value. * @return Lab color value. */ @Override public float[] fromCIEXYZ(float[] colorvalue) { double X = colorvalue[0]; double Y = colorvalue[1]; double Z = colorvalue[2]; double xr = X / Xw; double yr = Y / Yw; double zr = Z / Zw; double fx, fy, fz; if (xr > eps) { fx = Math.pow(xr, 1d / 3d); } else { fx = (k * xr + 16d) / 116d; } if (yr > eps) { fy = Math.pow(yr, 1d / 3d); } else { fy = (k * yr + 16d) / 116d; } if (zr > eps) { fz = Math.pow(zr, 1d / 3d); } else { fz = (k * zr + 16) / 116; } double L = 116d * fy - 16; double a = 500d * (fx - fy); double b = 200d * (fy - fz); return new float[]{(float) L, (float) a, (float) b}; } @Override public String getName() { return "CIE 1976 L*a*b*"; } @Override public float getMinValue(int component) { switch (component) { case 0: return 0f; case 1: case 2: return -128f; } throw new IllegalArgumentException("Illegal component:" + component); } @Override public float getMaxValue(int component) { switch (component) { case 0: return 100f; case 1: case 2: return 127f; } throw new IllegalArgumentException("Illegal component:" + component); } @Override public String getName(int component) { switch (component) { case 0: return "L*"; case 1: return "a*"; case 2: return "b*"; } throw new IllegalArgumentException("Illegal component:" + component); } public void setOutsideGamutHandling(OutsideGamutHandling b) { outsideGamutHandling = b; } public OutsideGamutHandling getOutsideGamutHandling() { return outsideGamutHandling; } public static void main(String[] arg) { CIELABColorSpace cs = new CIELABColorSpace(); float[] lab = cs.fromRGB(new float[]{1, 1, 1}); System.out.println("rgb->lab:" + lab[0] + "," + lab[1] + "," + lab[2]); float[] xyz = cs.toCIEXYZ(new float[]{0.75f, 0.25f, 0.1f}); System.out.println(" lab->xyz:" + xyz[0] + "," + xyz[1] + "," + xyz[2]); lab = cs.fromCIEXYZ(xyz); System.out.println("R xyz->LCHab:" + lab[0] + "," + lab[1] + "," + lab[2]); lab = cs.fromCIEXYZ(new float[]{1, 1, 1}); System.out.println("xyz->lab:" + lab[0] + "," + lab[1] + "," + lab[2]); lab = cs.fromCIEXYZ(new float[]{0.5f, 1, 1}); System.out.println("xyz->lab:" + lab[0] + "," + lab[1] + "," + lab[2]); } }

Ads help maintain this website.