- java.lang.Object
-
- javax.imageio.plugins.tiff.TIFFTag
-
public class TIFFTag extends Object
定义TIFF标记概念的类。 TIFF标记是可能出现在图像文件目录(IFD)中的密钥。 在IFD中,每个标签都有一些与之关联的数据,这些数据可能包含给定数据类型的零个或多个值。 标签和值的组合称为IFD Entry或TIFF Field。标准(“基线”)tiff流的根IFD中使用的实际标记值在
BaselineTIFFTagSet类中定义。- 从以下版本开始:
- 9
- 另请参见:
-
BaselineTIFFTagSet,TIFFField,TIFFTagSet
-
-
字段汇总
字段 变量和类型 字段 描述 static intMAX_DATATYPE表示TIFF数据类型的数字最大常量。static intMIN_DATATYPE表示TIFF数据类型的数字最小常量。static intTIFF_ASCII以null结尾的ASCII字符串的标志。static intTIFF_BYTE8位无符号整数的标志。static intTIFF_DOUBLE标志为64位IEEE双打。static intTIFF_FLOAT用于32位IEEE浮点数的标志。static intTIFF_IFD_POINTERIFF指针的标志在TIFF规范补充1中的TIFF技术说明1中定义。static intTIFF_LONG标记32位无符号整数。static intTIFF_RATIONAL用于32位无符号整数对的标志。static intTIFF_SBYTE8位有符号整数的标志。static intTIFF_SHORT标记为16位无符号整数。static intTIFF_SLONG用于32位有符号整数的标志。static intTIFF_SRATIONAL用于32位有符号整数对的标志。static intTIFF_SSHORT16位有符号整数的标志。static intTIFF_UNDEFINED标记8位未解释的字节。static StringUNKNOWN_TAG_NAME分配给具有未知标记号的标记的名称。
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 protected voidaddValueName(int value, String name)为此标记的数据可能采用的特定值添加助记符名称。intgetCount()返回此标记的值计数。intgetDataTypes()返回一个位掩码,指示可用于存储与标记关联的数据的数据类型集。StringgetName()返回标记的名称,因为它将显示在图像元数据中。int[]getNamedValues()返回为其定义助记符名称的值数组。intgetNumber()返回用于表示标记的整数。static intgetSizeOfType(int dataType)返回用于存储给定数据类型值的字节数。TIFFTagSetgetTagSet()返回此标记TIFFTagSet一部分的TIFFTagSet。StringgetValueName(int value)返回与此标记的数据可能采用的特定值关联的助记符名称,如果没有名称,则null。booleanhasValueNames()如果存在与此标记关联的数据的合法值集合关联的助记符名称,则返回true。booleanisDataTypeOK(int dataType)如果给定数据类型可用于与此标记关联的数据,则返回true。booleanisIFDPointer()如果此标记用于指向包含其他标记的IFD结构,则返回true。
-
-
-
字段详细信息
-
TIFF_BYTE
public static final int TIFF_BYTE
8位无符号整数的标志。- 另请参见:
- 常数字段值
-
TIFF_ASCII
public static final int TIFF_ASCII
以null结尾的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
IFF指针的标志在TIFF规范补充1中的TIFF技术说明1中定义。- 另请参见:
- 常数字段值
-
MIN_DATATYPE
public static final int MIN_DATATYPE
表示TIFF数据类型的数字最小常量。- 另请参见:
- 常数字段值
-
MAX_DATATYPE
public static final int MAX_DATATYPE
表示TIFF数据类型的数字最大常量。- 另请参见:
- 常数字段值
-
-
构造方法详细信息
-
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,值计数为1。TIFFTagSet将代表出现在IFD指向的TIFFTag的集合。 当且仅当tagSet为非null或数据类型TIFF_IFD_POINTER合法时,TIFFTag表示IFD指针。- 参数
-
name- 标签的名称。 -
number- 用于表示标记的数字。 -
tagSet- 此标签所属的TIFFTagSet。 - 异常
-
NullPointerException- 如果name或tagSet为null。 -
IllegalArgumentException- 如果数字为负数。 - 另请参见:
-
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等 - 结果
-
a
boolean指示给定的数据类型是否可以与此标记一起使用。 - 异常
-
IllegalArgumentException- 如果datatype小于MIN_DATATYPE或大于MAX_DATATYPE。
-
getTagSet
public TIFFTagSet getTagSet()
返回此标记TIFFTagSet一部分的TIFFTagSet。- 结果
-
包含
TIFFTagSet。
-
isIFDPointer
public boolean isIFDPointer()
如果此标记用于指向包含其他标记的IFD结构,则返回true。 当且仅当其TIFFTagSet为非null或数据类型TIFF_IFD_POINTER合法时,TIFFTag表示IFD指针。 当且仅当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()
- 结果
- 具有助记名称的值。
-
-