public class ICC_Profile extends Object implements Serializable
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.
ICC_ColorSpace, 
Serialized Form| Modifier and Type | Field and Description | 
|---|---|
| static int | CLASS_ABSTRACTProfile class is abstract. | 
| static int | CLASS_COLORSPACECONVERSIONProfile class is color space conversion. | 
| static int | CLASS_DEVICELINKProfile class is device link. | 
| static int | CLASS_DISPLAYProfile class is display. | 
| static int | CLASS_INPUTProfile class is input. | 
| static int | CLASS_NAMEDCOLORProfile class is named color. | 
| static int | CLASS_OUTPUTProfile class is output. | 
| static int | icAbsoluteColorimetricICC Profile Rendering Intent: AbsoluteColorimetric. | 
| static int | icCurveCountICC Profile Constant: curveType count. | 
| static int | icCurveDataICC Profile Constant: curveType data. | 
| static int | icHdrAttributesICC Profile Header Location: device attributes. | 
| static int | icHdrCmmIdICC Profile Header Location: CMM for this profile. | 
| static int | icHdrColorSpaceICC Profile Header Location: color space of data. | 
| static int | icHdrCreatorICC Profile Header Location: profile creator. | 
| static int | icHdrDateICC Profile Header Location: date profile was created. | 
| static int | icHdrDeviceClassICC Profile Header Location: type of profile. | 
| static int | icHdrFlagsICC Profile Header Location: various bit settings. | 
| static int | icHdrIlluminantICC Profile Header Location: profile illuminant. | 
| static int | icHdrMagicICC Profile Header Location: icMagicNumber. | 
| static int | icHdrManufacturerICC Profile Header Location: device manufacturer. | 
| static int | icHdrModelICC Profile Header Location: device model number. | 
| static int | icHdrPcsICC Profile Header Location: PCS - XYZ or Lab only. | 
| static int | icHdrPlatformICC Profile Header Location: primary platform. | 
| static int | icHdrProfileIDICC Profile Header Location: profile's ID. | 
| static int | icHdrRenderingIntentICC Profile Header Location: rendering intent. | 
| static int | icHdrSizeICC Profile Header Location: profile size in bytes. | 
| static int | icHdrVersionICC Profile Header Location: format version number. | 
| static int | icICCAbsoluteColorimetricICC Profile Rendering Intent: ICC-AbsoluteColorimetric. | 
| static int | icMediaRelativeColorimetricICC Profile Rendering Intent: Media-RelativeColorimetric. | 
| static int | icPerceptualICC Profile Rendering Intent: Perceptual. | 
| static int | icRelativeColorimetricICC Profile Rendering Intent: RelativeColorimetric. | 
| static int | icSaturationICC Profile Rendering Intent: Saturation. | 
| static int | icSigAbstractClassICC Profile Class Signature: 'abst'. | 
| static int | icSigAToB0TagICC Profile Tag Signature: 'A2B0'. | 
| static int | icSigAToB1TagICC Profile Tag Signature: 'A2B1'. | 
| static int | icSigAToB2TagICC Profile Tag Signature: 'A2B2'. | 
| static int | icSigBlueColorantTagICC Profile Tag Signature: 'bXYZ'. | 
| static int | icSigBlueMatrixColumnTagICC Profile Tag Signature: 'bXYZ'. | 
| static int | icSigBlueTRCTagICC Profile Tag Signature: 'bTRC'. | 
| static int | icSigBToA0TagICC Profile Tag Signature: 'B2A0'. | 
| static int | icSigBToA1TagICC Profile Tag Signature: 'B2A1'. | 
| static int | icSigBToA2TagICC Profile Tag Signature: 'B2A2'. | 
| static int | icSigCalibrationDateTimeTagICC Profile Tag Signature: 'calt'. | 
| static int | icSigCharTargetTagICC Profile Tag Signature: 'targ'. | 
| static int | icSigChromaticAdaptationTagICC Profile Tag Signature: 'chad'. | 
| static int | icSigChromaticityTagICC Profile Tag Signature: 'chrm'. | 
| static int | icSigCmyDataICC Profile Color Space Type Signature: 'CMY '. | 
| static int | icSigCmykDataICC Profile Color Space Type Signature: 'CMYK'. | 
| static int | icSigColorantOrderTagICC Profile Tag Signature: 'clro'. | 
| static int | icSigColorantTableTagICC Profile Tag Signature: 'clrt'. | 
| static int | icSigColorSpaceClassICC Profile Class Signature: 'spac'. | 
| static int | icSigCopyrightTagICC Profile Tag Signature: 'cprt'. | 
| static int | icSigCrdInfoTagICC Profile Tag Signature: 'crdi'. | 
| static int | icSigDeviceMfgDescTagICC Profile Tag Signature: 'dmnd'. | 
| static int | icSigDeviceModelDescTagICC Profile Tag Signature: 'dmdd'. | 
| static int | icSigDeviceSettingsTagICC Profile Tag Signature: 'devs'. | 
| static int | icSigDisplayClassICC Profile Class Signature: 'mntr'. | 
| static int | icSigGamutTagICC Profile Tag Signature: 'gamt'. | 
| static int | icSigGrayDataICC Profile Color Space Type Signature: 'GRAY'. | 
| static int | icSigGrayTRCTagICC Profile Tag Signature: 'kTRC'. | 
| static int | icSigGreenColorantTagICC Profile Tag Signature: 'gXYZ'. | 
| static int | icSigGreenMatrixColumnTagICC Profile Tag Signature: 'gXYZ'. | 
| static int | icSigGreenTRCTagICC Profile Tag Signature: 'gTRC'. | 
| static int | icSigHeadICC Profile Tag Signature: 'head' - special. | 
| static int | icSigHlsDataICC Profile Color Space Type Signature: 'HLS'. | 
| static int | icSigHsvDataICC Profile Color Space Type Signature: 'HSV'. | 
| static int | icSigInputClassICC Profile Class Signature: 'scnr'. | 
| static int | icSigLabDataICC Profile Color Space Type Signature: 'Lab '. | 
| static int | icSigLinkClassICC Profile Class Signature: 'link'. | 
| static int | icSigLuminanceTagICC Profile Tag Signature: 'lumi'. | 
| static int | icSigLuvDataICC Profile Color Space Type Signature: 'Luv '. | 
| static int | icSigMeasurementTagICC Profile Tag Signature: 'meas'. | 
| static int | icSigMediaBlackPointTagICC Profile Tag Signature: 'bkpt'. | 
| static int | icSigMediaWhitePointTagICC Profile Tag Signature: 'wtpt'. | 
| static int | icSigNamedColor2TagICC Profile Tag Signature: 'ncl2'. | 
| static int | icSigNamedColorClassICC Profile Class Signature: 'nmcl'. | 
| static int | icSigOutputClassICC Profile Class Signature: 'prtr'. | 
| static int | icSigOutputResponseTagICC Profile Tag Signature: 'resp'. | 
| static int | icSigPreview0TagICC Profile Tag Signature: 'pre0'. | 
| static int | icSigPreview1TagICC Profile Tag Signature: 'pre1'. | 
| static int | icSigPreview2TagICC Profile Tag Signature: 'pre2'. | 
| static int | icSigProfileDescriptionTagICC Profile Tag Signature: 'desc'. | 
| static int | icSigProfileSequenceDescTagICC Profile Tag Signature: 'pseq'. | 
| static int | icSigPs2CRD0TagICC Profile Tag Signature: 'psd0'. | 
| static int | icSigPs2CRD1TagICC Profile Tag Signature: 'psd1'. | 
| static int | icSigPs2CRD2TagICC Profile Tag Signature: 'psd2'. | 
| static int | icSigPs2CRD3TagICC Profile Tag Signature: 'psd3'. | 
| static int | icSigPs2CSATagICC Profile Tag Signature: 'ps2s'. | 
| static int | icSigPs2RenderingIntentTagICC Profile Tag Signature: 'ps2i'. | 
| static int | icSigRedColorantTagICC Profile Tag Signature: 'rXYZ'. | 
| static int | icSigRedMatrixColumnTagICC Profile Tag Signature: 'rXYZ'. | 
| static int | icSigRedTRCTagICC Profile Tag Signature: 'rTRC'. | 
| static int | icSigRgbDataICC Profile Color Space Type Signature: 'RGB '. | 
| static int | icSigScreeningDescTagICC Profile Tag Signature: 'scrd'. | 
| static int | icSigScreeningTagICC Profile Tag Signature: 'scrn'. | 
| static int | icSigSpace2CLRICC Profile Color Space Type Signature: '2CLR'. | 
| static int | icSigSpace3CLRICC Profile Color Space Type Signature: '3CLR'. | 
| static int | icSigSpace4CLRICC Profile Color Space Type Signature: '4CLR'. | 
| static int | icSigSpace5CLRICC Profile Color Space Type Signature: '5CLR'. | 
| static int | icSigSpace6CLRICC Profile Color Space Type Signature: '6CLR'. | 
| static int | icSigSpace7CLRICC Profile Color Space Type Signature: '7CLR'. | 
| static int | icSigSpace8CLRICC Profile Color Space Type Signature: '8CLR'. | 
| static int | icSigSpace9CLRICC Profile Color Space Type Signature: '9CLR'. | 
| static int | icSigSpaceACLRICC Profile Color Space Type Signature: 'ACLR'. | 
| static int | icSigSpaceBCLRICC Profile Color Space Type Signature: 'BCLR'. | 
| static int | icSigSpaceCCLRICC Profile Color Space Type Signature: 'CCLR'. | 
| static int | icSigSpaceDCLRICC Profile Color Space Type Signature: 'DCLR'. | 
| static int | icSigSpaceECLRICC Profile Color Space Type Signature: 'ECLR'. | 
| static int | icSigSpaceFCLRICC Profile Color Space Type Signature: 'FCLR'. | 
| static int | icSigTechnologyTagICC Profile Tag Signature: 'tech'. | 
| static int | icSigUcrBgTagICC Profile Tag Signature: 'bfd '. | 
| static int | icSigViewingCondDescTagICC Profile Tag Signature: 'vued'. | 
| static int | icSigViewingConditionsTagICC Profile Tag Signature: 'view'. | 
| static int | icSigXYZDataICC Profile Color Space Type Signature: 'XYZ '. | 
| static int | icSigYCbCrDataICC Profile Color Space Type Signature: 'YCbr'. | 
| static int | icSigYxyDataICC Profile Color Space Type Signature: 'Yxy '. | 
| static int | icTagReservedICC Profile Constant: reserved. | 
| static int | icTagTypeICC Profile Constant: tag type signaturE. | 
| static int | icXYZNumberXICC Profile Constant: XYZNumber X. | 
| Modifier and Type | Method and Description | 
|---|---|
| protected void | finalize()Frees the resources associated with an ICC_Profile object. | 
| int | getColorSpaceType()Returns the color space type. | 
| byte[] | getData()Returns a byte array corresponding to the data of this ICC_Profile. | 
| byte[] | getData(int tagSignature)Returns a particular tagged data element from the profile as
 a byte array. | 
