Package com.jogamp.nativewindow
Class DefaultGraphicsConfiguration
- java.lang.Object
-
- com.jogamp.nativewindow.DefaultGraphicsConfiguration
-
- All Implemented Interfaces:
AbstractGraphicsConfiguration,VisualIDHolder,Cloneable
- Direct Known Subclasses:
AWTGraphicsConfiguration,MutableGraphicsConfiguration
public class DefaultGraphicsConfiguration extends Object implements Cloneable, AbstractGraphicsConfiguration
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.jogamp.nativewindow.VisualIDHolder
VisualIDHolder.VIDComparator, VisualIDHolder.VIDType
-
-
Field Summary
-
Fields inherited from interface com.jogamp.nativewindow.VisualIDHolder
VID_UNDEFINED
-
-
Constructor Summary
Constructors Constructor Description DefaultGraphicsConfiguration(AbstractGraphicsScreen screen, CapabilitiesImmutable capsChosen, CapabilitiesImmutable capsRequested)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Objectclone()CapabilitiesImmutablegetChosenCapabilities()Return the capabilities reflecting this graphics configuration, which may differ from the capabilities used to choose this configuration.AbstractGraphicsConfigurationgetNativeGraphicsConfiguration()In case the implementation utilizes a delegation pattern to wrap abstract toolkits, this method shall return the nativeAbstractGraphicsConfiguration, otherwise this instance.CapabilitiesImmutablegetRequestedCapabilities()Return the capabilities used to choose this graphics configuration.AbstractGraphicsScreengetScreen()Return the screen this graphics configuration is valid forintgetVisualID(VisualIDHolder.VIDType type)Returns the native visual ID of the giventypeif supported, orVisualIDHolder.VID_UNDEFINEDif not supported.booleanisVisualIDSupported(VisualIDHolder.VIDType type)Returns true if the givenVisualIDHolder.VIDTypeis supported, otherwise false.static StringtoHexString(int val)static StringtoHexString(long val)StringtoString()
-
-
-
Constructor Detail
-
DefaultGraphicsConfiguration
public DefaultGraphicsConfiguration(AbstractGraphicsScreen screen, CapabilitiesImmutable capsChosen, CapabilitiesImmutable capsRequested)
-
-
Method Detail
-
clone
public Object clone()
- Specified by:
clonein interfaceAbstractGraphicsConfiguration
-
getScreen
public final AbstractGraphicsScreen getScreen()
Description copied from interface:AbstractGraphicsConfigurationReturn the screen this graphics configuration is valid for- Specified by:
getScreenin interfaceAbstractGraphicsConfiguration
-
getChosenCapabilities
public final CapabilitiesImmutable getChosenCapabilities()
Description copied from interface:AbstractGraphicsConfigurationReturn the capabilities reflecting this graphics configuration, which may differ from the capabilities used to choose this configuration.- Specified by:
getChosenCapabilitiesin interfaceAbstractGraphicsConfiguration- Returns:
- An immutable instance of the Capabilities to avoid mutation by the user.
-
getRequestedCapabilities
public final CapabilitiesImmutable getRequestedCapabilities()
Description copied from interface:AbstractGraphicsConfigurationReturn the capabilities used to choose this graphics configuration. These may be used to reconfigure the NativeWindow in case the device changes in a multiple screen environment.- Specified by:
getRequestedCapabilitiesin interfaceAbstractGraphicsConfiguration- Returns:
- An immutable instance of the Capabilities to avoid mutation by the user.
-
getNativeGraphicsConfiguration
public AbstractGraphicsConfiguration getNativeGraphicsConfiguration()
Description copied from interface:AbstractGraphicsConfigurationIn case the implementation utilizes a delegation pattern to wrap abstract toolkits, this method shall return the nativeAbstractGraphicsConfiguration, otherwise this instance.- Specified by:
getNativeGraphicsConfigurationin interfaceAbstractGraphicsConfiguration- See Also:
NativeSurface.getGraphicsConfiguration()
-
getVisualID
public final int getVisualID(VisualIDHolder.VIDType type) throws NativeWindowException
Description copied from interface:VisualIDHolderReturns the native visual ID of the giventypeif supported, orVisualIDHolder.VID_UNDEFINEDif not supported.Depending on the native windowing system,
typeis handled as follows:- X11 throws NativeWindowException on
EGL_CONFIG,WIN32_PFDINTRINSIC: X11 XVisual IDNATIVE: X11 XVisual IDX11_XVISUAL: X11 XVisual IDX11_FBCONFIG:VID_UNDEFINED
- X11/GL throws NativeWindowException on
EGL_CONFIG,WIN32_PFDINTRINSIC: X11 XVisual IDNATIVE: X11 XVisual IDX11_XVISUAL: X11 XVisual IDX11_FBCONFIG: X11 FBConfig ID orVID_UNDEFINED
- Windows/GL throws NativeWindowException on
EGL_CONFIG,X11_XVISUAL,X11_FBCONFIGINTRINSIC: Win32 PIXELFORMATDESCRIPTOR IDNATIVE: Win32 PIXELFORMATDESCRIPTOR IDWIN32_PFD: Win32 PIXELFORMATDESCRIPTOR ID
- EGL/GL throws NativeWindowException on
X11_XVISUAL,X11_FBCONFIG,WIN32_PFDINTRINSIC: EGL Config IDNATIVE: EGL NativeVisual ID (X11 XVisual ID, Win32 PIXELFORMATDESCRIPTOR ID, ...)EGL_CONFIG: EGL Config ID
One may use
Note:VisualIDHolder.isVisualIDSupported(VIDType)to test upfront whether aVisualIDHolder.VIDTypeis supported, e.g. to avoid an exception or query or compare all available.INTRINSICandNATIVEare always handled, but may result inVisualIDHolder.VID_UNDEFINED. The latter is true if the native value are actually undefined or the corresponding object is not mapped to a native visual object.- Specified by:
getVisualIDin interfaceVisualIDHolder- Throws:
NativeWindowException- iftypeis neitherINTRINSICnorNATIVEand does not match the native implementation.- See Also:
VisualIDHolder.isVisualIDSupported(VIDType)
- X11 throws NativeWindowException on
-
isVisualIDSupported
public final boolean isVisualIDSupported(VisualIDHolder.VIDType type)
Description copied from interface:VisualIDHolderReturns true if the givenVisualIDHolder.VIDTypeis supported, otherwise false.Note:
INTRINSICandNATIVEare always handled, but may result inVisualIDHolder.VID_UNDEFINED. The latter is true if the native value are actually undefined or the corresponding object is not mapped to a native visual object.- Specified by:
isVisualIDSupportedin interfaceVisualIDHolder- See Also:
VisualIDHolder.getVisualID(VIDType)
-
toHexString
public static String toHexString(int val)
-
toHexString
public static String toHexString(long val)
-
-