1. /*

  2.  * @(#)ICC_ProfileRGB.java	1.18 00/02/02

  3.  *

  4.  * Copyright 1997-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. /**********************************************************************

  12.  **********************************************************************

  13.  **********************************************************************

  14.  *** COPYRIGHT (c) Eastman Kodak Company, 1997                      ***

  15.  *** As  an unpublished  work pursuant to Title 17 of the United    ***

  16.  *** States Code.  All rights reserved.                             ***

  17.  **********************************************************************

  18.  **********************************************************************

  19.  **********************************************************************/

  20. 

  21. package java.awt.color;

  22. 

  23. import java.awt.image.LookupTable;

  24. import sun.awt.color.ProfileDeferralInfo;

  25. 

  26. /**

  27.  *

  28.  * A subclass of the ICC_Profile class which represents profiles

  29.  * which meet the following criteria: the color space type of the

  30.  * profile is RGB and the profile includes the redColorantTag,

  31.  * greenColorantTag, blueColorantTag, redTRCTag, greenTRCTag,

  32.  * blueTRCTag, and mediaWhitePointTag tags.  Examples of this

  33.  * kind of profile are three-component matrix-based input profiles

  34.  * and RGB display profiles.  The getInstance methods in the

  35.  * ICC_Profile class will return an ICC_ProfileRGB object

  36.  * when the above conditions are met.  The advantage of this class

  37.  * is that it provides color transform matrices and lookup tables

  38.  * that Java or native methods may be able to use directly to

  39.  * optimize color conversion in some cases.

  40.  * <p>

  41.  * To transform from a device profile color space to the CIEXYZ Profile

  42.  * Connection Space, each device color component is first linearized by

  43.  * a lookup through the corresponding tone reproduction curve (TRC).

  44.  * Then the resulting linear RGB components are converted via a 3x3 matrix

  45.  * (constructed from the RGB colorants) to the CIEXYZ PCS.

  46. <pre>

  47. 

  48.                 linearR = redTRC[deviceR]

  49. 

  50.                 linearG = greenTRC[deviceG]

  51. 

  52.                 linearB = blueTRC[deviceB]

  53. 

  54.   _      _       _                                             _   _         _

  55.  [  PCSX  ]     [  redColorantX  greenColorantX  blueColorantX  ] [  linearR  ]

  56.  [        ]     [                                               ] [           ]

  57.  [  PCSY  ]  =  [  redColorantY  greenColorantY  blueColorantY  ] [  linearG  ]

  58.  [        ]     [                                               ] [           ]

  59.  [_ PCSZ _]     [_ redColorantZ  greenColorantZ  blueColorantZ _] [_ linearB _]

  60. 

  61. </pre>

  62.  * The inverse transform is done by converting PCS XYZ components to linear

  63.  * RGB components via the inverse of the above 3x3 matrix, and then converting

  64.  * linear RGB to device RGB via inverses of the TRCs.

  65.  * <p>

  66.  */

  67. 

  68. 

  69. 

  70. public class ICC_ProfileRGB

  71. extends ICC_Profile {

  72. 

  73.     /**

  74.      * To request a gamma value or TRC for the red component.

  75.      */

  76.     public static final int REDCOMPONENT = 0;

  77. 

  78.     /**

  79.      * To request a gamma value or TRC for the green component.

  80.      */

  81.     public static final int GREENCOMPONENT = 1;

  82. 

  83.     /**

  84.      * To request a gamma value or TRC for the blue component.

  85.      */

  86.     public static final int BLUECOMPONENT = 2;

  87. 

  88. 

  89.     /**

  90.      * Constructs an new ICC_ProfileRGB from a CMM ID.

  91.      */

  92.     ICC_ProfileRGB(long ID) {

  93.         super(ID);

  94.     }

  95. 

  96.     /**

  97.      * Constructs a new ICC_ProfileRGB from a ProfileDeferralInfo object.

  98.      */

  99.     ICC_ProfileRGB(ProfileDeferralInfo pdi) {

  100.         super(pdi);

  101.     }

  102. 

  103. 

  104.     /**

  105.      * Returns a float array of length 3 containing the X, Y, and Z

  106.      * components of the mediaWhitePointTag in the ICC profile.

  107.      */

  108.     public float[] getMediaWhitePoint() {

  109.         return super.getMediaWhitePoint();

  110.     }

  111. 

  112. 

  113.     /**

  114.      * Returns a 3x3 float matrix constructed from the X, Y, and Z

  115.      * components of the redColorantTag, greenColorantTag, and

  116.      * blueColorantTag in the ICC profile, as described above.

  117.      * This matrix can be used for color transforms in the forward

  118.      * direction of the profile, i.e. from the profile color space

  119.      * to the CIEXYZ PCS.

  120.      */

  121.     public float[][] getMatrix() {

  122.         float[][] theMatrix = new float[3][3];

  123.         float[] tmpMatrix;

  124. 

  125.         tmpMatrix = getXYZTag(ICC_Profile.icSigRedColorantTag);

  126.         theMatrix[0][0] = tmpMatrix[0];

  127.         theMatrix[1][0] = tmpMatrix[1];

  128.         theMatrix[2][0] = tmpMatrix[2];

  129.         tmpMatrix = getXYZTag(ICC_Profile.icSigGreenColorantTag);

  130.         theMatrix[0][1] = tmpMatrix[0];

  131.         theMatrix[1][1] = tmpMatrix[1];

  132.         theMatrix[2][1] = tmpMatrix[2];

  133.         tmpMatrix = getXYZTag(ICC_Profile.icSigBlueColorantTag);

  134.         theMatrix[0][2] = tmpMatrix[0];

  135.         theMatrix[1][2] = tmpMatrix[1];

  136.         theMatrix[2][2] = tmpMatrix[2];

  137.         return theMatrix;

  138.     }

  139. 

  140.     /**

  141.      * Returns a gamma value representing the tone reproduction curve

  142.      * (TRC) for a particular component.  Component must be one of

  143.      * REDCOMPONENT, GREENCOMPONENT, or BLUECOMPONENT.  If the profile

  144.      * represents the TRC for the corresponding component

  145.      * as a table rather than a single gamma value, then an

  146.      * exception is thrown.  In this case the actual table

  147.      * can be obtained via getTRC().  When using a gamma value,

  148.      * the linear component (R, G, or B) is computed as follows:

  149. <pre>

  150. 

  151.                                           gamma

  152.          linearComponent = deviceComponent

  153. 

  154. </pre>

  155.      * @return the gamma value as a float.

  156.      * @exception ProfileDataException if the profile does not specify

  157.      *            the corresponding TRC as a single gamma value.

  158.      */

  159.     public float getGamma(int component) {

  160.     float theGamma;

  161.     int theSignature;

  162. 

  163.         switch (component) {

  164.         case REDCOMPONENT:

  165.             theSignature = ICC_Profile.icSigRedTRCTag;

  166.             break;

  167. 

  168.         case GREENCOMPONENT:

  169.             theSignature = ICC_Profile.icSigGreenTRCTag;

  170.             break;

  171. 

  172.         case BLUECOMPONENT:

  173.             theSignature = ICC_Profile.icSigBlueTRCTag;

  174.             break;

  175. 

  176.         default:

  177.             throw new IllegalArgumentException("Must be Red, Green, or Blue");

  178.         }

  179. 

  180.         theGamma = super.getGamma(theSignature);

  181. 

  182.         return theGamma;

  183.     }

  184. 

  185.     /**

  186.      * Returns the TRC for a particular component as an array of

  187.      * shorts.  Component must be one of REDCOMPONENT, GREENCOMPONENT, or

  188.      * BLUECOMPONENT.  If the profile has specified the corresponding TRC

  189.      * as linear (gamma = 1.0) or as a simple gamma value, this method

  190.      * throws an exception, and the getGamma() method should be used

  191.      * to get the gamma value.  Otherwise the short array returned here

  192.      * represents a lookup table where the input component value

  193.      * is conceptually in the range [0.0, 1.0].  Value 0.0 maps

  194.      * to array index 0 and value 1.0 maps to array index length-1.

  195.      * Interpolation may be used to generate output values for

  196.      * input values which do not map exactly to an index in the

  197.      * array.  Output values also map linearly to the range [0.0, 1.0].

  198.      * Value 0.0 is represented by an array value of 0x0000 and

  199.      * value 1.0 by 0xFFFF, i.e. the values are really unsigned

  200.      * short values, although they are returned in a short array.

  201.      * @return a short array representing the TRC.

  202.      * @exception ProfileDataException if the profile does not specify

  203.      *            the corresponding TRC as a table.

  204.      */

  205.     public short[] getTRC(int component) {

  206.     short[] theTRC;

  207.     int theSignature;

  208. 

  209.         switch (component) {

  210.         case REDCOMPONENT:

  211.             theSignature = ICC_Profile.icSigRedTRCTag;

  212.             break;

  213. 

  214.         case GREENCOMPONENT:

  215.             theSignature = ICC_Profile.icSigGreenTRCTag;

  216.             break;

  217. 

  218.         case BLUECOMPONENT:

  219.             theSignature = ICC_Profile.icSigBlueTRCTag;

  220.             break;

  221. 

  222.         default:

  223.             throw new IllegalArgumentException("Must be Red, Green, or Blue");

  224.         }

  225. 

  226.         theTRC = super.getTRC(theSignature);

  227. 

  228.         return theTRC;

  229.     }

  230. 

  231. }

  232.