クラスTIFFImageReadParam

java.lang.Object

javax.imageio.IIOParam

javax.imageio.ImageReadParam

javax.imageio.plugins.tiff.TIFFImageReadParam

public final class TIFFImageReadParam extends ImageReadParam

TIFF読取りプロセスを制御できるImageReadParamのサブクラス。

TIFFは拡張可能な形式であるため、意味のあるメタデータを生成するには、TIFF拡張で使用されるタグに関する情報が必要です。 また、TIFF拡張では、新しい圧縮タイプを定義できます。 このインタフェースでは、拡張機能に関するどちらのタイプの情報も提供されます。

追加のTIFFタグは、TIFFTagSetに編成する必要があります。 TIFFTagSetは、addAllowedTagSetメソッドを使用してリーダーに提供できます。 デフォルトでは、タグ・セットBaselineTIFFTagSet, FaxTIFFTagSet, ExifParentTIFFTagSetおよびGeoTIFFTagSetが含まれます。

許可されたTIFFTagSetのいずれにもないTIFFTagに対応するフィールドの強制読み込みは、setReadUnknownTagsを介して行われてもよい。

導入されたバージョン:

9

フィールドのサマリー

クラスで宣言されたフィールド ImageReadParam

canSetSourceRenderSize, destination, destinationBands, minProgressivePass, numProgressivePasses, sourceRenderSize

修飾子と型	フィールド	説明
protected boolean	canSetSourceRenderSize	このImageReadParamがソースの描画寸法を設定できる場合はtrueです。
protected BufferedImage	destination	現在のデスティネーションBufferedImage、または何も設定されていない場合はnullです。
protected int[]	destinationBands	intの配列としての、使用するデスティネーション・バンドのセットです。
protected int	minProgressivePass	ソースから読み取るプログレッシブ・パスの最小インデックスです。
protected int	numProgressivePasses	ソースから読み取るプログレッシブ・パスの最大数です。
protected Dimension	sourceRenderSize	canSetSourceRenderSizeがtrueの場合、目的のソース描画の幅と高さです。それ以外の場合はnullです。

クラスで宣言されたフィールド IIOParam

controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

修飾子と型	フィールド	説明
protected IIOParamController	controller	activateControllerメソッドが呼び出されたときに、このIIOParamオブジェクトの設定を指定するために使用するIIOParamControllerです。
protected IIOParamController	defaultController	activateControllerメソッドが呼び出されたときに、このIIOParamオブジェクトの設定を指定するために使用するデフォルトのIIOParamControllerです。
protected Point	destinationOffset	左上隅のデコードされたピクセルが配置されるデスティネーションのオフセットです。
protected ImageTypeSpecifier	destinationType	読込み時にデスティネーションのイメージを生成する、または書込み時に出力のカラー・タイプを設定するために使用するImageTypeSpecifierです。
protected int[]	sourceBands	使用するソース・バンドを示すint配列、またはnullです。
protected Rectangle	sourceRegion	ソース領域、または何も設定されない場合はnullとなります。
protected int	sourceXSubsampling	水平方向に適用される間引きサブサンプリングです。
protected int	sourceYSubsampling	垂直方向に適用される間引きサブサンプリングです。
protected int	subsamplingXOffset	サブサンプリングする前にサブサンプリング・グリッドに適用される水平方向のオフセットです。
protected int	subsamplingYOffset	サブサンプリングする前にサブサンプリング・グリッドに適用される垂直方向のオフセットです。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
TIFFImageReadParam()	TIFFImageReadParamを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addAllowedTagSet(TIFFTagSet tagSet)	許可されたタグ・セットのリストにTIFFTagSetオブジェクトを追加します。
List<TIFFTagSet>	getAllowedTagSets()	許可されたTIFFTagSetオブジェクトを含むListを返します。
boolean	getReadUnknownTags()	不明なTIFFTagに対応するフィールドを読み取るかどうかの設定を取得します。
void	removeAllowedTagSet(TIFFTagSet tagSet)	許可されたタグ・セットのリストからTIFFTagSetオブジェクトを削除します。
void	setReadUnknownTags(boolean readUnknownTags)	許可されているTIFFTagSetにないTIFFTagに対応するフィールドを読み取るかどうかを設定します。

クラスで宣言されたメソッド ImageReadParam

canSetSourceRenderSize, getDestination, getDestinationBands, getSourceMaxProgressivePass, getSourceMinProgressivePass, getSourceNumProgressivePasses, getSourceRenderSize, setDestination, setDestinationBands, setSourceProgressivePasses, setSourceRenderSize

修飾子と型	メソッド	説明
boolean	canSetSourceRenderSize()	この読取り側が、復号化プロセスの一部として、setSourceRenderSizeメソッドによって、ソース・イメージを任意のサイズで描画できるようにする場合、trueを返します。
BufferedImage	getDestination()	setDestinationメソッドによって現在設定されているBufferedImageを返します。何も設定されていない場合はnullを返します。
int[]	getDestinationBands()	データが配置されているバンド・インデックスのセットを返します。
int	getSourceMaxProgressivePass()	getSourceNumProgressivePassesがInteger.MAX_VALUEと等しい場合は、Integer.MAX_VALUEを返します。
int	getSourceMinProgressivePass()	復号化される最初のプログレッシブ・パスのインデックスを返します。
int	getSourceNumProgressivePasses()	復号化されるプログレッシブ・パスの数を返します。
Dimension	getSourceRenderSize()	setSourceRenderSizeメソッドによって設定されている場合、復号化の間に描画されるように、イメージの幅と高さを返します。
void	setDestination(BufferedImage destination)	復号化されるピクセル・データのデスティネーションとして使用するBufferedImageを提供します。
void	setDestinationBands(int[] destinationBands)	データが配置されているデスティネーション・バンドのインデックスを設定します。
void	setSourceProgressivePasses(int minPass, int numPasses)	復号化されるプログレッシブ・パスの範囲を設定します。
void	setSourceRenderSize(Dimension size)	イメージを任意のサイズでレンダリングできる場合、ソースの幅と高さを指定された値に設定します。

