モジュール java.desktop

クラス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を返します。
    • フィールドの詳細

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