Component.BltBufferStrategy (Java 2 Platform SE 5.0) (original) (raw)

java.lang.Object extended by java.awt.image.BufferStrategy java.awt.Component.BltBufferStrategy

Enclosing class:

protected class Component.BltBufferStrategy

Inner class for blitting offscreen surfaces to a component.

Since:

1.4

Field Summary
protected VolatileImage[]	backBuffers The back buffers
protected BufferCapabilities	caps The buffering capabilities
protected int	height
protected boolean	validatedContents Whether or not the drawing buffer has been recently restored from a lost state.
protected int	width Size of the back buffers

Constructor Summary
protected	[Component.BltBufferStrategy](../../java/awt/Component.BltBufferStrategy.html#Component.BltBufferStrategy%28int, java.awt.BufferCapabilities%29)(int numBuffers,BufferCapabilities caps) Creates a new blt buffer strategy around a component

Method Summary
boolean	contentsLost() Returns whether the drawing buffer was lost since the last call togetDrawGraphics.
boolean	contentsRestored() Returns whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white).
protected void	createBackBuffers(int numBuffers) Creates the back buffers
BufferCapabilities	getCapabilities()
Graphics	getDrawGraphics()
protected void	revalidate() Restore the drawing buffer if it has been lost
void	show() Makes the next available buffer visible.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Field Detail

caps

protected BufferCapabilities caps

The buffering capabilities

backBuffers

protected VolatileImage[] backBuffers

The back buffers

validatedContents

protected boolean validatedContents

Whether or not the drawing buffer has been recently restored from a lost state.

width

protected int width

Size of the back buffers

height

protected int height

Constructor Detail

Component.BltBufferStrategy

protected Component.BltBufferStrategy(int numBuffers, BufferCapabilities caps)

Creates a new blt buffer strategy around a component

Parameters:

numBuffers - the component to use as the front buffer

caps - the capabilities of the buffers

Method Detail

createBackBuffers

protected void createBackBuffers(int numBuffers)

Creates the back buffers

getCapabilities

public BufferCapabilities getCapabilities()

Specified by:

[getCapabilities](../../java/awt/image/BufferStrategy.html#getCapabilities%28%29) in class [BufferStrategy](../../java/awt/image/BufferStrategy.html "class in java.awt.image")

Returns:

the buffering capabilities of this strategy

getDrawGraphics

public Graphics getDrawGraphics()

Specified by:

[getDrawGraphics](../../java/awt/image/BufferStrategy.html#getDrawGraphics%28%29) in class [BufferStrategy](../../java/awt/image/BufferStrategy.html "class in java.awt.image")

Returns:

the draw graphics

show

public void show()

Makes the next available buffer visible.

Specified by:

[show](../../java/awt/image/BufferStrategy.html#show%28%29) in class [BufferStrategy](../../java/awt/image/BufferStrategy.html "class in java.awt.image")

revalidate

protected void revalidate()

Restore the drawing buffer if it has been lost

contentsLost

public boolean contentsLost()

Description copied from class: [BufferStrategy](../../java/awt/image/BufferStrategy.html#contentsLost%28%29)

Returns whether the drawing buffer was lost since the last call togetDrawGraphics. Since the buffers in a buffer strategy are usually type VolatileImage, they may become lost. For a discussion on lost buffers, see VolatileImage.

Specified by:

[contentsLost](../../java/awt/image/BufferStrategy.html#contentsLost%28%29) in class [BufferStrategy](../../java/awt/image/BufferStrategy.html "class in java.awt.image")

Returns:

whether the drawing buffer was lost since the last call togetDrawGraphics

See Also:

VolatileImage

contentsRestored

public boolean contentsRestored()

Description copied from class: [BufferStrategy](../../java/awt/image/BufferStrategy.html#contentsRestored%28%29)

Returns whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white). Since the buffers in a buffer strategy are usually typeVolatileImage, they may become lost. If a surface has been recently restored from a lost state since the last call togetDrawGraphics, it may require repainting. For a discussion on lost buffers, see VolatileImage.

Specified by:

[contentsRestored](../../java/awt/image/BufferStrategy.html#contentsRestored%28%29) in class [BufferStrategy](../../java/awt/image/BufferStrategy.html "class in java.awt.image")

Returns:

whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white)

See Also:

VolatileImage

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.