Класс TIFFField

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

Параметры:

tag - Тег, связанный с этим полем.

type - Одно из значений TIFFTag.TIFF_*, указывающих тип данных поля, как он записан в поток TIFF.

count - Количество значений данных.

data - Фактическое содержимое данных поля.

Исключения:

NullPointerException - если tag == null.

IllegalArgumentException - если type не является одним из TIFFTag.TIFF_* констант типов данных.

IllegalArgumentException - если type — неприемлемый тип данных для предоставленного TIFFTag.

IllegalArgumentException - если count < 0.

IllegalArgumentException - если count < 1 и type — TIFF_RATIONAL или TIFF_SRATIONAL.

IllegalArgumentException - если count != 1 и type — TIFF_IFD_POINTER.

NullPointerException - если data == null.

IllegalArgumentException - если data — экземпляр класса, несовместимого со специфицированным типом.

IllegalArgumentException - если размер массива данных неверный.

IllegalArgumentException - если тип массива данных — TIFF_LONG, TIFF_RATIONAL или TIFF_IFD_POINTER, и любое из элементов отрицательно или больше, чем 0xffffffff.

public TIFFField(TIFFTag tag, int type, int count)

Параметры:

tag - Тег, связанный с этим полем.

type - Одно из значений TIFFTag.TIFF_*, указывающих тип данных поля, как он записан в поток TIFF.

count - Количество значений данных.

Исключения:

NullPointerException - если tag == null.

IllegalArgumentException - если type не является одним из TIFFTag.TIFF_* констант типов данных.

IllegalArgumentException - если type — неприемлемый тип данных для предоставленного TIFFTag.

IllegalArgumentException - если count < 0.

IllegalArgumentException - если count < 1 и type — TIFF_RATIONAL или TIFF_SRATIONAL.

IllegalArgumentException - если count != 1 и type — TIFF_IFD_POINTER.

См. также:

• TIFFField(TIFFTag,int,int,Object)

public TIFFField(TIFFTag tag, long value)

Параметры:

tag - Тег, ассоциированный с этим полем.

value - Значение, ассоциированное с этим полем.

Исключения:

NullPointerException - если tag == null.

IllegalArgumentException - если value не находится в [0,0xffffffff].

IllegalArgumentException - если value находится в [0,0xffff] и TIFF_SHORT — неприемлемый тип для TIFFTag, или если value находится в [0x10000,0xffffffff] и TIFF_LONG — неприемлемый тип для TIFFTag.

public TIFFField(TIFFTag tag, int type, long offset, TIFFDirectory dir)

Параметры:

tag - Тег, связанный с этим полем.

type - Одно из значений TIFFTag.TIFF_LONG или TIFFTag.TIFF_IFD_POINTER.

offset - Смещение IFD.

dir - Директория.

Исключения:

NullPointerException - если tag == null.

IllegalArgumentException - если type — неприемлемый тип данных для предоставленного TIFFTag.

IllegalArgumentException - если type не является ни TIFFTag.TIFF_LONG, ни TIFFTag.TIFF_IFD_POINTER.

IllegalArgumentException - если offset <= 0.

NullPointerException - если dir == null.

См. также:

• TIFFField(TIFFTag,int,int,Object)

public static TIFFField createFromMetadataNode(TIFFTagSet tagSet, Node node)

Параметры:

tagSet - TIFFTagSet, которому принадлежит TIFFTag поля.

node - Узел TIFFField метаданных TIFF-изображения.

Возвращает:

Новый TIFFField.

Исключения:

IllegalArgumentException - Если содержимое параметра Node не соответствует структуре элемента TIFFField, определённой спецификацией формата метаданных TIFF-изображения TIFF native image metadata format specification, или если сочетание атрибутов узла и данных не является допустимым по спецификации конструктора TIFFField(TIFFTag,int,int,Object). Обратите внимание, что на таком исключении может быть установлен код ошибки.

public TIFFTag getTag()

Возвращает:

Связанный TIFFTag.

public int getTagNumber()

Возвращает:

Номер тега.

public int getType()

Возвращает:

Тип данных значения поля.

public static String getTypeName(int dataType)

Параметры:

dataType - Одно из значений TIFFTag.TIFF_*, указывающих тип данных поля, как он записан в поток TIFF.

Возвращает:

Имя типа, соответствующее предоставленной константе типа.

Исключения:

IllegalArgumentException - если dataType не является одним из TIFFTag.TIFF_* констант типов данных.

