< 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 ****
*
* gamma
* 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 ----
*
* gamma
* 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 >