ucar.jpeg.icc

Class ICCProfile

java.lang.Object

ucar.jpeg.icc.ICCProfile

Direct Known Subclasses:

ICCMatrixBasedInputProfile, ICCMonochromeInputProfile

public abstract class ICCProfile
extends Object

This class models the ICCProfile file. This file is a binary file which is divided into two parts, an ICCProfileHeader followed by an ICCTagTable. The header is a straightforward list of descriptive parameters such as profile size, version, date and various more esoteric parameters. The tag table is a structured list of more complexly aggragated data describing things such as ICC curves, copyright information, descriptive text blocks, etc. Classes exist to model the header and tag table and their various constituent parts the developer is refered to these for further information on the structure and contents of the header and tag table.

Version:

1.0

Author:

Bruce A. Kern

See Also:

jj2000.j2k.icc.types.ICCProfileHeader, jj2000.j2k.icc.tags.ICCTagTable

Field Summary

Fields

Modifier and Type	Field and Description
static int	BITS_PER_BYTE
static int	BITS_PER_INT
static int	BITS_PER_LONG
static int	BITS_PER_SHORT
static int	BLUE RGB index.
static int	boolean_size Size of native type
static int	byte_size Size of native type
static int	BYTES_PER_INT
static int	BYTES_PER_LONG
static int	BYTES_PER_SHORT
static int	char_size Size of native type
static int	double_size Size of native type
static int	float_size Size of native type
static int	GRAY Gray index.
static int	GREEN RGB index.
static int	int_size Size of native type
static int	kdwBlueColorantTag tag signature
static int	kdwBlueTRCTag tag signature
static int	kdwCopyrightTag tag signature
static int	kdwDisplayProfile tag type
static int	kdwGrayData tag type
static int	kdwGrayTRCTag tag signature
static int	kdwGreenColorantTag tag signature
static int	kdwGreenTRCTag tag signature
static int	kdwInputProfile profile type
static int	kdwMediaWhiteTag tag signature
static int	kdwProfileDescTag tag signature
static int	kdwProfileSignature signature
static int	kdwProfileSigReverse signature
static int	kdwRedColorantTag tag signature
static int	kdwRedTRCTag tag signature
static int	kdwRGBData tag type
static int	kdwXYZData tag type
static int	kMonochromeInput input type
static int	kThreeCompInput input type
static int	long_size Size of native type
static int	RED RGB index.
static int	short_size Size of native type

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ICCProfile(ColorSpace csm) ParameterList constructor

Method Summary

Methods

Modifier and Type	Method and Description
ICCProfileHeader	getHeader() Access the profile header
static ICCDateTime	getICCDateTime(byte[] data, int offset) Create an ICCDateTime from byte [] input
static ICCProfileVersion	getICCProfileVersion(byte[] data, int offset) Create an ICCProfileVersion from byte [] input
static int	getInt(byte[] bfr, int off) Create an int from a byte [4].
static int	getInt(byte[] bfr, int off, boolean swap) Create an int from a byte [4], with optional byte swapping.
static int	getIntFromString(String fourChar) Creates an int from a 4 character String
static long	getLong(byte[] bfr, int off) Create an long from a byte [8].
static short	getShort(byte[] bfr, int off) Create a short from a two byte [].
static short	getShort(byte[] bfr, int off, boolean swap) Create a short from a two byte [], with optional byte swapping.
static String	getString(byte[] bfr, int offset, int length, boolean swap) Create a String from a byte [].
ICCTagTable	getTagTable() Access the profile tag table
static XYZNumber	getXYZNumber(byte[] data, int offset) Create an XYZNumber from byte [] input
RestrictedICCProfile	parse() Parse this ICCProfile into a RestrictedICCProfile which is appropriate to the data in this profile.
static byte[]	setInt(int d) Separate bytes in an int into a byte array lsb to msb order.
static byte[]	setInt(int d, byte[] b) Separate bytes in an int into a byte array lsb to msb order.
static byte[]	setLong(long d) Separate bytes in a long into a byte array lsb to msb order.
static byte[]	setLong(long d, byte[] b) Separate bytes in a long into a byte array lsb to msb order.
static String	toHexString(byte i) Create a two character hex representation of a byte
static String	toHexString(int i) Create a 8 character hex representation of a int
static String	toHexString(short i) Create a 4 character hex representation of a short
String	toString() Provide a suitable string representation for the class
static String	toString(byte[] data)
void	write(RandomAccessFile os) Output this ICCProfile to a RandomAccessFile

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

