TiffField (com.pd4ml 4.0.15 API Documentation)

java.lang.Object
- com.pd4ml.cache.img.TiffField

All Implemented Interfaces:

Serializable, Comparable
```
public class TiffField
extends Object
implements Comparable, 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 datatypes 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:

TiffParser, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`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

Constructors
Constructor and Description

TiffField(int tag, int type, int count, Object data)

Constructors
Constructor and Description
`TiffField(int tag, int type, int count, Object data)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(Object o)` Compares this `TIFFField` with another `TIFFField` by comparing the tags.
`byte[]`	`getAsBytes()`
`char[]`	`getAsChars()`
`double`	`getAsDouble(int index)`
`double[]`	`getAsDoubles()`
`float`	`getAsFloat(int index)`
`float[]`	`getAsFloats()`
`int`	`getAsInt(int index)`
`int[]`	`getAsInts()`
`long`	`getAsLong(int index)`
`long[]`	`getAsLongs()`
`long[]`	`getAsRational(int index)`
`long[][]`	`getAsRationals()`
`short[]`	`getAsShorts()`
`int[]`	`getAsSRational(int index)`
`int[][]`	`getAsSRationals()`
`String`	`getAsString(int index)`
`int`	`getCount()`
`int`	`getTag()`
`int`	`getType()`

Methods inherited from class java.lang.Object
equals, 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)
```
- 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)
```
    Parameters:
    
    index - 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)
```
    Parameters:
    
    index - index
    
    Returns:
    
    data in TIFF_BYTE, TIFF_SBYTE, TIFF_UNDEFINED, TIFF_SHORT, TIFF_SSHORT, TIFF_SLONG, or TIFF_LONG format as a long.
    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, TIFF_SLONG, or TIFF_LONG.
  - getAsFloat
```
public float getAsFloat(int index)
```
    Parameters:
    
    index - 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)
```
    Parameters:
    
    index - 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.
    A ClassCastException will be thrown if the field is of type TIFF_UNDEFINED or TIFF_ASCII.
  - getAsString
```
public String getAsString(int index)
```
    Parameters:
    
    index - index
    
    Returns:
    
    a TIFF_ASCII data item as a String.
    A ClassCastException will be thrown if the field is not of type TIFF_ASCII.
  - getAsSRational
```
public int[] getAsSRational(int index)
```
    Parameters:
    
    index - index
    
    Returns:
    
    a TIFF_SRATIONAL data item as a two-element array of ints.
    A ClassCastException will be thrown if the field is not of type TIFF_SRATIONAL.
  - getAsRational
```
public long[] getAsRational(int index)
```
    Parameters:
    
    index - index
    
    Returns:
    
    a TIFF_RATIONAL data item as a two-element array of ints.
    A ClassCastException will be thrown if the field is not of type TIFF_RATIONAL.
  - compareTo
```
public int compareTo(Object o)
```
    Compares this TIFFField with another TIFFField by comparing the tags.
    Note: this class has a natural ordering that is inconsistent with equals().
    
    Specified by:
    
    compareTo in interface Comparable
    
    Parameters:
    
    o - object to compare to
    
    Returns:
    
    comparison result
    
    Throws:
    
    IllegalArgumentException - if the parameter is null.
    
    ClassCastException - if the parameter is not a TIFFField.

Class TiffField

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TIFF_BYTE

TIFF_ASCII

TIFF_SHORT

TIFF_LONG

TIFF_RATIONAL

TIFF_SBYTE

TIFF_UNDEFINED

TIFF_SSHORT

TIFF_SLONG

TIFF_SRATIONAL

TIFF_FLOAT

TIFF_DOUBLE

Constructor Detail

TiffField

Method Detail

getTag

getType

getCount

getAsBytes

getAsChars

getAsShorts

getAsInts

getAsLongs

getAsFloats

getAsDoubles

getAsSRationals

getAsRationals

getAsInt

getAsLong

getAsFloat

getAsDouble

getAsString

getAsSRational

getAsRational

compareTo