- 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 int
MAX_DATATYPE
表示TIFF数据类型的数字最大常量。static int
MIN_DATATYPE
表示TIFF数据类型的数字最小常量。static int
TIFF_ASCII
以null结尾的ASCII字符串的标志。static int
TIFF_BYTE
8位无符号整数的标志。static int
TIFF_DOUBLE
标志为64位IEEE双打。static int
TIFF_FLOAT
用于32位IEEE浮点数的标志。static int
TIFF_IFD_POINTER
IFF指针的标志在TIFF规范补充1中的TIFF技术说明1中定义。static int
TIFF_LONG
标记32位无符号整数。static int
TIFF_RATIONAL
用于32位无符号整数对的标志。static int
TIFF_SBYTE
8位有符号整数的标志。static int
TIFF_SHORT
标记为16位无符号整数。static int
TIFF_SLONG
用于32位有符号整数的标志。static int
TIFF_SRATIONAL
用于32位有符号整数对的标志。static int
TIFF_SSHORT
16位有符号整数的标志。static int
TIFF_UNDEFINED
标记8位未解释的字节。static String
UNKNOWN_TAG_NAME
分配给具有未知标记号的标记的名称。
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 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
一部分的TIFFTagSet
。String
getValueName(int value)
返回与此标记的数据可能采用的特定值关联的助记符名称,如果没有名称,则null
。boolean
hasValueNames()
如果存在与此标记关联的数据的合法值集合关联的助记符名称,则返回true
。boolean
isDataTypeOK(int dataType)
如果给定数据类型可用于与此标记关联的数据,则返回true
。boolean
isIFDPointer()
如果此标记用于指向包含其他标记的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()
- 结果
- 具有助记名称的值。
-
-