モジュール java.desktop

パッケージ 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