Java Platform 1.2
Beta 4

Class java.awt.color.ICC_ProfileGray


public class ICC_ProfileGray
extends ICC_Profile
A subclass of the ICC_Profile class which represents profiles which meet the following criteria: the color space type of the profile is TYPE_GRAY and the profile includes the grayTRCTag and mediaWhitePointTag tags. Examples of this kind of profile are monochrome input profiles, monochrome display profiles, and monochrome output profiles. The ICC_Profile.getInstance(byte[]) method will return an ICC_ProfileGray object when the above conditions are met. The advantage of this class is that it provides a lookup table that Java or native methods may be able to 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.

Fields inherited from class java.awt.color.ICC_Profile
CLASS_ABSTRACT , CLASS_COLORSPACECONVERSION , CLASS_DEVICELINK , CLASS_DISPLAY , CLASS_INPUT , CLASS_NAMEDCOLOR , CLASS_OUTPUT , icAbsoluteColorimetric , icCurveCount , icCurveData , icHdrAttributes , icHdrCmmId , icHdrColorSpace , icHdrCreator , icHdrDate , icHdrDeviceClass , icHdrFlags , icHdrIlluminant , icHdrMagic , icHdrManufacturer , icHdrModel , icHdrPcs , icHdrPlatform , icHdrRenderingIntent , icHdrSize , icHdrVersion , icPerceptual , icRelativeColorimetric , icSaturation , icSigAbstractClass , icSigAToB0Tag , icSigAToB1Tag , icSigAToB2Tag , icSigBlueColorantTag , icSigBlueTRCTag , icSigBToA0Tag , icSigBToA1Tag , icSigBToA2Tag , icSigCalibrationDateTimeTag , icSigCharTargetTag , icSigCmyData , icSigCmykData , icSigColorSpaceClass , icSigCopyrightTag , icSigDeviceMfgDescTag , icSigDeviceModelDescTag , icSigDisplayClass , icSigGamutTag , icSigGrayData , icSigGrayTRCTag , icSigGreenColorantTag , icSigGreenTRCTag , icSigHead , icSigHlsData , icSigHsvData , icSigInputClass , icSigLabData , icSigLinkClass , icSigLuminanceTag , icSigLuvData , icSigMeasurementTag , icSigMediaBlackPointTag , icSigMediaWhitePointTag , icSigNamedColor2Tag , icSigNamedColorClass , icSigOutputClass , icSigPreview0Tag , icSigPreview1Tag , icSigPreview2Tag , icSigProfileDescriptionTag , icSigProfileSequenceDescTag , icSigPs2CRD0Tag , icSigPs2CRD1Tag , icSigPs2CRD2Tag , icSigPs2CRD3Tag , icSigPs2CSATag , icSigPs2RenderingIntentTag , icSigRedColorantTag , icSigRedTRCTag , icSigRgbData , icSigScreeningDescTag , icSigScreeningTag , icSigSpace2CLR , icSigSpace3CLR , icSigSpace4CLR , icSigSpace5CLR , icSigSpace6CLR , icSigSpace7CLR , icSigSpace8CLR , icSigSpace9CLR , icSigSpaceACLR , icSigSpaceBCLR , icSigSpaceCCLR , icSigSpaceDCLR , icSigSpaceECLR , icSigSpaceFCLR , icSigTechnologyTag , icSigUcrBgTag , icSigViewingCondDescTag , icSigViewingConditionsTag , icSigXYZData , icSigYCbCrData , icSigYxyData , icTagReserved , icTagType , icXYZNumberX
Method Summary
 float getGamma()
          Returns a gamma value representing the tone reproduction curve (TRC).
 float[] getMediaWhitePoint()
          Returns a float array of length 3 containing the X, Y, and Z components of the mediaWhitePointTag in the ICC profile.
 short[] getTRC()
          Returns the TRC as an array of shorts.
Methods inherited from class java.awt.color.ICC_Profile
finalize , getColorSpaceType , getData , getData , getInstance , getInstance , getInstance , getInstance , getMajorVersion , getMinorVersion , getNumComponents , getPCSType , getProfileClass , setData , write , write
Methods inherited from class java.lang.Object
clone , equals , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

Method Detail


public float[] getMediaWhitePoint()
Returns a float array of length 3 containing the X, Y, and Z components of the mediaWhitePointTag in the ICC profile.


public float getGamma()
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:

         PCSY = deviceGray

the gamma value as a float.
ProfileDataException - if the profile does not specify the TRC as a single gamma value.


public short[] getTRC()
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.
a short array representing the TRC.
ProfileDataException - if the profile does not specify the TRC as a table.

Java Platform 1.2
Beta 4

Submit a bug or feature
Submit comments/suggestions about new javadoc look
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.
This documentation was generated with a post-Beta4 version of Javadoc.