- 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 intMAX_DATATYPE数値で最大のTIFFデータ型を表す定数です。static intMIN_DATATYPE数値で最小の定数で、TIFFデータ型を表します。static intTIFF_ASCIIヌル終了ASCII文字列のフラグ。static intTIFF_BYTE8ビットの符号なし整数のフラグ。static intTIFF_DOUBLE64ビットIEEE doubleのフラグ。static intTIFF_FLOAT32ビットIEEE浮動小数点のフラグ。static intTIFF_IFD_POINTERTIFF仕様補足1のTIFF Tech Note 1で定義されているIFDポインタのフラグ。static intTIFF_LONG32ビットの符号なし整数のフラグ。static intTIFF_RATIONAL32ビットの符号なし整数のペアのフラグ。static intTIFF_SBYTE8ビット符号付き整数のフラグ。static intTIFF_SHORT16ビットの符号なし整数のフラグ。static intTIFF_SLONG32ビット符号付き整数のフラグ。static intTIFF_SRATIONAL32ビット符号付き整数のペアのフラグ。static intTIFF_SSHORT16ビット符号付き整数のフラグ。static intTIFF_UNDEFINED8ビットの未解釈バイトのフラグ。static StringUNKNOWN_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 voidaddValueName(int value, String name)このタグ・データがとりうる特定の値のニーモニック名を追加します。intgetCount()このタグの値カウントを返します。intgetDataTypes()タグに関連付けられたデータを格納するために使用されるデータ型のセットを示すビット・マスクを返します。StringgetName()イメージ・メタデータに表示されるタグの名前を返します。int[]getNamedValues()ニーモニック名が定義されている値の配列を返します。intgetNumber()タグを表すために使用される整数を返します。static intgetSizeOfType(int dataType)指定されたデータ型の値を格納するために使用されるバイト数を返します。TIFFTagSetgetTagSet()このタグが含まれるTIFFTagSetを返します。StringgetValueName(int value)このタグ・データが取り得る特定の値に関連付けられたニーモニック名を返します。名前がない場合はnullを返します。booleanhasValueNames()このタグに関連付けられたデータの正当な値のセットに関連付けられたニーモニック名がある場合は、trueを返します。booleanisDataTypeOK(int dataType)指定されたデータ型がこのタグに関連付けられたデータに使用される場合は、trueを返します。booleanisIFDPointer()このタグが追加のタグを含む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を返します。 ニーモニック名は、整数データ型を持つタグにのみ適用されます。- 戻り値:
- ニーモニック名がある値。
-
-