Spec-Zone.ru › OpenJDK 27

Класс TIFFTag

java.lang.Object
javax.imageio.plugins.tiff.TIFFTag
public class TIFFTag extends Object
Класс, определяющий понятие тега TIFF. Тег TIFF — это ключ, который может присутствовать в каталоге файлов изображений (IFD). В IFD с каждым тегом связаны данные, которые могут состоять из нуля или более значений заданного типа данных. Сочетание тега и значения называется записью IFD или полем TIFF.

Фактические значения тегов, используемые в корневом IFD стандартного («базового») потока TIFF, определены в классе BaselineTIFFTagSet.

Начиная с:
9
См. также:
  • BaselineTIFFTagSet
  • TIFFField
  • TIFFTagSet

Краткое описание полей

Модификатор и тип Поле Описание
static final int MAX_DATATYPE
Численно наибольшая константа, представляющая тип данных TIFF.
static final int MIN_DATATYPE
Численно наименьшая константа, представляющая тип данных TIFF.
static final int TIFF_ASCII
Флаг строк ASCII с завершающим нулевым символом.
static final int TIFF_BYTE
Флаг 8-разрядных беззнаковых целых чисел.
static final int TIFF_DOUBLE
Флаг 64-разрядных чисел двойной точности IEEE.
static final int TIFF_FLOAT
Флаг 32-разрядных чисел с плавающей точкой IEEE.
static final int TIFF_IFD_POINTER
Флаг указателя IFD, определённого в технической заметке 1 приложения 1 к спецификации TIFF.
static final int TIFF_LONG
Флаг 32-разрядных беззнаковых целых чисел.
static final int TIFF_RATIONAL
Флаг пар 32-разрядных беззнаковых целых чисел.
static final int TIFF_SBYTE
Флаг 8-разрядных знаковых целых чисел.
static final int TIFF_SHORT
Флаг 16-разрядных беззнаковых целых чисел.
static final int TIFF_SLONG
Флаг 32-разрядных знаковых целых чисел.
static final int TIFF_SRATIONAL
Флаг пар 32-разрядных знаковых целых чисел.
static final int TIFF_SSHORT
Флаг 16-разрядных знаковых целых чисел.
static final int TIFF_UNDEFINED
Флаг 8-разрядных байтов без интерпретации.
static final String UNKNOWN_TAG_NAME
Имя, присваиваемое тегу с неизвестным номером.

Краткое описание конструкторов

Конструктор Описание
TIFFTag(String name, int number, int dataTypes)
Создаёт TIFFTag с заданными именем, номером тега и набором допустимых типов данных.
TIFFTag(String name, int number, int dataTypes, int count)
Создаёт TIFFTag с заданными именем, номером тега, набором допустимых типов данных и количеством значений.
TIFFTag(String name, int number, TIFFTagSet tagSet)
Создаёт TIFFTag с заданными именем и номером тега, а также TIFFTagSet, на который он ссылается.

Краткое описание методов

Модификатор и тип Метод Описание
protected void addValueName(int value, String name)
Добавляет мнемоническое имя для определённого значения, которое могут принимать данные этого тега.
int getCount()
Возвращает количество значений этого тега.
int getDataTypes()
Возвращает битовую маску, указывающую набор типов данных, которые могут использоваться для хранения данных, связанных с тегом.
String getName()
Возвращает имя тега в том виде, в котором оно будет отображаться в метаданных изображения.
int[] getNamedValues()
Возвращает массив значений, для которых определены мнемонические имена.
int getNumber()
Возвращает целое число, используемое для представления тега.
static int getSizeOfType(int dataType)
Возвращает количество байтов, используемых для хранения значения заданного типа данных.
TIFFTagSet getTagSet()
Возвращает TIFFTagSet, частью которого является этот тег.
String getValueName(int value)
Возвращает мнемоническое имя, связанное с определённым значением, которое могут принимать данные этого тега, или null, если имя отсутствует.
boolean hasValueNames()
Возвращает true, если с набором допустимых значений данных, связанных с этим тегом, связаны мнемонические имена.
boolean isDataTypeOK(int dataType)
Возвращает true, если указанный тип данных может использоваться для данных, связанных с этим тегом.
boolean isIFDPointer()
Возвращает true, если этот тег используется для указания на структуру IFD, содержащую дополнительные теги.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект какому-либо другому объекту.
protected void finalize()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс среды выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробуждён, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробуждён, обычно в результате вызова notify или interrupt, либо пока не истечёт заданный интервал реального времени.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробуждён, обычно в результате вызова notify или interrupt, либо пока не истечёт заданный интервал реального времени.

