Класс 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, определенного в техническом примечании TIFF 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_POINTER
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- если имя или 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() вернёт не-null только для значений, содержащихся в возвращённом массиве. Мнемонические имена применяются только к тегам, имеющим целочисленный тип данных.- Возвращает:
- значения, для которых есть мнемоническое имя.
© 1993, 2023, 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/21/docs/api/java.desktop/javax/imageio/plugins/tiff/TIFFTag.html