- すべての実装されたインタフェース:
- Cloneable
 TIFFイメージ・ファイル・ディレクトリ(IFD)のフィールドは、同じデータ型の値のシーケンスを伴うタグ番号として定義されます。 TIFF 6.0では12タイプのデータ型が定義されています。13番目の型IFDは、TIFF仕様補足1のTIFFテクニカル・ノート1で定義されています。 これらのTIFFデータ型はJava定数によって参照され、Java言語のデータ型と型名に内部的に次のようにマップされます: 
 
| TIFFデータ型 | Java定数 | Javaデータ型 | Javaの型名 | 
|---|---|---|---|
| BYTE | TIFFTag.TIFF_BYTE | byte | "Byte" | 
| ASCII | TIFFTag.TIFF_ASCII | String | "Ascii" | 
| SHORT | TIFFTag.TIFF_SHORT | char | "Short" | 
| LONG | TIFFTag.TIFF_LONG | long | "Long" | 
| RATIONAL | TIFFTag.TIFF_RATIONAL | long[2]{numerator, denominator} | "Rational" | 
| SBYTE | TIFFTag.TIFF_SBYTE | byte | "SByte" | 
| UNDEFINED | TIFFTag.TIFF_UNDEFINED | byte | "Undefined" | 
| SSHORT | TIFFTag.TIFF_SSHORT | short | "SShort" | 
| SLONG | TIFFTag.TIFF_SLONG | int | "SLong" | 
| SRATIONAL | TIFFTag.TIFF_SRATIONAL | int[2]{numerator, denominator} | "SRational" | 
| FLOAT | TIFFTag.TIFF_FLOAT | float | "Float" | 
| DOUBLE | TIFFTag.TIFF_DOUBLE | double | "Double" | 
| IFD | TIFFTag.TIFF_IFD_POINTER | long | "IFDPointer" | 
- 導入されたバージョン:
- 9
- 関連項目:
- TIFFDirectory,- TIFFTag
- 
コンストラクタのサマリーコンストラクタコンストラクタ説明createArrayForType()を使用してデータ配列を構築し、指定されたパラメータと作成された配列でTIFFField(TIFFTag,int,int,Object)を呼び出します。任意のデータを持つTIFFFieldを構築します。TIFFField(TIFFTag tag, int type, long offset, TIFFDirectory dir)IFDのオフセットと内容を持つTIFFFieldを構築します。単一の負の整数値を持つTIFFFieldを構築します。
- 
メソッドのサマリー修飾子と型メソッド説明clone()フィールドとそこに含まれるすべての情報をクローンします。static ObjectcreateArrayForType(int dataType, int count)指定されたデータ型に適した配列を作成します。static TIFFFieldcreateFromMetadataNode(TIFFTagSet tagSet, Node node)TIFFネイティブ・イメージ・メタデータ・ノードからTIFFFieldを作成します。byte[]byteの未解釈の配列としてデータを返します。char[]TIFFTag.TIFF_SHORTデータをchars (符号なし16ビット整数)の配列として返します。doublegetAsDouble(int index)任意の形式のデータをdoubleとして返します。double[]TIFFTag.TIFF_DOUBLEデータをdoubles (64ビット浮動小数点値)の配列として返します。floatgetAsFloat(int index)任意の形式のデータをfloatとして返します。float[]TIFFTag.TIFF_FLOATデータをfloats (32ビット浮動小数点値)の配列として返します。intgetAsInt(int index)任意の形式のデータをintとして返します。int[]TIFFTag.TIFF_SLONGデータをints (符号付き32ビット整数)の配列として返します。longgetAsLong(int index)任意の形式のデータをlongとして返します。long[]TIFFTag.TIFF_LONGまたはTIFF_IFD_POINTERデータをlongs (符号付き64ビット整数)の配列として返します。TIFFFieldを、"TIFFField"または"TIFFIFD"という名前のノードとして返します(TIFFネイティブ・イメージ・メタデータ仕様で説明されています)。long[]getAsRational(int index)TIFFTag.TIFF_RATIONALデータ・アイテムをintの2要素配列として返します。long[][]TIFFTag.TIFF_RATIONALデータをlongの2要素配列の配列として返します。short[]TIFFTag.TIFF_SSHORTデータをshorts (符号付き16ビット整数)の配列として返します。int[]getAsSRational(int index)TIFFTag.TIFF_SRATIONALデータ・アイテムをintの2要素配列として返します。int[][]TIFFTag.TIFF_SRATIONALデータをintの2要素配列の配列として返します。getAsString(int index)TIFFTag.TIFF_ASCIIの値をStringとして返します。intgetCount()フィールドに存在するデータ・アイテムの数を返します。getData()フィールドに関連付けられたデータ・オブジェクトへの参照を返します。利用可能であれば、関連するTIFFDirectoryを返します。getTag()このフィールドに関連付けられたタグを取得します。int[0,65535]の範囲のタグ番号を取得します。intgetType()フィールドに格納されているデータの型を返します。static intgetTypeByName(String typeName)指定されたデータ型名に対応するデータ型定数を返します。static StringgetTypeName(int dataType)指定されたデータ型定数の名前を返します。getValueAsString(int index)人間が判読可能なバージョンのデータ・アイテムを含むStringを返します。booleanフィールドにTIFFDirectoryがあるかどうかを返します。booleanフィールドに関連付けられた値が整数データ型であるかどうかを示します。
- 
コンストラクタの詳細- 
TIFFField任意のデータを持つTIFFFieldを構築します。typeパラメータは、tag.isDataTypeOK()がtrueを返す値でなければなりません。dataパラメータは、TIFFフィールドの型に適したJava型の配列でなければなりません。TIFFFieldの値(data)は、その値に必要なバイト数に関係なく、常に実際のフィールド値になります。 これは、フィールドに対応するTIFF 「IFDエントリ」が、実際に値(後者は、値が4バイトに収まる場合にのみ発生)ではなくフィールドの値へのオフセットを実際に含んでいる可能性があるにもかかわらず、このケースです。 つまり、フィールドの値は既にTIFFストリームから読み込まれています。 (フィールドが非ベースラインIFDの内容を表すときは、この場合の例外が発生することがあります。 その場合、データはIFDへのオフセットを含むlong[]になり、getDirectory()によって返されるTIFFDirectoryはその内容になります。)- パラメータ:
- tag- このフィールドに関連付けられるタグ。
- type-- TIFFTag.TIFF_*定数の1つ.TIFFストリームに書き込まれたフィールドのデータ型を示します。
- count- データ値の数。
- data- フィールドの実際のデータ内容。
- 例外:
- NullPointerException-- tag == nullの場合。
- IllegalArgumentException-- typeが- TIFFTag.TIFF_*データ型定数の1つでない場合。
- IllegalArgumentException-- typeが、指定された- TIFFTagの許容できないデータ型である場合。
- IllegalArgumentException-- count < 0の場合。
- IllegalArgumentException-- count < 1と- typeが- TIFF_RATIONALまたは- TIFF_SRATIONALの場合。
- IllegalArgumentException-- count != 1と- typeが- TIFF_IFD_POINTERの場合。
- NullPointerException-- data == nullの場合。
- IllegalArgumentException-- dataが、指定された型と互換性のないクラスのインスタンスである場合。
- IllegalArgumentException- データ配列のサイズが間違っている場合。
- IllegalArgumentException- データ配列の型が- TIFF_LONG、- TIFF_RATIONAL、または- TIFF_IFD_POINTERであり、いずれかの要素が負であるか- 0xffffffffより大きい場合。
 
