java.awt.image

クラス BufferStrategy

java.lang.Object

java.awt.image.BufferStrategy

直系の既知のサブクラス:

Component.BltBufferStrategy, Component.FlipBufferStrategy

public abstract class BufferStrategy
extends Object

BufferStrategy クラスは、特定の Canvas または Window 上の複雑なメモリーを編成するメカニズムを表します。特定のバッファーストラテジが実装可能かどうか、およびその実装方法は、ハードウェアとソフトウェアの制限事項によって決まります。これらの制限事項は、Canvas または Window を作成するときに使用する GraphicsConfiguration の機能を介して検出されます。

バッファーおよび表面という語は同義であり、ビデオデバイスメモリー内またはシステムメモリー内での連続したメモリー領域を指します。

複雑なバッファーストラテジには、順次リングバッファリング、Blit バッファリングなどいくつかの種類があります。もっとも一般的なのは、順次リングバッファリング (ダブルバッファリングまたはトリプルバッファリング) です。アプリケーションは単一のバックバッファーへ描画してから、データを複製するかビデオポインタを移動することにより単一ステップで内容をフロント (ディスプレイ) へ移動します。ビデオポインタを移動することでバッファーが交換され、最初に描画されたバッファーまたはデバイスに現在表示されているイメージがフロントバッファーになります。これはページフリッピングと呼ばれます。

代わりに、ビデオポインタを移動するのではなく、チェーン内で先行してバックバッファーの内容を複製または Blit することができます。

 Double buffering:

                    ***********         ***********
                    *         * ------> *         *
 [To display] <---- * Front B *   Show  * Back B. * <---- Rendering
                    *         * <------ *         *
                    ***********         ***********

 Triple buffering:

 [To      ***********         ***********        ***********
 display] *         * --------+---------+------> *         *
    <---- * Front B *   Show  * Mid. B. *        * Back B. * <---- Rendering
          *         * <------ *         * <----- *         *
          ***********         ***********        ***********

 

バッファーストラテジの作成と使用の例を示します。

 // Check the capabilities of the GraphicsConfiguration
 ...

 // Create our component
 Window w = new Window(gc);

 // Show our window
 w.setVisible(true);

 // Create a general double-buffering strategy
 w.createBufferStrategy(2);
 BufferStrategy strategy = w.getBufferStrategy();

 // Main loop
 while (!done) {
     // Prepare for rendering the next frame
     // ...

     // Render single frame
     do {
         // The following loop ensures that the contents of the drawing buffer
         // are consistent in case the underlying surface was recreated
         do {
             // Get a new graphics context every time through the loop
             // to make sure the strategy is validated
             Graphics graphics = strategy.getDrawGraphics();

             // Render to graphics
             // ...

             // Dispose the graphics
             graphics.dispose();

             // Repeat the rendering if the drawing buffer contents
             // were restored
         } while (strategy.contentsRestored());

         // Display the buffer
         strategy.show();

         // Repeat the rendering if the drawing buffer was lost
     } while (strategy.contentsLost());
 }

 // Dispose the window
 w.setVisible(false);
 w.dispose();
 

導入されたバージョン:

1.4

関連項目:

Window, Canvas, GraphicsConfiguration, VolatileImage

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

コンストラクタ

コンストラクタと説明
BufferStrategy()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract boolean	contentsLost() getDrawGraphics の最後の呼び出しのあとに描画バッファーが失われたかどうかを返します。
abstract boolean	contentsRestored() 描画バッファーが消失状態から最近復元され、デフォルトのバックグラウンドカラー (白) に再初期化されたかどうかを返します。
void	dispose() 現在この BufferStrategy によって消費されているシステムリソースを解放し、関連付けられたコンポーネントから削除します。
abstract BufferCapabilities	getCapabilities() この BufferStrategy の BufferCapabilities を返します。
abstract Graphics	getDrawGraphics() 描画バッファーのグラフィックスコンテキストを作成します。
abstract void	show() メモリーを複製 (Blit) するかディスプレイポインタを変更する (切り替える) ことにより、次に使用可能なバッファーを可視状態にします。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

BufferStrategy

public BufferStrategy()

メソッドの詳細

getCapabilities

public abstract BufferCapabilities getCapabilities()

この BufferStrategy の BufferCapabilities を返します。

戻り値:

この方針のバッファー容量

getDrawGraphics

public abstract Graphics getDrawGraphics()

描画バッファーのグラフィックスコンテキストを作成します。このメソッドはパフォーマンスの理由から同期しない場合があります。複数スレッドでこのメソッドを使用するには、アプリケーションレベルでの処理が必要です。取得したグラフィックスオブジェクトの処理は、アプリケーション側で行う必要があります。

戻り値:

描画バッファーのグラフィックスコンテキスト

contentsLost

public abstract boolean contentsLost()

getDrawGraphics の最後の呼び出しのあとに描画バッファーが失われたかどうかを返します。バッファー方式内のバッファーは通常、タイプが VolatileImage であるため、失われることがあります。失われたバッファーに関する説明については、VolatileImage を参照してください。

戻り値:

getDrawGraphics への最後の呼び出しのために描画バッファーが消失したかどうか。

関連項目:

VolatileImage

contentsRestored

public abstract boolean contentsRestored()

描画バッファーが消失状態から最近復元され、デフォルトのバックグラウンドカラー (白) に再初期化されたかどうかを返します。バッファー方式内のバッファーは通常、タイプが VolatileImage であるため、失われることがあります。getDrawGraphics の最後の呼び出しのあとに表面が最近、失われた状態から復元された場合は、その表面に再ペイントが必要になることがあります。失われたバッファーに関する説明については、VolatileImage を参照してください。

戻り値:

getDrawGraphics への最後の呼び出しのために描画バッファーが復元されたかどうか。

関連項目:

VolatileImage

show

public abstract void show()

メモリーを複製 (Blit) するかディスプレイポインタを変更する (切り替える) ことにより、次に使用可能なバッファーを可視状態にします。

dispose

public void dispose()

現在この BufferStrategy によって消費されているシステムリソースを解放し、関連付けられたコンポーネントから削除します。このメソッドを呼び出したあと、getBufferStrategy は null を返します。BufferStrategy をそれが破棄されたあとに使用しようとすると、未定義の動作になります。

導入されたバージョン:

1.6

関連項目:

Window.createBufferStrategy(int), Canvas.createBufferStrategy(int), Window.getBufferStrategy(), Canvas.getBufferStrategy()