net.java.games.jogl
Class DefaultGLCapabilitiesChooser
java.lang.Object
net.java.games.jogl.DefaultGLCapabilitiesChooser
- GLCapabilitiesChooser
public class DefaultGLCapabilitiesChooser
extends java.lang.Object
The default implementation of the
GLCapabilitiesChooser
interface, which provides consistent visual
selection behavior across platforms. The precise algorithm is
deliberately left loosely specified. Some properties are:
- As long as there is at least one available non-null
GLCapabilities which matches the "stereo" option, will return a
valid index.
- Attempts to match as closely as possible the given
GLCapabilities, but will select one with fewer capabilities (i.e.,
lower color depth) if necessary.
- Prefers hardware-accelerated visuals to
non-hardware-accelerated.
- If there is no exact match, prefers a more-capable visual to
a less-capable one.
- If there is more than one exact match, chooses an arbitrary
one.
- May select the opposite of a double- or single-buffered
visual (based on the user's request) in dire situations.
- Color depth (including alpha) mismatches are weighted higher
than depth buffer mismatches, which are in turn weighted higher
than accumulation buffer (including alpha) and stencil buffer
depth mismatches.
- If a valid windowSystemRecommendedChoice parameter is
supplied, chooses that instead of using the cross-platform code.