- 
TIFFFieldpublic TIFFField(TIFFTag tag, int type, int count)createArrayForType()を使用してデータ配列を構築し、指定されたパラメータと作成された配列でTIFFField(TIFFTag,int,int,Object)を呼び出します。- パラメータ:
- tag- このフィールドに関連付けられるタグ。
- type-- TIFFTag.TIFF_*定数の1つ.TIFFストリームに書き込まれたフィールドのデータ型を示します。
- count- データ値の数。
- 例外:
- NullPointerException-- tag == nullの場合。
- IllegalArgumentException-- typeが- TIFFTag.TIFF_*データ型定数の1つでない場合。
- IllegalArgumentException-- typeが、指定された- TIFFTagの許容できないデータ型である場合。
- IllegalArgumentException-- count < 0の場合。
- IllegalArgumentException-- count < 1と- typeが- TIFF_RATIONALまたは- TIFF_SRATIONALの場合。
- IllegalArgumentException-- count != 1と- typeが- TIFF_IFD_POINTERの場合。
- 関連項目:
- TIFFField(TIFFTag,int,int,Object)
 
- 
TIFFFieldpublic TIFFField(TIFFTag tag, long value)単一の負の整数値を持つTIFFFieldを構築します。valueが[0,0xffff]の場合、フィールドの型はTIFF_SHORT、valueが[0x10000,0xffffffff]の場合はTIFF_LONGと入力します。 フィールドのカウントは1になります。- パラメータ:
- tag- このフィールドに関連付けるタグ。
- value- このフィールドに関連付ける値。
- 例外:
- NullPointerException-- tag == nullの場合。
- IllegalArgumentException-- valueが- [0,0xffffffff]にない場合。
- IllegalArgumentException-- valueが- [0,0xffff]にあり、- TIFF_SHORTが- TIFFTagのために受け入れられない型である場合、または- valueが- [0x10000,0xffffffff]にあり、- TIFF_LONGが- TIFFTagのために受け入れがたい型である場合。
 
- 
TIFFFieldpublic TIFFField(TIFFTag tag, int type, long offset, TIFFDirectory dir)IFDのオフセットと内容を持つTIFFFieldを構築します。 オフセットは、このフィールドのデータとしてlong[] {offset}として保存されます。 ディレクトリはクローンされません。 フィールドのカウントは1になります。- パラメータ:
- tag- このフィールドに関連付けられるタグ。
- type- 定数- TIFFTag.TIFF_LONGまたは- TIFFTag.TIFF_IFD_POINTERの1つ。
- offset- IFDオフセット。
- dir- ディレクトリ。
- 例外:
- NullPointerException-- tag == nullの場合。
- IllegalArgumentException-- typeが、指定された- TIFFTagの許容できないデータ型である場合。
- IllegalArgumentException-- typeが- TIFFTag.TIFF_LONGでも- TIFFTag.TIFF_IFD_POINTERでもない場合。
- IllegalArgumentException-- offset <= 0の場合。
- NullPointerException-- dir == nullの場合。
- 関連項目:
- TIFFField(TIFFTag,int,int,Object)
 
 
- 
- 
メソッドの詳細- 
createFromMetadataNodepublic static TIFFField createFromMetadataNode(TIFFTagSet tagSet, Node node)TIFFネイティブ・イメージ・メタデータ・ノードからTIFFFieldを作成します。 ノードの"number"属性の値がtagSetに見つからない場合、名前TIFFTag.UNKNOWN_TAG_NAMEを持つ新しいTIFFTagが作成され、フィールドに割り当てられます。- パラメータ:
- tagSet- フィールドの- TIFFTagが属する- TIFFTagSet。
- node- ネイティブTIFFイメージ・メタデータ- TIFFFieldノード。
- 戻り値:
- 新しいTIFFField。
- 例外:
- IllegalArgumentException-- Nodeパラメータの内容が「TIFFネイティブ・イメージ・メタデータ・フォーマット仕様」によって定義された- TIFFField要素構造に従わない場合、またはノード属性とデータの組み合わせが- TIFFField(TIFFTag,int,int,Object)コンストラクタ仕様に従って合法でない場合。 このような例外に対しては、原因が設定される可能性があります。
 
- 
getTagpublic TIFFTag getTag()このフィールドに関連付けられたタグを取得します。- 戻り値:
- 関連するTIFFTag。
 
- 
getTagNumberpublic int getTagNumber()[0,65535]の範囲のタグ番号を取得します。- 戻り値:
- タグ番号。
 
