Package com.jogamp.nativewindow.egl

Class EGLGraphicsDevice

java.lang.Object

com.jogamp.nativewindow.DefaultGraphicsDevice

com.jogamp.nativewindow.egl.EGLGraphicsDevice

All Implemented Interfaces:

AbstractGraphicsDevice, Cloneable

public class EGLGraphicsDevice
extends DefaultGraphicsDevice
implements Cloneable

Encapsulates a graphics device on EGL platforms.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	EGLGraphicsDevice.EGLDisplayLifecycleCallback	Hack to allow inject a EGL termination call.

Field Summary

Fields inherited from interface com.jogamp.nativewindow.AbstractGraphicsDevice

DEBUG, DEFAULT_CONNECTION, DEFAULT_UNIT, EXTERNAL_CONNECTION

Constructor Summary

Constructors

Constructor	Description
EGLGraphicsDevice()	Note that this is not an open connection, ie no native display handle exist.
EGLGraphicsDevice(long nativeDisplayID, long eglDisplay, String connection, int unitID, EGLGraphicsDevice.EGLDisplayLifecycleCallback eglLifecycleCallback)
EGLGraphicsDevice(AbstractGraphicsDevice aDevice, long eglDisplay, EGLGraphicsDevice.EGLDisplayLifecycleCallback eglLifecycleCallback)

Method Summary

Modifier and Type	Method	Description
void	clearHandleOwner()
Object	clone()
boolean	close()	Closes the EGL device if handle is not null and it's EGLGraphicsDevice.EGLDisplayLifecycleCallback is valid.
VersionNumber	getEGLVersion()	EGL server version as returned by eglInitialize(..).
long	getNativeDisplayID()
boolean	isHandleOwner()
boolean	open()	Opens the EGL device if handle is null and it's EGLGraphicsDevice.EGLDisplayLifecycleCallback is valid.
String	toString()

Methods inherited from class com.jogamp.nativewindow.DefaultGraphicsDevice

getConnection, getDefaultDisplayConnection, getDefaultDisplayConnection, getHandle, getToolkitLock, getType, getUniqueID, getUnitID, lock, swapDeviceHandleAndOwnership, unlock, validateLocked

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

EGLGraphicsDevice

public EGLGraphicsDevice()

Note that this is not an open connection, ie no native display handle exist. This constructor exist to setup a default device connection/unit.

EGLGraphicsDevice

public EGLGraphicsDevice(AbstractGraphicsDevice aDevice,
                         long eglDisplay,
                         EGLGraphicsDevice.EGLDisplayLifecycleCallback eglLifecycleCallback)

EGLGraphicsDevice

public EGLGraphicsDevice(long nativeDisplayID,
                         long eglDisplay,
                         String connection,
                         int unitID,
                         EGLGraphicsDevice.EGLDisplayLifecycleCallback eglLifecycleCallback)

Method Detail

getEGLVersion

public VersionNumber getEGLVersion()

EGL server version as returned by eglInitialize(..). Only valid after open().

getNativeDisplayID

public long getNativeDisplayID()

clone

public Object clone()

Specified by:

clone in interface AbstractGraphicsDevice

Overrides:

clone in class DefaultGraphicsDevice

open

public boolean open()

Opens the EGL device if handle is null and it's EGLGraphicsDevice.EGLDisplayLifecycleCallback is valid.

Optionally [re]opening the device if handle is null.

The default implementation is a NOP.

Example implementations like X11GraphicsDevice or EGLGraphicsDevice issue the native open operation in case handle is null.

Specified by:

open in interface AbstractGraphicsDevice

Overrides:

open in class DefaultGraphicsDevice

Returns:

true if the handle was null and opening was successful, otherwise false.

close

public boolean close()

Closes the EGL device if handle is not null and it's EGLGraphicsDevice.EGLDisplayLifecycleCallback is valid.

Optionally closing the device if handle is not null.

The default implementation dispose it's ToolkitLock and sets the handle to null.

Example implementations like X11GraphicsDevice or EGLGraphicsDevice issue the native close operation or skip it depending on the handles's ownership.

Specified by:

close in interface AbstractGraphicsDevice

Overrides:

close in class DefaultGraphicsDevice

Returns:

true if the handle was not null and closing was successful, otherwise false.

isHandleOwner

public boolean isHandleOwner()

Specified by:

isHandleOwner in interface AbstractGraphicsDevice

Overrides:

isHandleOwner in class DefaultGraphicsDevice

Returns:

true if instance owns the handle to issue AbstractGraphicsDevice.close(), otherwise false.

clearHandleOwner

public void clearHandleOwner()

Specified by:

clearHandleOwner in interface AbstractGraphicsDevice

Overrides:

clearHandleOwner in class DefaultGraphicsDevice

toString

public String toString()

Overrides:

toString in class DefaultGraphicsDevice