< prev index next >
src/java.desktop/share/classes/java/awt/color/ICC_Profile.java
Print this page
*** 764,775 ****
/**
* 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.
* @param data the specified ICC Profile data
! * @return an <code>ICC_Profile</code> object corresponding to
! * the data in the specified <code>data</code> array.
*/
public static ICC_Profile getInstance(byte[] data) {
ICC_Profile thisProfile;
Profile p = null;
--- 764,775 ----
/**
* 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.
* @param data the specified ICC Profile data
! * @return an {@code ICC_Profile} object corresponding to
! * the data in the specified {@code data} array.
*/
public static ICC_Profile getInstance(byte[] data) {
ICC_Profile thisProfile;
Profile p = null;
*** 819,833 ****
* Throws an IllegalArgumentException if cspace is not one of the
* defined color spaces.
*
* @param cspace the type of color space to create a profile for.
* The specified type is one of the color
! * space constants defined in the <CODE>ColorSpace</CODE> class.
*
! * @return an <code>ICC_Profile</code> object corresponding to
! * the specified <code>ColorSpace</code> type.
! * @exception IllegalArgumentException If <CODE>cspace</CODE> is not
* one of the predefined color space types.
*/
public static ICC_Profile getInstance (int cspace) {
ICC_Profile thisProfile = null;
String fileName;
--- 819,833 ----
* Throws an IllegalArgumentException if cspace is not one of the
* defined color spaces.
*
* @param cspace the type of color space to create a profile for.
* The specified type is one of the color
! * space constants defined in the {@code ColorSpace} class.
*
! * @return an {@code ICC_Profile} object corresponding to
! * the specified {@code ColorSpace} type.
! * @exception IllegalArgumentException If {@code cspace} is not
* one of the predefined color space types.
*/
public static ICC_Profile getInstance (int cspace) {
ICC_Profile thisProfile = null;
String fileName;
*** 954,964 ****
* 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.
* @param fileName The file that contains the data for the profile.
*
! * @return an <code>ICC_Profile</code> object corresponding to
* the data in the specified file.
* @exception IOException If the specified file cannot be opened or
* an I/O error occurs while reading the file.
*
* @exception IllegalArgumentException If the file does not
--- 954,964 ----
* 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.
* @param fileName The file that contains the data for the profile.
*
! * @return an {@code ICC_Profile} object corresponding to
* the data in the specified file.
* @exception IOException If the specified file cannot be opened or
* an I/O error occurs while reading the file.
*
* @exception IllegalArgumentException If the file does not
*** 995,1006 ****
* 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.
* @param s The input stream from which to read the profile data.
*
! * @return an <CODE>ICC_Profile</CODE> object corresponding to the
! * data in the specified <code>InputStream</code>.
*
* @exception IOException If an I/O error occurs while reading the stream.
*
* @exception IllegalArgumentException If the stream does not
* contain valid ICC Profile data.
--- 995,1006 ----
* 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.
* @param s The input stream from which to read the profile data.
*
! * @return an {@code ICC_Profile} object corresponding to the
! * data in the specified {@code InputStream}.
*
* @exception IOException If an I/O error occurs while reading the stream.
*
* @exception IllegalArgumentException If the stream does not
* contain valid ICC Profile data.
*** 1211,1221 ****
* 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.
* @return One of the color space type constants defined in the
! * <CODE>ColorSpace</CODE> class.
*/
public int getColorSpaceType() {
if (deferralInfo != null) {
return deferralInfo.colorSpaceType; /* Need to have this info for
ICC_ColorSpace without
--- 1211,1221 ----
* 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.
* @return One of the color space type constants defined in the
! * {@code ColorSpace} class.
*/
public int getColorSpaceType() {
if (deferralInfo != null) {
return deferralInfo.colorSpaceType; /* Need to have this info for
ICC_ColorSpace without
*** 1243,1253 ****
* 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.
* @return One of the color space type constants defined in the
! * <CODE>ColorSpace</CODE> class.
*/
public int getPCSType() {
if (ProfileDeferralMgr.deferring) {
ProfileDeferralMgr.activateProfiles();
}
--- 1243,1253 ----
* 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.
* @return One of the color space type constants defined in the
! * {@code ColorSpace} class.
*/
public int getPCSType() {
if (ProfileDeferralMgr.deferring) {
ProfileDeferralMgr.activateProfiles();
}
*** 1340,1350 ****
*
* @param tagSignature The ICC tag signature for the data element you
* want to get.
*
* @return A byte array that contains the tagged data element. Returns
! * <code>null</code> if the specified tag doesn't exist.
* @see #setData(int, byte[])
*/
public byte[] getData(int tagSignature) {
if (ProfileDeferralMgr.deferring) {
--- 1340,1350 ----
*
* @param tagSignature The ICC tag signature for the data element you
* want to get.
*
* @return A byte array that contains the tagged data element. Returns
! * {@code null} if the specified tag doesn't exist.
* @see #setData(int, byte[])
*/
public byte[] getData(int tagSignature) {
if (ProfileDeferralMgr.deferring) {
*** 1927,1937 ****
*/
/**
* Version of the format of additional serialized data in the
! * stream. Version <code>1</code> corresponds to Java 2
* Platform, v1.3.
* @since 1.3
* @serial
*/
private int iccProfileSerializedDataVersion = 1;
--- 1927,1937 ----
*/
/**
* Version of the format of additional serialized data in the
! * stream. Version {@code 1} corresponds to Java 2
* Platform, v1.3.
* @since 1.3
* @serial
*/
private int iccProfileSerializedDataVersion = 1;
*** 1941,1961 ****
* Writes default serializable fields to the stream. Writes a
* string and an array of bytes to the stream as additional data.
*
* @param s stream used for serialization.
* @throws IOException
! * thrown by <code>ObjectInputStream</code>.
* @serialData
! * The <code>String</code> is the name of one of
* <code>CS_<var>*</var></code> constants defined in the
* {@link ColorSpace} class if the profile object is a profile
* for a predefined color space (for example
! * <code>"CS_sRGB"</code>). The string is <code>null</code>
* otherwise.
* <p>
! * The <code>byte[]</code> array is the profile data for the
! * profile. For predefined color spaces <code>null</code> is
* written instead of the profile data. If in the future
* versions of Java API new predefined color spaces will be
* added, future versions of this class may choose to write
* for new predefined color spaces not only the color space
* name, but the profile data as well so that older versions
--- 1941,1961 ----
* Writes default serializable fields to the stream. Writes a
* string and an array of bytes to the stream as additional data.
*
* @param s stream used for serialization.
* @throws IOException
! * thrown by {@code ObjectInputStream}.
* @serialData
! * The {@code String} is the name of one of
* <code>CS_<var>*</var></code> constants defined in the
* {@link ColorSpace} class if the profile object is a profile
* for a predefined color space (for example
! * {@code "CS_sRGB"}). The string is {@code null}
* otherwise.
* <p>
! * The {@code byte[]} array is the profile data for the
! * profile. For predefined color spaces {@code null} is
* written instead of the profile data. If in the future
* versions of Java API new predefined color spaces will be
* added, future versions of this class may choose to write
* for new predefined color spaces not only the color space
* name, but the profile data as well so that older versions
*** 2001,2023 ****
* Reads default serializable fields from the stream. Reads from
* the stream a string and an array of bytes as additional data.
*
* @param s stream used for deserialization.
* @throws IOException
! * thrown by <code>ObjectInputStream</code>.
* @throws ClassNotFoundException
! * thrown by <code>ObjectInputStream</code>.
* @serialData
! * The <code>String</code> is the name of one of
* <code>CS_<var>*</var></code> constants defined in the
* {@link ColorSpace} class if the profile object is a profile
* for a predefined color space (for example
! * <code>"CS_sRGB"</code>). The string is <code>null</code>
* otherwise.
* <p>
! * The <code>byte[]</code> array is the profile data for the
! * profile. It will usually be <code>null</code> for the
* predefined profiles.
* <p>
* If the string is recognized as a constant name for
* predefined color space the object will be resolved into
* profile obtained with
--- 2001,2023 ----
* Reads default serializable fields from the stream. Reads from
* the stream a string and an array of bytes as additional data.
*
* @param s stream used for deserialization.
* @throws IOException
! * thrown by {@code ObjectInputStream}.
* @throws ClassNotFoundException
! * thrown by {@code ObjectInputStream}.
* @serialData
! * The {@code String} is the name of one of
* <code>CS_<var>*</var></code> constants defined in the
* {@link ColorSpace} class if the profile object is a profile
* for a predefined color space (for example
! * {@code "CS_sRGB"}). The string is {@code null}
* otherwise.
* <p>
! * The {@code byte[]} array is the profile data for the
! * profile. It will usually be {@code null} for the
* predefined profiles.
* <p>
* If the string is recognized as a constant name for
* predefined color space the object will be resolved into
* profile obtained with
< prev index next >