- 
getTypepublic int getType()フィールドに格納されているデータの型を返します。 TIFF 6.0ストリームの場合、値はTIFFTag.TIFF_*定数の1つと等しくなります。 TIFFの今後の改訂版では、より高い値が可能です。- 戻り値:
- フィールド値のデータ型。
 
- 
getTypeNamepublic static String getTypeName(int dataType)指定されたデータ型定数の名前を返します。- パラメータ:
- dataType-- TIFFTag.TIFF_*定数の1つ.TIFFストリームに書き込まれたフィールドのデータ型を示します。
- 戻り値:
- 指定された型定数に対応する型名。
- 例外:
- IllegalArgumentException-- dataTypeが- TIFFTag.TIFF_*データ型定数の1つでない場合。
 
- 
getTypeByNamepublic static int getTypeByName(String typeName)指定されたデータ型名に対応するデータ型定数を返します。 名前が不明の場合は-1が返されます。- パラメータ:
- typeName- 型名です。
- 戻り値:
- 名前が認識されない場合は、TIFFTag.TIFF_*定数または-1の1つ。
 
- 
createArrayForTypepublic static Object createArrayForType(int dataType, int count)指定されたデータ型に適した配列を作成します。- パラメータ:
- dataType-- TIFFTag.TIFF_*データ型定数の1つ。
- count- 配列内の値の数。
- 戻り値:
- 指定されたデータ型に適した配列。
- 例外:
- IllegalArgumentException-- dataTypeが- TIFFTag.TIFF_*データ型定数の1つでない場合。
- IllegalArgumentException-- count < 0の場合。
- IllegalArgumentException-- count < 1と- typeが- TIFF_RATIONALまたは- TIFF_SRATIONALの場合。
- IllegalArgumentException-- count != 1と- typeが- TIFF_IFD_POINTERの場合。
 
- 
getAsNativeNodepublic Node getAsNativeNode()TIFFFieldを、"TIFFField"または"TIFFIFD"という名前のノードとして返します(TIFFネイティブ・イメージ・メタデータ仕様で説明されています)。hasDirectory()がtrueを返し、フィールド型がTIFFTag.TIFF_LONGまたはTIFFTag.TIFF_IFD_POINTERの場合にのみ、ノードの名前は"TIFFIFD"になります。- 戻り値:
- "TIFFField"または- "TIFFIFD"と名付けられた- Node。
 
- 
isIntegralpublic boolean isIntegral()フィールドに関連付けられた値が整数データ型であるかどうかを示します。- 戻り値:
- フィールド型が整数かどうか。
 
- 
getCountpublic int getCount()フィールドに存在するデータ・アイテムの数を返します。TIFFTag.TIFF_ASCIIフィールドの場合、返される値は、ファイル表現のようなデータの合計長ではなく、Stringの数です。- 戻り値:
- フィールドに存在するデータ・アイテムの数。
 
- 
getDatapublic Object getData()フィールドに関連付けられたデータ・オブジェクトへの参照を返します。- 戻り値:
- フィールドのデータ・オブジェクト。
 
- 
getAsBytespublic byte[] getAsBytes()byteの未解釈の配列としてデータを返します。 フィールドの型は、TIFFTag.TIFF_BYTE、TIFF_SBYTE、またはTIFF_UNDEFINEDのいずれかでなければなりません。TIFFTag.TIFF_BYTE形式のデータの場合、符号拡張を避けるために、データをより長い積分型に昇格させるときにアプリケーションは注意が必要です。- 戻り値:
- データは未解釈のバイト配列です。
- 例外:
- ClassCastException- フィールドが型- TIFF_BYTE、- TIFF_SBYTE、または- TIFF_UNDEFINEDでない場合。
 
- 
getAsCharspublic char[] getAsChars()TIFFTag.TIFF_SHORTデータをchars (符号なし16ビット整数)の配列として返します。- 戻り値:
- charの配列としてのデータ。
- 例外:
- ClassCastException- フィールドの型が- TIFF_SHORTではない場合。
 
