- java.lang.Object
- 
- java.awt.image.BufferStrategy
- 
- java.awt.Component.FlipBufferStrategy
 
 
- 
- Enclosing class:
- Component
 
 protected class Component.FlipBufferStrategy extends BufferStrategy Inner class for flipping buffers on a component. That component must be aCanvasorWindoworApplet.- Since:
- 1.4
- See Also:
- Canvas,- Window,- Applet,- BufferStrategy
 
- 
- 
Field SummaryFields Modifier and Type Field Description protected BufferCapabilitiescapsThe buffering capabilitiesprotected ImagedrawBufferThe drawing bufferprotected VolatileImagedrawVBufferThe drawing buffer as a volatile imageprotected intnumBuffersThe number of buffersprotected booleanvalidatedContentsWhether or not the drawing buffer has been recently restored from a lost state.
 - 
Constructor SummaryConstructors Modifier Constructor Description protectedFlipBufferStrategy(int numBuffers, BufferCapabilities caps)Creates a new flipping buffer strategy for this component.
 - 
Method SummaryAll Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancontentsLost()Returns whether the drawing buffer was lost since the last call togetDrawGraphics.booleancontentsRestored()Returns whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white).protected voidcreateBuffers(int numBuffers, BufferCapabilities caps)Creates one or more complex, flipping buffers with the given capabilities.protected voiddestroyBuffers()Destroys the buffers created through this objectvoiddispose()Releases system resources currently consumed by thisBufferStrategyand removes it from the associated Component.protected voidflip(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 ImagegetBackBuffer()BufferCapabilitiesgetCapabilities()Returns theBufferCapabilitiesfor thisBufferStrategy.GraphicsgetDrawGraphics()Creates a graphics context for the drawing buffer.protected voidrevalidate()Restore the drawing buffer if it has been lostvoidshow()Makes the next available buffer visible by either blitting or flipping.
 
- 
- 
- 
Field Detail- 
numBuffersprotected int numBuffers The number of buffers
 - 
capsprotected BufferCapabilities caps The buffering capabilities
 - 
drawBufferprotected Image drawBuffer The drawing buffer
 - 
drawVBufferprotected VolatileImage drawVBuffer The drawing buffer as a volatile image
 - 
validatedContentsprotected boolean validatedContents Whether or not the drawing buffer has been recently restored from a lost state.
 
- 
 - 
Constructor Detail- 
FlipBufferStrategyprotected FlipBufferStrategy(int numBuffers, BufferCapabilities caps) throws AWTExceptionCreates a new flipping buffer strategy for this component. The component must be aCanvasorWindoworApplet.- Parameters:
- numBuffers- the number of buffers
- caps- the capabilities of the buffers
- Throws:
- AWTException- if the capabilities supplied could not be supported or met
- ClassCastException- if the component is not a canvas or window.
- IllegalStateException- if the component has no peer
- IllegalArgumentException- if- numBuffersis less than two, or if- BufferCapabilities.isPageFlippingis not- true.
- See Also:
- Canvas,- Window,- Applet,- createBuffers(int, BufferCapabilities)
 
 
- 
 - 
Method Detail- 
createBuffersprotected void createBuffers(int numBuffers, BufferCapabilities caps) throws AWTExceptionCreates one or more complex, flipping buffers with the given capabilities.- Parameters:
- numBuffers- number of buffers to create; must be greater than one
- caps- the capabilities of the buffers.- BufferCapabilities.isPageFlippingmust be- true.
- Throws:
- 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.isPageFlippingis not- true.
- See Also:
- BufferCapabilities.isPageFlipping()
 
 - 
getBackBufferprotected Image getBackBuffer() - Returns:
- direct access to the back buffer, as an image.
- Throws:
- IllegalStateException- if the buffers have not yet been created
 
 - 
flipprotected 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.- Parameters:
- 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.FlipContentsproperty.
- Throws:
- IllegalStateException- if the buffers have not yet been created
- See Also:
- BufferCapabilities.getFlipContents()
 
 - 
destroyBuffersprotected void destroyBuffers() Destroys the buffers created through this object
 - 
getCapabilitiespublic BufferCapabilities getCapabilities() Description copied from class:BufferStrategyReturns theBufferCapabilitiesfor thisBufferStrategy.- Specified by:
- getCapabilitiesin class- BufferStrategy
- Returns:
- the buffering capabilities of this strategy
 
 - 
getDrawGraphicspublic Graphics getDrawGraphics() Description copied from class:BufferStrategyCreates a graphics context for the drawing buffer. This method may not be synchronized for performance reasons; use of this method by multiple threads should be handled at the application level. Disposal of the graphics object obtained must be handled by the application.- Specified by:
- getDrawGraphicsin class- BufferStrategy
- Returns:
- the graphics on the drawing buffer. This method may not be synchronized for performance reasons; use of this method by multiple threads should be handled at the application level. Disposal of the graphics object must be handled by the application.
 
 - 
revalidateprotected void revalidate() Restore the drawing buffer if it has been lost
 - 
contentsLostpublic boolean contentsLost() Description copied from class:BufferStrategyReturns whether the drawing buffer was lost since the last call togetDrawGraphics. Since the buffers in a buffer strategy are usually typeVolatileImage, they may become lost. For a discussion on lost buffers, seeVolatileImage.- Specified by:
- contentsLostin class- BufferStrategy
- Returns:
- whether the drawing buffer was lost since the last call to
 getDrawGraphics
- See Also:
- VolatileImage
 
 - 
contentsRestoredpublic boolean contentsRestored() Description copied from class:BufferStrategyReturns 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, seeVolatileImage.- Specified by:
- contentsRestoredin class- BufferStrategy
- Returns:
- whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white)
- See Also:
- VolatileImage
 
 - 
showpublic void show() Makes the next available buffer visible by either blitting or flipping.- Specified by:
- showin class- BufferStrategy
 
 - 
disposepublic void dispose() Releases system resources currently consumed by thisBufferStrategyand removes it from the associated Component. After invoking this method,getBufferStrategywill return null. Trying to use aBufferStrategyafter it has been disposed will result in undefined behavior.- Overrides:
- disposein class- BufferStrategy
- Since:
- 1.6
- See Also:
- Window.createBufferStrategy(int),- Canvas.createBufferStrategy(int),- Window.getBufferStrategy(),- Canvas.getBufferStrategy()
 
 
- 
 
-