モジュール java.desktop
パッケージ javax.imageio.plugins.tiff

クラスTIFFTag

java.lang.Object
javax.imageio.plugins.tiff.TIFFTag
public class TIFFTag extends Object
TIFFタグの概念を定義するクラス。 TIFFタグは、イメージ・ファイル・ディレクトリ(IFD)に表示されるキーです。 IFDでは、各タグはそれに関連付けられたいくつかのデータを有し、これは与えられたデータ型のゼロまたはそれ以上の値からなります。 タグと値の組み合わせは、IFD EntryまたはTIFF Fieldとして知られています。

標準の("baseline") tiffストリームのルートIFDで使用される実際のタグ値は、BaselineTIFFTagSetクラスで定義されています。

導入されたバージョン:
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 doubleのフラグ。
    static final int
    TIFF_FLOAT
    32ビットIEEE浮動小数点のフラグ。
    static final int
    TIFF_IFD_POINTER
    TIFF仕様補足1のTIFF Tech Note 1で定義されているIFDポインタのフラグ。
    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(String name, int number, int dataTypes)
    指定された名前、タグ番号、および有効なデータ型のセットを持つTIFFTagを構築します。
    TIFFTag(String name, int number, int dataTypes, int count)
    指定された名前、タグ番号、有効なデータ型のセット、および値のカウントを持つTIFFTagを構築します。
    TIFFTag(String name, int number, TIFFTagSet tagSet)
    指定された名前、タグ番号、およびそれが参照するTIFFTagSetを持つTIFFTagを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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を返します。
    String
    getValueName(int value)
    このタグ・データが取り得る特定の値に関連付けられたニーモニック名を返します。名前がない場合はnullを返します。
    boolean
    hasValueNames()
    このタグに関連付けられたデータの正当な値のセットに関連付けられたニーモニック名がある場合は、trueを返します。
    boolean
    isDataTypeOK(int dataType)
    指定されたデータ型がこのタグに関連付けられたデータに使用される場合は、trueを返します。
    boolean
    isIFDPointer()
    このタグが追加のタグを含むIFD構造体を指すために使用される場合は、trueを返します。

    クラス java.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • フィールド詳細

    • TIFF_BYTE

      public static final int TIFF_BYTE
      8ビットの符号なし整数のフラグ。
      関連項目:

    • TIFF_ASCII

      public static final int TIFF_ASCII
      ヌル終了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 doubleのフラグ。
      関連項目:

    • TIFF_IFD_POINTER

      public static final int TIFF_IFD_POINTER
      TIFF仕様補足1のTIFF Tech Note 1で定義されているIFDポインタのフラグ。
      関連項目:

    • 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 - このタグの値の数。
      throws:
      NullPointerException - nameがnullの場合。
      IllegalArgumentException - numberが負の場合、またはdataTypesが負の場合、または範囲外の型を指定している場合。

    • TIFFTag

      public TIFFTag(String name, int number, TIFFTagSet tagSet)
      指定された名前、タグ番号、およびそれが参照するTIFFTagSetを持つTIFFTagを構築します。 有効なデータ型はTIFF_LONGとTIFF_IFD_POINTERを含むように設定され、値のカウントは1です。 TIFFTagSetは、指されているIFDに現れるTIFFTagのセットを表します。 TIFFTagは、tagSetが非nullである場合、またはデータ型TIFF_IFD_POINTERが合法である場合にのみIFDポインタを表します。
      パラメータ:
      name - タグの名前。
      number - タグを表すために使用される番号。
      tagSet - このタグが属するTIFFTagSet。
      throws:
      NullPointerException - nameまたはtagSetがnullの場合。
      IllegalArgumentException - 数値が負の場合。
      関連項目:

    • TIFFTag

      public TIFFTag(String name, int number, int dataTypes)
      指定された名前、タグ番号、および有効なデータ型のセットを持つTIFFTagを構築します。 タグの値のカウントは未定義で、関連するTIFFTagSetはありません。
      パラメータ:
      name - タグの名前。
      number - タグを表すために使用される番号。
      dataTypes - このタグの有効なデータ型のセットを示すビット・マスク。
      throws:
      NullPointerException - nameがnullの場合。
      IllegalArgumentException - numberが負の場合、またはdataTypesが負の場合、または範囲外の型を指定している場合。
      関連項目:

  • メソッドの詳細

    • getSizeOfType

      public static int getSizeOfType(int dataType)
      指定されたデータ型の値を格納するために使用されるバイト数を返します。
      パラメータ:
      dataType - 問合せされるデータ型。
      戻り値:
      指定されたデータ型を格納するために使用されたバイト数。
      throws:
      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などのうちの1つ。
      戻り値:
      指定されたデータ型をこのタグで使用できるかどうかを示すboolean。
      throws:
      IllegalArgumentException - datatypeがMIN_DATATYPEより小さいか、MAX_DATATYPEより大きい場合。

    • getTagSet

      public TIFFTagSet getTagSet()
      このタグが含まれるTIFFTagSetを返します。
      戻り値:
      TIFFTagSetを含む。

    • isIFDPointer

      public boolean isIFDPointer()
      このタグが追加のタグを含むIFD構造体を指すために使用される場合は、trueを返します。 TIFFTagは、そのTIFFTagSetが非nullであるか、またはデータ型TIFF_IFD_POINTERが合法である場合にのみIFDポインタを表します。 この条件は、getTagSet() != nullまたはisDataTypeOK(TIFF_IFD_POINTER) == trueのいずれかの場合にのみ満たされます。

      多くのTIFF拡張は、IFDメカニズムを使用して、ルートIFDに現れる可能性のある新しいタグの数を制限します。

      戻り値:
      このタグがIFDを指している場合はtrue。

    • 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を返します。 ニーモニック名は、整数データ型を持つタグにのみ適用されます。
      戻り値:
      ニーモニック名がある値。