- 
getAsShortspublic short[] getAsShorts()TIFFTag.TIFF_SSHORTデータをshorts (符号付き16ビット整数)の配列として返します。- 戻り値:
- shortの配列としてのデータ。
- 例外:
- ClassCastException- フィールドの型が- TIFF_SSHORTではない場合。
 
- 
getAsIntspublic int[] getAsInts()TIFFTag.TIFF_SLONGデータをints (符号付き32ビット整数)の配列として返します。- 戻り値:
- intの配列としてのデータ。
- 例外:
- ClassCastException- フィールドが型- TIFF_SHORT、- TIFF_SSHORT、または- TIFF_SLONGでない場合。
 
- 
getAsLongspublic long[] getAsLongs()TIFFTag.TIFF_LONGまたはTIFF_IFD_POINTERデータをlongs (符号付き64ビット整数)の配列として返します。- 戻り値:
- longの配列としてのデータ。
- 例外:
- ClassCastException- フィールドが型- TIFF_LONGまたは- TIFF_IFD_POINTERでない場合。
 
- 
getAsFloatspublic float[] getAsFloats()TIFFTag.TIFF_FLOATデータをfloats (32ビット浮動小数点値)の配列として返します。- 戻り値:
- floatの配列としてのデータ。
- 例外:
- ClassCastException- フィールドの型が- TIFF_FLOATではない場合。
 
- 
getAsDoublespublic double[] getAsDoubles()TIFFTag.TIFF_DOUBLEデータをdoubles (64ビット浮動小数点値)の配列として返します。- 戻り値:
- doubleの配列としてのデータ。
- 例外:
- ClassCastException- フィールドの型が- TIFF_DOUBLEではない場合。
 
- 
getAsSRationalspublic int[][] getAsSRationals()TIFFTag.TIFF_SRATIONALデータをintの2要素配列の配列として返します。- 戻り値:
- 署名された有理数の配列としてのデータ。
- 例外:
- ClassCastException- フィールドの型が- TIFF_SRATIONALではない場合。
 
- 
getAsRationalspublic long[][] getAsRationals()TIFFTag.TIFF_RATIONALデータをlongの2要素配列の配列として返します。- 戻り値:
- 署名されていないrationalsの配列としてのデータ。
- 例外:
- ClassCastException- フィールドの型が- TIFF_RATIONALではない場合。
 
- 
getAsIntpublic int getAsInt(int index)任意の形式のデータをintとして返します。TIFFTag.TIFF_BYTEの値は符号なしとして扱われます。つまり、符号の拡張は行われず、返される値は[0, 255]の範囲になります。TIFF_SBYTEデータは[-128, 127]の範囲で返されます。TIFF_UNDEFINEDの値は、TIFF_BYTEのように扱われます。TIFF_SLONG、TIFF_LONG、TIFF_FLOAT、TIFF_DOUBLEまたはTIFF_IFD_POINTER形式のデータは、単にintにキャストされ、切り捨てられる可能性があります。TIFF_SRATIONALまたはTIFF_RATIONAL形式のデータは、倍精度算術を使用して分子を分母に分割し、次にintにキャストすることによって評価されます。 精度の低下や切り捨てが発生することがあります。TIFF_ASCII形式のデータは、Double.parseDoubleメソッドのように解析され、結果ケースはintに解析されます。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスにあるデータをintとして返します。
 
- 
getAsLongpublic long getAsLong(int index)任意の形式のデータをlongとして返します。TIFFTag.TIFF_BYTEおよびTIFF_UNDEFINEDデータは符号なしとして扱われます。つまり、符号の拡張は行われず、戻り値は[0, 255]の範囲になります。TIFF_SBYTEデータは[-128, 127]の範囲で返されます。TIFF_FLOATとTIFF_DOUBLEのデータは単にlongにキャストされ、切り捨てられます。TIFF_SRATIONALまたはTIFF_RATIONAL形式のデータは、倍精度算術を使用して分子を分母に分割し、次にlongにキャストすることによって評価されます。 精度の低下や切り捨てが発生することがあります。TIFF_ASCII形式のデータはDouble.parseDoubleメソッドのように解析され、結果はlongにキャストされます。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスにあるデータをlongとして返します。
 
- 
getAsFloatpublic float getAsFloat(int index)任意の形式のデータをfloatとして返します。TIFFTag.TIFF_BYTEおよびTIFF_UNDEFINEDデータは符号なしとして扱われます。つまり、符号の拡張は行われず、戻り値は[0, 255]の範囲になります。TIFF_SBYTEデータは[-128, 127]の範囲で返されます。TIFF_SLONG、TIFF_LONG、TIFF_DOUBLE、またはTIFF_IFD_POINTER形式のデータは単にfloatにキャストされ、切り捨てられます。TIFF_SRATIONALまたはTIFF_RATIONAL形式のデータは、倍精度算術を使用して分子を分母に分割し、次にfloatにキャストすることによって評価されます。TIFF_ASCII形式のデータはDouble.parseDoubleメソッドのように解析され、結果はfloatにキャストされます。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスにあるデータをfloatとして返します。
 
- 
getAsDoublepublic double getAsDouble(int index)任意の形式のデータをdoubleとして返します。TIFFTag.TIFF_BYTEおよびTIFF_UNDEFINEDデータは符号なしとして扱われます。つまり、符号の拡張は行われず、戻り値は[0, 255]の範囲になります。TIFF_SBYTEデータは[-128, 127]の範囲で返されます。TIFF_SRATIONALまたはTIFF_RATIONAL形式のデータは、倍精度算術を使用して分子を分母に分割することによって評価されます。TIFF_ASCII形式のデータは、Double.parseDoubleメソッドのように解析されます。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスにあるデータをdoubleとして返します。
 
- 
getAsStringpublic String getAsString(int index)TIFFTag.TIFF_ASCIIの値をStringとして返します。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスにあるデータをStringとして返します。
- 例外:
- ClassCastException- フィールドの型が- TIFF_ASCIIではない場合。
 
- 
getAsSRationalpublic int[] getAsSRational(int index)TIFFTag.TIFF_SRATIONALデータ・アイテムをintの2要素配列として返します。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスのデータは、署名付きの合理的なものです。
- 例外:
- ClassCastException- フィールドの型が- TIFF_SRATIONALではない場合。
 
- 
getAsRationalpublic long[] getAsRational(int index)TIFFTag.TIFF_RATIONALデータ・アイテムをintの2要素配列として返します。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスのデータは、符号なしの合理的なものです。
- 例外:
- ClassCastException- フィールドの型が- TIFF_RATIONALではない場合。
 
- 
getValueAsStringpublic String getValueAsString(int index)人間が判読可能なバージョンのデータ・アイテムを含むStringを返します。 型TIFFTag.TIFF_RATIONALまたはTIFF_SRATIONALのデータは、'/'文字で区切られた整数のペアとして表されます。TIFFTag.TIFF_RATIONALまたはTIFF_SRATIONALの分子が分母の整数倍である場合、その値は"q/1"として表されます。ここで、qは分子と分母の商です。- パラメータ:
- index- データのインデックス。
- 戻り値:
- 指定されたインデックスにあるデータをStringとして返します。
- 例外:
- ClassCastException- フィールドが正当なフィールド型のいずれかでない場合。
 
- 
hasDirectorypublic boolean hasDirectory()フィールドにTIFFDirectoryがあるかどうかを返します。- 戻り値:
- getDirectory()が非nullを返す場合にのみtrue。
 
- 
getDirectorypublic TIFFDirectory getDirectory()利用可能であれば、関連するTIFFDirectoryを返します。 ディレクトリが設定されていない場合は、nullが返されます。- 戻り値:
- TIFFDirectoryインスタンスまたはnull。
 
- 
clonepublic TIFFField clone() throws CloneNotSupportedExceptionフィールドとそこに含まれるすべての情報をクローンします。- オーバーライド:
- clone、クラス:- Object
- 戻り値:
- このTIFFFieldのクローン。
- 例外:
- CloneNotSupportedException- インスタンスをクローン化できない場合。
- 関連項目:
- Cloneable
 
 
-