- 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
を返します。
-
-
-
フィールドの詳細
-
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データ型を表す定数です。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
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
を返します。 ニーモニック名は、整数データ型を持つタグにのみ適用されます。- 戻り値:
- ニーモニック名がある値。
-
-