< prev index next >

src/java.desktop/share/classes/java/awt/color/ICC_ProfileRGB.java

Print this page

        

*** 43,59 **** * * The ICC_ProfileRGB class is a subclass of the ICC_Profile class * that represents profiles which meet the following criteria: * <ul> * <li>The profile's color space type is RGB.</li> ! * <li>The profile includes the <code>redColorantTag</code>, ! * <code>greenColorantTag</code>, <code>blueColorantTag</code>, ! * <code>redTRCTag</code>, <code>greenTRCTag</code>, ! * <code>blueTRCTag</code>, and <code>mediaWhitePointTag</code> tags.</li> * </ul> ! * The <code>ICC_Profile</code> <code>getInstance</code> method will ! * return an <code>ICC_ProfileRGB</code> object when these conditions are met. * Three-component, matrix-based input profiles and RGB display profiles are * examples of this type of profile. * <p> * This profile class provides color transform matrices and lookup tables * that Java or native methods can use directly to --- 43,59 ---- * * The ICC_ProfileRGB class is a subclass of the ICC_Profile class * that represents profiles which meet the following criteria: * <ul> * <li>The profile's color space type is RGB.</li> ! * <li>The profile includes the {@code redColorantTag}, ! * {@code greenColorantTag}, {@code blueColorantTag}, ! * {@code redTRCTag}, {@code greenTRCTag}, ! * {@code blueTRCTag}, and {@code mediaWhitePointTag} tags.</li> * </ul> ! * The {@code ICC_Profile getInstance} method will ! * return an {@code ICC_ProfileRGB} object when these conditions are met. * Three-component, matrix-based input profiles and RGB display profiles are * examples of this type of profile. * <p> * This profile class provides color transform matrices and lookup tables * that Java or native methods can use directly to
*** 107,127 **** */ public static final int BLUECOMPONENT = 2; /** ! * Constructs an new <code>ICC_ProfileRGB</code> from a CMM ID. * * @param p The CMM ID for the profile. * */ ICC_ProfileRGB(Profile p) { super(p); } /** ! * Constructs a new <code>ICC_ProfileRGB</code> from a * ProfileDeferralInfo object. * * @param pdi */ ICC_ProfileRGB(ProfileDeferralInfo pdi) { --- 107,127 ---- */ public static final int BLUECOMPONENT = 2; /** ! * Constructs an new {@code ICC_ProfileRGB} from a CMM ID. * * @param p The CMM ID for the profile. * */ ICC_ProfileRGB(Profile p) { super(p); } /** ! * Constructs a new {@code ICC_ProfileRGB} from a * ProfileDeferralInfo object. * * @param pdi */ ICC_ProfileRGB(ProfileDeferralInfo pdi) {
*** 129,160 **** } /** * Returns an array that contains the components of the profile's ! * <CODE>mediaWhitePointTag</CODE>. * ! * @return A 3-element <CODE>float</CODE> array containing the x, y, ! * and z components of the profile's <CODE>mediaWhitePointTag</CODE>. */ public float[] getMediaWhitePoint() { return super.getMediaWhitePoint(); } /** ! * Returns a 3x3 <CODE>float</CODE> matrix constructed from the ! * X, Y, and Z components of the profile's <CODE>redColorantTag</CODE>, ! * <CODE>greenColorantTag</CODE>, and <CODE>blueColorantTag</CODE>. * <p> * This matrix can be used for color transforms in the forward * direction of the profile--from the profile color space * to the CIEXYZ PCS. * ! * @return A 3x3 <CODE>float</CODE> array that contains the x, y, and z ! * components of the profile's <CODE>redColorantTag</CODE>, ! * <CODE>greenColorantTag</CODE>, and <CODE>blueColorantTag</CODE>. */ public float[][] getMatrix() { float[][] theMatrix = new float[3][3]; float[] tmpMatrix; --- 129,160 ---- } /** * Returns an array that contains the components of the profile's ! * {@code mediaWhitePointTag}. * ! * @return A 3-element {@code float} array containing the x, y, ! * and z components of the profile's {@code mediaWhitePointTag}. */ public float[] getMediaWhitePoint() { return super.getMediaWhitePoint(); } /** ! * Returns a 3x3 {@code float} matrix constructed from the ! * X, Y, and Z components of the profile's {@code redColorantTag}, ! * {@code greenColorantTag}, and {@code blueColorantTag}. * <p> * This matrix can be used for color transforms in the forward * direction of the profile--from the profile color space * to the CIEXYZ PCS. * ! * @return A 3x3 {@code float} array that contains the x, y, and z ! * components of the profile's {@code redColorantTag}, ! * {@code greenColorantTag}, and {@code blueColorantTag}. */ public float[][] getMatrix() { float[][] theMatrix = new float[3][3]; float[] tmpMatrix;
*** 189,199 **** * * &nbsp; gamma * &nbsp; linearComponent = deviceComponent * *</pre> ! * @param component The <CODE>ICC_ProfileRGB</CODE> constant that * represents the component whose TRC you want to retrieve * @return the gamma value as a float. * @exception ProfileDataException if the profile does not specify * the corresponding TRC as a single gamma value. */ --- 189,199 ---- * * &nbsp; gamma * &nbsp; linearComponent = deviceComponent * *</pre> ! * @param component The {@code ICC_ProfileRGB} constant that * represents the component whose TRC you want to retrieve * @return the gamma value as a float. * @exception ProfileDataException if the profile does not specify * the corresponding TRC as a single gamma value. */
*** 223,255 **** return theGamma; } /** * Returns the TRC for a particular component as an array. ! * Component must be <code>REDCOMPONENT</code>, ! * <code>GREENCOMPONENT</code>, or <code>BLUECOMPONENT</code>. * Otherwise the returned array * represents a lookup table where the input component value * is conceptually in the range [0.0, 1.0]. Value 0.0 maps * to array index 0 and value 1.0 maps to array index length-1. * Interpolation might be used to generate output values for * input values that do not map exactly to an index in the * array. Output values also map linearly to the range [0.0, 1.0]. * Value 0.0 is represented by an array value of 0x0000 and * value 1.0 by 0xFFFF. In other words, the values are really unsigned ! * <code>short</code> values even though they are returned in a ! * <code>short</code> array. * * If the profile has specified the corresponding TRC * as linear (gamma = 1.0) or as a simple gamma value, this method * throws an exception. In this case, the {@link #getGamma(int)} * method should be used to get the gamma value. * ! * @param component The <CODE>ICC_ProfileRGB</CODE> constant that * represents the component whose TRC you want to retrieve: ! * <CODE>REDCOMPONENT</CODE>, <CODE>GREENCOMPONENT</CODE>, or ! * <CODE>BLUECOMPONENT</CODE>. * * @return a short array representing the TRC. * @exception ProfileDataException if the profile does not specify * the corresponding TRC as a table. */ --- 223,255 ---- return theGamma; } /** * Returns the TRC for a particular component as an array. ! * Component must be {@code REDCOMPONENT}, ! * {@code GREENCOMPONENT}, or {@code BLUECOMPONENT}. * Otherwise the returned array * represents a lookup table where the input component value * is conceptually in the range [0.0, 1.0]. Value 0.0 maps * to array index 0 and value 1.0 maps to array index length-1. * Interpolation might be used to generate output values for * input values that do not map exactly to an index in the * array. Output values also map linearly to the range [0.0, 1.0]. * Value 0.0 is represented by an array value of 0x0000 and * value 1.0 by 0xFFFF. In other words, the values are really unsigned ! * {@code short} values even though they are returned in a ! * {@code short} array. * * If the profile has specified the corresponding TRC * as linear (gamma = 1.0) or as a simple gamma value, this method * throws an exception. In this case, the {@link #getGamma(int)} * method should be used to get the gamma value. * ! * @param component The {@code ICC_ProfileRGB} constant that * represents the component whose TRC you want to retrieve: ! * {@code REDCOMPONENT}, {@code GREENCOMPONENT}, or ! * {@code BLUECOMPONENT}. * * @return a short array representing the TRC. * @exception ProfileDataException if the profile does not specify * the corresponding TRC as a table. */
< prev index next >