JOGL v2.6.0-rc-20250706
JOGL, High-Performance Graphics Binding for Java™ (public API).
com.jogamp.nativewindow.CapabilitiesChooser Interface Reference

Provides a mechanism by which applications can customize the window type selection for a given Capabilities. More...

Inheritance diagram for com.jogamp.nativewindow.CapabilitiesChooser:
Collaboration diagram for com.jogamp.nativewindow.CapabilitiesChooser:

Public Member Functions

int chooseCapabilities (CapabilitiesImmutable desired, List<? extends CapabilitiesImmutable > available, int windowSystemRecommendedChoice)
 Chooses the index (0..available.length - 1) of the Capabilities most closely matching the desired one from the list of all supported. More...
 

Detailed Description

Provides a mechanism by which applications can customize the window type selection for a given Capabilities.

Developers can implement this interface and pass an instance into the method GraphicsConfigurationFactory#chooseGraphicsConfiguration; the chooser will be called at window creation time.

Definition at line 50 of file CapabilitiesChooser.java.

Member Function Documentation

◆ chooseCapabilities()

int com.jogamp.nativewindow.CapabilitiesChooser.chooseCapabilities ( CapabilitiesImmutable  desired,
List<? extends CapabilitiesImmutable available,
int  windowSystemRecommendedChoice 
)

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.

Implemented in com.jogamp.opengl.DefaultGLCapabilitiesChooser, com.jogamp.opengl.GenericGLCapabilitiesChooser, com.jogamp.nativewindow.DefaultCapabilitiesChooser, and com.jogamp.opengl.util.caps.NonFSAAGLCapsChooser.


The documentation for this interface was generated from the following file: