This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


java.awt
class Component.FlipBufferStrategy

java.lang.Object extended by java.awt.image.BufferStrategy extended by 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 a Canvas or Window.


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

          Creates a new flipping buffer strategy for this component.
 
Method Summary
 boolean

          Returns whether the drawing buffer was lost since the last call to getDrawGraphics.
 boolean

          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

          Destroys the buffers created through this object
 void

          Releases system resources currently consumed by this BufferStrategy and removes it from the associated Component.
protected void

          Flipping moves the contents of the back buffer to the front buffer, either by copying or by moving the video pointer.
protected Image

          
 BufferCapabilities

          Returns the BufferCapabilities for this BufferStrategy.
 Graphics

          Creates a graphics context for the drawing buffer.
protected void

          Restore the drawing buffer if it has been lost
 void

          Makes the next available buffer visible by either blitting or flipping.
 
Methods inherited from class java.awt.image.BufferStrategy
contentsLost, contentsRestored, dispose, getCapabilities, getDrawGraphics, show
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

caps

protected BufferCapabilities caps
The buffering capabilities

drawBuffer

protected Image drawBuffer
The drawing buffer

drawVBuffer

protected VolatileImage drawVBuffer
The drawing buffer as a volatile image

numBuffers

protected int numBuffers
The number of buffers

validatedContents

protected boolean validatedContents
Whether or not the drawing buffer has been recently restored from a lost state.
Constructor Detail

Component.FlipBufferStrategy

protected Component.FlipBufferStrategy(int numBuffers,
                                       BufferCapabilities caps)
                                throws AWTException
Creates a new flipping buffer strategy for this component. The component must be a Canvas or Window.

Parameters:
numBuffers - the number of buffers
caps - the capabilities of the buffers
Throws:
AWTException - if the capabilities supplied could not be supported or met
Method Detail

contentsLost

public boolean contentsLost()
Overrides:
contentsLost in class BufferStrategy
Returns:
whether the drawing buffer was lost since the last call to getDrawGraphics

contentsRestored

public boolean contentsRestored()
Overrides:
contentsRestored in class BufferStrategy
Returns:
whether the drawing buffer was recently restored from a lost state and reinitialized to the default background color (white)

createBuffers

protected void createBuffers(int numBuffers,
                             BufferCapabilities caps)
                      throws AWTException
Creates 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.isPageFlipping must be true.
Throws:
AWTException - if the capabilities supplied could not be supported or met

destroyBuffers

protected void destroyBuffers()
Destroys the buffers created through this object


dispose

public void dispose()
{@inheritDoc}

Overrides:
dispose in class BufferStrategy

flip

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.

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.FlipContents property.

getBackBuffer

protected Image getBackBuffer()
Returns:
direct access to the back buffer, as an image.

getCapabilities

public BufferCapabilities getCapabilities()
Overrides:
getCapabilities in class BufferStrategy
Returns:
the buffering capabilities of this strategy

getDrawGraphics

public Graphics getDrawGraphics()
Overrides:
getDrawGraphics in 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.

revalidate

protected void revalidate()
Restore the drawing buffer if it has been lost


show

public void show()
Makes the next available buffer visible by either blitting or flipping.

Overrides:
show in class BufferStrategy


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.