+ * The advantage of this class is that it provides a lookup table that Java + * or native methods can use directly to optimize color conversion in some + * cases. *
* To transform from a GRAY device profile color space to the CIEXYZ Profile - * Connection Space, the device gray component is transformed by - * a lookup through the tone reproduction curve (TRC). The result is - * treated as the achromatic component of the PCS. -
- - PCSY = grayTRC[deviceGray] - -- * The inverse transform is done by converting the PCS Y components to - * device Gray via the inverse of the grayTRC. + * Connection Space, the device gray component is transformed by a lookup + * through the tone reproduction curve (TRC). The result is treated as the + * achromatic component of the PCS. + *
+ * + * PCSY = grayTRC[deviceGray] + * + *+ * The inverse transform is done by converting the PCS Y components to device + * Gray via the inverse of the grayTRC. */ - - - public class ICC_ProfileGray extends ICC_Profile { + /** + * Use serialVersionUID from JDK 1.2 for interoperability. + */ static final long serialVersionUID = -1124721290732002649L; /** - * Constructs a new ICC_ProfileGray from a CMM ID. + * Constructs a new {@code ICC_ProfileGray} from a CMM ID. */ ICC_ProfileGray(Profile p) { super(p); } /** - * Constructs a new ICC_ProfileGray from a ProfileDeferralInfo object. + * Constructs a new {@code ICC_ProfileGray} from a + * {@code ProfileDeferralInfo} object. */ ICC_ProfileGray(ProfileDeferralInfo pdi) { super(pdi); } - /** - * Returns a float array of length 3 containing the X, Y, and Z - * components of the mediaWhitePointTag in the ICC profile. - * @return an array containing the components of the - * mediaWhitePointTag in the ICC profile. + * Returns a float array of length 3 containing the X, Y, and Z components + * of the mediaWhitePointTag in the ICC profile. + * + * @return an array containing the components of the mediaWhitePointTag in + * the ICC profile */ public float[] getMediaWhitePoint() { return super.getMediaWhitePoint(); } - /** - * Returns a gamma value representing the tone reproduction - * curve (TRC). If the profile represents the TRC as a table rather - * than a single gamma value, then an exception is thrown. In this - * case the actual table can be obtained via getTRC(). When - * using a gamma value, the PCS Y component is computed as follows: -
- - gamma - PCSY = deviceGray - -- * @return the gamma value as a float. - * @exception ProfileDataException if the profile does not specify - * the TRC as a single gamma value. + * Returns a gamma value representing the tone reproduction curve (TRC). If + * the profile represents the TRC as a table rather than a single gamma + * value, then an exception is thrown. In this case the actual table can be + * obtained via {@code getTRC()}. When using a gamma value, the PCS Y + * component is computed as follows: + *
+ * + * gamma + * PCSY = deviceGray + * + *+ * + * @return the gamma value as a float + * @throws ProfileDataException if the profile does not specify the TRC as a + * single gamma value */ public float getGamma() { float theGamma; @@ -123,22 +123,22 @@ } /** - * Returns the TRC as an array of shorts. If the profile has - * specified the TRC as linear (gamma = 1.0) or as a simple gamma - * value, this method throws an exception, and the getGamma() method - * should be used to get the gamma value. Otherwise the short array - * returned here represents a lookup table where the input Gray 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 may be used to generate output values for - * input values which 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, i.e. the values are really unsigned - * short values, although they are returned in a short array. - * @return a short array representing the TRC. - * @exception ProfileDataException if the profile does not specify - * the TRC as a table. + * Returns the TRC as an array of shorts. If the profile has specified the + * TRC as linear (gamma = 1.0) or as a simple gamma value, this method + * throws an exception, and the {@code getGamma()} method should be used to + * get the gamma value. Otherwise the short array returned here represents a + * lookup table where the input Gray 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 {@code length-1}. Interpolation may be used to generate output + * values for input values which 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, i.e. + * the values are really unsigned short values, although they are returned + * in a short array. + * + * @return a short array representing the TRC + * @throws ProfileDataException if the profile does not specify the TRC as a + * table */ public short[] getTRC() { short[] theTRC;