JOGL 2.3.2 · com.jogamp.opengl.DefaultGLCapabilitiesChooser

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.

Field Summary

Modifier and Type	Field and Description
private static final int	ACCUM_MISMATCH_PENALTY_SCALE
private static final int	COLOR_MISMATCH_PENALTY_SCALE
private static final boolean	DEBUG
private static final int	DEPTH_MISMATCH_PENALTY_SCALE
private static final int	DOUBLE_BUFFER_MISMATCH_PENALTY
private static final int	MULTISAMPLE_EXTENSION_MISMATCH_PENALTY
private static final int	MULTISAMPLE_MISMATCH_PENALTY
private static final int	MULTISAMPLE_MISMATCH_PENALTY_SCALE
private static final int	NO_SCORE
private static final int	OPAQUE_MISMATCH_PENALTY
private static final int	STENCIL_MISMATCH_PENALTY
private static final int	STENCIL_MISMATCH_PENALTY_SCALE

Constructor Summary

Access	Constructor and Description
public	DefaultGLCapabilitiesChooser()

Method Summary

Modifier and Type	Method and Description
public int	chooseCapabilities(final CapabilitiesImmutable desired, final List<? extends CapabilitiesImmutable> available, final int windowSystemRecommendedChoice) Implements com.jogamp.nativewindow.CapabilitiesChooser.chooseCapabilities. Chooses the index (0..available.length - 1) of the `Capabilities` most closely matching the desired one from the list of all supported.
private static int	sign(final int score)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ACCUM_MISMATCH_PENALTY_SCALE	back to summary
private static final int ACCUM_MISMATCH_PENALTY_SCALE

COLOR_MISMATCH_PENALTY_SCALE	back to summary
private static final int COLOR_MISMATCH_PENALTY_SCALE

DEBUG	back to summary
private static final boolean DEBUG

DEPTH_MISMATCH_PENALTY_SCALE	back to summary
private static final int DEPTH_MISMATCH_PENALTY_SCALE

DOUBLE_BUFFER_MISMATCH_PENALTY	back to summary
private static final int DOUBLE_BUFFER_MISMATCH_PENALTY

MULTISAMPLE_EXTENSION_MISMATCH_PENALTY	back to summary
private static final int MULTISAMPLE_EXTENSION_MISMATCH_PENALTY

MULTISAMPLE_MISMATCH_PENALTY	back to summary
private static final int MULTISAMPLE_MISMATCH_PENALTY

MULTISAMPLE_MISMATCH_PENALTY_SCALE	back to summary
private static final int MULTISAMPLE_MISMATCH_PENALTY_SCALE

NO_SCORE	back to summary
private static final int NO_SCORE

OPAQUE_MISMATCH_PENALTY	back to summary
private static final int OPAQUE_MISMATCH_PENALTY

STENCIL_MISMATCH_PENALTY	back to summary
private static final int STENCIL_MISMATCH_PENALTY

STENCIL_MISMATCH_PENALTY_SCALE	back to summary
private static final int STENCIL_MISMATCH_PENALTY_SCALE

Constructor Detail

DefaultGLCapabilitiesChooser	back to summary
public DefaultGLCapabilitiesChooser()

Method Detail

chooseCapabilities back to summary

chooseCapabilities	back to summary
public int chooseCapabilities(final CapabilitiesImmutable desired, final List<? extends CapabilitiesImmutable> available, final int windowSystemRecommendedChoice) Implements com.jogamp.nativewindow.CapabilitiesChooser.chooseCapabilities. Doc from com.jogamp.nativewindow.CapabilitiesChooser.chooseCapabilities. Chooses the index (0..available.length - 1) of the `Capabilities` most closely matching the desired one from the list of all supported. Some of the entries in the `available` array may be null; the chooser must ignore these. The windowSystemRecommendedChoice parameter may be provided to the chooser by the underlying window system; if this index is valid, it is recommended, but not necessarily required, that the chooser select that entry. Note this method is called automatically by the `GraphicsConfigurationFactory#chooseGraphicsConfiguration` method when an instance of this class is passed in to it. It should generally not be invoked by users directly, unless it is desired to delegate the choice to some other CapabilitiesChooser object. Annotations @Override

public int chooseCapabilities(final CapabilitiesImmutable desired, final List<? extends CapabilitiesImmutable> available, final int windowSystemRecommendedChoice)

Implements com.jogamp.nativewindow.CapabilitiesChooser.chooseCapabilities.

Doc from com.jogamp.nativewindow.CapabilitiesChooser.chooseCapabilities.

Chooses the index (0..available.length - 1) of the Capabilities most closely matching the desired one from the list of all supported. Some of the entries in the available array may be null; the chooser must ignore these. The windowSystemRecommendedChoice parameter may be provided to the chooser by the underlying window system; if this index is valid, it is recommended, but not necessarily required, that the chooser select that entry.

Note

this method is called automatically by the GraphicsConfigurationFactory#chooseGraphicsConfiguration method when an instance of this class is passed in to it. It should generally not be invoked by users directly, unless it is desired to delegate the choice to some other CapabilitiesChooser object.

Annotations

@Override

sign	back to summary
private static int sign(final int score)