< prev index next >

src/java.desktop/share/classes/java/awt/image/BufferStrategy.java

Print this page

        

*** 28,44 **** import java.awt.BufferCapabilities; import java.awt.Graphics; import java.awt.Image; /** ! * The <code>BufferStrategy</code> class represents the mechanism with which ! * to organize complex memory on a particular <code>Canvas</code> or ! * <code>Window</code>. Hardware and software limitations determine whether and * how a particular buffer strategy can be implemented. These limitations * are detectable through the capabilities of the ! * <code>GraphicsConfiguration</code> used when creating the ! * <code>Canvas</code> or <code>Window</code>. * <p> * It is worth noting that the terms <i>buffer</i> and <i>surface</i> are meant * to be synonymous: an area of contiguous memory, either in video device * memory or in system memory. * <p> --- 28,44 ---- import java.awt.BufferCapabilities; import java.awt.Graphics; import java.awt.Image; /** ! * The {@code BufferStrategy} class represents the mechanism with which ! * to organize complex memory on a particular {@code Canvas} or ! * {@code Window}. Hardware and software limitations determine whether and * how a particular buffer strategy can be implemented. These limitations * are detectable through the capabilities of the ! * {@code GraphicsConfiguration} used when creating the ! * {@code Canvas} or {@code Window}. * <p> * It is worth noting that the terms <i>buffer</i> and <i>surface</i> are meant * to be synonymous: an area of contiguous memory, either in video device * memory or in system memory. * <p>
*** 133,144 **** * @since 1.4 */ public abstract class BufferStrategy { /** ! * Returns the <code>BufferCapabilities</code> for this ! * <code>BufferStrategy</code>. * * @return the buffering capabilities of this strategy */ public abstract BufferCapabilities getCapabilities(); --- 133,144 ---- * @since 1.4 */ public abstract class BufferStrategy { /** ! * Returns the {@code BufferCapabilities} for this ! * {@code BufferStrategy}. * * @return the buffering capabilities of this strategy */ public abstract BufferCapabilities getCapabilities();
*** 152,182 **** */ public abstract Graphics getDrawGraphics(); /** * Returns whether the drawing buffer was lost since the last call to ! * <code>getDrawGraphics</code>. Since the buffers in a buffer strategy ! * are usually type <code>VolatileImage</code>, they may become lost. ! * For a discussion on lost buffers, see <code>VolatileImage</code>. * * @return Whether or not the drawing buffer was lost since the last call ! * to <code>getDrawGraphics</code>. * @see java.awt.image.VolatileImage */ public abstract boolean contentsLost(); /** * 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 type ! * <code>VolatileImage</code>, they may become lost. If a surface has * been recently restored from a lost state since the last call to ! * <code>getDrawGraphics</code>, it may require repainting. ! * For a discussion on lost buffers, see <code>VolatileImage</code>. * * @return Whether or not the drawing buffer was restored since the last ! * call to <code>getDrawGraphics</code>. * @see java.awt.image.VolatileImage */ public abstract boolean contentsRestored(); /** --- 152,182 ---- */ public abstract Graphics getDrawGraphics(); /** * Returns whether the drawing buffer was lost since the last call to ! * {@code getDrawGraphics}. Since the buffers in a buffer strategy ! * are usually type {@code VolatileImage}, they may become lost. ! * For a discussion on lost buffers, see {@code VolatileImage}. * * @return Whether or not the drawing buffer was lost since the last call ! * to {@code getDrawGraphics}. * @see java.awt.image.VolatileImage */ public abstract boolean contentsLost(); /** * 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 type ! * {@code VolatileImage}, they may become lost. If a surface has * been recently restored from a lost state since the last call to ! * {@code getDrawGraphics}, it may require repainting. ! * For a discussion on lost buffers, see {@code VolatileImage}. * * @return Whether or not the drawing buffer was restored since the last ! * call to {@code getDrawGraphics}. * @see java.awt.image.VolatileImage */ public abstract boolean contentsRestored(); /**
*** 185,198 **** */ public abstract void show(); /** * Releases system resources currently consumed by this ! * <code>BufferStrategy</code> and * removes it from the associated Component. After invoking this ! * method, <code>getBufferStrategy</code> will return null. Trying ! * to use a <code>BufferStrategy</code> after it has been disposed will * result in undefined behavior. * * @see java.awt.Window#createBufferStrategy * @see java.awt.Canvas#createBufferStrategy * @see java.awt.Window#getBufferStrategy --- 185,198 ---- */ public abstract void show(); /** * Releases system resources currently consumed by this ! * {@code BufferStrategy} and * removes it from the associated Component. After invoking this ! * method, {@code getBufferStrategy} will return null. Trying ! * to use a {@code BufferStrategy} after it has been disposed will * result in undefined behavior. * * @see java.awt.Window#createBufferStrategy * @see java.awt.Canvas#createBufferStrategy * @see java.awt.Window#getBufferStrategy
< prev index next >