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
数値で最大のTIFFデータ型を表す定数。static int
数値で最小の定数で、TIFFデータ型を表します。static int
ヌル終了ASCII文字列のフラグ。static int
8ビットの符号なし整数のフラグ。static int
64ビットIEEE doubleのフラグ。static int
32ビットIEEE浮動小数点のフラグ。static int
TIFF仕様補足1のTIFF Tech Note 1で定義されているIFDポインタのフラグ。static int
32ビットの符号なし整数のフラグ。static int
32ビットの符号なし整数のペアのフラグ。static int
8ビット符号付き整数のフラグ。static int
16ビットの符号なし整数のフラグ。static int
32ビット符号付き整数のフラグ。static int
32ビット符号付き整数のペアのフラグ。static int
16ビット符号付き整数のフラグ。static int
8ビットの未解釈バイトのフラグ。static String
未知のタグ番号を持つタグに割り当てられた名前。 -
コンストラクタのサマリー
コンストラクタ説明指定された名前、タグ番号、および有効なデータ型のセットを持つTIFFTag
を構築します。指定された名前、タグ番号、有効なデータ型のセット、および値のカウントを持つTIFFTag
を構築します。TIFFTag(String name, int number, TIFFTagSet tagSet)
指定された名前、タグ番号、およびそれが参照するTIFFTagSet
を持つTIFFTag
を構築します。 -
メソッドのサマリー
修飾子と型メソッド説明protected void
addValueName(int value, String name)
このタグ・データがとりうる特定の値のニーモニック名を追加します。int
getCount()
このタグの値カウントを返します。int
タグに関連付けられたデータを格納するために使用されるデータ型のセットを示すビット・マスクを返します。getName()
イメージ・メタデータに表示されるタグの名前を返します。int[]
ニーモニック名が定義されている値の配列を返します。int
タグを表すために使用される整数を返します。static int
getSizeOfType(int dataType)
指定されたデータ型の値を格納するために使用されるバイト数を返します。このタグが含まれるTIFFTagSet
を返します。getValueName(int value)
このタグ・データが取り得る特定の値に関連付けられたニーモニック名を返します。名前がない場合はnull
を返します。boolean
このタグに関連付けられたデータの正当な値のセットに関連付けられたニーモニック名がある場合は、true
を返します。boolean
isDataTypeOK(int dataType)
指定されたデータ型がこのタグに関連付けられたデータに使用される場合は、true
を返します。boolean
このタグが追加のタグを含むIFD構造体を指すために使用される場合は、true
を返します。
-
フィールド詳細
-
TIFF_BYTE
public static final int TIFF_BYTE8ビットの符号なし整数のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_ASCII
public static final int TIFF_ASCIIヌル終了ASCII文字列のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_SHORT
public static final int TIFF_SHORT16ビットの符号なし整数のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_LONG
public static final int TIFF_LONG32ビットの符号なし整数のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_RATIONAL
public static final int TIFF_RATIONAL32ビットの符号なし整数のペアのフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_SBYTE
public static final int TIFF_SBYTE8ビット符号付き整数のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_UNDEFINED
public static final int TIFF_UNDEFINED8ビットの未解釈バイトのフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_SSHORT
public static final int TIFF_SSHORT16ビット符号付き整数のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_SLONG
public static final int TIFF_SLONG32ビット符号付き整数のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_SRATIONAL
public static final int TIFF_SRATIONAL32ビット符号付き整数のペアのフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_FLOAT
public static final int TIFF_FLOAT32ビットIEEE浮動小数点のフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_DOUBLE
public static final int TIFF_DOUBLE64ビットIEEE doubleのフラグ。- 関連項目:
- 定数フィールド値
-
TIFF_IFD_POINTER
public static final int TIFF_IFD_POINTERTIFF仕様補足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_LONG
とTIFF_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
-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
。 - 例外:
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
を返します。 ニーモニック名は、整数データ型を持つタグにのみ適用されます。- 戻り値:
- ニーモニック名がある値。
-