GRAY

public static final int GRAY

Gray index.

See Also:

Constant Field Values

RED

public static final int RED

RGB index.

See Also:

Constant Field Values

GREEN

public static final int GREEN

RGB index.

See Also:

Constant Field Values

BLUE

public static final int BLUE

RGB index.

See Also:

Constant Field Values

boolean_size

public static final int boolean_size

Size of native type

See Also:

Constant Field Values

byte_size

public static final int byte_size

Size of native type

See Also:

Constant Field Values

char_size

public static final int char_size

Size of native type

See Also:

Constant Field Values

short_size

public static final int short_size

Size of native type

See Also:

Constant Field Values

int_size

public static final int int_size

Size of native type

See Also:

Constant Field Values

float_size

public static final int float_size

Size of native type

See Also:

Constant Field Values

long_size

public static final int long_size

Size of native type

See Also:

Constant Field Values

double_size

public static final int double_size

Size of native type

See Also:

Constant Field Values

BITS_PER_BYTE

public static final int BITS_PER_BYTE

See Also:

Constant Field Values

BITS_PER_SHORT

public static final int BITS_PER_SHORT

See Also:

Constant Field Values

BITS_PER_INT

public static final int BITS_PER_INT

See Also:

Constant Field Values

BITS_PER_LONG

public static final int BITS_PER_LONG

See Also:

Constant Field Values

BYTES_PER_SHORT

public static final int BYTES_PER_SHORT

See Also:

Constant Field Values

BYTES_PER_INT

public static final int BYTES_PER_INT

See Also:

Constant Field Values

BYTES_PER_LONG

public static final int BYTES_PER_LONG

See Also:

Constant Field Values

kdwProfileSignature

public static final int kdwProfileSignature

signature

kdwProfileSigReverse

public static final int kdwProfileSigReverse

signature

kdwInputProfile

public static final int kdwInputProfile

profile type

kdwDisplayProfile

public static final int kdwDisplayProfile

tag type

kdwRGBData

public static final int kdwRGBData

tag type

kdwGrayData

public static final int kdwGrayData

tag type

kdwXYZData

public static final int kdwXYZData

tag type

kMonochromeInput

public static final int kMonochromeInput

input type

See Also:

Constant Field Values

kThreeCompInput

public static final int kThreeCompInput

input type

See Also:

Constant Field Values

kdwGrayTRCTag

public static final int kdwGrayTRCTag

tag signature

kdwRedColorantTag

public static final int kdwRedColorantTag

tag signature

kdwGreenColorantTag

public static final int kdwGreenColorantTag

tag signature

kdwBlueColorantTag

public static final int kdwBlueColorantTag

tag signature

kdwRedTRCTag

public static final int kdwRedTRCTag

tag signature

kdwGreenTRCTag

public static final int kdwGreenTRCTag

tag signature

kdwBlueTRCTag

public static final int kdwBlueTRCTag

tag signature

kdwCopyrightTag

public static final int kdwCopyrightTag

tag signature

kdwMediaWhiteTag

public static final int kdwMediaWhiteTag

tag signature

kdwProfileDescTag

public static final int kdwProfileDescTag

tag signature

Constructor Detail

ICCProfile

protected ICCProfile(ColorSpace csm)
              throws ColorSpaceException,
                     ICCProfileInvalidException

ParameterList constructor

Parameters:

csb - provides colorspace information

Throws:

ColorSpaceException

ICCProfileInvalidException

Method Detail

getIntFromString

public static int getIntFromString(String fourChar)

Creates an int from a 4 character String

Parameters:

fourChar - string representation of an integer

Returns:

the integer which is denoted by the input String.

getXYZNumber

public static XYZNumber getXYZNumber(byte[] data,
                     int offset)

Create an XYZNumber from byte [] input

