モジュール java.desktop

パッケージ 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オブジェクトが、このImageProducerを使ってコンシューマとして現在登録されているかどうかを判定します。
void	removeConsumer(ImageConsumer ic)	イメージ・データを受け取るように現在登録されているコンシューマ・リストから、指定されたImageConsumerオブジェクトを削除します。
void	requestTopDownLeftRightResend(ImageConsumer ic)	イメージ・データを上下左右順で再送信するようにImageProducerに要求するために、ImageConsumerによって使用されます。ピクセルを順番に受け取ることで変換アルゴリズムの質が高くなり、良質なイメージ出力が得られます。
void	startProduction(ImageConsumer ic)	指定されたImageConsumerオブジェクトをコンシューマとして登録し、イメージ・データの再構成をただちに開始します。イメージ・データは、このコンシューマやすでにプロデューサで登録されているほかのコンシューマに転送されます。

メソッドの詳細

addConsumer

void addConsumer(ImageConsumer ic)

ImageProducerにImageConsumerを登録し、あとでImageを再構成するときに、そのイメージ・データにアクセスします。 ImageProducerはただちに、またはstartProductionメソッドが次の利用可能なイメージの再構成を開始するときに、ImageConsumerインタフェースを使ってイメージ・データをコンシューマへ転送できます。

パラメータ:

ic - 指定されたImageConsumer

関連項目:

• startProduction(java.awt.image.ImageConsumer)

isConsumer

boolean isConsumer(ImageConsumer ic)

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

パラメータ:

ic - 指定されたImageConsumer

戻り値:

指定されたImageConsumerがこのImageProducerに登録されている場合はtrue、それ以外の場合はfalse。

removeConsumer

void removeConsumer(ImageConsumer ic)

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

パラメータ:

ic - 指定されたImageConsumer

startProduction

void startProduction(ImageConsumer ic)

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

パラメータ:

ic - 指定されたImageConsumer

関連項目:

• addConsumer(java.awt.image.ImageConsumer)

requestTopDownLeftRightResend

void requestTopDownLeftRightResend(ImageConsumer ic)

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

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

パラメータ:

ic - 指定されたImageConsumer

関連項目:

• ImageConsumer.setHints(int)