モジュール java.desktop

クラス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
関連項目:
BaselineTIFFTagSet, TIFFField, TIFFTagSet
  • フィールドのサマリー

    フィールド 
    修飾子と型 フィールド 説明
    static int MAX_DATATYPE
    数値で最大のTIFFデータ型を表す定数。
    static int MIN_DATATYPE
    数値で最小の定数で、TIFFデータ型を表します。
    static int TIFF_ASCII
    ヌル終了ASCII文字列のフラグ。
    static int TIFF_BYTE
    8ビットの符号なし整数のフラグ。
    static int TIFF_DOUBLE
    64ビットIEEE doubleのフラグ。
    static int TIFF_FLOAT
    32ビットIEEE浮動小数点のフラグ。
    static int TIFF_IFD_POINTER
    TIFF仕様補足1のTIFF Tech Note 1で定義されているIFDポインタのフラグ。
    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)
    指定された名前、タグ番号、およびそれが参照する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で宣言されたメソッド

    cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait
  • フィールド詳細

  • コンストラクタの詳細

    • 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)
      指定された名前、タグ番号、およびそれが参照するTIFFTagSetを持つTIFFTagを構築します。 有効なデータ型はTIFF_LONGTIFF_IFD_POINTERを含むように設定され、値のカウントは1です。 TIFFTagSetは、指されているIFDに現れるTIFFTagのセットを表します。 TIFFTagは、tagSetが非nullである場合、またはデータ型TIFF_IFD_POINTERが合法である場合にのみ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 - datatypeMIN_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などのうちの1つ。
      戻り値:
      指定されたデータ型をこのタグで使用できるかどうかを示すboolean
      例外:
      IllegalArgumentException - datatypeMIN_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を返します。 ニーモニック名は、整数データ型を持つタグにのみ適用されます。
      戻り値:
      ニーモニック名がある値。