com.jogamp.nativewindow.impl.x11
Class X11GraphicsConfigurationFactory

java.lang.Object
  extended by javax.media.nativewindow.GraphicsConfigurationFactory
      extended by com.jogamp.nativewindow.impl.x11.X11GraphicsConfigurationFactory

public class X11GraphicsConfigurationFactory
extends GraphicsConfigurationFactory


Field Summary
 
Fields inherited from class javax.media.nativewindow.GraphicsConfigurationFactory
DEBUG
 
Constructor Summary
X11GraphicsConfigurationFactory()
           
 
Method Summary
 AbstractGraphicsConfiguration chooseGraphicsConfiguration(Capabilities capabilities, CapabilitiesChooser chooser, AbstractGraphicsScreen screen)
           Selects a graphics configuration on the specified graphics device compatible with the supplied Capabilities.
static XVisualInfo getXVisualInfo(AbstractGraphicsScreen screen, Capabilities capabilities)
           
static XVisualInfo getXVisualInfo(AbstractGraphicsScreen screen, long visualID)
           
 
Methods inherited from class javax.media.nativewindow.GraphicsConfigurationFactory
getFactory, getFactory, registerFactory
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

X11GraphicsConfigurationFactory

public X11GraphicsConfigurationFactory()
Method Detail

chooseGraphicsConfiguration

public AbstractGraphicsConfiguration chooseGraphicsConfiguration(Capabilities capabilities,
                                                                 CapabilitiesChooser chooser,
                                                                 AbstractGraphicsScreen screen)
                                                          throws IllegalArgumentException,
                                                                 NativeWindowException
Description copied from class: GraphicsConfigurationFactory

Selects a graphics configuration on the specified graphics device compatible with the supplied Capabilities. Some platforms (e.g.: X11, EGL, KD) require the graphics configuration to be specified when the native window is created. These architectures have seperated their device, screen, window and drawable context and hence are capable of quering the capabilities for each screen. A fully established window is not required.

Other platforms (e.g. Windows, MacOSX) don't offer the mentioned seperation and hence need a fully established window and it's drawable. Here the validation of the capabilities is performed later. In this case, the AbstractGraphicsConfiguration implementation must allow an overwrite of the Capabilites, for example DefaultGraphicsConfiguration.setChosenCapabilities(..).

This method is mainly intended to be both used and implemented by the OpenGL binding.

The concrete data type of the passed graphics device and returned graphics configuration must be specified in the documentation binding this particular API to the underlying window toolkit. The Reference Implementation accepts AWTGraphicsDevice objects and returns AWTGraphicsConfiguration objects. On X11 platforms where the AWT is not in use, it also accepts X11GraphicsDevice objects and returns X11GraphicsConfiguration objects.

Specified by:
chooseGraphicsConfiguration in class GraphicsConfigurationFactory
Throws:
IllegalArgumentException - if the data type of the passed AbstractGraphicsDevice is not supported by this NativeWindowFactory.
NativeWindowException - if any window system-specific errors caused the selection of the graphics configuration to fail.
See Also:
GraphicsConfigurationFactory.chooseGraphicsConfiguration(Capabilities, CapabilitiesChooser, AbstractGraphicsScreen), DefaultGraphicsConfiguration.setChosenCapabilities(Capabilities caps)

getXVisualInfo

public static XVisualInfo getXVisualInfo(AbstractGraphicsScreen screen,
                                         long visualID)

getXVisualInfo

public static XVisualInfo getXVisualInfo(AbstractGraphicsScreen screen,
                                         Capabilities capabilities)


Copyright 2010 JogAmp Community.