クラスで宣言されたメソッド IIOParam

activateController, getController, getDefaultController, getDestinationOffset, getDestinationType, getSourceBands, getSourceRegion, getSourceXSubsampling, getSourceYSubsampling, getSubsamplingXOffset, getSubsamplingYOffset, hasController, setController, setDestinationOffset, setDestinationType, setSourceBands, setSourceRegion, setSourceSubsampling

修飾子と型	メソッド	説明
boolean	activateController()	このIIOParamオブジェクトに対してインストールされているIIOParamControllerをアクティブにし、結果の値を返します。
IIOParamController	getController()	現在インストールされているIIOParamControllerを返します。
IIOParamController	getDefaultController()	デフォルトのIIOParamControllerがある場合は、現在インストールされているコントローラとは関係なく、これを返します。
Point	getDestinationOffset()	ピクセルが配置されるデスティネーション・イメージのオフセットを返します。
ImageTypeSpecifier	getDestinationType()	ImageTypeSpecifierとして、setDestination(ImageTypeSpecifier)の呼出しによって設定された場合、読込みによって返されるイメージのタイプを返します。
int[]	getSourceBands()	使用するソース・バンドのセットを返します。
Rectangle	getSourceRegion()	使用するソース領域を返します。
int	getSourceXSubsampling()	ピクセルごとに浮き出るソース列の数を返します。
int	getSourceYSubsampling()	ピクセルごとに浮き出るソース行の数を返します。
int	getSubsamplingXOffset()	サブサンプリング・グリッドの水平方向のオフセットを返します。
int	getSubsamplingYOffset()	サブサンプリング・グリッドの垂直方向のオフセットを返します。
boolean	hasController()	このIIOParamオブジェクトにインストールされたコントローラがある場合はtrueを返します。
void	setController(IIOParamController controller)	activateControllerメソッドを呼び出して、すべてのデフォルト・コントローラをオーバーライドするときに、このIIOParamオブジェクトの設定を指定するために使用するIIOParamControllerを設定します。
void	setDestinationOffset(Point destinationOffset)	読込み時の場合は、将来デコードされるピクセルが配置されるオフセット、書込み時の場合は、領域が書き込まれるオフセットをデスティネーション・イメージに指定します。
void	setDestinationType(ImageTypeSpecifier destinationType)	ImageTypeSpecifierを使用して、目的のイメージ形式をデスティネーション・イメージに設定します。
void	setSourceBands(int[] sourceBands)	使用するソース・バンドのインデックスを設定します。
void	setSourceRegion(Rectangle sourceRegion)	処理対象のソース領域を設定します。
void	setSourceSubsampling(int sourceXSubsampling, int sourceYSubsampling, int subsamplingXOffset, int subsamplingYOffset)	間引きサブサンプリングを指定して入出力に適用します。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

TIFFImageReadParam

public TIFFImageReadParam()

TIFFImageReadParamを構築します。 TIFFTagSetのBaselineTIFFTagSet, FaxTIFFTagSet, ExifParentTIFFTagSetおよびGeoTIFFTagSetで定義されたタグがサポートされます。

関連項目:

• BaselineTIFFTagSet
• FaxTIFFTagSet
• ExifParentTIFFTagSet
• GeoTIFFTagSet

メソッドの詳細

addAllowedTagSet

public void addAllowedTagSet(TIFFTagSet tagSet)

許可されたタグ・セットのリストにTIFFTagSetオブジェクトを追加します。 リストに重複オブジェクトを追加しようとしても効果はありません。

パラメータ:

tagSet - TIFFTagSet。

スロー:

IllegalArgumentException - tagSetがnullの場合。

removeAllowedTagSet

public void removeAllowedTagSet(TIFFTagSet tagSet)

許可されたタグ・セットのリストからTIFFTagSetオブジェクトを削除します。 削除は、通常参照等価として定義されるTIFFTagSetのequalsメソッドに基づきます。

パラメータ:

tagSet - TIFFTagSet。

スロー:

IllegalArgumentException - tagSetがnullの場合。

getAllowedTagSets

public List<TIFFTagSet> getAllowedTagSets()

許可されたTIFFTagSetオブジェクトを含むListを返します。

戻り値:

TIFFTagSetのList。

setReadUnknownTags

public void setReadUnknownTags(boolean readUnknownTags)

許可されているTIFFTagSetにないTIFFTagに対応するフィールドを読み取るかどうかを設定します。 デフォルトの設定は「false」です。 TIFF ImageReaderがメタデータを無視している場合、trueの設定は、イメージ自体の読取りに不可欠なものを除き、すべてのメタデータが無視されるため、オーバーライドされます。

パラメータ:

readUnknownTags - 認識されないタグのフィールドを読み込むかどうか

getReadUnknownTags

public boolean getReadUnknownTags()

不明なTIFFTagに対応するフィールドを読み取るかどうかの設定を取得します。

戻り値:

認識されないタグのフィールドを読み込むかどうか