AWT メモリイメージ動的更新 API

問題

MemoryImageSource クラスはこの機能を提供しますが、静的なイメージ機能を実装するだけです。初めてイメージが、イメージを描画したり、prepareImage メソッドを使用したり、またはイメージを構築するために MediaTracker を使用したりして画面用に準備されたとき、配列内のピクセルのスナップショットが画面表示用に変換されます。すると、イメージが同じスケールで再び描画されるたびに、同じバッファの画面表示が使用され、開発者がその間に元のピクセルの配列に対して行った変更を無視します。

この実装は各レンダリング操作に対して、ピクセル情報の元の配列を固有に再読み込みすることはありません。それは、イメージ変換が、変換されたピクセルを画面に単に移動することに比べて遅いプロセスだからです。drawImage を速くするためには、表示ハードウェアがピクセルを表示するために使用するフォーマット内に既にあるイメージのコピーを使用すると、うまく機能します。こうして、イメージを変化していないときには速く表示することと、動的に元のイメージデータへの変更を取り込むこととの交互使用ができます。

この実装は、一度計算されその結果が最終であるイメージに対しては、見事に機能しました。これはめったに変更されないイメージに対してさえも機能しました。それは、まれに行われる各変更の後、新しい MemoryImageSource イメージを構築できたこと、または元のイメージを Image.flush() メソッドを使用して流しだし、既存のすべての画面表示をキャッシュから除外できたことによります。これらの作業はアニメーションなどの、より頻繁な更新に対しては不充分であったか、非実際的でした。それは、イメージ全体を、データへの小さな修正に対してさえも再変換する必要があったからです。あるいはさらに悪いことに、この作業はイメージの古い廃棄されたバージョンが使用した空間を取り戻すために、厳密に必要なもの以上のガベージコレクションを要求します。

新メモリイメージアニメーション API

	setAnimated(boolean animated)
	setFullBufferUpdates(boolean animated)
	newPixels()
	newPixels(int x, int y, int w, int h)
	newPixels(int x, int y, int w, int h,
		  boolean framenotify)
	newPixels(byte[] newpix, ColorModel newmodel,
		  int offset, int scansize)
	newPixels(int[] newpix, ColorModel newmodel,
		  int offset, int scansize)

サンプルコード

メモリイメージバッファアニメーションを実行する古い API の使用方法を示すサンプルコードを、次に示します:

    import java.awt.*;
    import java.awt.image.*;
    import java.applet.*;

    public class AnimationExample extends Applet implements Runnable {
    	Thread anim;
	MemoryImageSource imgsrc;
	Image memimg;
	int[] pixels;

	public void init() {
	    pixels = new int[100 * 100];
	    imgsrc = new MemoryImageSource(100, 100, pixels, 0, 100);
	    memimg = createImage(imgsrc);
	}

    	public void start() {
	    anim = new Thread(this);
	    anim.start();
	}

	public synchronized void stop() {
	    anim = null;
	    notify();
	}

	public synchronized void run() {
	    while (Thread.currentThread() == anim) {
	    	int x = (int) (Math.random() * 100);
	    	int y = (int) (Math.random() * 100);
		int r = (int) (Math.random() * 255);
		int g = (int) (Math.random() * 255);
		int b = (int) (Math.random() * 255);
		pixels[y * 100 + x] =
		    ((int) (Math.random() * 0xffffff)) | (0xff<<24);
		memimg.flush();
		repaint();
		try {wait(100);} catch (InterruptedException e) {return;}
	    }
	}

	public void paint(Graphics g) {
	    // Draw the animated image
	    g.drawImage(memimg, 0, 0, this);
	}
    }

メモリイメージバッファアニメーションを実行する新しい API の使用方法を示すサンプルコードを、次に示します:

    import java.awt.*;
    import java.awt.image.*;
    import java.applet.*;

    public class AnimationExample extends Applet implements Runnable {
    	Thread anim;
	MemoryImageSource imgsrc;
	Image memimg;
	int[] pixels;

	public void init() {
	    pixels = new int[100 * 100];
	    imgsrc = new MemoryImageSource(100, 100, pixels, 0, 100);
	    imgsrc.setAnimated(true);
	    memimg = createImage(imgsrc);
	}

    	public void start() {
	    anim = new Thread(this);
	    anim.start();
	}

	public synchronized void stop() {
	    anim = null;
	    notify();
	}

	public synchronized void run() {
	    while (Thread.currentThread() == anim) {
	    	int x = (int) (Math.random() * 100);
	    	int y = (int) (Math.random() * 100);
		int r = (int) (Math.random() * 255);
		int g = (int) (Math.random() * 255);
		int b = (int) (Math.random() * 255);
		pixels[y * 100 + x] =
		    ((int) (Math.random() * 0xffffff)) | (0xff<<24);
		imgsrc.newPixels(x, y, 1, 1);
		repaint();
		try {wait(100);} catch (InterruptedException e) {return;}
	    }
	}

	public void paint(Graphics g) {
	    // Draw the animated image
	    g.drawImage(memimg, 0, 0, this);
	}
    }