| static ICC_Profile | getInstance(byte[] data)Constructs an ICC_Profile object corresponding to the data in
 a byte array. | 
| static ICC_Profile | getInstance(InputStream s)Constructs an ICC_Profile corresponding to the data in an InputStream. | 
| static ICC_Profile | getInstance(int cspace)Constructs an ICC_Profile corresponding to one of the specific color
 spaces defined by the ColorSpace class (for example CS_sRGB). | 
| static ICC_Profile | getInstance(String fileName)Constructs an ICC_Profile corresponding to the data in a file. | 
| int | getMajorVersion()Returns profile major version. | 
| int | getMinorVersion()Returns profile minor version. | 
| int | getNumComponents()Returns the number of color components in the "input" color
 space of this profile. | 
| int | getPCSType()Returns the color space type of the Profile Connection Space (PCS). | 
| int | getProfileClass()Returns the profile class. | 
| protected Object | readResolve()Resolves instances being deserialized into instances registered
 with CMM. | 
| void | setData(int tagSignature,
       byte[] tagData)Sets a particular tagged data element in the profile from
 a byte array. | 
| void | write(OutputStream s)Write this ICC_Profile to an OutputStream. | 
| void | write(String fileName)Write this ICC_Profile to a file. | 
public static final int CLASS_INPUT
public static final int CLASS_DISPLAY
public static final int CLASS_OUTPUT
public static final int CLASS_DEVICELINK
public static final int CLASS_COLORSPACECONVERSION
public static final int CLASS_ABSTRACT
public static final int CLASS_NAMEDCOLOR
public static final int icSigXYZData
public static final int icSigLabData
public static final int icSigLuvData
public static final int icSigYCbCrData
public static final int icSigYxyData
public static final int icSigRgbData
public static final int icSigGrayData
public static final int icSigHsvData
public static final int icSigHlsData
public static final int icSigCmykData
public static final int icSigCmyData
public static final int icSigSpace2CLR
public static final int icSigSpace3CLR
public static final int icSigSpace4CLR
public static final int icSigSpace5CLR
public static final int icSigSpace6CLR
public static final int icSigSpace7CLR
public static final int icSigSpace8CLR
public static final int icSigSpace9CLR
public static final int icSigSpaceACLR
public static final int icSigSpaceBCLR
public static final int icSigSpaceCCLR
public static final int icSigSpaceDCLR
public static final int icSigSpaceECLR
public static final int icSigSpaceFCLR
public static final int icSigInputClass
public static final int icSigDisplayClass
public static final int icSigOutputClass
public static final int icSigLinkClass
public static final int icSigAbstractClass
public static final int icSigColorSpaceClass
public static final int icSigNamedColorClass
public static final int icPerceptual
public static final int icRelativeColorimetric
public static final int icMediaRelativeColorimetric
public static final int icSaturation
public static final int icAbsoluteColorimetric
public static final int icICCAbsoluteColorimetric
public static final int icSigHead
public static final int icSigAToB0Tag
public static final int icSigAToB1Tag
public static final int icSigAToB2Tag
public static final int icSigBlueColorantTag
public static final int icSigBlueMatrixColumnTag
public static final int icSigBlueTRCTag
public static final int icSigBToA0Tag
public static final int icSigBToA1Tag
public static final int icSigBToA2Tag
public static final int icSigCalibrationDateTimeTag
public static final int icSigCharTargetTag
public static final int icSigCopyrightTag
public static final int icSigCrdInfoTag
public static final int icSigDeviceMfgDescTag
public static final int icSigDeviceModelDescTag
public static final int icSigDeviceSettingsTag
public static final int icSigGamutTag
public static final int icSigGrayTRCTag
public static final int icSigGreenColorantTag
public static final int icSigGreenMatrixColumnTag
public static final int icSigGreenTRCTag
public static final int icSigLuminanceTag
public static final int icSigMeasurementTag
public static final int icSigMediaBlackPointTag
public static final int icSigMediaWhitePointTag
public static final int icSigNamedColor2Tag
public static final int icSigOutputResponseTag
public static final int icSigPreview0Tag
public static final int icSigPreview1Tag
public static final int icSigPreview2Tag
public static final int icSigProfileDescriptionTag
public static final int icSigProfileSequenceDescTag
public static final int icSigPs2CRD0Tag
public static final int icSigPs2CRD1Tag
public static final int icSigPs2CRD2Tag
public static final int icSigPs2CRD3Tag
public static final int icSigPs2CSATag
public static final int icSigPs2RenderingIntentTag
public static final int icSigRedColorantTag
public static final int icSigRedMatrixColumnTag
public static final int icSigRedTRCTag
public static final int icSigScreeningDescTag
public static final int icSigScreeningTag
public static final int icSigTechnologyTag
public static final int icSigUcrBgTag
public static final int icSigViewingCondDescTag
public static final int icSigViewingConditionsTag
public static final int icSigChromaticityTag
public static final int icSigChromaticAdaptationTag
public static final int icSigColorantOrderTag
public static final int icSigColorantTableTag
public static final int icHdrSize
public static final int icHdrCmmId
public static final int icHdrVersion
public static final int icHdrDeviceClass
public static final int icHdrColorSpace
public static final int icHdrPcs
public static final int icHdrDate
public static final int icHdrMagic
public static final int icHdrPlatform
public static final int icHdrFlags
public static final int icHdrManufacturer
public static final int icHdrModel
public static final int icHdrAttributes
public static final int icHdrRenderingIntent
public static final int icHdrIlluminant
public static final int icHdrCreator
public static final int icHdrProfileID
public static final int icTagType
public static final int icTagReserved
public static final int icCurveCount
public static final int icCurveData
public static final int icXYZNumberX
protected void finalize()
finalize in class ObjectWeakReference, 
PhantomReferencepublic static ICC_Profile getInstance(byte[] data)
data - the specified ICC Profile dataICC_Profile object corresponding to
          the data in the specified data array.public static ICC_Profile getInstance(int cspace)
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.public static ICC_Profile getInstance(String fileName) throws IOException
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.public static ICC_Profile getInstance(InputStream s) throws IOException
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.public int getMajorVersion()
public int getMinorVersion()
public int getProfileClass()
public int getColorSpaceType()
ColorSpace class.public int getPCSType()
ColorSpace class.public void write(String fileName) throws IOException
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.public void write(OutputStream s) throws IOException
s - The stream to write the profile data to.IOException - If an I/O error occurs while writing to the
 stream.public byte[] getData()
setData(int, byte[])public byte[] getData(int tagSignature)
tagSignature - The ICC tag signature for the data element you
 want to get.null if the specified tag doesn't exist.setData(int, byte[])public void setData(int tagSignature,
                    byte[] tagData)
tagSignature as defined in the ICC specification, section 10.
 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 signatureIllegalArgumentException - if tagSignature is not a signature
         as defined in the ICC specification.IllegalArgumentException - if a content of the tagData
         array can not be interpreted as valid tag data, corresponding
         to the tagSignature.getData()public int getNumComponents()
ProfileDataException - if color space is in the profile
         is invalidprotected Object readResolve() throws ObjectStreamException
ObjectStreamException - never thrown, but mandated by the serialization spec. Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2017, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.