Подробное описание полей

TIFF_BYTE

public static final int TIFF_BYTE
Флаг 8-разрядных беззнаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_ASCII

public static final int TIFF_ASCII
Флаг строк ASCII с завершающим нулевым символом.
См. также:
  • Значения константных полей

TIFF_SHORT

public static final int TIFF_SHORT
Флаг 16-разрядных беззнаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_LONG

public static final int TIFF_LONG
Флаг 32-разрядных беззнаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_RATIONAL

public static final int TIFF_RATIONAL
Флаг пар 32-разрядных беззнаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_SBYTE

public static final int TIFF_SBYTE
Флаг 8-разрядных знаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_UNDEFINED

public static final int TIFF_UNDEFINED
Флаг 8-разрядных байтов без интерпретации.
См. также:
  • Значения константных полей

TIFF_SSHORT

public static final int TIFF_SSHORT
Флаг 16-разрядных знаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_SLONG

public static final int TIFF_SLONG
Флаг 32-разрядных знаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_SRATIONAL

public static final int TIFF_SRATIONAL
Флаг пар 32-разрядных знаковых целых чисел.
См. также:
  • Значения константных полей

TIFF_FLOAT

public static final int TIFF_FLOAT
Флаг 32-разрядных чисел с плавающей точкой IEEE.
См. также:
  • Значения константных полей

TIFF_DOUBLE

public static final int TIFF_DOUBLE
Флаг 64-разрядных чисел двойной точности IEEE.
См. также:
  • Значения константных полей

TIFF_IFD_POINTER

public static final int TIFF_IFD_POINTER
Флаг указателя IFD, определённого в технической заметке 1 приложения 1 к спецификации TIFF.
См. также:
  • Значения константных полей

MIN_DATATYPE

public static final int MIN_DATATYPE
Численно наименьшая константа, представляющая тип данных TIFF.
См. также:
  • Значения константных полей

MAX_DATATYPE

public static final int MAX_DATATYPE
Численно наибольшая константа, представляющая тип данных TIFF.
См. также:
  • Значения константных полей

UNKNOWN_TAG_NAME

public static final String UNKNOWN_TAG_NAME
Имя, присваиваемое тегу с неизвестным номером. Такой тег может быть создан, например, при чтении IFD, если встретился номер тега, отсутствующий во всех известных читателю TIFFTagSet.
См. также:
  • Значения константных полей

Подробное описание конструкторов

TIFFTag

public TIFFTag(String name, int number, int dataTypes, int count)
Создаёт TIFFTag с заданными именем, номером тега, набором допустимых типов данных и количеством значений. Отрицательное количество значений означает, что допустимо любое число значений либо необходимое количество определяется значениями других полей IFD. Неотрицательное количество задаёт число значений, которое должно содержать связанное поле. С этим тегом не будет связан TIFFTagSet.

Если с допустимыми значениями данных тега необходимо связать мнемонические имена, для каждого имени следует вызвать addValueName() для нового экземпляра. Мнемонические имена применимы только к тегам с целочисленным типом данных.

Объяснение преобразования набора типов данных в битовую маску см. в документации к getDataTypes().

Параметры:
name — имя тега.
number — число, используемое для представления тега.
dataTypes — битовая маска, указывающая набор допустимых типов данных для этого тега.
count — количество значений для этого тега.
Исключения:
NullPointerException — если name равно null.
IllegalArgumentException — если number отрицательно, dataTypes отрицательно или указывает тип вне допустимого диапазона.

TIFFTag

public TIFFTag(String name, int number, TIFFTagSet tagSet)
Создаёт TIFFTag с заданными именем и номером тега, а также TIFFTagSet, на который он ссылается. В набор допустимых типов данных включаются TIFF_LONG и TIFF_IFD_POINTER, а количество значений устанавливается равным единице. TIFFTagSet будет представлять набор TIFFTags, присутствующих в IFD, на который указывает этот тег. TIFFTag представляет указатель IFD тогда и только тогда, когда tagSet не равен null или допустим тип данных TIFF_IFD_POINTER.
Параметры:
name — имя тега.
number — число, используемое для представления тега.
tagSet — TIFFTagSet, к которому относится этот тег.
Исключения:
NullPointerException — если name или tagSet равны null.
IllegalArgumentException — если number отрицательно.
См. также:
  • TIFFTag(String, int, int, int)

TIFFTag

