JOGL 2.3.2 · com.jogamp.opengl.GLDrawableFactory

Modifier and Type	Field and Description
protected static final boolean	DEBUG
private static GLDrawableFactory	eglFactory
private static ArrayList<GLDrawableFactory>	glDrawableFactories
private static volatile boolean	isInit
private static GLDrawableFactory	nativeOSFactory

Access	Constructor and Description
protected	GLDrawableFactory()

Method Summary

Modifier and Type	Method and Description
public abstract boolean	canCreateExternalGLDrawable(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device) Returns true if it is possible to create an external GLDrawable object via `createExternalGLDrawable`.
public abstract boolean	canCreateFBO(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device, GLProfile `GLProfile` to check for FBO capabilities glp) Returns true if it is possible to create an framebuffer object (FBO).
public abstract boolean	canCreateGLPbuffer(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device, GLProfile `GLProfile` to check for FBO capabilities glp) Returns true if it is possible to create an pbuffer surface.
public abstract GLAutoDrawable	Returns: the created and realized dummy `GLAutoDrawable` instance createDummyAutoDrawable(AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. deviceReq, boolean if `true` a new independent device instance is created from the `deviceReq`, otherwise `deviceReq` is used as-is and must be valid! createNewDevice, GLCapabilitiesImmutable the desired `GLCapabilitiesImmutable`, incl. it's `GLProfile`. For shared context, same `GLCapabilitiesImmutable#getVisualID(com.jogamp.nativewindow.VisualIDHolder.VIDType)` across shared drawables will yield best compatibility. capsRequested, GLCapabilitiesChooser the custom chooser, may be null for default chooser) Creates a `realized` dummy `GLAutoDrawable` incl it's dummy, invisible `NativeSurface` as created with `createDummyDrawable(AbstractGraphicsDevice, boolean, GLCapabilitiesImmutable, GLCapabilitiesChooser)`.
public abstract GLDrawable	Returns: the created unrealized dummy `GLDrawable` createDummyDrawable(AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. deviceReq, boolean if `true` a new independent device instance is created from the `deviceReq`, otherwise `deviceReq` is used as-is and must be valid! createNewDevice, GLCapabilitiesImmutable the desired `GLCapabilitiesImmutable`, incl. it's `GLProfile`. For shared context, same `visual ID` or `caps` across shared drawables will yield best compatibility. capsRequested, GLCapabilitiesChooser the custom chooser, may be null for default chooser) Creates an `unrealized` dummy `GLDrawable`.
public abstract GLContext	createExternalGLContext() Creates a GLContext object representing an existing OpenGL context in an external (third-party) OpenGL-based library.
public abstract GLDrawable	createExternalGLDrawable() Creates a `GLDrawable` object representing an existing OpenGL drawable in an external (third-party) OpenGL-based library.
public abstract GLDrawable	createGLDrawable(NativeSurface target) Returns an `unrealized` GLDrawable according to it's chosen `GLCapabilitiesImmutable`, which determines pixel format, on- and offscreen incl.
public abstract GLOffscreenAutoDrawable	Returns: the created and realized offscreen `GLOffscreenAutoDrawable` instance createOffscreenAutoDrawable(AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. device, GLCapabilitiesImmutable the requested GLCapabilties caps, GLCapabilitiesChooser the custom chooser, may be null for default chooser, int the requested offscreen width width, int the requested offscreen height height) Creates a `realized` `GLOffscreenAutoDrawable` incl it's offscreen `NativeSurface` with the given capabilites and dimensions.
public abstract GLDrawable	Returns: the created unrealized offscreen `GLDrawable` createOffscreenDrawable(AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. device, GLCapabilitiesImmutable the requested GLCapabilties caps, GLCapabilitiesChooser the custom chooser, may be null for default chooser, int the requested offscreen width width, int the requested offscreen height height) Creates an `unrealized` offscreen `GLDrawable` incl it's offscreen `NativeSurface` with the given capabilites and dimensions.
public abstract ProxySurface	Returns: the created `ProxySurface` instance w/ defined surface handle. createProxySurface(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. Caller has to ensure it is compatible w/ the given `windowHandle` device, int matching screen index of given `windowHandle` screenIdx, long the native window handle windowHandle, GLCapabilitiesImmutable the requested GLCapabilties caps, GLCapabilitiesChooser the custom chooser, may be null for default chooser, UpstreamSurfaceHook optional `UpstreamSurfaceHook` allowing control of the `ProxySurface`'s lifecycle and data it presents. upstream) Creates a proxy `NativeSurface` w/ defined surface handle, i.e. a `jogamp.nativewindow.WrappedSurface` or `jogamp.nativewindow.windows.GDISurface` instance.
protected final boolean	Returns: true if a shared resource could been created, otherwise false. createSharedResource(final AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device) Create the shared resource used internally as a reference for capabilities etc. Returns true if a shared resource could be created for the `device` `AbstractGraphicsDevice#getConnection()`.
protected abstract boolean	createSharedResourceImpl(AbstractGraphicsDevice device)
protected void	enterThreadCriticalZone()
public final List<GLCapabilitiesImmutable>	Returns: A list of `com.jogamp.opengl.GLCapabilitiesImmutable`'s, maybe empty if none is available. getAvailableCapabilities(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device) Returns an array of available GLCapabilities for the device.
protected abstract List<GLCapabilitiesImmutable>	getAvailableCapabilitiesImpl(AbstractGraphicsDevice device)
public abstract AbstractGraphicsDevice	Returns: the default shared device for this factory, eg. :0.0 on X11 desktop. getDefaultDevice() Retrieve the default `device` `connection`, `unit ID` and `unique ID name`.
public static GLDrawableFactory	getDesktopFactory() Returns the sole GLDrawableFactory instance for the desktop (X11, WGL, ..) if exist or null
public static GLDrawableFactory	getEGLFactory() Returns the sole GLDrawableFactory instance for EGL if exist or null
public static GLDrawableFactory	getFactory(final GLProfile GLProfile to determine the factory type, ie EGLDrawableFactory, or one of the native GLDrawableFactory's, ie X11/GLX, Windows/WGL or MacOSX/CGL. glProfile) Returns the sole GLDrawableFactory instance.
protected static GLDrawableFactory	getFactoryImpl(final String glProfileImplName)
protected static GLDrawableFactory	getFactoryImpl(final AbstractGraphicsDevice device)
public abstract boolean	Returns: true if the device is compatible with this factory, ie. if it can be used for GLDrawable creation. Otherwise false. This implies validation whether the implementation is functional. getIsDeviceCompatible(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device)
public abstract GLRendererQuirks	getRendererQuirks(AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device, final GLProfile `GLProfile` to identify the device's `GLRendererQuirks`, maybe `null` glp) Returns the shared resource's context `GLRendererQuirks`.
protected abstract Thread	Returns: the shared resource runner thread, if implementation uses it. getSharedResourceThread() Validate and start the shared resource runner thread if necessary and if the implementation uses it.
protected static String	getThreadName()
public abstract boolean	hasOpenGLDesktopSupport() Method returns `true` if underlying implementation may support native desktop OpenGL, otherwise `false`.
public abstract boolean	hasOpenGLESSupport() Method returns `true` if underlying implementation may support native embedded OpenGL ES, otherwise `false`.
public final boolean	hasRendererQuirk(final AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device, final GLProfile `GLProfile` to identify the device's `GLRendererQuirks`, maybe `null` glp, final int the quirk to be tested, e.g. `GLRendererQuirks#NoDoubleBufferedPBuffer`. quirk) Returns true if the `quirk` exist in the shared resource's context `GLRendererQuirks`.
public static final void	initSingleton() Instantiate singleton factories if available, EGLES1, EGLES2 and the OS native ones.
private static final void	initSingletonImpl()
protected abstract boolean	isComplete() Returns true if this factory is complete, i.e. ready to be used.
protected void	leaveThreadCriticalZone()
public abstract void	resetAllDisplayGamma() Resets the gamma, brightness and contrast values of all modified displays to their original values before `setDisplayGamma` was called the first time.
protected abstract void	resetAllDisplayGammaNoSync()
public abstract void	resetDisplayGamma(final NativeSurface surface) Resets the gamma, brightness and contrast values of the display associated with the given `surface` to its original values before `setDisplayGamma` was called the first time.
public abstract boolean	Returns: true if gamma settings were successfully changed, false if not setDisplayGamma(final NativeSurface denominates the display device surface, final float The gamma value, typically > 1.0 (default values vary, but typically roughly 1.0) gamma, final float The brightness value between -1.0 and 1.0, inclusive (default values vary, but typically 0) brightness, final float The contrast, greater than 0.0 (default values vary, but typically 1) contrast) Sets the gamma, brightness, and contrast of the display associated with the given `surface`.
protected static void	shutdown()
private static void	shutdown0()
protected abstract void	shutdownImpl()
protected final AbstractGraphicsDevice	validateDevice(AbstractGraphicsDevice device)

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

DEBUG	back to summary
protected static final boolean DEBUG

eglFactory	back to summary
private static GLDrawableFactory eglFactory

glDrawableFactories	back to summary
private static ArrayList<GLDrawableFactory> glDrawableFactories

isInit	back to summary
private static volatile boolean isInit

nativeOSFactory	back to summary
private static GLDrawableFactory nativeOSFactory

GLDrawableFactory	back to summary
protected GLDrawableFactory()

Method Detail

canCreateExternalGLDrawable back to summary

canCreateExternalGLDrawable	back to summary
public abstract boolean canCreateExternalGLDrawable(AbstractGraphicsDevice device) Returns true if it is possible to create an external GLDrawable object via `createExternalGLDrawable`. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device.

public abstract boolean canCreateExternalGLDrawable(AbstractGraphicsDevice device)

Returns true if it is possible to create an external GLDrawable object via createExternalGLDrawable.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.

canCreateFBO back to summary

canCreateFBO	back to summary
public abstract boolean canCreateFBO(AbstractGraphicsDevice device, GLProfile glp) Returns true if it is possible to create an framebuffer object (FBO). FBO feature is implemented in OpenGL, hence it is `GLProfile` dependent. FBO support is queried as described in `GLContext#hasBasicFBOSupport()`. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. glp:GLProfile `GLProfile` to check for FBO capabilities See Also `GLContext#hasBasicFBOSupport()`

public abstract boolean canCreateFBO(AbstractGraphicsDevice device, GLProfile glp)

Returns true if it is possible to create an framebuffer object (FBO).

FBO feature is implemented in OpenGL, hence it is GLProfile dependent.

FBO support is queried as described in GLContext#hasBasicFBOSupport().

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.
glp:GLProfile: GLProfile to check for FBO capabilities

See Also

GLContext#hasBasicFBOSupport()

canCreateGLPbuffer back to summary

canCreateGLPbuffer	back to summary
public abstract boolean canCreateGLPbuffer(AbstractGraphicsDevice device, GLProfile glp) Returns true if it is possible to create an pbuffer surface. Some older graphics cards do not have this capability, as well as some new GL implementation, i.e. OpenGL 3 core on OSX. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. glp:GLProfile `GLProfile` to check for FBO capabilities

public abstract boolean canCreateGLPbuffer(AbstractGraphicsDevice device, GLProfile glp)

Returns true if it is possible to create an pbuffer surface.

Some older graphics cards do not have this capability, as well as some new GL implementation, i.e. OpenGL 3 core on OSX.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.
glp:GLProfile: GLProfile to check for FBO capabilities

createDummyAutoDrawable back to summary

createDummyAutoDrawable	back to summary
public abstract GLAutoDrawable createDummyAutoDrawable(AbstractGraphicsDevice deviceReq, boolean createNewDevice, GLCapabilitiesImmutable capsRequested, GLCapabilitiesChooser chooser) Creates a `realized` dummy `GLAutoDrawable` incl it's dummy, invisible `NativeSurface` as created with `createDummyDrawable(AbstractGraphicsDevice, boolean, GLCapabilitiesImmutable, GLCapabilitiesChooser)`. The dummy `GLAutoDrawable`'s `GLDrawable` is `realized` without an assigned `GLContext`, hence not initialized completely. The `GLContext` can be assigned later manually via `setContext(ctx)` or it will be created lazily at the 1st `display()` method call. Lazy `GLContext` creation will take a shared `GLContext` into account which has been set `directly` or `via another GLAutoDrawable`. Parameters deviceReq:AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. createNewDevice:boolean if `true` a new independent device instance is created from the `deviceReq`, otherwise `deviceReq` is used as-is and must be valid! capsRequested:GLCapabilitiesImmutable the desired `GLCapabilitiesImmutable`, incl. it's `GLProfile`. For shared context, same `GLCapabilitiesImmutable#getVisualID(com.jogamp.nativewindow.VisualIDHolder.VIDType)` across shared drawables will yield best compatibility. chooser:GLCapabilitiesChooser the custom chooser, may be null for default Returns:GLAutoDrawable the created and realized dummy `GLAutoDrawable` instance See Also `createDummyDrawable(AbstractGraphicsDevice, boolean, GLCapabilitiesImmutable, GLCapabilitiesChooser)`

public abstract GLAutoDrawable createDummyAutoDrawable(AbstractGraphicsDevice deviceReq, boolean createNewDevice, GLCapabilitiesImmutable capsRequested, GLCapabilitiesChooser chooser)

Creates a realized dummy GLAutoDrawable incl it's dummy, invisible NativeSurface as created with createDummyDrawable(AbstractGraphicsDevice, boolean, GLCapabilitiesImmutable, GLCapabilitiesChooser).

The dummy GLAutoDrawable's GLDrawable is realized without an assigned GLContext, hence not initialized completely.
The GLContext can be assigned later manually via setContext(ctx) or it will be created lazily at the 1st display() method call.
Lazy GLContext creation will take a shared GLContext into account which has been set directly or via another GLAutoDrawable.

Parameters

deviceReq:AbstractGraphicsDevice: which connection denotes the shared device to be used, may be null for the platform's default device.
createNewDevice:boolean: if true a new independent device instance is created from the deviceReq, otherwise deviceReq is used as-is and must be valid!
capsRequested:GLCapabilitiesImmutable: the desired GLCapabilitiesImmutable, incl. it's GLProfile. For shared context, same GLCapabilitiesImmutable#getVisualID(com.jogamp.nativewindow.VisualIDHolder.VIDType) across shared drawables will yield best compatibility.
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default

Returns:GLAutoDrawable

the created and realized dummy GLAutoDrawable instance

createDummyDrawable back to summary

createDummyDrawable	back to summary
public abstract GLDrawable createDummyDrawable(AbstractGraphicsDevice deviceReq, boolean createNewDevice, GLCapabilitiesImmutable capsRequested, GLCapabilitiesChooser chooser) Creates an `unrealized` dummy `GLDrawable`. A dummy drawable is not visible on screen and will not be used to render directly to, it maybe on- or offscreen. It is used to allow the creation of a `GLContext` to query information. It also allows creation of framebuffer objects which are used for rendering or creating a shared GLContext w/o actually rendering to this dummy drawable's framebuffer. Parameters deviceReq:AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. createNewDevice:boolean if `true` a new independent device instance is created from the `deviceReq`, otherwise `deviceReq` is used as-is and must be valid! capsRequested:GLCapabilitiesImmutable the desired `GLCapabilitiesImmutable`, incl. it's `GLProfile`. For shared context, same `visual ID` or `caps` across shared drawables will yield best compatibility. chooser:GLCapabilitiesChooser the custom chooser, may be null for default Returns:GLDrawable the created unrealized dummy `GLDrawable`

public abstract GLDrawable createDummyDrawable(AbstractGraphicsDevice deviceReq, boolean createNewDevice, GLCapabilitiesImmutable capsRequested, GLCapabilitiesChooser chooser)

Creates an unrealized dummy GLDrawable. A dummy drawable is not visible on screen and will not be used to render directly to, it maybe on- or offscreen.

It is used to allow the creation of a GLContext to query information. It also allows creation of framebuffer objects which are used for rendering or creating a shared GLContext w/o actually rendering to this dummy drawable's framebuffer.

Parameters

deviceReq:AbstractGraphicsDevice: which connection denotes the shared device to be used, may be null for the platform's default device.
createNewDevice:boolean: if true a new independent device instance is created from the deviceReq, otherwise deviceReq is used as-is and must be valid!
capsRequested:GLCapabilitiesImmutable: the desired GLCapabilitiesImmutable, incl. it's GLProfile. For shared context, same visual ID or caps across shared drawables will yield best compatibility.
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default

Returns:GLDrawable

the created unrealized dummy GLDrawable

createExternalGLContext back to summary

createExternalGLContext	back to summary
public abstract GLContext createExternalGLContext() throws GLException Creates a GLContext object representing an existing OpenGL context in an external (third-party) OpenGL-based library. This GLContext object may be used to draw into this preexisting context using its `GL` and `com.jogamp.opengl.glu.GLU` objects. New contexts created through `GLDrawable`s may share textures and display lists with this external context. The underlying OpenGL context must be current on the current thread at the time this method is called. The user is responsible for the maintenance of the underlying OpenGL context; calls to `makeCurrent` and `release` on the returned GLContext object have no effect. If the underlying OpenGL context is destroyed, the `destroy` method should be called on the `GLContext`. A new `GLContext` object should be created for each newly-created underlying OpenGL context. Exceptions GLException: if any window system-specific errors caused the creation of the external GLContext to fail.

public abstract GLContext createExternalGLContext() throws GLException

Creates a GLContext object representing an existing OpenGL context in an external (third-party) OpenGL-based library. This GLContext object may be used to draw into this preexisting context using its GL and com.jogamp.opengl.glu.GLU objects. New contexts created through GLDrawables may share textures and display lists with this external context.

The underlying OpenGL context must be current on the current thread at the time this method is called. The user is responsible for the maintenance of the underlying OpenGL context; calls to makeCurrent and release on the returned GLContext object have no effect. If the underlying OpenGL context is destroyed, the destroy method should be called on the GLContext. A new GLContext object should be created for each newly-created underlying OpenGL context.

Exceptions

GLException:: if any window system-specific errors caused the creation of the external GLContext to fail.

createExternalGLDrawable back to summary

createExternalGLDrawable	back to summary
public abstract GLDrawable createExternalGLDrawable() throws GLException Creates a `GLDrawable` object representing an existing OpenGL drawable in an external (third-party) OpenGL-based library. This GLDrawable object may be used to create new, fully-functional `GLContext`s on the OpenGL drawable. This is useful when interoperating with a third-party OpenGL-based library and it is essential to not perturb the state of the library's existing context, even to the point of not sharing textures or display lists with that context. An underlying OpenGL context must be current on the desired drawable and the current thread at the time this method is called. The user is responsible for the maintenance of the underlying drawable. If one or more contexts are created on the drawable using `GLDrawable#createContext`, and the drawable is deleted by the third-party library, the user is responsible for calling `GLContext#destroy` on these contexts. Calls to `setSize`, `getWidth` and `getHeight` are illegal on the returned GLDrawable. If these operations are required by the user, they must be performed by the third-party library. It is legal to create both an external GLContext and GLDrawable representing the same third-party OpenGL entities. This can be used, for example, to query current state information using the external GLContext and then create and set up new GLContexts using the external GLDrawable. This functionality may not be available on all platforms and `canCreateExternalGLDrawable` should be called first to see if it is present. For example, on X11 platforms, this API requires the presence of GLX 1.3 or later. Exceptions GLException: if any window system-specific errors caused the creation of the external GLDrawable to fail.

public abstract GLDrawable createExternalGLDrawable() throws GLException

Creates a GLDrawable object representing an existing OpenGL drawable in an external (third-party) OpenGL-based library. This GLDrawable object may be used to create new, fully-functional GLContexts on the OpenGL drawable. This is useful when interoperating with a third-party OpenGL-based library and it is essential to not perturb the state of the library's existing context, even to the point of not sharing textures or display lists with that context.

An underlying OpenGL context must be current on the desired drawable and the current thread at the time this method is called. The user is responsible for the maintenance of the underlying drawable. If one or more contexts are created on the drawable using GLDrawable#createContext, and the drawable is deleted by the third-party library, the user is responsible for calling GLContext#destroy on these contexts.

Calls to setSize, getWidth and getHeight are illegal on the returned GLDrawable. If these operations are required by the user, they must be performed by the third-party library.

It is legal to create both an external GLContext and GLDrawable representing the same third-party OpenGL entities. This can be used, for example, to query current state information using the external GLContext and then create and set up new GLContexts using the external GLDrawable.

This functionality may not be available on all platforms and canCreateExternalGLDrawable should be called first to see if it is present. For example, on X11 platforms, this API requires the presence of GLX 1.3 or later.

Exceptions

GLException:: if any window system-specific errors caused the creation of the external GLDrawable to fail.

createGLDrawable back to summary

createGLDrawable	back to summary
public abstract GLDrawable createGLDrawable(NativeSurface target) throws IllegalArgumentException, GLException Returns an `unrealized` GLDrawable according to it's chosen `GLCapabilitiesImmutable`, which determines pixel format, on- and offscreen incl. PBuffer type. The chosen `GLCapabilitiesImmutable` are referenced within the target `NativeSurface`'s `AbstractGraphicsConfiguration`. An onscreen GLDrawable is created if `caps.isOnscreen()` is true. A FBO drawable is created if both `caps.isFBO()` and `canCreateFBO(device, caps.getGLProfile())` is true. A Pbuffer drawable is created if both `caps.isPBuffer()` and `canCreateGLPbuffer(device)` is true. If not onscreen and neither FBO nor Pbuffer is available, a simple pixmap/bitmap drawable/surface is created, which is unlikely to be hardware accelerated. Exceptions IllegalArgumentException: if the passed target is null GLException: if any window system-specific errors caused the creation of the GLDrawable to fail. See Also `canCreateGLPbuffer(AbstractGraphicsDevice, GLProfile)`, `GLContext#isFBOAvailable(AbstractGraphicsDevice, GLProfile)`, `com.jogamp.opengl.GLCapabilities#isOnscreen()`, `com.jogamp.opengl.GLCapabilities#isFBO()`, `com.jogamp.opengl.GLCapabilities#isPBuffer()`, `GraphicsConfigurationFactory#chooseGraphicsConfiguration(CapabilitiesImmutable, CapabilitiesImmutable, CapabilitiesChooser, AbstractGraphicsScreen, int)`

public abstract GLDrawable createGLDrawable(NativeSurface target) throws IllegalArgumentException, GLException

Returns an unrealized GLDrawable according to it's chosen GLCapabilitiesImmutable,
which determines pixel format, on- and offscreen incl. PBuffer type.

The chosen GLCapabilitiesImmutable are referenced within the target NativeSurface's AbstractGraphicsConfiguration.

An onscreen GLDrawable is created if caps.isOnscreen() is true.

A FBO drawable is created if both caps.isFBO() and canCreateFBO(device, caps.getGLProfile()) is true.

A Pbuffer drawable is created if both caps.isPBuffer() and canCreateGLPbuffer(device) is true.

If not onscreen and neither FBO nor Pbuffer is available, a simple pixmap/bitmap drawable/surface is created, which is unlikely to be hardware accelerated.

Exceptions

IllegalArgumentException:: if the passed target is null
GLException:: if any window system-specific errors caused the creation of the GLDrawable to fail.

GraphicsConfigurationFactory#chooseGraphicsConfiguration(CapabilitiesImmutable, CapabilitiesImmutable, CapabilitiesChooser, AbstractGraphicsScreen, int)

createOffscreenAutoDrawable back to summary

createOffscreenAutoDrawable	back to summary
public abstract GLOffscreenAutoDrawable createOffscreenAutoDrawable(AbstractGraphicsDevice device, GLCapabilitiesImmutable caps, GLCapabilitiesChooser chooser, int width, int height) throws GLException Creates a `realized` `GLOffscreenAutoDrawable` incl it's offscreen `NativeSurface` with the given capabilites and dimensions. The `GLOffscreenAutoDrawable`'s `GLDrawable` is `realized` without an assigned `GLContext`, hence not initialized completely. The `GLContext` can be assigned later manually via `setContext(ctx)` or it will be created lazily at the 1st `display()` method call. Lazy `GLContext` creation will take a shared `GLContext` into account which has been set `directly` or `via another GLAutoDrawable`. In case the passed `GLCapabilitiesImmutable` contains default values, i.e. `caps.isOnscreen()` `== true`, it is auto-configured. Auto configuration will set `caps` to offscreen and FBO or Pbuffer, whichever is available in that order. A FBO based auto drawable, `GLOffscreenAutoDrawable.FBO`, is created if both `caps.isFBO()` and `canCreateFBO(device, caps.getGLProfile())` is true. A Pbuffer based auto drawable is created if both `caps.isPBuffer()` and `canCreateGLPbuffer(device)` is true. If neither FBO nor Pbuffer is available, a simple pixmap/bitmap auto drawable is created, which is unlikely to be hardware accelerated. The resulting `GLOffscreenAutoDrawable` has it's own independent device instance using `device` details. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. caps:GLCapabilitiesImmutable the requested GLCapabilties chooser:GLCapabilitiesChooser the custom chooser, may be null for default width:int the requested offscreen width height:int the requested offscreen height Returns:GLOffscreenAutoDrawable the created and realized offscreen `GLOffscreenAutoDrawable` instance Exceptions GLException: if any window system-specific errors caused the creation of the Offscreen to fail. See Also `createOffscreenDrawable(AbstractGraphicsDevice, GLCapabilitiesImmutable, GLCapabilitiesChooser, int, int)`

public abstract GLOffscreenAutoDrawable createOffscreenAutoDrawable(AbstractGraphicsDevice device, GLCapabilitiesImmutable caps, GLCapabilitiesChooser chooser, int width, int height) throws GLException

Creates a realized GLOffscreenAutoDrawable incl it's offscreen NativeSurface with the given capabilites and dimensions.

The GLOffscreenAutoDrawable's GLDrawable is realized without an assigned GLContext, hence not initialized completely.
The GLContext can be assigned later manually via setContext(ctx) or it will be created lazily at the 1st display() method call.
Lazy GLContext creation will take a shared GLContext into account which has been set directly or via another GLAutoDrawable.

In case the passed GLCapabilitiesImmutable contains default values, i.e. caps.isOnscreen() == true, it is auto-configured. Auto configuration will set caps to offscreen and FBO or Pbuffer, whichever is available in that order.

A FBO based auto drawable, GLOffscreenAutoDrawable.FBO, is created if both caps.isFBO() and canCreateFBO(device, caps.getGLProfile()) is true.

A Pbuffer based auto drawable is created if both caps.isPBuffer() and canCreateGLPbuffer(device) is true.

If neither FBO nor Pbuffer is available, a simple pixmap/bitmap auto drawable is created, which is unlikely to be hardware accelerated.

The resulting GLOffscreenAutoDrawable has it's own independent device instance using device details.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared device to be used, may be null for the platform's default device.
caps:GLCapabilitiesImmutable: the requested GLCapabilties
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default
width:int: the requested offscreen width
height:int: the requested offscreen height

Returns:GLOffscreenAutoDrawable

the created and realized offscreen GLOffscreenAutoDrawable instance

Exceptions

GLException:: if any window system-specific errors caused the creation of the Offscreen to fail.

createOffscreenDrawable back to summary

createOffscreenDrawable	back to summary
public abstract GLDrawable createOffscreenDrawable(AbstractGraphicsDevice device, GLCapabilitiesImmutable caps, GLCapabilitiesChooser chooser, int width, int height) throws GLException Creates an `unrealized` offscreen `GLDrawable` incl it's offscreen `NativeSurface` with the given capabilites and dimensions. In case the passed `GLCapabilitiesImmutable` contains default values, i.e. `caps.isOnscreen()` `== true`, it is auto-configured. The latter will set offscreen and also FBO or Pbuffer, whichever is available in that order. A resizeable FBO drawable, `GLFBODrawable.Resizeable`, is created if both `caps.isFBO()` and `canCreateFBO(device, caps.getGLProfile())` is true. A Pbuffer drawable is created if both `caps.isPBuffer()` and `canCreateGLPbuffer(device)` is true. If neither FBO nor Pbuffer is available, a simple pixmap/bitmap drawable is created, which is unlikely to be hardware accelerated. The resulting `GLDrawable` has it's own independent device instance using `device` details. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared device to be used, may be `null` for the platform's default device. caps:GLCapabilitiesImmutable the requested GLCapabilties chooser:GLCapabilitiesChooser the custom chooser, may be null for default width:int the requested offscreen width height:int the requested offscreen height Returns:GLDrawable the created unrealized offscreen `GLDrawable` Exceptions GLException: if any window system-specific errors caused the creation of the Offscreen to fail. See Also `createOffscreenAutoDrawable(AbstractGraphicsDevice, GLCapabilitiesImmutable, GLCapabilitiesChooser, int, int, GLContext)`

public abstract GLDrawable createOffscreenDrawable(AbstractGraphicsDevice device, GLCapabilitiesImmutable caps, GLCapabilitiesChooser chooser, int width, int height) throws GLException

Creates an unrealized offscreen GLDrawable incl it's offscreen NativeSurface with the given capabilites and dimensions.

In case the passed GLCapabilitiesImmutable contains default values, i.e. caps.isOnscreen() == true, it is auto-configured. The latter will set offscreen and also FBO or Pbuffer, whichever is available in that order.

A resizeable FBO drawable, GLFBODrawable.Resizeable, is created if both caps.isFBO() and canCreateFBO(device, caps.getGLProfile()) is true.

A Pbuffer drawable is created if both caps.isPBuffer() and canCreateGLPbuffer(device) is true.

If neither FBO nor Pbuffer is available, a simple pixmap/bitmap drawable is created, which is unlikely to be hardware accelerated.

The resulting GLDrawable has it's own independent device instance using device details.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared device to be used, may be null for the platform's default device.
caps:GLCapabilitiesImmutable: the requested GLCapabilties
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default
width:int: the requested offscreen width
height:int: the requested offscreen height

Returns:GLDrawable

the created unrealized offscreen GLDrawable

Exceptions

GLException:: if any window system-specific errors caused the creation of the Offscreen to fail.

createProxySurface back to summary

createProxySurface	back to summary
public abstract ProxySurface createProxySurface(AbstractGraphicsDevice device, int screenIdx, long windowHandle, GLCapabilitiesImmutable caps, GLCapabilitiesChooser chooser, UpstreamSurfaceHook upstream) Creates a proxy `NativeSurface` w/ defined surface handle, i.e. a `jogamp.nativewindow.WrappedSurface` or `jogamp.nativewindow.windows.GDISurface` instance. It's `AbstractGraphicsConfiguration` is properly set according to the given `windowHandle`'s native visualID if set or the given `GLCapabilitiesImmutable`. Lifecycle (creation and destruction) of the given surface handle shall be handled by the caller via `ProxySurface#createNotify()` and `ProxySurface#destroyNotify()`. Such surface can be used to instantiate a GLDrawable. With the help of `GLAutoDrawableDelegate` you will be able to implement a new native windowing system binding almost on-the-fly, see `com.jogamp.opengl.swt.GLCanvas`. The resulting `GLOffscreenAutoDrawable` has it's own independent device instance using `device` details which may be blocking depending on platform and windowing-toolkit requirements. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. Caller has to ensure it is compatible w/ the given `windowHandle` screenIdx:int matching screen index of given `windowHandle` windowHandle:long the native window handle caps:GLCapabilitiesImmutable the requested GLCapabilties chooser:GLCapabilitiesChooser the custom chooser, may be null for default upstream:UpstreamSurfaceHook optional `UpstreamSurfaceHook` allowing control of the `ProxySurface`'s lifecycle and data it presents. Returns:ProxySurface the created `ProxySurface` instance w/ defined surface handle.

public abstract ProxySurface createProxySurface(AbstractGraphicsDevice device, int screenIdx, long windowHandle, GLCapabilitiesImmutable caps, GLCapabilitiesChooser chooser, UpstreamSurfaceHook upstream)

Creates a proxy NativeSurface w/ defined surface handle, i.e. a jogamp.nativewindow.WrappedSurface or jogamp.nativewindow.windows.GDISurface instance.

It's AbstractGraphicsConfiguration is properly set according to the given windowHandle's native visualID if set or the given GLCapabilitiesImmutable.

Lifecycle (creation and destruction) of the given surface handle shall be handled by the caller via ProxySurface#createNotify() and ProxySurface#destroyNotify().

Such surface can be used to instantiate a GLDrawable. With the help of GLAutoDrawableDelegate you will be able to implement a new native windowing system binding almost on-the-fly, see com.jogamp.opengl.swt.GLCanvas.

The resulting GLOffscreenAutoDrawable has it's own independent device instance using device details which may be blocking depending on platform and windowing-toolkit requirements.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device. Caller has to ensure it is compatible w/ the given windowHandle
screenIdx:int: matching screen index of given windowHandle
windowHandle:long: the native window handle
caps:GLCapabilitiesImmutable: the requested GLCapabilties
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default
upstream:UpstreamSurfaceHook: optional UpstreamSurfaceHook allowing control of the ProxySurface's lifecycle and data it presents.

Returns:ProxySurface

the created ProxySurface instance w/ defined surface handle.

createSharedResource back to summary

createSharedResource	back to summary
protected final boolean createSharedResource(final AbstractGraphicsDevice device) Create the shared resource used internally as a reference for capabilities etc. Returns true if a shared resource could be created for the `device` `AbstractGraphicsDevice#getConnection()`. This does not imply a shared resource is mapped (ie. made persistent), but is available in general . Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. Returns:boolean true if a shared resource could been created, otherwise false.

protected final boolean createSharedResource(final AbstractGraphicsDevice device)

Create the shared resource used internally as a reference for capabilities etc.

Returns true if a shared resource could be created for the device AbstractGraphicsDevice#getConnection().
This does not imply a shared resource is mapped (ie. made persistent), but is available in general
.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.

Returns:boolean

true if a shared resource could been created, otherwise false.

createSharedResourceImpl	back to summary
protected abstract boolean createSharedResourceImpl(AbstractGraphicsDevice device)

enterThreadCriticalZone	back to summary
protected void enterThreadCriticalZone()

getAvailableCapabilities back to summary

getAvailableCapabilities	back to summary
public final List<GLCapabilitiesImmutable> getAvailableCapabilities(AbstractGraphicsDevice device) Returns an array of available GLCapabilities for the device. The list is sorted by the native ID, ascending. The chosen GLProfile statement in the result may not refer to the maximum available profile due to implementation constraints, ie using the shared resource. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. Returns:List<GLCapabilitiesImmutable> A list of `com.jogamp.opengl.GLCapabilitiesImmutable`'s, maybe empty if none is available.

public final List<GLCapabilitiesImmutable> getAvailableCapabilities(AbstractGraphicsDevice device)

Returns an array of available GLCapabilities for the device.
The list is sorted by the native ID, ascending.
The chosen GLProfile statement in the result may not refer to the maximum available profile due to implementation constraints, ie using the shared resource.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.

Returns:List<GLCapabilitiesImmutable>

A list of com.jogamp.opengl.GLCapabilitiesImmutable's, maybe empty if none is available.

getAvailableCapabilitiesImpl	back to summary
protected abstract List<GLCapabilitiesImmutable> getAvailableCapabilitiesImpl(AbstractGraphicsDevice device)

getDefaultDevice back to summary

getDefaultDevice	back to summary
public abstract AbstractGraphicsDevice getDefaultDevice() Retrieve the default `device` `connection`, `unit ID` and `unique ID name`. for this factory The implementation must return a non `null` default device, which must not be opened, ie. it's native handle is `null`. This method shall return the default device if available even if the GLDrawableFactory is not functional and hence not compatible. The latter situation may happen because no native OpenGL implementation is available for the specific implementation. Returns:AbstractGraphicsDevice the default shared device for this factory, eg. :0.0 on X11 desktop. See Also `getIsDeviceCompatible(AbstractGraphicsDevice)`

public abstract AbstractGraphicsDevice getDefaultDevice()

Retrieve the default device connection, unit ID and unique ID name. for this factory
The implementation must return a non null default device, which must not be opened, ie. it's native handle is null.

This method shall return the default device if available even if the GLDrawableFactory is not functional and hence not compatible. The latter situation may happen because no native OpenGL implementation is available for the specific implementation.

Returns:AbstractGraphicsDevice: the default shared device for this factory, eg. :0.0 on X11 desktop.
See Also: getIsDeviceCompatible(AbstractGraphicsDevice)

getDesktopFactory	back to summary
public static GLDrawableFactory getDesktopFactory() Returns the sole GLDrawableFactory instance for the desktop (X11, WGL, ..) if exist or null

getEGLFactory	back to summary
public static GLDrawableFactory getEGLFactory() Returns the sole GLDrawableFactory instance for EGL if exist or null

getFactory	back to summary
public static GLDrawableFactory getFactory(final GLProfile glProfile) throws GLException Returns the sole GLDrawableFactory instance. Parameters glProfile:GLProfile GLProfile to determine the factory type, ie EGLDrawableFactory, or one of the native GLDrawableFactory's, ie X11/GLX, Windows/WGL or MacOSX/CGL.

getFactory

back to summary

public static GLDrawableFactory getFactory(final GLProfile glProfile) throws GLException

Returns the sole GLDrawableFactory instance.

Parameters

glProfile:GLProfile: GLProfile to determine the factory type, ie EGLDrawableFactory, or one of the native GLDrawableFactory's, ie X11/GLX, Windows/WGL or MacOSX/CGL.

getFactoryImpl	back to summary
protected static GLDrawableFactory getFactoryImpl(final String glProfileImplName) throws GLException

getFactoryImpl	back to summary
protected static GLDrawableFactory getFactoryImpl(final AbstractGraphicsDevice device) throws GLException

getIsDeviceCompatible back to summary

getIsDeviceCompatible	back to summary
public abstract boolean getIsDeviceCompatible(AbstractGraphicsDevice device) Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. Returns:boolean true if the device is compatible with this factory, ie. if it can be used for GLDrawable creation. Otherwise false. This implies validation whether the implementation is functional. See Also `getDefaultDevice()`

public abstract boolean getIsDeviceCompatible(AbstractGraphicsDevice device)

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.

Returns:boolean

true if the device is compatible with this factory, ie. if it can be used for GLDrawable creation. Otherwise false. This implies validation whether the implementation is functional.

See Also

getDefaultDevice()

getRendererQuirks back to summary

getRendererQuirks	back to summary
public abstract GLRendererQuirks getRendererQuirks(AbstractGraphicsDevice device, final GLProfile glp) Returns the shared resource's context `GLRendererQuirks`. Implementation calls `GLContext#getRendererQuirks()` on the shared resource context. In case no shared device exist yet or the implementation doesn't support tracking quirks, the result is always `null`. Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. glp:GLProfile `GLProfile` to identify the device's `GLRendererQuirks`, maybe `null` See Also `GLContext#getRendererQuirks()`, `GLRendererQuirks`

public abstract GLRendererQuirks getRendererQuirks(AbstractGraphicsDevice device, final GLProfile glp)

Returns the shared resource's context GLRendererQuirks.

Implementation calls GLContext#getRendererQuirks() on the shared resource context.

In case no shared device exist yet or the implementation doesn't support tracking quirks, the result is always null.

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.
glp:GLProfile: GLProfile to identify the device's GLRendererQuirks, maybe null

getSharedResourceThread	back to summary
protected abstract Thread getSharedResourceThread() Validate and start the shared resource runner thread if necessary and if the implementation uses it. Returns:Thread the shared resource runner thread, if implementation uses it.

getSharedResourceThread

back to summary

protected abstract Thread getSharedResourceThread()

Validate and start the shared resource runner thread if necessary and if the implementation uses it.

Returns:Thread: the shared resource runner thread, if implementation uses it.

getThreadName	back to summary
protected static String getThreadName()

hasOpenGLDesktopSupport	back to summary
public abstract boolean hasOpenGLDesktopSupport() Method returns `true` if underlying implementation may support native desktop OpenGL, otherwise `false`.

hasOpenGLESSupport	back to summary
public abstract boolean hasOpenGLESSupport() Method returns `true` if underlying implementation may support native embedded OpenGL ES, otherwise `false`.

hasRendererQuirk back to summary

hasRendererQuirk	back to summary
public final boolean hasRendererQuirk(final AbstractGraphicsDevice device, final GLProfile glp, final int quirk) Returns true if the `quirk` exist in the shared resource's context `GLRendererQuirks`. Convenience method for: final GLRendererQuirks glrq = factory.getRendererQuirks(device); return null != glrq ? glrq.exist(quirk) : false; Parameters device:AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. glp:GLProfile `GLProfile` to identify the device's `GLRendererQuirks`, maybe `null` quirk:int the quirk to be tested, e.g. `GLRendererQuirks#NoDoubleBufferedPBuffer`. Exceptions IllegalArgumentException: if the quirk is out of range See Also `getRendererQuirks(AbstractGraphicsDevice, GLProfile)`, `GLRendererQuirks`

public final boolean hasRendererQuirk(final AbstractGraphicsDevice device, final GLProfile glp, final int quirk)

Returns true if the quirk exist in the shared resource's context GLRendererQuirks.

Convenience method for:

     final GLRendererQuirks glrq = factory.getRendererQuirks(device);
     return null != glrq ? glrq.exist(quirk) : false;

Parameters

device:AbstractGraphicsDevice: which connection denotes the shared the target device, may be null for the platform's default device.
glp:GLProfile: GLProfile to identify the device's GLRendererQuirks, maybe null
quirk:int: the quirk to be tested, e.g. GLRendererQuirks#NoDoubleBufferedPBuffer.

Exceptions

IllegalArgumentException:: if the quirk is out of range

initSingleton	back to summary
public static final void initSingleton() Instantiate singleton factories if available, EGLES1, EGLES2 and the OS native ones.

initSingletonImpl	back to summary
private static final void initSingletonImpl()

isComplete	back to summary
protected abstract boolean isComplete() Returns true if this factory is complete, i.e. ready to be used. Otherwise return false.

leaveThreadCriticalZone	back to summary
protected void leaveThreadCriticalZone()

resetAllDisplayGamma back to summary

resetAllDisplayGamma	back to summary
public abstract void resetAllDisplayGamma() Resets the gamma, brightness and contrast values of all modified displays to their original values before `setDisplayGamma` was called the first time. While it is not explicitly required that this method be called before exiting manually, calling it is recommended because of the inevitable unspecified behavior during JVM teardown.

public abstract void resetAllDisplayGamma()

Resets the gamma, brightness and contrast values of all modified displays to their original values before setDisplayGamma was called the first time.

While it is not explicitly required that this method be called before exiting manually, calling it is recommended because of the inevitable unspecified behavior during JVM teardown.

resetAllDisplayGammaNoSync	back to summary
protected abstract void resetAllDisplayGammaNoSync()

resetDisplayGamma back to summary

resetDisplayGamma	back to summary
public abstract void resetDisplayGamma(final NativeSurface surface) Resets the gamma, brightness and contrast values of the display associated with the given `surface` to its original values before `setDisplayGamma` was called the first time. While it is not explicitly required that this method be called before exiting manually, calling it is recommended because of the inevitable unspecified behavior during JVM teardown.

public abstract void resetDisplayGamma(final NativeSurface surface)

Resets the gamma, brightness and contrast values of the display associated with the given surface to its original values before setDisplayGamma was called the first time.

While it is not explicitly required that this method be called before exiting manually, calling it is recommended because of the inevitable unspecified behavior during JVM teardown.

setDisplayGamma back to summary

setDisplayGamma	back to summary
public abstract boolean setDisplayGamma(final NativeSurface surface, final float gamma, final float brightness, final float contrast) throws IllegalArgumentException Sets the gamma, brightness, and contrast of the display associated with the given `surface`. This functionality is not available on all platforms and graphics hardware. Returns true if the settings were successfully changed, false if not. This method may return false for some values of the incoming arguments even on hardware which does support the underlying functionality. If this method returns true, the display settings will automatically be reset to their original values upon JVM exit (assuming the JVM does not crash); if the user wishes to change the display settings back to normal ahead of time, use `resetDisplayGamma(NativeSurface)` or `resetAllDisplayGamma()`. It is recommended to call `resetDisplayGamma(NativeSurface)` or `resetAllDisplayGamma()` before calling e.g. `System.exit()` from the application rather than rely on the shutdown hook functionality due to inevitable race conditions and unspecified behavior during JVM teardown. This method may be called multiple times during the application's execution, but calling `resetDisplayGamma(NativeSurface)` will only reset the settings to the values before the first call to this method. Parameters surface:NativeSurface denominates the display device gamma:float The gamma value, typically > 1.0 (default values vary, but typically roughly 1.0) brightness:float The brightness value between -1.0 and 1.0, inclusive (default values vary, but typically 0) contrast:float The contrast, greater than 0.0 (default values vary, but typically 1) Returns:boolean true if gamma settings were successfully changed, false if not Exceptions IllegalArgumentException: if any of the parameters were out-of-bounds See Also `resetDisplayGamma(NativeSurface)`, `resetAllDisplayGamma()`

public abstract boolean setDisplayGamma(final NativeSurface surface, final float gamma, final float brightness, final float contrast) throws IllegalArgumentException

Sets the gamma, brightness, and contrast of the display associated with the given surface.

This functionality is not available on all platforms and graphics hardware. Returns true if the settings were successfully changed, false if not. This method may return false for some values of the incoming arguments even on hardware which does support the underlying functionality.

If this method returns true, the display settings will automatically be reset to their original values upon JVM exit (assuming the JVM does not crash); if the user wishes to change the display settings back to normal ahead of time, use resetDisplayGamma(NativeSurface) or resetAllDisplayGamma().

It is recommended to call resetDisplayGamma(NativeSurface) or resetAllDisplayGamma() before calling e.g. System.exit() from the application rather than rely on the shutdown hook functionality due to inevitable race conditions and unspecified behavior during JVM teardown.

This method may be called multiple times during the application's execution, but calling resetDisplayGamma(NativeSurface) will only reset the settings to the values before the first call to this method.

Parameters

surface:NativeSurface: denominates the display device
gamma:float: The gamma value, typically > 1.0 (default values vary, but typically roughly 1.0)
brightness:float: The brightness value between -1.0 and 1.0, inclusive (default values vary, but typically 0)
contrast:float: The contrast, greater than 0.0 (default values vary, but typically 1)

Returns:boolean

true if gamma settings were successfully changed, false if not

Exceptions

IllegalArgumentException:: if any of the parameters were out-of-bounds

shutdown	back to summary
protected static void shutdown()

shutdown0	back to summary
private static void shutdown0()

shutdownImpl	back to summary
protected abstract void shutdownImpl()

validateDevice	back to summary
protected final AbstractGraphicsDevice validateDevice(AbstractGraphicsDevice device)

public abstract Class GLDrawableFactory

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail