1 /* 2 * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 /* ******************************************************************** 27 ********************************************************************** 28 ********************************************************************** 29 *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** 30 *** As an unpublished work pursuant to Title 17 of the United *** 31 *** States Code. All rights reserved. *** 32 ********************************************************************** 33 ********************************************************************** 34 **********************************************************************/ 35 36 package java.awt.color; 37 38 import sun.java2d.cmm.Profile; 39 import sun.java2d.cmm.ProfileDeferralInfo; 40 41 /** 42 * The {@code ICC_ProfileRGB} class is a subclass of the {@code ICC_Profile} 43 * class that represents profiles which meet the following criteria: the 44 * profile's color space type is RGB, and the profile includes the 45 * {@code redColorantTag}, {@code greenColorantTag}, {@code blueColorantTag}, 46 * {@code redTRCTag}, {@code greenTRCTag}, {@code blueTRCTag}, 47 * {@code mediaWhitePointTag} tags. The {@code getInstance} methods in the 48 * {@code ICC_Profile} class will return an {@code ICC_ProfileRGB} object when 49 * the above conditions are met. Three-component, matrix-based input profiles 50 * and RGB display profiles are examples of this type of profile. 51 * <p> 52 * The advantage of this class is that it provides color transform matrices and 53 * lookup tables that Java or native methods can use directly to optimize color 54 * conversion in some cases. 55 * <p> 56 * To transform from a device profile color space to the CIEXYZ Profile 57 * Connection Space, each device color component is first linearized by a lookup 58 * through the corresponding tone reproduction curve (TRC). The resulting linear 59 * RGB components are converted to the CIEXYZ PCS using a a 3x3 matrix 60 * constructed from the RGB colorants. 61 * <pre> 62 * 63 * linearR = redTRC[deviceR] 64 * 65 * linearG = greenTRC[deviceG] 66 * 67 * linearB = blueTRC[deviceB] 68 * 69 * _ _ _ _ _ _ 70 * [ PCSX ] [ redColorantX greenColorantX blueColorantX ] [ linearR ] 71 * [ ] [ ] [ ] 72 * [ PCSY ] = [ redColorantY greenColorantY blueColorantY ] [ linearG ] 73 * [ ] [ ] [ ] 74 * [_ PCSZ _] [_ redColorantZ greenColorantZ blueColorantZ _] [_ linearB _] 75 * 76 * </pre> 77 * The inverse transform is performed by converting PCS XYZ components to linear 78 * RGB components through the inverse of the above 3x3 matrix, and then 79 * converting linear RGB to device RGB through inverses of the TRCs. 80 */ 81 public class ICC_ProfileRGB 82 extends ICC_Profile { 83 84 static final long serialVersionUID = 8505067385152579334L; 85 86 /** 87 * Used to get a gamma value or TRC for the red component. 88 */ 89 public static final int REDCOMPONENT = 0; 90 91 /** 92 * Used to get a gamma value or TRC for the green component. 93 */ 94 public static final int GREENCOMPONENT = 1; 95 96 /** 97 * Used to get a gamma value or TRC for the blue component. 98 */ 99 public static final int BLUECOMPONENT = 2; 100 101 /** 102 * Constructs an new {@code ICC_ProfileRGB} from a CMM ID. 103 * 104 * @param p the CMM ID for the profile. 105 */ ICC_ProfileRGB(Profile p)106 ICC_ProfileRGB(Profile p) { 107 super(p); 108 } 109 110 /** 111 * Constructs a new {@code ICC_ProfileRGB} from a 112 * {@code ProfileDeferralInfo} object. 113 * 114 * @param pdi 115 */ ICC_ProfileRGB(ProfileDeferralInfo pdi)116 ICC_ProfileRGB(ProfileDeferralInfo pdi) { 117 super(pdi); 118 } 119 120 /** 121 * Returns an array that contains the components of the profile's 122 * {@code mediaWhitePointTag}. 123 * 124 * @return a 3-element {@code float} array containing the x, y, and z 125 * components of the profile's {@code mediaWhitePointTag} 126 */ getMediaWhitePoint()127 public float[] getMediaWhitePoint() { 128 return super.getMediaWhitePoint(); 129 } 130 131 /** 132 * Returns a 3x3 {@code float} matrix constructed from the X, Y, and Z 133 * components of the profile's {@code redColorantTag}, 134 * {@code greenColorantTag}, and {@code blueColorantTag}. 135 * <p> 136 * This matrix can be used for color transforms in the forward direction of 137 * the profile--from the profile color space to the CIEXYZ PCS. 138 * 139 * @return a 3x3 {@code float} array that contains the x, y, and z 140 * components of the profile's {@code redColorantTag}, 141 * {@code greenColorantTag}, and {@code blueColorantTag} 142 */ getMatrix()143 public float[][] getMatrix() { 144 float[][] theMatrix = new float[3][3]; 145 float[] tmpMatrix; 146 147 tmpMatrix = getXYZTag(ICC_Profile.icSigRedColorantTag); 148 theMatrix[0][0] = tmpMatrix[0]; 149 theMatrix[1][0] = tmpMatrix[1]; 150 theMatrix[2][0] = tmpMatrix[2]; 151 tmpMatrix = getXYZTag(ICC_Profile.icSigGreenColorantTag); 152 theMatrix[0][1] = tmpMatrix[0]; 153 theMatrix[1][1] = tmpMatrix[1]; 154 theMatrix[2][1] = tmpMatrix[2]; 155 tmpMatrix = getXYZTag(ICC_Profile.icSigBlueColorantTag); 156 theMatrix[0][2] = tmpMatrix[0]; 157 theMatrix[1][2] = tmpMatrix[1]; 158 theMatrix[2][2] = tmpMatrix[2]; 159 return theMatrix; 160 } 161 162 /** 163 * Returns a gamma value representing the tone reproduction curve (TRC) for 164 * a particular component. The component parameter must be one of 165 * {@code REDCOMPONENT}, {@code GREENCOMPONENT}, or {@code BLUECOMPONENT}. 166 * <p> 167 * If the profile represents the TRC for the corresponding component as a 168 * table rather than a single gamma value, an exception is thrown. In this 169 * case the actual table can be obtained through the {@link #getTRC(int)} 170 * method. When using a gamma value, the linear component (R, G, or B) is 171 * computed as follows: 172 * <pre> 173 * 174 * gamma 175 * linearComponent = deviceComponent 176 * 177 * </pre> 178 * 179 * @param component the {@code ICC_ProfileRGB} constant that represents the 180 * component whose TRC you want to retrieve 181 * @return the gamma value as a float 182 * @throws ProfileDataException if the profile does not specify the 183 * corresponding TRC as a single gamma value 184 */ getGamma(int component)185 public float getGamma(int component) { 186 float theGamma; 187 int theSignature; 188 189 switch (component) { 190 case REDCOMPONENT: 191 theSignature = ICC_Profile.icSigRedTRCTag; 192 break; 193 194 case GREENCOMPONENT: 195 theSignature = ICC_Profile.icSigGreenTRCTag; 196 break; 197 198 case BLUECOMPONENT: 199 theSignature = ICC_Profile.icSigBlueTRCTag; 200 break; 201 202 default: 203 throw new IllegalArgumentException("Must be Red, Green, or Blue"); 204 } 205 206 theGamma = super.getGamma(theSignature); 207 208 return theGamma; 209 } 210 211 /** 212 * Returns the TRC for a particular component as an array. Component must be 213 * {@code REDCOMPONENT}, {@code GREENCOMPONENT}, or {@code BLUECOMPONENT}. 214 * Otherwise the returned array represents a lookup table where the input 215 * component value is conceptually in the range [0.0, 1.0]. Value 0.0 maps 216 * to array index 0 and value 1.0 maps to array index {@code length-1}. 217 * Interpolation might be used to generate output values for input values 218 * that do not map exactly to an index in the array. Output values also map 219 * linearly to the range [0.0, 1.0]. Value 0.0 is represented by an array 220 * value of 0x0000 and value 1.0 by 0xFFFF. In other words, the values are 221 * really unsigned {@code short} values even though they are returned in a 222 * {@code short} array. 223 * <p> 224 * If the profile has specified the corresponding TRC as linear (gamma = 225 * 1.0) or as a simple gamma value, this method throws an exception. In this 226 * case, the {@link #getGamma(int)} method should be used to get the gamma 227 * value. 228 * 229 * @param component the {@code ICC_ProfileRGB} constant that represents the 230 * component whose TRC you want to retrieve: {@code REDCOMPONENT}, 231 * {@code GREENCOMPONENT}, or {@code BLUECOMPONENT} 232 * @return a short array representing the TRC 233 * @throws ProfileDataException if the profile does not specify the 234 * corresponding TRC as a table 235 */ getTRC(int component)236 public short[] getTRC(int component) { 237 short[] theTRC; 238 int theSignature; 239 240 switch (component) { 241 case REDCOMPONENT: 242 theSignature = ICC_Profile.icSigRedTRCTag; 243 break; 244 245 case GREENCOMPONENT: 246 theSignature = ICC_Profile.icSigGreenTRCTag; 247 break; 248 249 case BLUECOMPONENT: 250 theSignature = ICC_Profile.icSigBlueTRCTag; 251 break; 252 253 default: 254 throw new IllegalArgumentException("Must be Red, Green, or Blue"); 255 } 256 257 theTRC = super.getTRC(theSignature); 258 259 return theTRC; 260 } 261 262 } 263