public TIFFTag(String name, int number, int dataTypes)
Создаёт TIFFTag с заданными именем, номером тега и набором допустимых типов данных. Количество значений тега не определено, и с ним не будет связан TIFFTagSet.
Параметры:
name — имя тега.
number — число, используемое для представления тега.
dataTypes — битовая маска, указывающая набор допустимых типов данных для этого тега.
Исключения:
NullPointerException — если name равно null.
IllegalArgumentException — если number отрицательно, dataTypes отрицательно или указывает тип вне допустимого диапазона.
См. также:
  • TIFFTag(String, int, int, int)

Подробное описание методов

getSizeOfType

public static int getSizeOfType(int dataType)
Возвращает количество байтов, используемых для хранения значения заданного типа данных.
Параметры:
dataType — тип данных, для которого выполняется запрос.
Возвращает:
количество байтов, используемых для хранения значения заданного типа данных.
Исключения:
IllegalArgumentException — если datatype меньше MIN_DATATYPE или больше MAX_DATATYPE.

getName

public String getName()
Возвращает имя тега в том виде, в котором оно будет отображаться в метаданных изображения.
Возвращает:
имя тега в виде String.

getNumber

public int getNumber()
Возвращает целое число, используемое для представления тега.
Возвращает:
номер тега в виде int.

getDataTypes

public int getDataTypes()
Возвращает битовую маску, указывающую набор типов данных, которые можно использовать для хранения данных, связанных с тегом. Например, для тега, который может хранить значения SHORT и LONG, будет возвращено значение: 
(1 << TIFFTag.TIFF_SHORT) | (1 << TIFFTag.TIFF_LONG)
Возвращает:
int, содержащий битовую маску, кодирующую набор допустимых типов данных.

getCount

public int getCount()
Возвращает количество значений этого тега. Если это значение положительно, оно обозначает требуемое число значений для TIFFField, содержащего этот тег. Если значение отрицательно, количество не определено. В последнем случае количество может быть вычислено, например, число значений поля BitsPerSample равно SamplesPerPixel, либо оно может быть переменным, как в случае большинства полей US-ASCII.
Возвращает:
количество значений этого тега.

isDataTypeOK

public boolean isDataTypeOK(int dataType)
Возвращает true, если указанный тип данных может использоваться для данных, связанных с этим тегом.
Параметры:
dataType — тип данных, для которого выполняется запрос: один из TIFF_BYTE, TIFF_SHORT и т. д.
Возвращает:
boolean, указывающий, можно ли использовать указанный тип данных с этим тегом.
Исключения:
IllegalArgumentException — если datatype меньше MIN_DATATYPE или больше MAX_DATATYPE.

getTagSet

public TIFFTagSet getTagSet()
Возвращает TIFFTagSet, частью которого является этот тег.
Возвращает:
содержащий TIFFTagSet.

isIFDPointer

public boolean isIFDPointer()
Возвращает true, если этот тег используется для указания на структуру IFD, содержащую дополнительные теги. TIFFTag представляет указатель IFD тогда и только тогда, когда его TIFFTagSet не равен null или допустим тип данных TIFF_IFD_POINTER. Это условие выполняется тогда и только тогда, когда выполняется getTagSet() != null или isDataTypeOK(TIFF_IFD_POINTER) == true.

Многие расширения TIFF используют механизм IFD, чтобы ограничить количество новых тегов, которые могут присутствовать в корневом IFD.

Возвращает:
true, если этот тег указывает на IFD.

hasValueNames

public boolean hasValueNames()
Возвращает true, если с набором допустимых значений данных, связанных с этим тегом, связаны мнемонические имена. Мнемонические имена применимы только к тегам с целочисленным типом данных.
Возвращает:
true, если мнемонические имена значений доступны.

addValueName

protected void addValueName(int value, String name)
Добавляет мнемоническое имя для определённого значения, которое могут принимать данные этого тега. Мнемонические имена применимы только к тегам с целочисленным типом данных.
Параметры:
value — значение данных.
name — имя, связываемое со значением.

getValueName

public String getValueName(int value)
Возвращает мнемоническое имя, связанное с определённым значением, которое могут принимать данные этого тега, или null, если имя отсутствует. Мнемонические имена применимы только к тегам с целочисленным типом данных.
Параметры:
value — значение данных.
Возвращает:
мнемоническое имя, связанное со значением, в виде String.

getNamedValues

public int[] getNamedValues()
Возвращает массив значений, для которых определены мнемонические имена. Метод getValueName() возвращает значение, отличное от null, только для значений, содержащихся в возвращённом массиве. Мнемонические имена применимы только к тегам с целочисленным типом данных.
Возвращает:
значения, для которых определено мнемоническое имя.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или её дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API