java.awt

クラス BufferCapabilities

java.lang.Object

java.awt.BufferCapabilities

すべての実装されたインタフェース:

Cloneable

public class BufferCapabilities
extends Object
implements Cloneable

バッファーの機能とプロパティー

導入されたバージョン:

1.4

関連項目:

BufferStrategy.getCapabilities(), GraphicsConfiguration.getBufferCapabilities()

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	BufferCapabilities.FlipContents ページ反転後に、バックバッファーの内容を型保証して列挙します。

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

コンストラクタ

コンストラクタと説明
BufferCapabilities(ImageCapabilities frontCaps, ImageCapabilities backCaps, BufferCapabilities.FlipContents flipContents) バッファリング機能を指定するためのオブジェクトを新しく生成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Object	clone() このオブジェクトのコピーを作成して、返します。
ImageCapabilities	getBackBufferCapabilities()
BufferCapabilities.FlipContents	getFlipContents()
ImageCapabilities	getFrontBufferCapabilities()
boolean	isFullScreenRequired()
boolean	isMultiBufferAvailable()
boolean	isPageFlipping()

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

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

コンストラクタの詳細

BufferCapabilities

public BufferCapabilities(ImageCapabilities frontCaps,
                  ImageCapabilities backCaps,
                  BufferCapabilities.FlipContents flipContents)

バッファリング機能を指定するためのオブジェクトを新しく生成します。

パラメータ:

frontCaps - フロントバッファーの機能。null は指定不可

backCaps - バックバッファーおよび中間バッファーの機能。null は指定不可

flipContents - ページ反転後のバックバッファーの内容。ページ反転が使用されない場合 (暗黙的な Blit) は null

例外:

IllegalArgumentException - frontCaps または backCaps が null の場合

メソッドの詳細

getFrontBufferCapabilities

public ImageCapabilities getFrontBufferCapabilities()

戻り値:

フロントバッファー (表示されているバッファー) のイメージ機能

getBackBufferCapabilities

public ImageCapabilities getBackBufferCapabilities()

戻り値:

すべてのバックバッファーのイメージ機能。中間バッファーはバックバッファーとみなされる

isPageFlipping

public boolean isPageFlipping()

戻り値:

ページ反転をバッファーで使用するかどうか。ページ反転を使用するバッファーセットでは、ビデオポインタの切り替え、またはメモリーの内部コピーにより、フロントバッファーと 1 つ以上のバックバッファーの間で内部的に内容の切り替えが可能。反転を使用しないバッファーセットでは、Blit を使用してバッファーから別のバッファーに内容をコピーする。この場合 getFlipContents は null を返す

getFlipContents

public BufferCapabilities.FlipContents getFlipContents()

戻り値:

ページ反転後のバックバッファーの内容。isPageFlipping が false を返す場合は null (Blit を使用)。この値は FlipContents.UNDEFINED (デフォルト値)、FlipContents.BACKGROUND、FlipContents.PRIOR、または FlipContents.COPIED のいずれか

関連項目:

isPageFlipping(), BufferCapabilities.FlipContents.UNDEFINED, BufferCapabilities.FlipContents.BACKGROUND, BufferCapabilities.FlipContents.PRIOR, BufferCapabilities.FlipContents.COPIED

isFullScreenRequired

public boolean isFullScreenRequired()

戻り値:

ページ切り替えをフルスクリーンモードだけで利用可能にするかどうか。true の場合、フルスクリーン排他モードでページ切り替えを行う

関連項目:

isPageFlipping(), GraphicsDevice.setFullScreenWindow(java.awt.Window)

isMultiBufferAvailable

public boolean isMultiBufferAvailable()

戻り値:

フロントバッファーとバックバッファー以外に、1 つ以上の中間バッファーを使ったページ切り替えができるかどうか

関連項目:

isPageFlipping()

clone

public Object clone()

次のクラスからコピーされた説明: Object

このオブジェクトのコピーを作成して、返します。「コピー」の正確な意味合いは、オブジェクトのクラスによって異なります。一般的な意図は、任意のオブジェクト x について、次の式

 x.clone() != x

が true であり、次の式

 x.clone().getClass() == x.getClass()

が true になることですが、これらは絶対的な要件ではありません。また次の式

 x.clone().equals(x)

が true になりますが、これは絶対的な要件ではありません。

慣例上、返されたオブジェクトは、super.clone を呼び出すことによって取得するようにしてください。クラスとそのすべてのスーパークラス (Object を除く) がこの規則に従っている場合は、x.clone().getClass() == x.getClass() が成立します。

通常、このメソッドにより返されるオブジェクトは、このオブジェクト (複製されている) から独立している必要があります。この独立性を実現するには、super.clone によって返されたオブジェクトを返す前に、その 1 つ以上のフィールドを変更することが必要になる場合があります。これは、通常、複製するオブジェクトの内部「深層構造」を構成する可変オブジェクトのコピー、およびこれらのオブジェクトへの参照をコピーへの参照に置き換えることを意味します。クラスにプリミティブフィールドまたは不変オブジェクトへの参照しか含まれていない場合は、通常、super.clone によって返されたオブジェクト内のフィールドを変更する必要がありません。

クラス Object のメソッド clone は、特定のクローニング操作を実行します。まず、このオブジェクトのクラスがインタフェース Cloneable を実装していない場合は、CloneNotSupportedException がスローされます。すべての配列がインタフェース Cloneable を実装していると見なされること、および配列型 T[] の clone メソッドの戻り値の型は T[] (ここで、T は任意の参照またはプリミティブ型) です。実装していない場合、このメソッドはこのオブジェクトのクラスの新しいインスタンスを生成し、そのフィールドをすべて、このオブジェクトの対応する各フィールドの内容で初期化します。これは代入と同様で、フィールドの内容自身が複製されるのではありません。つまりこのメソッドは、オブジェクトの「シャローコピー」を生成しますが、「ディープコピー」は生成しません。

クラス Object 自体はインタフェース Cloneable を実装していないため、クラスが Object であるオブジェクトに対して clone メソッドを呼び出すと、実行時に例外がスローされます。

オーバーライド:

clone、クラス: Object

戻り値:

この BufferCapabilities オブジェクトのコピー

関連項目:

Cloneable