Класс TIFFTag
public class TIFFTag extends Object
Фактические значения тегов, используемые в корневом IFD стандартного («базового») потока tiff, определены в классе BaselineTIFFTagSet.
- Since:
- 9
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
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 |
Конструирует TIFFTag с заданным именем, номером тега и набором допустимых типов данных. |
TIFFTag |
Конструирует TIFFTag с заданным именем, номером тега, набором допустимых типов данных и количеством значений. |
TIFFTag |
Конструирует TIFFTag с заданным именем, номером тега и TIFFTagSet, на который он ссылается. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
addValueName |
Добавляет мнемоническое имя для конкретного значения, которое могут принимать данные этого тега. |
int |
getCount() |
Возвращает количество значений данного тега. |
int |
getDataTypes() |
Возвращает маску битов, указывающую набор типов данных, которые могут использоваться для хранения данных, связанных с тегом. |
String |
getName() |
Возвращает имя тега, которое будет отображаться в метаданных изображения. |
int[] |
getNamedValues() |
Возвращает массив значений, для которых определены мнемонические имена. |
int |
getNumber() |
Возвращает целое число, используемое для представления тега. |
static int |
getSizeOfType |
Возвращает количество байтов, используемых для хранения значения данного типа данных. |
TIFFTagSet |
getTagSet() |
Возвращает TIFFTagSet, частью которого является этот тег. |
String |
getValueName |
Возвращает мнемоническое имя, связанное с конкретным значением, которое могут принимать данные данного тега, или null , если имя отсутствует. |
boolean |
hasValueNames() |
Возвращает true , если существуют мнемонические имена, связанные с набором допустимых значений данных, связанных с этим тегом. |
boolean |
isDataTypeOK |
Возвращает true , если данный тип данных может использоваться для данных, связанных с этим тегом. |
boolean |
isIFDPointer() |
Возвращает true , если этот тег используется для указания структуры IFD, содержащей дополнительные теги. |
Подробное описание полей
TIFF_BYTE
public static final int TIFF_BYTE
- См. также:
TIFF_ASCII
public static final int TIFF_ASCII
- См. также:
TIFF_SHORT
public static final int TIFF_SHORT
- См. также:
TIFF_LONG
public static final int TIFF_LONG
- См. также:
TIFF_RATIONAL
public static final int TIFF_RATIONAL
- См. также:
TIFF_SBYTE
public static final int TIFF_SBYTE
- См. также:
TIFF_UNDEFINED
public static final int TIFF_UNDEFINED
- См. также:
TIFF_SSHORT
public static final int TIFF_SSHORT
- См. также:
TIFF_SLONG
public static final int TIFF_SLONG
- См. также:
TIFF_SRATIONAL
public static final int TIFF_SRATIONAL
- См. также:
TIFF_FLOAT
public static final int TIFF_FLOAT
- См. также:
TIFF_DOUBLE
public static final int TIFF_DOUBLE
- См. также:
TIFF_IFD_Указатель
public static final int TIFF_IFD_POINTER
- См. также:
MIN_DATATYPE
public static final int MIN_DATATYPE
- См. также:
MAX_DATATYPE
public static final int MAX_DATATYPE
- См. также:
UNKNOWN_TAG_NAME
public static final String UNKNOWN_TAG_NAME
TIFFTagSet известных чтецу.- См. также:
Подробное описание конструкторов
TIFFTag
public TIFFTag(String name, int number, int dataTypes, int count)
TIFFTag с заданным именем, номером тега, набором допустимых типов данных и количеством значений. Отрицательное количество значений означает, что либо допустимо произвольное количество значений, либо требуемое количество определяется значениями других полей в IFD. Положительное количество указывает количество значений, которые должно содержать соответствующее поле. У тега не будет связанного TIFFTagSet. Если необходимо связать мнемонические имена с допустимыми значениями данных для тега, для каждого имени следует вызвать addValueName() на новом экземпляре. Мнемонические имена применяются только к тегам с целочисленным типом данных.
См. документацию getDataTypes() для объяснения, как набор типов данных должен быть преобразован в битовую маску.
- Параметры:
-
name- имя тега. -
number- номер, используемый для представления тега. -
dataTypes- битовая маска, указывающая набор допустимых типов данных для данного тега. -
count- количество значений для данного тега. - Исключения:
-
NullPointerException- если имя равно null. -
IllegalArgumentException- если номер отрицательный или dataTypes отрицательный или указывает на тип вне диапазона.
TIFFTag
public TIFFTag(String name, int number, TIFFTagSet tagSet)
TIFFTag с заданным именем, номером тега и TIFFTagSet, к которому он относится. Допустимые типы данных включают TIFF_LONG и TIFF_IFD_POINTER, а количество значений равно единице. TIFFTagSet будет представлять набор TIFFTag которые появляются в указанном IFD. TIFFTag представляет собой указатель на IFD только в том случае, если tagSet не равен null или тип данных TIFF_IFD_POINTER допустим.- Параметры:
-
name- имя тега. -
number- номер, используемый для представления тега. -
tagSet-TIFFTagSetк которому принадлежит этот тег. - Исключения:
-
NullPointerException- если name или tagSet равны null. -
IllegalArgumentException- если номер отрицательный. - См. также:
TIFFTag
public TIFFTag(String name, int number, int dataTypes)
TIFFTag с заданным именем, номером тега и набором допустимых типов данных. Количество значений тега не определено, и у него нет связанного TIFFTagSet.- Параметры:
-
name- имя тега. -
number- номер, используемый для представления тега. -
dataTypes- битовая маска, указывающая набор допустимых типов данных для данного тега. - Исключения:
-
NullPointerException- если имя равно null. -
IllegalArgumentException- если номер отрицательный или dataTypes отрицательный или указывает на тип вне диапазона. - См. также:
Подробное описание методов
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()
(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() вернёт не пустое значение только для значений, содержащихся в возвращаемом массиве. Мнемонические имена применяются только к тегам, имеющим целочисленный тип данных.- Возвращает:
- значения, для которых существует мнемоническое имя.
© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/imageio/plugins/tiff/TIFFTag.html