Provides extended BufferStrategy capabilities, allowing to specify the type of vertical refresh synchronization for a buffer strategy. This BS capability is always page flipping because v-sync is only relevant to flipping buffer strategies. Note that asking for a v-synced BS doesn't necessarily guarantee that it will be v-synced since the vsync capability may be disabled in the driver, or there may be other restriction (like a number of v-synced buffer strategies allowed per vm). Because of this createBufferStrategy doesn't throw AWTException when a v-synced BS could not be created when requested.

Nested and Inner Type Summary

Modifier and Type	Class and Description
public static enum	ExtendedBufferCapabilities.VSyncType Type of synchronization on vertical retrace.

Modifier and Type	Field and Description
private ExtendedBufferCapabilities.VSyncType	vsync

Constructor Summary

Access	Constructor and Description
public	ExtendedBufferCapabilities(BufferCapabilities caps) Creates an ExtendedBufferCapabilities object with front/back/flip caps from the passed cap, and VSYNC_DEFAULT v-sync mode.
public	ExtendedBufferCapabilities(ImageCapabilities front, ImageCapabilities back, BufferCapabilities.FlipContents flip) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the passed caps, and VSYNC_DEFAULT v-sync mode.
public	ExtendedBufferCapabilities(ImageCapabilities front, ImageCapabilities back, BufferCapabilities.FlipContents flip, ExtendedBufferCapabilities.VSyncType t) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the passed image/flip caps, and the v-sync type.
public	ExtendedBufferCapabilities(BufferCapabilities caps, ExtendedBufferCapabilities.VSyncType t) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the passed cap, and the passed v-sync mode.

Method Summary

Modifier and Type	Method and Description
public ExtendedBufferCapabilities	derive(ExtendedBufferCapabilities.VSyncType t) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the object, and passed v-sync mode.
public ExtendedBufferCapabilities.VSyncType	getVSync() Returns the type of v-sync requested by this capabilities instance.
public final boolean	isPageFlipping() Overrides java.awt.BufferCapabilities.isPageFlipping. Returns whether or not the buffer strategy uses page flipping.

Inherited from java.awt.BufferCapabilities:: clone getBackBufferCapabilities getFlipContents getFrontBufferCapabilities isFullScreenRequired isMultiBufferAvailable

vsync	back to summary
private ExtendedBufferCapabilities.VSyncType vsync

Constructor Detail

ExtendedBufferCapabilities	back to summary
public ExtendedBufferCapabilities(BufferCapabilities caps) Creates an ExtendedBufferCapabilities object with front/back/flip caps from the passed cap, and VSYNC_DEFAULT v-sync mode.

ExtendedBufferCapabilities	back to summary
public ExtendedBufferCapabilities(ImageCapabilities front, ImageCapabilities back, BufferCapabilities.FlipContents flip) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the passed caps, and VSYNC_DEFAULT v-sync mode.

ExtendedBufferCapabilities	back to summary
public ExtendedBufferCapabilities(ImageCapabilities front, ImageCapabilities back, BufferCapabilities.FlipContents flip, ExtendedBufferCapabilities.VSyncType t) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the passed image/flip caps, and the v-sync type.

ExtendedBufferCapabilities	back to summary
public ExtendedBufferCapabilities(BufferCapabilities caps, ExtendedBufferCapabilities.VSyncType t) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the passed cap, and the passed v-sync mode.

Method Detail

derive	back to summary
public ExtendedBufferCapabilities derive(ExtendedBufferCapabilities.VSyncType t) Creates an ExtendedBufferCapabilities instance with front/back/flip caps from the object, and passed v-sync mode.

getVSync	back to summary
public ExtendedBufferCapabilities.VSyncType getVSync() Returns the type of v-sync requested by this capabilities instance.

isPageFlipping back to summary

isPageFlipping	back to summary
public final boolean isPageFlipping() Overrides java.awt.BufferCapabilities.isPageFlipping. Doc from java.awt.BufferCapabilities.isPageFlipping. Returns whether or not the buffer strategy uses page flipping. A set of 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, `getFlipContents` returns `null`. Annotations @Override

public final boolean isPageFlipping()

Overrides java.awt.BufferCapabilities.isPageFlipping.

Doc from java.awt.BufferCapabilities.isPageFlipping.

Returns whether or not the buffer strategy uses page flipping. A set of 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, getFlipContents returns null.

Annotations

@Override

sun.java2d.pipe.hw back to summary

public final Enum ExtendedBufferCapabilities.VSyncType

Class Inheritance

extends Enum<ExtendedBufferCapabilities.VSyncType>

java.lang.Object
java.lang.Enum
sun.java2d.pipe.hw.ExtendedBufferCapabilities.VSyncType

Type of synchronization on vertical retrace.

Field Summary

Modifier and Type	Field and Description
private int	id
public static final ExtendedBufferCapabilities.VSyncType	VSYNC_DEFAULT Use the default v-sync mode appropriate for given BufferStrategy and situation.
public static final ExtendedBufferCapabilities.VSyncType	VSYNC_OFF Do not synchronize flip on vertical retrace.
public static final ExtendedBufferCapabilities.VSyncType	VSYNC_ON Synchronize flip on vertical retrace.

Constructor Summary

Access	Constructor and Description
private	VSyncType(int id)

Method Summary

Modifier and Type	Method and Description
public int	id() Used to identify the v-sync type (independent of the constants order as opposed to `ordinal()`).
public static ExtendedBufferCapabilities.VSyncType	valueOf(String name)
public static ExtendedBufferCapabilities.VSyncType[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

id	back to summary
private int id

VSYNC_DEFAULT	back to summary
public static final ExtendedBufferCapabilities.VSyncType VSYNC_DEFAULT Use the default v-sync mode appropriate for given BufferStrategy and situation.

VSYNC_OFF	back to summary
public static final ExtendedBufferCapabilities.VSyncType VSYNC_OFF Do not synchronize flip on vertical retrace.

VSYNC_ON	back to summary
public static final ExtendedBufferCapabilities.VSyncType VSYNC_ON Synchronize flip on vertical retrace.

Constructor Detail

VSyncType	back to summary
private VSyncType(int id)

Method Detail

id	back to summary
public int id() Used to identify the v-sync type (independent of the constants order as opposed to `ordinal()`).

valueOf	back to summary
public static ExtendedBufferCapabilities.VSyncType valueOf(String name)

values	back to summary
public static ExtendedBufferCapabilities.VSyncType[] values()

public Class ExtendedBufferCapabilities

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum ExtendedBufferCapabilities.VSyncType

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail