模块  java.desktop

Class TIFFTag


  • public class TIFFTag
    extends Object
    定义TIFF标记概念的类。 TIFF标记是可能出现在图像文件目录(IFD)中的密钥。 在IFD中,每个标签都有一些与之关联的数据,这些数据可能包含给定数据类型的零个或多个值。 标签和值的组合称为IFD Entry或TIFF Field。

    标准(“基线”)tiff流的根IFD中使用的实际标记值在BaselineTIFFTagSet类中定义。

    从以下版本开始:
    9
    另请参见:
    BaselineTIFFTagSetTIFFFieldTIFFTagSet
    • 字段汇总

      字段  
      变量和类型 字段 描述
      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
      分配给具有未知标记号的标记的名称。
    • 构造方法摘要

      构造方法  
      构造器 描述
      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一部分的 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数据类型的数字最大常量。
        另请参见:
        常数字段值
      • 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_LONGTIFF_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_BYTETIFF_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() != nullisDataTypeOK(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 助记符名称仅适用于具有整数数据类型的标记。
        结果
        具有助记名称的值。