|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.awt.image.BufferStrategy
java.awt.Component.FlipBufferStrategy
protected class Component.FlipBufferStrategy
Inner class for flipping buffers on a component. That component must
be a Canvas or Window.
Canvas,
Window,
BufferStrategy| Field Summary | |
|---|---|
protected BufferCapabilities |
caps
The buffering capabilities |
protected Image |
drawBuffer
The drawing buffer |
protected VolatileImage |
drawVBuffer
The drawing buffer as a volatile image |
protected int |
numBuffers
The number of buffers |
protected boolean |
validatedContents
Whether or not the drawing buffer has been recently restored from a lost state. |
| Constructor Summary | |
|---|---|
protected |
Component.FlipBufferStrategy(int numBuffers,
BufferCapabilities caps)
Creates a new flipping buffer strategy for this component. |
| Method Summary | |
|---|---|
boolean |
contentsLost()
Returns whether the drawing buffer was lost since the last call to getDrawGraphics. |
boolean |
contentsRestored()
Returns whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white). |
protected void |
createBuffers(int numBuffers,
BufferCapabilities caps)
Creates one or more complex, flipping buffers with the given capabilities. |
protected void |
destroyBuffers()
Destroys the buffers created through this object |
void |
dispose()
Releases system resources currently consumed by this BufferStrategy and
removes it from the associated Component. |
protected void |
flip(BufferCapabilities.FlipContents flipAction)
Flipping moves the contents of the back buffer to the front buffer, either by copying or by moving the video pointer. |
protected Image |
getBackBuffer()
|
BufferCapabilities |
getCapabilities()
Returns the BufferCapabilities for this
BufferStrategy. |
Graphics |
getDrawGraphics()
Creates a graphics context for the drawing buffer. |
protected void |
revalidate()
Restore the drawing buffer if it has been lost |
void |
show()
Makes the next available buffer visible by either blitting or flipping. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
protected int numBuffers
protected BufferCapabilities caps
protected Image drawBuffer
protected VolatileImage drawVBuffer
protected boolean validatedContents
| Constructor Detail |
|---|
protected Component.FlipBufferStrategy(int numBuffers,
BufferCapabilities caps)
throws AWTException
Canvas or Window.
numBuffers - the number of bufferscaps - the capabilities of the buffers
AWTException - if the capabilities supplied could not be
supported or met
ClassCastException - if the component is not a canvas or
window.Canvas,
Window| Method Detail |
|---|
protected void createBuffers(int numBuffers,
BufferCapabilities caps)
throws AWTException
numBuffers - number of buffers to create; must be greater than
onecaps - the capabilities of the buffers.
BufferCapabilities.isPageFlipping must be
true.
AWTException - if the capabilities supplied could not be
supported or met
IllegalStateException - if the component has no peer
IllegalArgumentException - if numBuffers is less than two,
or if BufferCapabilities.isPageFlipping is not
true.BufferCapabilities.isPageFlipping()protected Image getBackBuffer()
IllegalStateException - if the buffers have not yet
been createdprotected void flip(BufferCapabilities.FlipContents flipAction)
flipAction - an integer value describing the flipping action
for the contents of the back buffer. This should be one of the
values of the BufferCapabilities.FlipContents
property.
IllegalStateException - if the buffers have not yet
been createdBufferCapabilities.getFlipContents()protected void destroyBuffers()
public BufferCapabilities getCapabilities()
BufferStrategyBufferCapabilities for this
BufferStrategy.
getCapabilities in class BufferStrategypublic Graphics getDrawGraphics()
BufferStrategy
getDrawGraphics in class BufferStrategyprotected void revalidate()
public boolean contentsLost()
BufferStrategygetDrawGraphics. Since the buffers in a buffer strategy
are usually type VolatileImage, they may become lost.
For a discussion on lost buffers, see VolatileImage.
contentsLost in class BufferStrategygetDrawGraphicsVolatileImagepublic boolean contentsRestored()
BufferStrategyVolatileImage, they may become lost. If a surface has
been recently restored from a lost state since the last call to
getDrawGraphics, it may require repainting.
For a discussion on lost buffers, see VolatileImage.
contentsRestored in class BufferStrategyVolatileImagepublic void show()
show in class BufferStrategypublic void dispose()
BufferStrategy and
removes it from the associated Component. After invoking this
method, getBufferStrategy will return null. Trying
to use a BufferStrategy after it has been disposed will
result in undefined behavior.
dispose in class BufferStrategyComponent.createBufferStrategy(int),
Component.getBufferStrategy()
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.