java.lang.Object | |
↳ | java.awt.color.ICC_Profile |
Known Direct Subclasses |
A representation of color profile data for device independent and device dependent color spaces based on the International Color Consortium Specification ICC.1:2001-12, File Format for Color Profiles, (see http://www.color.org).
An ICC_ColorSpace object can be constructed from an appropriate ICC_Profile. Typically, an ICC_ColorSpace would be associated with an ICC Profile which is either an input, display, or output profile (see the ICC specification). There are also device link, abstract, color space conversion, and named color profiles. These are less useful for tagging a color or image, but are useful for other purposes (in particular device link profiles can provide improved performance for converting from one device's color space to another's).
ICC Profiles represent transformations from the color space of the profile (e.g. a monitor) to a Profile Connection Space (PCS). Profiles of interest for tagging images or colors have a PCS which is one of the two specific device independent spaces (one CIEXYZ space and one CIELab space) defined in the ICC Profile Format Specification. Most profiles of interest either have invertible transformations or explicitly specify transformations going both directions.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | CLASS_ABSTRACT | Profile class is abstract. | |||||||||
int | CLASS_COLORSPACECONVERSION | Profile class is color space conversion. | |||||||||
int | CLASS_DEVICELINK | Profile class is device link. | |||||||||
int | CLASS_DISPLAY | Profile class is display. | |||||||||
int | CLASS_INPUT | Profile class is input. | |||||||||
int | CLASS_NAMEDCOLOR | Profile class is named color. | |||||||||
int | CLASS_OUTPUT | Profile class is output. | |||||||||
int | icAbsoluteColorimetric | ICC Profile Rendering Intent: AbsoluteColorimetric. | |||||||||
int | icCurveCount | ICC Profile Constant: curveType count. | |||||||||
int | icCurveData | ICC Profile Constant: curveType data. | |||||||||
int | icHdrAttributes | ICC Profile Header Location: device attributes. | |||||||||
int | icHdrCmmId | ICC Profile Header Location: CMM for this profile. | |||||||||
int | icHdrColorSpace | ICC Profile Header Location: color space of data. | |||||||||
int | icHdrCreator | ICC Profile Header Location: profile creator. | |||||||||
int | icHdrDate | ICC Profile Header Location: date profile was created. | |||||||||
int | icHdrDeviceClass | ICC Profile Header Location: type of profile. | |||||||||
int | icHdrFlags | ICC Profile Header Location: various bit settings. | |||||||||
int | icHdrIlluminant | ICC Profile Header Location: profile illuminant. | |||||||||
int | icHdrMagic | ICC Profile Header Location: icMagicNumber. | |||||||||
int | icHdrManufacturer | ICC Profile Header Location: device manufacturer. | |||||||||
int | icHdrModel | ICC Profile Header Location: device model number. | |||||||||
int | icHdrPcs | ICC Profile Header Location: PCS - XYZ or Lab only. | |||||||||
int | icHdrPlatform | ICC Profile Header Location: primary platform. | |||||||||
int | icHdrProfileID | ICC Profile Header Location: profile's ID. | |||||||||
int | icHdrRenderingIntent | ICC Profile Header Location: rendering intent. | |||||||||
int | icHdrSize | ICC Profile Header Location: profile size in bytes. | |||||||||
int | icHdrVersion | ICC Profile Header Location: format version number. | |||||||||
int | icICCAbsoluteColorimetric | ICC Profile Rendering Intent: ICC-AbsoluteColorimetric. | |||||||||
int | icMediaRelativeColorimetric | ICC Profile Rendering Intent: Media-RelativeColorimetric. | |||||||||
int | icPerceptual | ICC Profile Rendering Intent: Perceptual. | |||||||||
int | icRelativeColorimetric | ICC Profile Rendering Intent: RelativeColorimetric. | |||||||||
int | icSaturation | ICC Profile Rendering Intent: Saturation. | |||||||||
int | icSigAToB0Tag | ICC Profile Tag Signature: 'A2B0'. | |||||||||
int | icSigAToB1Tag | ICC Profile Tag Signature: 'A2B1'. | |||||||||
int | icSigAToB2Tag | ICC Profile Tag Signature: 'A2B2'. | |||||||||
int | icSigAbstractClass | ICC Profile Class Signature: 'abst'. | |||||||||
int | icSigBToA0Tag | ICC Profile Tag Signature: 'B2A0'. | |||||||||
int | icSigBToA1Tag | ICC Profile Tag Signature: 'B2A1'. | |||||||||
int | icSigBToA2Tag | ICC Profile Tag Signature: 'B2A2'. | |||||||||
int | icSigBlueColorantTag | ICC Profile Tag Signature: 'bXYZ'. | |||||||||
int | icSigBlueMatrixColumnTag | ICC Profile Tag Signature: 'bXYZ'. | |||||||||
int | icSigBlueTRCTag | ICC Profile Tag Signature: 'bTRC'. | |||||||||
int | icSigCalibrationDateTimeTag | ICC Profile Tag Signature: 'calt'. | |||||||||
int | icSigCharTargetTag | ICC Profile Tag Signature: 'targ'. | |||||||||
int | icSigChromaticAdaptationTag | ICC Profile Tag Signature: 'chad'. | |||||||||
int | icSigChromaticityTag | ICC Profile Tag Signature: 'chrm'. | |||||||||
int | icSigCmyData | ICC Profile Color Space Type Signature: 'CMY '. | |||||||||
int | icSigCmykData | ICC Profile Color Space Type Signature: 'CMYK'. | |||||||||
int | icSigColorSpaceClass | ICC Profile Class Signature: 'spac'. | |||||||||
int | icSigColorantOrderTag | ICC Profile Tag Signature: 'clro'. | |||||||||
int | icSigColorantTableTag | ICC Profile Tag Signature: 'clrt'. | |||||||||
int | icSigCopyrightTag | ICC Profile Tag Signature: 'cprt'. | |||||||||
int | icSigCrdInfoTag | ICC Profile Tag Signature: 'crdi'. | |||||||||
int | icSigDeviceMfgDescTag | ICC Profile Tag Signature: 'dmnd'. | |||||||||
int | icSigDeviceModelDescTag | ICC Profile Tag Signature: 'dmdd'. | |||||||||
int | icSigDeviceSettingsTag | ICC Profile Tag Signature: 'devs'. | |||||||||
int | icSigDisplayClass | ICC Profile Class Signature: 'mntr'. | |||||||||
int | icSigGamutTag | ICC Profile Tag Signature: 'gamt'. | |||||||||
int | icSigGrayData | ICC Profile Color Space Type Signature: 'GRAY'. | |||||||||
int | icSigGrayTRCTag | ICC Profile Tag Signature: 'kTRC'. | |||||||||
int | icSigGreenColorantTag | ICC Profile Tag Signature: 'gXYZ'. | |||||||||
int | icSigGreenMatrixColumnTag | ICC Profile Tag Signature: 'gXYZ'. | |||||||||
int | icSigGreenTRCTag | ICC Profile Tag Signature: 'gTRC'. | |||||||||
int | icSigHead | ICC Profile Tag Signature: 'head' - special. | |||||||||
int | icSigHlsData | ICC Profile Color Space Type Signature: 'HLS'. | |||||||||
int | icSigHsvData | ICC Profile Color Space Type Signature: 'HSV'. | |||||||||
int | icSigInputClass | ICC Profile Class Signature: 'scnr'. | |||||||||
int | icSigLabData | ICC Profile Color Space Type Signature: 'Lab '. | |||||||||
int | icSigLinkClass | ICC Profile Class Signature: 'link'. | |||||||||
int | icSigLuminanceTag | ICC Profile Tag Signature: 'lumi'. | |||||||||
int | icSigLuvData | ICC Profile Color Space Type Signature: 'Luv '. | |||||||||
int | icSigMeasurementTag | ICC Profile Tag Signature: 'meas'. | |||||||||
int | icSigMediaBlackPointTag | ICC Profile Tag Signature: 'bkpt'. | |||||||||
int | icSigMediaWhitePointTag | ICC Profile Tag Signature: 'wtpt'. | |||||||||
int | icSigNamedColor2Tag | ICC Profile Tag Signature: 'ncl2'. | |||||||||
int | icSigNamedColorClass | ICC Profile Class Signature: 'nmcl'. | |||||||||
int | icSigOutputClass | ICC Profile Class Signature: 'prtr'. | |||||||||
int | icSigOutputResponseTag | ICC Profile Tag Signature: 'resp'. | |||||||||
int | icSigPreview0Tag | ICC Profile Tag Signature: 'pre0'. | |||||||||
int | icSigPreview1Tag | ICC Profile Tag Signature: 'pre1'. | |||||||||
int | icSigPreview2Tag | ICC Profile Tag Signature: 'pre2'. | |||||||||
int | icSigProfileDescriptionTag | ICC Profile Tag Signature: 'desc'. | |||||||||
int | icSigProfileSequenceDescTag | ICC Profile Tag Signature: 'pseq'. | |||||||||
int | icSigPs2CRD0Tag | ICC Profile Tag Signature: 'psd0'. | |||||||||
int | icSigPs2CRD1Tag | ICC Profile Tag Signature: 'psd1'. | |||||||||
int | icSigPs2CRD2Tag | ICC Profile Tag Signature: 'psd2'. | |||||||||
int | icSigPs2CRD3Tag | ICC Profile Tag Signature: 'psd3'. | |||||||||
int | icSigPs2CSATag | ICC Profile Tag Signature: 'ps2s'. | |||||||||
int | icSigPs2RenderingIntentTag | ICC Profile Tag Signature: 'ps2i'. | |||||||||
int | icSigRedColorantTag | ICC Profile Tag Signature: 'rXYZ'. | |||||||||
int | icSigRedMatrixColumnTag | ICC Profile Tag Signature: 'rXYZ'. | |||||||||
int | icSigRedTRCTag | ICC Profile Tag Signature: 'rTRC'. | |||||||||
int | icSigRgbData | ICC Profile Color Space Type Signature: 'RGB '. | |||||||||
int | icSigScreeningDescTag | ICC Profile Tag Signature: 'scrd'. | |||||||||
int | icSigScreeningTag | ICC Profile Tag Signature: 'scrn'. | |||||||||
int | icSigSpace2CLR | ICC Profile Color Space Type Signature: '2CLR'. | |||||||||
int | icSigSpace3CLR | ICC Profile Color Space Type Signature: '3CLR'. | |||||||||
int | icSigSpace4CLR | ICC Profile Color Space Type Signature: '4CLR'. | |||||||||
int | icSigSpace5CLR | ICC Profile Color Space Type Signature: '5CLR'. | |||||||||
int | icSigSpace6CLR | ICC Profile Color Space Type Signature: '6CLR'. | |||||||||
int | icSigSpace7CLR | ICC Profile Color Space Type Signature: '7CLR'. | |||||||||
int | icSigSpace8CLR | ICC Profile Color Space Type Signature: '8CLR'. | |||||||||
int | icSigSpace9CLR | ICC Profile Color Space Type Signature: '9CLR'. | |||||||||
int | icSigSpaceACLR | ICC Profile Color Space Type Signature: 'ACLR'. | |||||||||
int | icSigSpaceBCLR | ICC Profile Color Space Type Signature: 'BCLR'. | |||||||||
int | icSigSpaceCCLR | ICC Profile Color Space Type Signature: 'CCLR'. | |||||||||
int | icSigSpaceDCLR | ICC Profile Color Space Type Signature: 'DCLR'. | |||||||||
int | icSigSpaceECLR | ICC Profile Color Space Type Signature: 'ECLR'. | |||||||||
int | icSigSpaceFCLR | ICC Profile Color Space Type Signature: 'FCLR'. | |||||||||
int | icSigTechnologyTag | ICC Profile Tag Signature: 'tech'. | |||||||||
int | icSigUcrBgTag | ICC Profile Tag Signature: 'bfd '. | |||||||||
int | icSigViewingCondDescTag | ICC Profile Tag Signature: 'vued'. | |||||||||
int | icSigViewingConditionsTag | ICC Profile Tag Signature: 'view'. | |||||||||
int | icSigXYZData | ICC Profile Color Space Type Signature: 'XYZ '. | |||||||||
int | icSigYCbCrData | ICC Profile Color Space Type Signature: 'YCbr'. | |||||||||
int | icSigYxyData | ICC Profile Color Space Type Signature: 'Yxy '. | |||||||||
int | icTagReserved | ICC Profile Constant: reserved. | |||||||||
int | icTagType | ICC Profile Constant: tag type signaturE. | |||||||||
int | icXYZNumberX | ICC Profile Constant: XYZNumber X. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns the color space type.
| |||||||||||
Returns a particular tagged data element from the profile as
a byte array.
| |||||||||||
Returns a byte array corresponding to the data of this ICC_Profile.
| |||||||||||
Constructs an ICC_Profile corresponding to the data in an InputStream.
| |||||||||||
Constructs an ICC_Profile object corresponding to the data in
a byte array.
| |||||||||||
Constructs an ICC_Profile corresponding to the data in a file.
| |||||||||||
Constructs an ICC_Profile corresponding to one of the specific color
spaces defined by the ColorSpace class (for example CS_sRGB).
| |||||||||||
Returns profile major version.
| |||||||||||
Returns profile minor version.
| |||||||||||
Returns the number of color components in the "input" color
space of this profile.
| |||||||||||
Returns the color space type of the Profile Connection Space (PCS).
| |||||||||||
Returns the profile class.
| |||||||||||
Sets a particular tagged data element in the profile from
a byte array.
| |||||||||||
Write this ICC_Profile to a file.
| |||||||||||
Write this ICC_Profile to an OutputStream.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Frees the resources associated with an ICC_Profile object.
| |||||||||||
Resolves instances being deserialized into instances registered
with CMM.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Profile class is abstract.
Profile class is color space conversion.
Profile class is device link.
Profile class is display.
Profile class is input.
Profile class is named color.
Profile class is output.
ICC Profile Rendering Intent: AbsoluteColorimetric.
ICC Profile Constant: curveType count.
ICC Profile Constant: curveType data.
ICC Profile Header Location: device attributes.
ICC Profile Header Location: CMM for this profile.
ICC Profile Header Location: color space of data.
ICC Profile Header Location: profile creator.
ICC Profile Header Location: date profile was created.
ICC Profile Header Location: type of profile.
ICC Profile Header Location: various bit settings.
ICC Profile Header Location: profile illuminant.
ICC Profile Header Location: icMagicNumber.
ICC Profile Header Location: device manufacturer.
ICC Profile Header Location: device model number.
ICC Profile Header Location: PCS - XYZ or Lab only.
ICC Profile Header Location: primary platform.
ICC Profile Header Location: profile's ID.
ICC Profile Header Location: rendering intent.
ICC Profile Header Location: profile size in bytes.
ICC Profile Header Location: format version number.
ICC Profile Rendering Intent: ICC-AbsoluteColorimetric.
ICC Profile Rendering Intent: Media-RelativeColorimetric.
ICC Profile Rendering Intent: Perceptual.
ICC Profile Rendering Intent: RelativeColorimetric.
ICC Profile Rendering Intent: Saturation.
ICC Profile Tag Signature: 'A2B0'.
ICC Profile Tag Signature: 'A2B1'.
ICC Profile Tag Signature: 'A2B2'.
ICC Profile Class Signature: 'abst'.
ICC Profile Tag Signature: 'B2A0'.
ICC Profile Tag Signature: 'B2A1'.
ICC Profile Tag Signature: 'B2A2'.
ICC Profile Tag Signature: 'bXYZ'.
ICC Profile Tag Signature: 'bXYZ'.
ICC Profile Tag Signature: 'bTRC'.
ICC Profile Tag Signature: 'calt'.
ICC Profile Tag Signature: 'targ'.
ICC Profile Tag Signature: 'chad'.
ICC Profile Tag Signature: 'chrm'.
ICC Profile Color Space Type Signature: 'CMY '.
ICC Profile Color Space Type Signature: 'CMYK'.
ICC Profile Class Signature: 'spac'.
ICC Profile Tag Signature: 'clro'.
ICC Profile Tag Signature: 'clrt'.
ICC Profile Tag Signature: 'cprt'.
ICC Profile Tag Signature: 'crdi'.
ICC Profile Tag Signature: 'dmnd'.
ICC Profile Tag Signature: 'dmdd'.
ICC Profile Tag Signature: 'devs'.
ICC Profile Class Signature: 'mntr'.
ICC Profile Tag Signature: 'gamt'.
ICC Profile Color Space Type Signature: 'GRAY'.
ICC Profile Tag Signature: 'kTRC'.
ICC Profile Tag Signature: 'gXYZ'.
ICC Profile Tag Signature: 'gXYZ'.
ICC Profile Tag Signature: 'gTRC'.
ICC Profile Tag Signature: 'head' - special.
ICC Profile Color Space Type Signature: 'HLS'.
ICC Profile Color Space Type Signature: 'HSV'.
ICC Profile Class Signature: 'scnr'.
ICC Profile Color Space Type Signature: 'Lab '.
ICC Profile Class Signature: 'link'.
ICC Profile Tag Signature: 'lumi'.
ICC Profile Color Space Type Signature: 'Luv '.
ICC Profile Tag Signature: 'meas'.
ICC Profile Tag Signature: 'bkpt'.
ICC Profile Tag Signature: 'wtpt'.
ICC Profile Tag Signature: 'ncl2'.
ICC Profile Class Signature: 'nmcl'.
ICC Profile Class Signature: 'prtr'.
ICC Profile Tag Signature: 'resp'.
ICC Profile Tag Signature: 'pre0'.
ICC Profile Tag Signature: 'pre1'.
ICC Profile Tag Signature: 'pre2'.
ICC Profile Tag Signature: 'desc'.
ICC Profile Tag Signature: 'pseq'.
ICC Profile Tag Signature: 'psd0'.
ICC Profile Tag Signature: 'psd1'.
ICC Profile Tag Signature: 'psd2'.
ICC Profile Tag Signature: 'psd3'.
ICC Profile Tag Signature: 'ps2s'.
ICC Profile Tag Signature: 'ps2i'.
ICC Profile Tag Signature: 'rXYZ'.
ICC Profile Tag Signature: 'rXYZ'.
ICC Profile Tag Signature: 'rTRC'.
ICC Profile Color Space Type Signature: 'RGB '.
ICC Profile Tag Signature: 'scrd'.
ICC Profile Tag Signature: 'scrn'.
ICC Profile Color Space Type Signature: '2CLR'.
ICC Profile Color Space Type Signature: '3CLR'.
ICC Profile Color Space Type Signature: '4CLR'.
ICC Profile Color Space Type Signature: '5CLR'.
ICC Profile Color Space Type Signature: '6CLR'.
ICC Profile Color Space Type Signature: '7CLR'.
ICC Profile Color Space Type Signature: '8CLR'.
ICC Profile Color Space Type Signature: '9CLR'.
ICC Profile Color Space Type Signature: 'ACLR'.
ICC Profile Color Space Type Signature: 'BCLR'.
ICC Profile Color Space Type Signature: 'CCLR'.
ICC Profile Color Space Type Signature: 'DCLR'.
ICC Profile Color Space Type Signature: 'ECLR'.
ICC Profile Color Space Type Signature: 'FCLR'.
ICC Profile Tag Signature: 'tech'.
ICC Profile Tag Signature: 'bfd '.
ICC Profile Tag Signature: 'vued'.
ICC Profile Tag Signature: 'view'.
ICC Profile Color Space Type Signature: 'XYZ '.
ICC Profile Color Space Type Signature: 'YCbr'.
ICC Profile Color Space Type Signature: 'Yxy '.
ICC Profile Constant: reserved.
ICC Profile Constant: tag type signaturE.
ICC Profile Constant: XYZNumber X.
Returns the color space type. Returns one of the color space type constants defined by the ColorSpace class. This is the "input" color space of the profile. The type defines the number of components of the color space and the interpretation, e.g. TYPE_RGB identifies a color space with three components - red, green, and blue. It does not define the particular color characteristics of the space, e.g. the chromaticities of the primaries.
ColorSpace
class.
Returns a particular tagged data element from the profile as a byte array. Elements are identified by signatures as defined in the ICC specification. The signature icSigHead can be used to get the header. This method is useful for advanced applets or applications which need to access profile data directly.
tagSignature | The ICC tag signature for the data element you want to get. |
---|
null
if the specified tag doesn't exist.Returns a byte array corresponding to the data of this ICC_Profile.
Constructs an ICC_Profile corresponding to the data in an InputStream. This method throws an IllegalArgumentException if the stream does not contain valid ICC Profile data. It throws an IOException if an I/O error occurs while reading the stream.
s | The input stream from which to read the profile data. |
---|
ICC_Profile
object corresponding to the
data in the specified InputStream
.IOException | If an I/O error occurs while reading the stream. |
---|---|
IllegalArgumentException | If the stream does not contain valid ICC Profile data. |
Constructs an ICC_Profile object corresponding to the data in a byte array. Throws an IllegalArgumentException if the data does not correspond to a valid ICC Profile.
data | the specified ICC Profile data |
---|
ICC_Profile
object corresponding to
the data in the specified data
array.
Constructs an ICC_Profile corresponding to the data in a file. fileName may be an absolute or a relative file specification. Relative file names are looked for in several places: first, relative to any directories specified by the java.iccprofile.path property; second, relative to any directories specified by the java.class.path property; finally, in a directory used to store profiles always available, such as the profile for sRGB. Built-in profiles use .pf as the file name extension for profiles, e.g. sRGB.pf. This method throws an IOException if the specified file cannot be opened or if an I/O error occurs while reading the file. It throws an IllegalArgumentException if the file does not contain valid ICC Profile data.
fileName | The file that contains the data for the profile. |
---|
ICC_Profile
object corresponding to
the data in the specified file.IOException | If the specified file cannot be opened or an I/O error occurs while reading the file. |
---|---|
IllegalArgumentException | If the file does not contain valid ICC Profile data. |
SecurityException | If a security manager is installed and it does not permit read access to the given file. |
Constructs an ICC_Profile corresponding to one of the specific color spaces defined by the ColorSpace class (for example CS_sRGB). Throws an IllegalArgumentException if cspace is not one of the defined color spaces.
cspace | the type of color space to create a profile for.
The specified type is one of the color
space constants defined in the ColorSpace class. |
---|
ICC_Profile
object corresponding to
the specified ColorSpace
type.IllegalArgumentException | If cspace is not
one of the predefined color space types.
|
---|
Returns profile major version.
Returns profile minor version.
Returns the number of color components in the "input" color space of this profile. For example if the color space type of this profile is TYPE_RGB, then this method will return 3.
ProfileDataException | if color space is in the profile is invalid |
---|
Returns the color space type of the Profile Connection Space (PCS). Returns one of the color space type constants defined by the ColorSpace class. This is the "output" color space of the profile. For an input, display, or output profile useful for tagging colors or images, this will be either TYPE_XYZ or TYPE_Lab and should be interpreted as the corresponding specific color space defined in the ICC specification. For a device link profile, this could be any of the color space type constants.
ColorSpace
class.
Returns the profile class.
Sets a particular tagged data element in the profile from a byte array. This method is useful for advanced applets or applications which need to access profile data directly.
tagSignature | The ICC tag signature for the data element you want to set. |
---|---|
tagData | the data to set for the specified tag signature |
Write this ICC_Profile to a file.
fileName | The file to write the profile data to. |
---|
IOException | If the file cannot be opened for writing or an I/O error occurs while writing to the file. |
---|
Write this ICC_Profile to an OutputStream.
s | The stream to write the profile data to. |
---|
IOException | If an I/O error occurs while writing to the stream. |
---|
Frees the resources associated with an ICC_Profile object.
Resolves instances being deserialized into instances registered with CMM.
ObjectStreamException | never thrown, but mandated by the serialization spec. |
---|