Parameters:

data - array containing the XYZNumber representation

offset - start of the rep in the array

Returns:

the created XYZNumber

getICCProfileVersion

public static ICCProfileVersion getICCProfileVersion(byte[] data,
                                     int offset)

Create an ICCProfileVersion from byte [] input

Parameters:

data - array containing the ICCProfileVersion representation

offset - start of the rep in the array

Returns:

the created ICCProfileVersion

getICCDateTime

public static ICCDateTime getICCDateTime(byte[] data,
                         int offset)

Create an ICCDateTime from byte [] input

Parameters:

data - array containing the ICCProfileVersion representation

offset - start of the rep in the array

Returns:

the created ICCProfileVersion

getString

public static String getString(byte[] bfr,
               int offset,
               int length,
               boolean swap)

Create a String from a byte []. Optionally swap adjacent byte pairs. Intended to be used to create integer String representations allowing for endian translations.

Parameters:

bfr - data array

offset - start of data in array

length - length of data in array

swap - swap adjacent bytes?

Returns:

String rep of data

getShort

public static short getShort(byte[] bfr,
             int off,
             boolean swap)

Create a short from a two byte [], with optional byte swapping.

Parameters:

bfr - data array

off - start of data in array

swap - swap bytes?

Returns:

native type from representation.

getShort

public static short getShort(byte[] bfr,
             int off)

Create a short from a two byte [].

Parameters:

bfr - data array

off - start of data in array

Returns:

native type from representation.

setInt

public static byte[] setInt(int d)

Separate bytes in an int into a byte array lsb to msb order.

Parameters:

d - integer to separate

Returns:

byte [] containing separated int.

setInt

public static byte[] setInt(int d,
            byte[] b)

Separate bytes in an int into a byte array lsb to msb order. Return the result in the provided array

Parameters:

d - integer to separate

b - return output here.

Returns:

reference to output.

setLong

public static byte[] setLong(long d)

Separate bytes in a long into a byte array lsb to msb order.

Parameters:

d - long to separate

Returns:

byte [] containing separated int.

setLong

public static byte[] setLong(long d,
             byte[] b)

Separate bytes in a long into a byte array lsb to msb order. Return the result in the provided array

Parameters:

d - long to separate

b - return output here.

Returns:

reference to output.

getInt

public static int getInt(byte[] bfr,
         int off,
         boolean swap)

Create an int from a byte [4], with optional byte swapping.

Parameters:

bfr - data array

off - start of data in array

swap - swap bytes?

Returns:

native type from representation.

getInt

public static int getInt(byte[] bfr,
         int off)

Create an int from a byte [4].

Parameters:

bfr - data array

off - start of data in array

Returns:

native type from representation.

getLong

public static long getLong(byte[] bfr,
           int off)

Create an long from a byte [8].

Parameters:

bfr - data array

off - start of data in array

Returns:

native type from representation.

toString

public String toString()

Provide a suitable string representation for the class

Overrides:

toString in class Object

toHexString

public static String toHexString(byte i)

Create a two character hex representation of a byte

Parameters:

i - byte to represent

Returns:

representation

toHexString

public static String toHexString(short i)

Create a 4 character hex representation of a short

Parameters:

i - short to represent

Returns:

representation

toHexString

public static String toHexString(int i)

Create a 8 character hex representation of a int

Parameters:

i - int to represent

Returns:

representation

toString

public static String toString(byte[] data)

getHeader

public ICCProfileHeader getHeader()

Access the profile header

Returns:

ICCProfileHeader

getTagTable

public ICCTagTable getTagTable()

Access the profile tag table

Returns:

ICCTagTable

parse

public RestrictedICCProfile parse()
                           throws ICCProfileInvalidException

Parse this ICCProfile into a RestrictedICCProfile which is appropriate to the data in this profile. Either a MonochromeInputRestrictedProfile or MatrixBasedRestrictedProfile is returned

Returns:

RestrictedICCProfile

Throws:

ICCProfileInvalidException - no curve data

write

public void write(RandomAccessFile os)
           throws IOException

Output this ICCProfile to a RandomAccessFile

Parameters:

os - output file

Throws:

IOException