public static int getTypeByName(String typeName)

Параметры:

typeName - Имя типа.

Возвращает:

Одно из TIFFTag.TIFF_* констант или -1, если имя не распознано.

public static Object createArrayForType(int dataType, int count)

Параметры:

dataType - Один из констант TIFFTag.TIFF_* типов данных.

count - Количество значений в массиве.

Возвращает:

Массив, подходящий для указанного типа данных.

Исключения:

IllegalArgumentException - если dataType не является одной из констант TIFFTag.TIFF_* типов данных.

IllegalArgumentException - если count < 0.

IllegalArgumentException - если count < 1 и type равно TIFF_RATIONAL или TIFF_SRATIONAL.

IllegalArgumentException - если count != 1 и type равно TIFF_IFD_POINTER.

public Node getAsNativeNode()

Возвращает:

Node, названный "TIFFField" или "TIFFIFD".

public boolean isIntegral()

Возвращает:

Является ли тип поля целым.

public int getCount()

Возвращает:

Количество элементов данных, присутствующих в поле.

public Object getData()

Возвращает:

Объект данных поля.

public byte[] getAsBytes()

Возвращает:

Данные как неинтерпретированный массив байтов.

Исключения:

ClassCastException - если поле не является типом TIFF_BYTE, TIFF_SBYTE или TIFF_UNDEFINED.

public char[] getAsChars()

Возвращает:

Данные как массив char.

Исключения:

ClassCastException - если поле не является типом TIFF_SHORT.

public short[] getAsShorts()

Возвращает:

Данные как массив short.

Исключения:

ClassCastException - если поле не является типом TIFF_SSHORT.

public int[] getAsInts()

Возвращает:

Данные как массив int.

Исключения:

ClassCastException - если поле не является типом TIFF_SHORT, TIFF_SSHORT или TIFF_SLONG.

public long[] getAsLongs()

Возвращает:

Данные как массив long.

Исключения:

ClassCastException - если поле не является типом TIFF_LONG или TIFF_IFD_POINTER.

public float[] getAsFloats()

Возвращает:

Данные как массив float.

Исключения:

ClassCastException - если поле не является типом TIFF_FLOAT.

public double[] getAsDoubles()

Возвращает:

Данные как массив double.

Исключения:

ClassCastException - если поле не является типом TIFF_DOUBLE.

public int[][] getAsSRationals()

Возвращает:

Данные как массив знаковых рациональных чисел.

Исключения:

ClassCastException - если поле не является типом TIFF_SRATIONAL.

public long[][] getAsRationals()

Возвращает:

Данные как массив беззнаковых рациональных чисел.

Исключения:

ClassCastException - если поле не является типом TIFF_RATIONAL.

public int getAsInt(int index)

Параметры:

index - Индекс данных.

Возвращает:

Данные по указанному индексу как int.

public long getAsLong(int index)

Параметры:

index - Индекс данных.

Возвращает:

Данные по указанному индексу как long.

public float getAsFloat(int index)

Параметры:

index - Индекс данных.

Возвращает:

Данные по указанному индексу как float.

public double getAsDouble(int index)

Parameters:

index - Индекс данных.

Returns:

Данные в заданном индексе как double.

public String getAsString(int index)

Parameters:

index - Индекс данных.

Returns:

Данные в заданном индексе как String.

Throws:

ClassCastException - если поле не имеет тип TIFF_ASCII.

public int[] getAsSRational(int index)

Parameters:

index - Индекс данных.

Returns:

Данные в заданном индексе как рациональное число со знаком.

Throws:

ClassCastException - если поле не имеет тип TIFF_SRATIONAL.

public long[] getAsRational(int index)

Parameters:

index - Индекс данных.

Returns:

Данные в заданном индексе как беззнаковое рациональное число.

Throws:

ClassCastException - если поле не имеет тип TIFF_RATIONAL.

public String getValueAsString(int index)

Parameters:

index - Индекс данных.

Returns:

Данные в заданном индексе как строку.

Throws:

ClassCastException - если поле не имеет один из разрешённых типов.

public boolean hasDirectory()

Returns:

true тогда и только тогда, когда getDirectory() возвращает не null.

public TIFFDirectory getDirectory()

Returns:

экземпляр TIFFDirectory или null.

public TIFFField clone() throws CloneNotSupportedException

Overrides:

clone в классе Object

Returns:

Клон этого TIFFField.

Throws:

CloneNotSupportedException - если экземпляр не может быть клонирован.

See Also:

• Cloneable