java.awt.image
インタフェース ImageProducer

既知の実装クラスの一覧:

FilteredImageSource, MemoryImageSource, RenderableImageProducer

public interface ImageProducer

Image オブジェクト用のイメージデータを生成することができるオブジェクトのためのインタフェースです。イメージには ImageProducer が含まれます。ImageProducer は、イメージの再構成が必要なとき、たとえば、Image の大きさの変更や Image の高さや幅が必要なときなどに使われます。

関連項目:

ImageConsumer

メソッドの概要

void	addConsumer(ImageConsumer ic) このメソッドは、ImageProducer に ImageConsumer を登録するために使われ、あとで Image を再構成するとき、そのイメージデータにアクセスします。
boolean	isConsumer(ImageConsumer ic) 指定された ImageConsumer オブジェクトがコンシューマとして現在登録されているかどうかを判定します。
void	removeConsumer(ImageConsumer ic) イメージデータを受け取るように現在登録されているコンシューマリストから、指定された ImageConsumer オブジェクトを削除します。
void	requestTopDownLeftRightResend(ImageConsumer ic) イメージデータを上下左右順で再送信するように ImageProducer に要求するために、ImageConsumer によって使用されます。
void	startProduction(ImageConsumer ic) 指定された ImageConsumer オブジェクトをコンシューマとして登録し、イメージデータの再構成をただちに開始します。

メソッドの詳細

addConsumer

public void addConsumer(ImageConsumer ic)

このメソッドは、ImageProducer に ImageConsumer を登録するために使われ、あとで Image を再構成するとき、そのイメージデータにアクセスします。ImageProducer は任意で、または startProduction メソッドが次のイメージの再構成を呼び出すときに、ImageConsumer インタフェースを使ってイメージデータをただちにコンシューマへ転送します。

関連項目:

startProduction(java.awt.image.ImageConsumer)

isConsumer

public boolean isConsumer(ImageConsumer ic)

指定された ImageConsumer オブジェクトがコンシューマとして現在登録されているかどうかを判定します。

removeConsumer

public void removeConsumer(ImageConsumer ic)

イメージデータを受け取るように現在登録されているコンシューマリストから、指定された ImageConsumer オブジェクトを削除します。現在登録されていないコンシューマを削除することはエラーではありません。ImageProducer はただちに、このコンシューマへデータを転送することを中止します。

startProduction

public void startProduction(ImageConsumer ic)

指定された ImageConsumer オブジェクトをコンシューマとして登録し、イメージデータの再構成をただちに開始します。イメージデータは、このコンシューマやすでにプロデューサに登録されているほかのコンシューマに転送されます。このメソッドは、イメージの再構成をただちに行う addConsumer メソッドとは異なります。

関連項目:

addConsumer(java.awt.image.ImageConsumer)

requestTopDownLeftRightResend

public void requestTopDownLeftRightResend(ImageConsumer ic)

イメージデータを上下左右順で再送信するように ImageProducer に要求するために、ImageConsumer によって使用されます。ピクセルを順番に受け取ることで変換アルゴリズムの質が高くなり、良質なイメージ出力が得られます。ImageProducer は、この順序でデータを再送信することができない場合は、この呼び出しを無視することができます。データを再送信できる場合、ImageProducer は以下のような最小限の ImageConsumer メソッド呼び出しを実行することによって応答します。

	ic.setHints(TOPDOWNLEFTRIGHT | < otherhints >);
	ic.setPixels(...);	// As many times as needed
	ic.imageComplete();
 

関連項目:

ImageConsumer.setHints(int)