TIFFField (iText, a Free Java-PDF library 5.4.2 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.itextpdf.text.pdf.codec
Class TIFFField

java.lang.Object
  com.itextpdf.text.pdf.codec.TIFFField

All Implemented Interfaces:: Serializable, Comparable<TIFFField>

public class TIFFField
extends Object
implements Comparable<TIFFField>, Serializable
extends Object
implements Comparable<TIFFField>, Serializable

A class representing a field in a TIFF 6.0 Image File Directory.

The TIFF file format is described in more detail in the comments for the TIFFDescriptor class.

A field in a TIFF Image File Directory (IFD). A field is defined as a sequence of values of identical data type. TIFF 6.0 defines 12 data types, which are mapped internally onto the Java data types byte, int, long, float, and double.

This class is not a committed part of the JAI API. It may be removed or changed in future releases of JAI.

See Also:: TIFFDirectory, Serialized Form

Field Summary
`static int`	`TIFF_ASCII` Flag for null-terminated ASCII strings.
`static int`	`TIFF_BYTE` Flag for 8 bit unsigned integers.
`static int`	`TIFF_DOUBLE` Flag for 64 bit IEEE doubles.
`static int`	`TIFF_FLOAT` Flag for 32 bit IEEE floats.
`static int`	`TIFF_LONG` Flag for 32 bit unsigned integers.
`static int`	`TIFF_RATIONAL` Flag for pairs of 32 bit unsigned integers.
`static int`	`TIFF_SBYTE` Flag for 8 bit signed integers.
`static int`	`TIFF_SHORT` Flag for 16 bit unsigned integers.
`static int`	`TIFF_SLONG` Flag for 32 bit signed integers.
`static int`	`TIFF_SRATIONAL` Flag for pairs of 32 bit signed integers.
`static int`	`TIFF_SSHORT` Flag for 16 bit signed integers.
`static int`	`TIFF_UNDEFINED` Flag for 8 bit uninterpreted bytes.

Constructor Summary
`TIFFField(int tag, int type, int count, Object data)` Constructs a TIFFField with arbitrary data.

Method Summary
`int`	`compareTo(TIFFField o)` Compares this `TIFFField` with another `TIFFField` by comparing the tags.
`byte[]`	`getAsBytes()` Returns the data as an uninterpreted array of bytes.
`char[]`	`getAsChars()` Returns TIFF_SHORT data as an array of chars (unsigned 16-bit integers).
`double`	`getAsDouble(int index)` Returns data in any numerical format as a float.
`double[]`	`getAsDoubles()` Returns TIFF_DOUBLE data as an array of doubles.
`float`	`getAsFloat(int index)` Returns data in any numerical format as a float.
`float[]`	`getAsFloats()` Returns TIFF_FLOAT data as an array of floats.
`int`	`getAsInt(int index)` Returns data in TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, or TIFF_SLONG format as an int.
`int[]`	`getAsInts()` Returns TIFF_SLONG data as an array of ints (signed 32-bit integers).
`long`	`getAsLong(int index)` Returns data in TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, TIFF_SLONG, or TIFF_LONG format as a long.
`long[]`	`getAsLongs()` Returns TIFF_LONG data as an array of longs (signed 64-bit integers).
`long[]`	`getAsRational(int index)` Returns a TIFF_RATIONAL data item as a two-element array of ints.
`long[][]`	`getAsRationals()` Returns TIFF_RATIONAL data as an array of 2-element arrays of longs.
`short[]`	`getAsShorts()` Returns TIFF_SSHORT data as an array of shorts (signed 16-bit integers).
`int[]`	`getAsSRational(int index)` Returns a TIFF_SRATIONAL data item as a two-element array of ints.
`int[][]`	`getAsSRationals()` Returns TIFF_SRATIONAL data as an array of 2-element arrays of ints.
`String`	`getAsString(int index)` Returns a TIFF_ASCII data item as a String.
`int`	`getCount()` Returns the number of elements in the IFD.
`int`	`getTag()` Returns the tag number, between 0 and 65535.
`int`	`getType()` Returns the type of the data stored in the IFD.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

TIFF_BYTE

public static final int TIFF_BYTE

Flag for 8 bit unsigned integers.

See Also:: Constant Field Values

TIFF_ASCII

public static final int TIFF_ASCII

Flag for null-terminated ASCII strings.

See Also:: Constant Field Values

TIFF_SHORT

public static final int TIFF_SHORT

Flag for 16 bit unsigned integers.

See Also:: Constant Field Values

TIFF_LONG

public static final int TIFF_LONG

Flag for 32 bit unsigned integers.

See Also:: Constant Field Values

TIFF_RATIONAL

public static final int TIFF_RATIONAL

Flag for pairs of 32 bit unsigned integers.

See Also:: Constant Field Values

TIFF_SBYTE

public static final int TIFF_SBYTE

Flag for 8 bit signed integers.

See Also:: Constant Field Values

TIFF_UNDEFINED

public static final int TIFF_UNDEFINED

Flag for 8 bit uninterpreted bytes.

See Also:: Constant Field Values

TIFF_SSHORT

public static final int TIFF_SSHORT

Flag for 16 bit signed integers.

See Also:: Constant Field Values

TIFF_SLONG

public static final int TIFF_SLONG

Flag for 32 bit signed integers.

See Also:: Constant Field Values

TIFF_SRATIONAL

public static final int TIFF_SRATIONAL

Flag for pairs of 32 bit signed integers.

See Also:: Constant Field Values

TIFF_FLOAT

public static final int TIFF_FLOAT

Flag for 32 bit IEEE floats.

See Also:: Constant Field Values

TIFF_DOUBLE

public static final int TIFF_DOUBLE

Flag for 64 bit IEEE doubles.

See Also:: Constant Field Values

Constructor Detail

TIFFField

public TIFFField(int tag,
                 int type,
                 int count,
                 Object data)

Constructs a TIFFField with arbitrary data. The data parameter must be an array of a Java type appropriate for the type of the TIFF field. Since there is no available 32-bit unsigned data type, long is used. The mapping between types is as follows:

TIFF type	Java type
`TIFF_BYTE`	`byte`
`TIFF_ASCII`	`String`
`TIFF_SHORT`	`char`
`TIFF_LONG`	`long`
`TIFF_RATIONAL`	`long[2]`
`TIFF_SBYTE`	`byte`
`TIFF_UNDEFINED`	`byte`
`TIFF_SSHORT`	`short`
`TIFF_SLONG`	`int`
`TIFF_SRATIONAL`	`int[2]`
`TIFF_FLOAT`	`float`
`TIFF_DOUBLE`	`double`

Method Detail

getTag

public int getTag()

Returns the tag number, between 0 and 65535.

getType

public int getType()

Returns the type of the data stored in the IFD. For a TIFF6.0 file, the value will equal one of the TIFF_ constants defined in this class. For future revisions of TIFF, higher values are possible.

getCount

public int getCount()

Returns the number of elements in the IFD.

getAsBytes

public byte[] getAsBytes()

Returns the data as an uninterpreted array of bytes. The type of the field must be one of TIFF_BYTE, TIFF_SBYTE, or TIFF_UNDEFINED;

For data in TIFF_BYTE format, the application must take care when promoting the data to longer integral types to avoid sign extension.

A ClassCastException will be thrown if the field is not of type TIFF_BYTE, TIFF_SBYTE, or TIFF_UNDEFINED.

getAsChars

public char[] getAsChars()

Returns TIFF_SHORT data as an array of chars (unsigned 16-bit integers).

A ClassCastException will be thrown if the field is not of type TIFF_SHORT.

getAsShorts

public short[] getAsShorts()

Returns TIFF_SSHORT data as an array of shorts (signed 16-bit integers).

A ClassCastException will be thrown if the field is not of type TIFF_SSHORT.

getAsInts

public int[] getAsInts()

Returns TIFF_SLONG data as an array of ints (signed 32-bit integers).

A ClassCastException will be thrown if the field is not of type TIFF_SLONG.

getAsLongs

public long[] getAsLongs()

Returns TIFF_LONG data as an array of longs (signed 64-bit integers).

A ClassCastException will be thrown if the field is not of type TIFF_LONG.

getAsFloats

public float[] getAsFloats()

Returns TIFF_FLOAT data as an array of floats.

A ClassCastException will be thrown if the field is not of type TIFF_FLOAT.

getAsDoubles

public double[] getAsDoubles()

Returns TIFF_DOUBLE data as an array of doubles.

A ClassCastException will be thrown if the field is not of type TIFF_DOUBLE.

getAsSRationals

public int[][] getAsSRationals()

Returns TIFF_SRATIONAL data as an array of 2-element arrays of ints.

A ClassCastException will be thrown if the field is not of type TIFF_SRATIONAL.

getAsRationals

public long[][] getAsRationals()

Returns TIFF_RATIONAL data as an array of 2-element arrays of longs.

A ClassCastException will be thrown if the field is not of type TIFF_RATTIONAL.

getAsInt

public int getAsInt(int index)

Returns data in TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, or TIFF_SLONG format as an int.

TIFF_BYTE and TIFF_UNDEFINED data are treated as unsigned; that is, no sign extension will take place and the returned value will be in the range [0, 255]. TIFF_SBYTE data will be returned in the range [-128, 127].

A ClassCastException will be thrown if the field is not of type TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, or TIFF_SLONG.

getAsLong

public long getAsLong(int index)

Returns data in TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, TIFF_SLONG, or TIFF_LONG format as a long.

A ClassCastException will be thrown if the field is not of type TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, TIFF_SLONG, or TIFF_LONG.

getAsFloat

public float getAsFloat(int index)

Returns data in any numerical format as a float. Data in TIFF_SRATIONAL or TIFF_RATIONAL format are evaluated by dividing the numerator into the denominator using double-precision arithmetic and then truncating to single precision. Data in TIFF_SLONG, TIFF_LONG, or TIFF_DOUBLE format may suffer from truncation.

A ClassCastException will be thrown if the field is of type TIFF_UNDEFINED or TIFF_ASCII.

getAsDouble

public double getAsDouble(int index)

Returns data in any numerical format as a float. Data in TIFF_SRATIONAL or TIFF_RATIONAL format are evaluated by dividing the numerator into the denominator using double-precision arithmetic.