OpenJDK 1.23 · java.awt.color.ICC_ProfileGray · APIdia, the JavaDoc alternative

The ICC_ProfileGray class is a subclass of the ICC_Profile class that 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. The getInstance methods in the ICC_Profile class will return an ICC_ProfileGray object when the above conditions are met. Examples of this kind of profile are monochrome input profiles, monochrome display profiles, and monochrome output profiles.

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.

Field Summary

Modifier and Type	Field and Description
private static final long	serialVersionUID Hides java.awt.color.ICC_Profile.serialVersionUID. Use serialVersionUID from JDK 1.2 for interoperability.

Inherited from 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 icHdrProfileID icHdrRenderingIntent icHdrSize icHdrVersion icICCAbsoluteColorimetric icMediaRelativeColorimetric icPerceptual icRelativeColorimetric icSaturation icSigAbstractClass icSigAToB0Tag icSigAToB1Tag icSigAToB2Tag icSigBlueColorantTag icSigBlueMatrixColumnTag icSigBlueTRCTag icSigBToA0Tag icSigBToA1Tag icSigBToA2Tag icSigCalibrationDateTimeTag icSigCharTargetTag icSigChromaticAdaptationTag icSigChromaticityTag icSigCmyData icSigCmykData icSigColorantOrderTag icSigColorantTableTag icSigColorSpaceClass icSigCopyrightTag icSigCrdInfoTag icSigDeviceMfgDescTag icSigDeviceModelDescTag icSigDeviceSettingsTag icSigDisplayClass icSigGamutTag icSigGrayData icSigGrayTRCTag icSigGreenColorantTag icSigGreenMatrixColumnTag icSigGreenTRCTag icSigHead icSigHlsData icSigHsvData icSigInputClass icSigLabData icSigLinkClass icSigLuminanceTag icSigLuvData icSigMeasurementTag icSigMediaBlackPointTag icSigMediaWhitePointTag icSigNamedColor2Tag icSigNamedColorClass icSigOutputClass icSigOutputResponseTag icSigPreview0Tag icSigPreview1Tag icSigPreview2Tag icSigProfileDescriptionTag icSigProfileSequenceDescTag icSigPs2CRD0Tag icSigPs2CRD1Tag icSigPs2CRD2Tag icSigPs2CRD3Tag icSigPs2CSATag icSigPs2RenderingIntentTag icSigRedColorantTag icSigRedMatrixColumnTag 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

Constructor Summary

Access	Constructor and Description
pack-priv	ICC_ProfileGray(Profile p) Constructs a new `ICC_ProfileGray` from a CMM ID.
pack-priv	ICC_ProfileGray(ProfileDeferralInfo pdi) Constructs a new `ICC_ProfileGray` from a `ProfileDeferralInfo` object.

Method Summary

Modifier and Type	Method and Description
public float	Returns: the gamma value as a float getGamma() Returns a gamma value representing the tone reproduction curve (TRC).
public float[]	Returns: an array containing the components of the mediaWhitePointTag in the ICC profile getMediaWhitePoint() Overrides java.awt.color.ICC_Profile.getMediaWhitePoint. Returns a float array of length 3 containing the X, Y, and Z components of the mediaWhitePointTag in the ICC profile.
public short[]	Returns: a short array representing the TRC getTRC() Returns the TRC as an array of shorts.

Field Detail

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.awt.color.ICC_Profile.serialVersionUID. Use serialVersionUID from JDK 1.2 for interoperability. Annotations @Serial

serialVersionUID

back to summary

private static final long serialVersionUID

Hides java.awt.color.ICC_Profile.serialVersionUID.

Use serialVersionUID from JDK 1.2 for interoperability.

Annotations

@Serial

Constructor Detail

ICC_ProfileGray	back to summary
pack-priv ICC_ProfileGray(Profile p) Constructs a new `ICC_ProfileGray` from a CMM ID.

ICC_ProfileGray	back to summary
pack-priv ICC_ProfileGray(ProfileDeferralInfo pdi) Constructs a new `ICC_ProfileGray` from a `ProfileDeferralInfo` object.

Method Detail

getGamma back to summary

getGamma	back to summary
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: gamma PCSY = deviceGray Returns:float the gamma value as a float Exceptions ProfileDataException: if the profile does not specify the TRC as a single gamma value

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:


                          gamma
         PCSY = deviceGray

Returns:float

the gamma value as a float

Exceptions

ProfileDataException:: if the profile does not specify the TRC as a single gamma value

getMediaWhitePoint	back to summary
public float[] getMediaWhitePoint() Overrides java.awt.color.ICC_Profile.getMediaWhitePoint. Returns a float array of length 3 containing the X, Y, and Z components of the mediaWhitePointTag in the ICC profile. Returns:float[] an array containing the components of the mediaWhitePointTag in the ICC profile

getMediaWhitePoint

back to summary

public float[] getMediaWhitePoint()

Overrides java.awt.color.ICC_Profile.getMediaWhitePoint.

Returns a float array of length 3 containing the X, Y, and Z components of the mediaWhitePointTag in the ICC profile.

Returns:float[]: an array containing the components of the mediaWhitePointTag in the ICC profile

getTRC back to summary

getTRC	back to summary
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. Returns:short[] a short array representing the TRC Exceptions ProfileDataException: if the profile does not specify the TRC as a table

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.

Returns:short[]

a short array representing the TRC