1 /* ICC_ProfileRGB.java -- the ICC profile for a RGB colorspace 2 Copyright (C) 2002, 2004 Free Software Foundation, Inc. 3 4 This file is part of GNU Classpath. 5 6 GNU Classpath is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 2, or (at your option) 9 any later version. 10 11 GNU Classpath is distributed in the hope that it will be useful, but 12 WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14 General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with GNU Classpath; see the file COPYING. If not, write to the 18 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 19 02110-1301 USA. 20 21 Linking this library statically or dynamically with other modules is 22 making a combined work based on this library. Thus, the terms and 23 conditions of the GNU General Public License cover the whole 24 combination. 25 26 As a special exception, the copyright holders of this library give you 27 permission to link this library with independent modules to produce an 28 executable, regardless of the license terms of these independent 29 modules, and to copy and distribute the resulting executable under 30 terms of your choice, provided that you also meet, for each linked 31 independent module, the terms and conditions of the license of that 32 module. An independent module is a module which is not derived from 33 or based on this library. If you modify this library, you may extend 34 this exception to your version of the library, but you are not 35 obligated to do so. If you do not wish to do so, delete this 36 exception statement from your version. */ 37 38 39 package java.awt.color; 40 41 /** 42 * ICC_ProfileRGB - a special case of ICC_Profiles. 43 * 44 * The ICC_Profile.getInstance() method will return an instance of the 45 * ICC_ProfileRGB subclass when all the following conditions are met: 46 * The device color space of the profile is TYPE_RGB. 47 * The profile contains red, green and blue ColorantTags. 48 * The profile contains red, green and blue TRCTags. 49 * The profile contains a mediaWhitePointTag included. 50 * 51 * As per the ICC specification, the color space conversion can then 52 * be done through the following method: 53 * linearR = redTRC[deviceR] 54 * linearG = greenTRC[deviceG] 55 * linearB = blueTRC[deviceB] 56 * TRC curves are either a single gamma value, or a 1-dimensional lookup table. 57 * 58 * Followed by the matrix transform: 59 * PCS = M*linear 60 * 61 * Where PCS is the vector of profile color space (must be XYZ) coordinates, 62 * linear is the vector of linear RGB coordinates, and the matrix M is 63 * constructed from the ColorantTags, where the columns are red, green and 64 * blue respectively, and the rows are X, Y and Z. 65 * 66 * Note that if the profile contains a CLUT for the color space conversion, 67 * it should be used instead, and the TRC information ignored. 68 * 69 * @author Sven de Marothy 70 * @since 1.2 71 */ 72 public class ICC_ProfileRGB extends ICC_Profile 73 { 74 /** 75 * Compatible with JDK 1.2+. 76 */ 77 private static final long serialVersionUID = 8505067385152579334L; 78 79 public static final int REDCOMPONENT = 0; 80 81 public static final int GREENCOMPONENT = 1; 82 83 public static final int BLUECOMPONENT = 2; 84 85 private transient float[][] matrix; 86 87 private transient float[] gamma; 88 89 private transient float[] whitePoint; 90 91 92 /** 93 * Package-private constructor used by ICC_ColorSpace for creating an 94 * ICC_ProfileRGB from a predefined ColorSpace (CS_LINEAR_RGB and CS_sRGB) 95 */ ICC_ProfileRGB(int cspace)96 ICC_ProfileRGB(int cspace) 97 { 98 super(cspace); 99 matrix = createMatrix(); 100 whitePoint = getXYZData(icSigMediaWhitePointTag); 101 } 102 103 /** 104 * Package-private constructor used by ICC_ColorSpace for creating an 105 * ICC_ProfileRGB from profile data. 106 */ ICC_ProfileRGB(byte[] data)107 ICC_ProfileRGB(byte[] data) 108 { 109 super(data); 110 matrix = createMatrix(); 111 whitePoint = getXYZData(icSigMediaWhitePointTag); 112 } 113 114 /** 115 * Returns the media white point of the profile. 116 */ getMediaWhitePoint()117 public float[] getMediaWhitePoint() 118 { 119 float[] wp = new float[3]; 120 wp[0] = whitePoint[0]; 121 wp[1] = whitePoint[1]; 122 wp[2] = whitePoint[2]; 123 return wp; 124 } 125 126 /** 127 * Returns the colorant matrix of the conversion. 128 */ getMatrix()129 public float[][] getMatrix() 130 { 131 float[][] mat = new float[3][3]; 132 for (int i = 0; i < 3; i++) 133 for (int j = 0; j < 3; j++) 134 mat[i][j] = matrix[i][j]; 135 return mat; 136 } 137 138 /** 139 * Returns the gamma value of a component 140 * @throws ProfileDataException if the TRC is described by a lookup 141 * table and not a gamma value. 142 */ getGamma(int component)143 public float getGamma(int component) 144 { 145 short[] data; 146 switch (component) 147 { 148 case REDCOMPONENT: 149 data = getCurve(icSigRedTRCTag); 150 break; 151 case GREENCOMPONENT: 152 data = getCurve(icSigGreenTRCTag); 153 break; 154 case BLUECOMPONENT: 155 data = getCurve(icSigBlueTRCTag); 156 break; 157 default: 158 throw new IllegalArgumentException("Not a valid component"); 159 } 160 if (data == null) 161 throw new IllegalArgumentException("Error reading TRC"); 162 163 if (data.length != 1) 164 throw new ProfileDataException("Not a single-gamma TRC"); 165 166 // convert the unsigned 7.8 fixed-point gamma to a float. 167 float gamma = (float) (((int) data[0] & 0xFF00) >> 8); 168 double fraction = ((int) data[0] & 0x00FF) / 256.0; 169 gamma += (float) fraction; 170 return gamma; 171 } 172 173 /** 174 * Returns the TRC lookup table for a component 175 * @throws ProfileDataException if the TRC is described by a gamma 176 * value and not a lookup table. 177 */ getTRC(int component)178 public short[] getTRC(int component) 179 { 180 short[] data; 181 switch (component) 182 { 183 case REDCOMPONENT: 184 data = getCurve(icSigRedTRCTag); 185 break; 186 case GREENCOMPONENT: 187 data = getCurve(icSigGreenTRCTag); 188 break; 189 case BLUECOMPONENT: 190 data = getCurve(icSigBlueTRCTag); 191 break; 192 default: 193 throw new IllegalArgumentException("Not a valid component"); 194 } 195 if (data == null) 196 throw new IllegalArgumentException("Error reading TRC"); 197 198 if (data.length <= 1) 199 throw new ProfileDataException("Gamma value, not a TRC table."); 200 201 return data; 202 } 203 204 /** 205 * Creates the colorspace conversion matrix from the RGB tristimulus 206 * values. 207 */ createMatrix()208 private float[][] createMatrix() throws IllegalArgumentException 209 { 210 float[][] mat = new float[3][3]; 211 float[] r; 212 float[] g; 213 float[] b; 214 r = getXYZData(icSigRedColorantTag); 215 g = getXYZData(icSigGreenColorantTag); 216 b = getXYZData(icSigBlueColorantTag); 217 if (r == null || g == null || b == null) 218 throw new IllegalArgumentException("Error reading colorant tags!"); 219 for (int i = 0; i < 3; i++) 220 { 221 mat[i][0] = r[i]; 222 mat[i][1] = g[i]; 223 mat[i][2] = b[i]; 224 } 225 return mat; 226 } 227 } // class ICC_ProfileRGB 228