< prev index next >
src/java.desktop/share/classes/java/awt/BufferCapabilities.java
Print this page
*** 40,56 ****
private FlipContents flipContents;
/**
* Creates a new object for specifying buffering capabilities
* @param frontCaps the capabilities of the front buffer; cannot be
! * <code>null</code>
* @param backCaps the capabilities of the back and intermediate buffers;
! * cannot be <code>null</code>
* @param flipContents the contents of the back buffer after page-flipping,
! * <code>null</code> if page flipping is not used (implies blitting)
* @exception IllegalArgumentException if frontCaps or backCaps are
! * <code>null</code>
*/
public BufferCapabilities(ImageCapabilities frontCaps,
ImageCapabilities backCaps, FlipContents flipContents) {
if (frontCaps == null || backCaps == null) {
throw new IllegalArgumentException(
--- 40,56 ----
private FlipContents flipContents;
/**
* Creates a new object for specifying buffering capabilities
* @param frontCaps the capabilities of the front buffer; cannot be
! * {@code null}
* @param backCaps the capabilities of the back and intermediate buffers;
! * cannot be {@code null}
* @param flipContents the contents of the back buffer after page-flipping,
! * {@code null} if page flipping is not used (implies blitting)
* @exception IllegalArgumentException if frontCaps or backCaps are
! * {@code null}
*/
public BufferCapabilities(ImageCapabilities frontCaps,
ImageCapabilities backCaps, FlipContents flipContents) {
if (frontCaps == null || backCaps == null) {
throw new IllegalArgumentException(
*** 81,105 ****
* buffers that uses page flipping
* can swap the contents internally between the front buffer and one or
* more back buffers by switching the video pointer (or by copying memory
* internally). A non-flipping set of
* buffers uses blitting to copy the contents from one buffer to
! * another; when this is the case, <code>getFlipContents</code> returns
! * <code>null</code>
*/
public boolean isPageFlipping() {
return (getFlipContents() != null);
}
/**
* @return the resulting contents of the back buffer after page-flipping.
! * This value is <code>null</code> when the <code>isPageFlipping</code>
! * returns <code>false</code>, implying blitting. It can be one of
! * <code>FlipContents.UNDEFINED</code>
! * (the assumed default), <code>FlipContents.BACKGROUND</code>,
! * <code>FlipContents.PRIOR</code>, or
! * <code>FlipContents.COPIED</code>.
* @see #isPageFlipping
* @see FlipContents#UNDEFINED
* @see FlipContents#BACKGROUND
* @see FlipContents#PRIOR
* @see FlipContents#COPIED
--- 81,105 ----
* buffers that uses page flipping
* can swap the contents internally between the front buffer and one or
* more back buffers by switching the video pointer (or by copying memory
* internally). A non-flipping set of
* buffers uses blitting to copy the contents from one buffer to
! * another; when this is the case, {@code getFlipContents} returns
! * {@code null}
*/
public boolean isPageFlipping() {
return (getFlipContents() != null);
}
/**
* @return the resulting contents of the back buffer after page-flipping.
! * This value is {@code null} when the {@code isPageFlipping}
! * returns {@code false}, implying blitting. It can be one of
! * {@code FlipContents.UNDEFINED}
! * (the assumed default), {@code FlipContents.BACKGROUND},
! * {@code FlipContents.PRIOR}, or
! * {@code FlipContents.COPIED}.
* @see #isPageFlipping
* @see FlipContents#UNDEFINED
* @see FlipContents#BACKGROUND
* @see FlipContents#PRIOR
* @see FlipContents#COPIED
*** 108,118 ****
return flipContents;
}
/**
* @return whether page flipping is only available in full-screen mode. If this
! * is <code>true</code>, full-screen exclusive mode is required for
* page-flipping.
* @see #isPageFlipping
* @see GraphicsDevice#setFullScreenWindow
*/
public boolean isFullScreenRequired() {
--- 108,118 ----
return flipContents;
}
/**
* @return whether page flipping is only available in full-screen mode. If this
! * is {@code true}, full-screen exclusive mode is required for
* page-flipping.
* @see #isPageFlipping
* @see GraphicsDevice#setFullScreenWindow
*/
public boolean isFullScreenRequired() {
*** 156,166 ****
private static final String NAMES[] =
{ "undefined", "background", "prior", "copied" };
/**
! * When flip contents are <code>UNDEFINED</code>, the
* contents of the back buffer are undefined after flipping.
* @see #isPageFlipping
* @see #getFlipContents
* @see #BACKGROUND
* @see #PRIOR
--- 156,166 ----
private static final String NAMES[] =
{ "undefined", "background", "prior", "copied" };
/**
! * When flip contents are {@code UNDEFINED}, the
* contents of the back buffer are undefined after flipping.
* @see #isPageFlipping
* @see #getFlipContents
* @see #BACKGROUND
* @see #PRIOR
*** 168,178 ****
*/
public static final FlipContents UNDEFINED =
new FlipContents(I_UNDEFINED);
/**
! * When flip contents are <code>BACKGROUND</code>, the
* contents of the back buffer are cleared with the background color after
* flipping.
* @see #isPageFlipping
* @see #getFlipContents
* @see #UNDEFINED
--- 168,178 ----
*/
public static final FlipContents UNDEFINED =
new FlipContents(I_UNDEFINED);
/**
! * When flip contents are {@code BACKGROUND}, the
* contents of the back buffer are cleared with the background color after
* flipping.
* @see #isPageFlipping
* @see #getFlipContents
* @see #UNDEFINED
*** 181,191 ****
*/
public static final FlipContents BACKGROUND =
new FlipContents(I_BACKGROUND);
/**
! * When flip contents are <code>PRIOR</code>, the
* contents of the back buffer are the prior contents of the front buffer
* (a true page flip).
* @see #isPageFlipping
* @see #getFlipContents
* @see #UNDEFINED
--- 181,191 ----
*/
public static final FlipContents BACKGROUND =
new FlipContents(I_BACKGROUND);
/**
! * When flip contents are {@code PRIOR}, the
* contents of the back buffer are the prior contents of the front buffer
* (a true page flip).
* @see #isPageFlipping
* @see #getFlipContents
* @see #UNDEFINED
*** 194,204 ****
*/
public static final FlipContents PRIOR =
new FlipContents(I_PRIOR);
/**
! * When flip contents are <code>COPIED</code>, the
* contents of the back buffer are copied to the front buffer when
* flipping.
* @see #isPageFlipping
* @see #getFlipContents
* @see #UNDEFINED
--- 194,204 ----
*/
public static final FlipContents PRIOR =
new FlipContents(I_PRIOR);
/**
! * When flip contents are {@code COPIED}, the
* contents of the back buffer are copied to the front buffer when
* flipping.
* @see #isPageFlipping
* @see #getFlipContents
* @see #UNDEFINED
< prev index next >