Modifier and Type	Class and Description
pack-priv static class	MacOSXCGLDrawableFactory.SharedResource

Modifier and Type	Field and Description
private static final boolean	DEBUG_SHAREDCTX
private MacOSXGraphicsDevice	defaultDevice
private final HashSet<String>	devicesTried
private static final int	GAMMA_RAMP_LENGTH
private static DesktopGLDynamicLookupHelper	macOSXCGLDynamicLookupHelper
private HashMap<String, MacOSXCGLDrawableFactory.SharedResource>	sharedMap

Access	Constructor and Description
public	MacOSXCGLDrawableFactory()

Method Summary

Modifier and Type	Method and Description
private void	addDeviceTried(final String connection)
public boolean	canCreateExternalGLDrawable(final AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device) Implements abstract com.jogamp.opengl.GLDrawableFactory.canCreateExternalGLDrawable. Returns true if it is possible to create an external GLDrawable object via `createExternalGLDrawable`.
public boolean	canCreateGLPbuffer(final AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device, final GLProfile `GLProfile` to check for FBO capabilities glp) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.canCreateGLPbuffer. Returns true if it is possible to create an pbuffer surface.
public final ProxySurface	createDummySurfaceImpl(final AbstractGraphicsDevice a valid platform dependent target device. deviceReq, final boolean if `true` a new device instance is created using `device` details, otherwise `device` instance is used as-is. createNewDevice, GLCapabilitiesImmutable chosenCaps, final GLCapabilitiesImmutable requestedCaps, final GLCapabilitiesChooser the custom chooser, may be null for default chooser, final int the initial width as returned by `NativeSurface#getSurfaceWidth()`, not the actual dummy surface width. The latter is platform specific and small width, final int the initial height as returned by `NativeSurface#getSurfaceHeight()`, not the actual dummy surface height, The latter is platform specific and small height) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createDummySurfaceImpl. A dummy surface is not visible on screen and may be on- or offscreen.
protected GLContext	createExternalGLContextImpl() Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createExternalGLContextImpl.
protected GLDrawable	createExternalGLDrawableImpl() Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createExternalGLDrawableImpl.
protected ProxySurface	createMutableSurfaceImpl(final AbstractGraphicsDevice a valid platform dependent target device. deviceReq, final boolean if `true` a new independent device instance is created using `device` details, otherwise `device` instance is used as-is. createNewDevice, final GLCapabilitiesImmutable capsChosen, final GLCapabilitiesImmutable capsRequested, final GLCapabilitiesChooser the custom chooser, may be null for default chooser, final UpstreamSurfaceHook surface size information and optional control of the surface's lifecycle upstreamHook) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createMutableSurfaceImpl. Creates a mutable `ProxySurface` w/o defined surface handle.
protected GLDrawableImpl	createOffscreenDrawableImpl(final NativeSurface target) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createOffscreenDrawableImpl. Creates a platform dependent unrealized offscreen pbuffer/pixmap GLDrawable instance
protected GLDrawableImpl	createOnscreenDrawableImpl(final NativeSurface target) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createOnscreenDrawableImpl.
protected ProxySurface	createProxySurfaceImpl(final AbstractGraphicsDevice deviceReq, final int screenIdx, final long windowHandle, final GLCapabilitiesImmutable capsRequested, final GLCapabilitiesChooser chooser, final UpstreamSurfaceHook TODO upstream) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createProxySurfaceImpl. Creates a `ProxySurface` with a set surface handle.
public final ProxySurface	createSurfacelessImpl(final AbstractGraphicsDevice a valid platform dependent target device. deviceReq, final boolean if `true` a new device instance is created using `device` details, otherwise `device` instance is used as-is. createNewDevice, GLCapabilitiesImmutable chosenCaps, final GLCapabilitiesImmutable requestedCaps, final GLCapabilitiesChooser the custom chooser, may be null for default chooser, final int the initial width as returned by `NativeSurface#getSurfaceWidth()`, not the actual dummy surface width. The latter is platform specific and small width, final int the initial height as returned by `NativeSurface#getSurfaceHeight()`, not the actual dummy surface height, The latter is platform specific and small height) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createSurfacelessImpl. A surfaceless `ProxySurface` is a non-existing surface and will not be used as a render target.
protected List<GLCapabilitiesImmutable>	getAvailableCapabilitiesImpl(final AbstractGraphicsDevice device) Implements abstract com.jogamp.opengl.GLDrawableFactory.getAvailableCapabilitiesImpl.
public final AbstractGraphicsDevice	getDefaultDevice() Implements abstract com.jogamp.opengl.GLDrawableFactory.getDefaultDevice. Retrieve the default `device` `connection`, `unit ID` and `unique ID name`.
private boolean	getDeviceTried(final String connection)
protected Buffer	getGammaRamp(final NativeSurface TODO surface) Overrides jogamp.opengl.GLDrawableFactoryImpl.getGammaRamp. Gets the current gamma ramp.
protected int	getGammaRampLength(final NativeSurface TODO surface) Overrides jogamp.opengl.GLDrawableFactoryImpl.getGammaRampLength. Returns the length of the computed gamma ramp for this OS and hardware.
public final GLDynamicLookupHelper	getGLDynamicLookupHelper(final int the major OpenGL profile version majorVersion, final int the context profile options contextOptions) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.getGLDynamicLookupHelper. Returns the GLDynamicLookupHelper if installed, otherwise `null`.
public final boolean	getIsDeviceCompatible(final AbstractGraphicsDevice which `connection` denotes the shared the target device, may be `null` for the platform's default device. device) Implements abstract com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible.
protected final MacOSXCGLDrawableFactory.SharedResource	getOrCreateSharedResourceImpl(final AbstractGraphicsDevice adevice) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.getOrCreateSharedResourceImpl.
protected final Thread	getSharedResourceThread() Implements abstract com.jogamp.opengl.GLDrawableFactory.getSharedResourceThread. Validate and start the shared resource runner thread if necessary and if the implementation uses it.
public final boolean	hasMajorMinorCreateContextARB() Implements abstract jogamp.opengl.GLDrawableFactoryImpl.hasMajorMinorCreateContextARB. Method returns `true` if underlying `ARB context creation` supports `major` and `minor` version number.
public final boolean	hasOpenGLDesktopSupport() Implements abstract com.jogamp.opengl.GLDrawableFactory.hasOpenGLDesktopSupport. Method returns `true` if underlying implementation may support native desktop OpenGL, otherwise `false`.
public final boolean	hasOpenGLESSupport() Implements abstract com.jogamp.opengl.GLDrawableFactory.hasOpenGLESSupport. Method returns `true` if underlying implementation may support native embedded OpenGL ES, otherwise `false`.
protected final boolean	isComplete() Implements abstract com.jogamp.opengl.GLDrawableFactory.isComplete. Returns true if this factory is complete, i.e. ready to be used.
private void	removeDeviceTried(final String connection)
protected void	resetGammaRamp(final NativeSurface TODO surface, final Buffer originalGammaRamp) Overrides jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp. Resets the gamma ramp, potentially using the specified Buffer as data to restore the original values.
protected final void	resetGammaRamp(final GLDrawableFactoryImpl.DeviceScreenID deviceScreenID, final Buffer originalGammaRamp) Overrides jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp.
protected boolean	setGammaRamp(final NativeSurface TODO surface, final float[] ramp) Overrides jogamp.opengl.GLDrawableFactoryImpl.setGammaRamp. Sets the gamma ramp for the main screen.
protected final void	shutdownImpl() Implements abstract com.jogamp.opengl.GLDrawableFactory.shutdownImpl.

Field Detail

DEBUG_SHAREDCTX	back to summary
private static final boolean DEBUG_SHAREDCTX

defaultDevice	back to summary
private MacOSXGraphicsDevice defaultDevice

devicesTried	back to summary
private final HashSet<String> devicesTried

GAMMA_RAMP_LENGTH	back to summary
private static final int GAMMA_RAMP_LENGTH

macOSXCGLDynamicLookupHelper	back to summary
private static DesktopGLDynamicLookupHelper macOSXCGLDynamicLookupHelper

sharedMap	back to summary
private HashMap<String, MacOSXCGLDrawableFactory.SharedResource> sharedMap

Constructor Detail

MacOSXCGLDrawableFactory	back to summary
public MacOSXCGLDrawableFactory()

Method Detail

addDeviceTried	back to summary
private void addDeviceTried(final String connection)

canCreateExternalGLDrawable back to summary

canCreateExternalGLDrawable	back to summary
public boolean canCreateExternalGLDrawable(final AbstractGraphicsDevice device) Implements abstract com.jogamp.opengl.GLDrawableFactory.canCreateExternalGLDrawable. Doc from com.jogamp.opengl.GLDrawableFactory.canCreateExternalGLDrawable. 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. Annotations @Override

public boolean canCreateExternalGLDrawable(final AbstractGraphicsDevice device)

Implements abstract com.jogamp.opengl.GLDrawableFactory.canCreateExternalGLDrawable.

Doc from com.jogamp.opengl.GLDrawableFactory.canCreateExternalGLDrawable.

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.

Annotations

@Override

canCreateGLPbuffer back to summary

canCreateGLPbuffer	back to summary
public boolean canCreateGLPbuffer(final AbstractGraphicsDevice device, final GLProfile glp) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.canCreateGLPbuffer. Doc from com.jogamp.opengl.GLDrawableFactory.canCreateGLPbuffer. 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 Annotations @Override

public boolean canCreateGLPbuffer(final AbstractGraphicsDevice device, final GLProfile glp)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.canCreateGLPbuffer.

Doc from com.jogamp.opengl.GLDrawableFactory.canCreateGLPbuffer.

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

Annotations

@Override

createDummySurfaceImpl back to summary

createDummySurfaceImpl	back to summary
public final ProxySurface createDummySurfaceImpl(final AbstractGraphicsDevice deviceReq, final boolean createNewDevice, GLCapabilitiesImmutable chosenCaps, final GLCapabilitiesImmutable requestedCaps, final GLCapabilitiesChooser chooser, final int width, final int height) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createDummySurfaceImpl. Doc from jogamp.opengl.GLDrawableFactoryImpl.createDummySurfaceImpl. A dummy surface is not visible on screen and may be on- or offscreen. It is used to allow the creation of a `GLDrawable` and `GLContext` to query information. It also allows creation of framebuffer objects which are used for rendering or using a shared GLContext w/o actually rendering to a usable framebuffer. Parameters deviceReq:AbstractGraphicsDevice a valid platform dependent target device. createNewDevice:boolean if `true` a new device instance is created using `device` details, otherwise `device` instance is used as-is. chooser:GLCapabilitiesChooser the custom chooser, may be null for default width:int the initial width as returned by `NativeSurface#getSurfaceWidth()`, not the actual dummy surface width. The latter is platform specific and small height:int the initial height as returned by `NativeSurface#getSurfaceHeight()`, not the actual dummy surface height, The latter is platform specific and small Returns:ProxySurface the created `ProxySurface` instance w/o defined surface handle but platform specific `UpstreamSurfaceHook`. Annotations @Override

public final ProxySurface createDummySurfaceImpl(final AbstractGraphicsDevice deviceReq, final boolean createNewDevice, GLCapabilitiesImmutable chosenCaps, final GLCapabilitiesImmutable requestedCaps, final GLCapabilitiesChooser chooser, final int width, final int height)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createDummySurfaceImpl.

Doc from jogamp.opengl.GLDrawableFactoryImpl.createDummySurfaceImpl.

A dummy surface is not visible on screen and may be on- or offscreen.

It is used to allow the creation of a GLDrawable and GLContext to query information. It also allows creation of framebuffer objects which are used for rendering or using a shared GLContext w/o actually rendering to a usable framebuffer.

Parameters

deviceReq:AbstractGraphicsDevice: a valid platform dependent target device.
createNewDevice:boolean: if true a new device instance is created using device details, otherwise device instance is used as-is.
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default
width:int: the initial width as returned by NativeSurface#getSurfaceWidth(), not the actual dummy surface width. The latter is platform specific and small
height:int: the initial height as returned by NativeSurface#getSurfaceHeight(), not the actual dummy surface height, The latter is platform specific and small

Returns:ProxySurface

the created ProxySurface instance w/o defined surface handle but platform specific UpstreamSurfaceHook.

Annotations

@Override

createExternalGLContextImpl	back to summary
protected GLContext createExternalGLContextImpl() Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createExternalGLContextImpl. Annotations @Override

createExternalGLContextImpl

back to summary

protected GLContext createExternalGLContextImpl()

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createExternalGLContextImpl.

Annotations

@Override

createExternalGLDrawableImpl	back to summary
protected GLDrawable createExternalGLDrawableImpl() Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createExternalGLDrawableImpl. Annotations @Override

createExternalGLDrawableImpl

back to summary

protected GLDrawable createExternalGLDrawableImpl()

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createExternalGLDrawableImpl.

Annotations

@Override

createMutableSurfaceImpl back to summary

createMutableSurfaceImpl	back to summary
protected ProxySurface createMutableSurfaceImpl(final AbstractGraphicsDevice deviceReq, final boolean createNewDevice, final GLCapabilitiesImmutable capsChosen, final GLCapabilitiesImmutable capsRequested, final GLCapabilitiesChooser chooser, final UpstreamSurfaceHook upstreamHook) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createMutableSurfaceImpl. Doc from jogamp.opengl.GLDrawableFactoryImpl.createMutableSurfaceImpl. Creates a mutable `ProxySurface` w/o defined surface handle. It's `AbstractGraphicsConfiguration` is properly set according to the given `GLCapabilitiesImmutable`. Lifecycle (destruction) of the TBD surface handle shall be handled by the caller. Parameters deviceReq:AbstractGraphicsDevice a valid platform dependent target device. createNewDevice:boolean if `true` a new independent device instance is created using `device` details, otherwise `device` instance is used as-is. chooser:GLCapabilitiesChooser the custom chooser, may be null for default upstreamHook:UpstreamSurfaceHook surface size information and optional control of the surface's lifecycle Returns:ProxySurface the created `MutableSurface` instance w/o defined surface handle Annotations @Override

protected ProxySurface createMutableSurfaceImpl(final AbstractGraphicsDevice deviceReq, final boolean createNewDevice, final GLCapabilitiesImmutable capsChosen, final GLCapabilitiesImmutable capsRequested, final GLCapabilitiesChooser chooser, final UpstreamSurfaceHook upstreamHook)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createMutableSurfaceImpl.

Doc from jogamp.opengl.GLDrawableFactoryImpl.createMutableSurfaceImpl.

Creates a mutable ProxySurface w/o defined surface handle.

It's AbstractGraphicsConfiguration is properly set according to the given GLCapabilitiesImmutable.

Lifecycle (destruction) of the TBD surface handle shall be handled by the caller.

Parameters

deviceReq:AbstractGraphicsDevice: a valid platform dependent target device.
createNewDevice:boolean: if true a new independent device instance is created using device details, otherwise device instance is used as-is.
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default
upstreamHook:UpstreamSurfaceHook: surface size information and optional control of the surface's lifecycle

Returns:ProxySurface

the created MutableSurface instance w/o defined surface handle

Annotations

@Override

createOffscreenDrawableImpl	back to summary
protected GLDrawableImpl createOffscreenDrawableImpl(final NativeSurface target) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createOffscreenDrawableImpl. Doc from jogamp.opengl.GLDrawableFactoryImpl.createOffscreenDrawableImpl. Creates a platform dependent unrealized offscreen pbuffer/pixmap GLDrawable instance Annotations @Override

createOffscreenDrawableImpl

back to summary

protected GLDrawableImpl createOffscreenDrawableImpl(final NativeSurface target)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createOffscreenDrawableImpl.

Doc from jogamp.opengl.GLDrawableFactoryImpl.createOffscreenDrawableImpl.

Creates a platform dependent unrealized offscreen pbuffer/pixmap GLDrawable instance

Annotations

@Override

createOnscreenDrawableImpl	back to summary
protected GLDrawableImpl createOnscreenDrawableImpl(final NativeSurface target) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createOnscreenDrawableImpl. Annotations @Override

createOnscreenDrawableImpl

back to summary

protected GLDrawableImpl createOnscreenDrawableImpl(final NativeSurface target)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createOnscreenDrawableImpl.

Annotations

@Override

createProxySurfaceImpl back to summary

createProxySurfaceImpl	back to summary
protected ProxySurface createProxySurfaceImpl(final AbstractGraphicsDevice deviceReq, final int screenIdx, final long windowHandle, final GLCapabilitiesImmutable capsRequested, final GLCapabilitiesChooser chooser, final UpstreamSurfaceHook upstream) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createProxySurfaceImpl. Doc from jogamp.opengl.GLDrawableFactoryImpl.createProxySurfaceImpl. Creates a `ProxySurface` with a set surface handle. Implementation is also required to allocate it's own `AbstractGraphicsDevice` instance. Parameters upstream:UpstreamSurfaceHook TODO Annotations @Override

protected ProxySurface createProxySurfaceImpl(final AbstractGraphicsDevice deviceReq, final int screenIdx, final long windowHandle, final GLCapabilitiesImmutable capsRequested, final GLCapabilitiesChooser chooser, final UpstreamSurfaceHook upstream)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createProxySurfaceImpl.

Doc from jogamp.opengl.GLDrawableFactoryImpl.createProxySurfaceImpl.

Creates a ProxySurface with a set surface handle.

Implementation is also required to allocate it's own AbstractGraphicsDevice instance.

Parameters

upstream:UpstreamSurfaceHook: TODO

Annotations

@Override

createSurfacelessImpl back to summary

createSurfacelessImpl	back to summary
public final ProxySurface createSurfacelessImpl(final AbstractGraphicsDevice deviceReq, final boolean createNewDevice, GLCapabilitiesImmutable chosenCaps, final GLCapabilitiesImmutable requestedCaps, final GLCapabilitiesChooser chooser, final int width, final int height) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createSurfacelessImpl. Doc from jogamp.opengl.GLDrawableFactoryImpl.createSurfacelessImpl. A surfaceless `ProxySurface` is a non-existing surface and will not be used as a render target. It is used to allow the creation of a `GLDrawable` and `GLContext` w/o default framebuffer to query information. It also allows creation of framebuffer objects which are used for rendering or using a shared GLContext w/o actually rendering to a usable framebuffer. Parameters deviceReq:AbstractGraphicsDevice a valid platform dependent target device. createNewDevice:boolean if `true` a new device instance is created using `device` details, otherwise `device` instance is used as-is. chooser:GLCapabilitiesChooser the custom chooser, may be null for default width:int the initial width as returned by `NativeSurface#getSurfaceWidth()`, not the actual dummy surface width. The latter is platform specific and small height:int the initial height as returned by `NativeSurface#getSurfaceHeight()`, not the actual dummy surface height, The latter is platform specific and small Returns:ProxySurface the created `ProxySurface` instance w/o defined surface handle but platform specific `UpstreamSurfaceHook`. Annotations @Override

public final ProxySurface createSurfacelessImpl(final AbstractGraphicsDevice deviceReq, final boolean createNewDevice, GLCapabilitiesImmutable chosenCaps, final GLCapabilitiesImmutable requestedCaps, final GLCapabilitiesChooser chooser, final int width, final int height)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.createSurfacelessImpl.

Doc from jogamp.opengl.GLDrawableFactoryImpl.createSurfacelessImpl.

A surfaceless ProxySurface is a non-existing surface and will not be used as a render target.

It is used to allow the creation of a GLDrawable and GLContext w/o default framebuffer to query information. It also allows creation of framebuffer objects which are used for rendering or using a shared GLContext w/o actually rendering to a usable framebuffer.

Parameters

deviceReq:AbstractGraphicsDevice: a valid platform dependent target device.
createNewDevice:boolean: if true a new device instance is created using device details, otherwise device instance is used as-is.
chooser:GLCapabilitiesChooser: the custom chooser, may be null for default
width:int: the initial width as returned by NativeSurface#getSurfaceWidth(), not the actual dummy surface width. The latter is platform specific and small
height:int: the initial height as returned by NativeSurface#getSurfaceHeight(), not the actual dummy surface height, The latter is platform specific and small

Returns:ProxySurface

the created ProxySurface instance w/o defined surface handle but platform specific UpstreamSurfaceHook.

Annotations

@Override

getAvailableCapabilitiesImpl	back to summary
protected List<GLCapabilitiesImmutable> getAvailableCapabilitiesImpl(final AbstractGraphicsDevice device) Implements abstract com.jogamp.opengl.GLDrawableFactory.getAvailableCapabilitiesImpl. Annotations @Override

getAvailableCapabilitiesImpl

back to summary

protected List<GLCapabilitiesImmutable> getAvailableCapabilitiesImpl(final AbstractGraphicsDevice device)

Implements abstract com.jogamp.opengl.GLDrawableFactory.getAvailableCapabilitiesImpl.

Annotations

@Override

getDefaultDevice back to summary

getDefaultDevice	back to summary
public final AbstractGraphicsDevice getDefaultDevice() Implements abstract com.jogamp.opengl.GLDrawableFactory.getDefaultDevice. Doc from com.jogamp.opengl.GLDrawableFactory.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. Annotations @Override

public final AbstractGraphicsDevice getDefaultDevice()

Implements abstract com.jogamp.opengl.GLDrawableFactory.getDefaultDevice.

Doc from com.jogamp.opengl.GLDrawableFactory.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.

Annotations

@Override

getDeviceTried	back to summary
private boolean getDeviceTried(final String connection)

getGammaRamp	back to summary
protected Buffer getGammaRamp(final NativeSurface surface) Overrides jogamp.opengl.GLDrawableFactoryImpl.getGammaRamp. Doc from jogamp.opengl.GLDrawableFactoryImpl.getGammaRamp. Gets the current gamma ramp. This is basically an opaque value used only on some platforms to reset the gamma ramp to its original settings. Parameters surface:NativeSurface TODO Annotations @Override

getGammaRamp

back to summary

protected Buffer getGammaRamp(final NativeSurface surface)

Overrides jogamp.opengl.GLDrawableFactoryImpl.getGammaRamp.

Doc from jogamp.opengl.GLDrawableFactoryImpl.getGammaRamp.

Gets the current gamma ramp. This is basically an opaque value used only on some platforms to reset the gamma ramp to its original settings.

Parameters

surface:NativeSurface: TODO

Annotations

@Override

getGammaRampLength	back to summary
protected int getGammaRampLength(final NativeSurface surface) Overrides jogamp.opengl.GLDrawableFactoryImpl.getGammaRampLength. Returns the length of the computed gamma ramp for this OS and hardware. Returns 0 if gamma changes are not supported. Parameters surface:NativeSurface Doc from jogamp.opengl.GLDrawableFactoryImpl.getGammaRampLength. TODO Annotations @Override

getGammaRampLength

back to summary

protected int getGammaRampLength(final NativeSurface surface)

Overrides jogamp.opengl.GLDrawableFactoryImpl.getGammaRampLength.

Returns the length of the computed gamma ramp for this OS and hardware. Returns 0 if gamma changes are not supported.

Parameters

surface:NativeSurface

Doc from jogamp.opengl.GLDrawableFactoryImpl.getGammaRampLength.

TODO

Annotations

@Override

getGLDynamicLookupHelper back to summary

getGLDynamicLookupHelper	back to summary
public final GLDynamicLookupHelper getGLDynamicLookupHelper(final int majorVersion, final int contextOptions) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.getGLDynamicLookupHelper. Doc from jogamp.opengl.GLDrawableFactoryImpl.getGLDynamicLookupHelper. Returns the GLDynamicLookupHelper if installed, otherwise `null`. Parameters majorVersion:int the major OpenGL profile version contextOptions:int the context profile options Annotations @Override

public final GLDynamicLookupHelper getGLDynamicLookupHelper(final int majorVersion, final int contextOptions)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.getGLDynamicLookupHelper.

Doc from jogamp.opengl.GLDrawableFactoryImpl.getGLDynamicLookupHelper.

Returns the GLDynamicLookupHelper if installed, otherwise null.

Parameters

majorVersion:int: the major OpenGL profile version
contextOptions:int: the context profile options

Annotations

@Override

getIsDeviceCompatible back to summary

getIsDeviceCompatible	back to summary
public final boolean getIsDeviceCompatible(final AbstractGraphicsDevice device) Implements abstract com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible. Parameters device:AbstractGraphicsDevice Doc from com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible. which `connection` denotes the shared the target device, may be `null` for the platform's default device. Returns:boolean Doc from com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible. 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. Annotations @Override

public final boolean getIsDeviceCompatible(final AbstractGraphicsDevice device)

Implements abstract com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible.

Parameters

device:AbstractGraphicsDevice

Doc from com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible.

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

Returns:boolean

Doc from com.jogamp.opengl.GLDrawableFactory.getIsDeviceCompatible.

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.

Annotations

@Override

getOrCreateSharedResourceImpl	back to summary
protected final MacOSXCGLDrawableFactory.SharedResource getOrCreateSharedResourceImpl(final AbstractGraphicsDevice adevice) Implements abstract jogamp.opengl.GLDrawableFactoryImpl.getOrCreateSharedResourceImpl. Annotations @Override

getOrCreateSharedResourceImpl

back to summary

protected final MacOSXCGLDrawableFactory.SharedResource getOrCreateSharedResourceImpl(final AbstractGraphicsDevice adevice)

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.getOrCreateSharedResourceImpl.

Annotations

@Override

getSharedResourceThread	back to summary
protected final Thread getSharedResourceThread() Implements abstract com.jogamp.opengl.GLDrawableFactory.getSharedResourceThread. Doc from com.jogamp.opengl.GLDrawableFactory.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. Annotations @Override

getSharedResourceThread

back to summary

protected final Thread getSharedResourceThread()

Implements abstract com.jogamp.opengl.GLDrawableFactory.getSharedResourceThread.

Doc from com.jogamp.opengl.GLDrawableFactory.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.

Annotations

@Override

hasMajorMinorCreateContextARB back to summary

hasMajorMinorCreateContextARB	back to summary
public final boolean hasMajorMinorCreateContextARB() Implements abstract jogamp.opengl.GLDrawableFactoryImpl.hasMajorMinorCreateContextARB. Doc from jogamp.opengl.GLDrawableFactoryImpl.hasMajorMinorCreateContextARB. Method returns `true` if underlying `ARB context creation` supports `major` and `minor` version number. Otherwise only the `major` version number is supported for context creation. Always returns true. Annotations @Override

public final boolean hasMajorMinorCreateContextARB()

Implements abstract jogamp.opengl.GLDrawableFactoryImpl.hasMajorMinorCreateContextARB.

Doc from jogamp.opengl.GLDrawableFactoryImpl.hasMajorMinorCreateContextARB.

Method returns true if underlying ARB context creation supports major and minor version number.

Otherwise only the major version number is supported for context creation.

Always returns true.

Annotations

@Override

hasOpenGLDesktopSupport back to summary

hasOpenGLDesktopSupport	back to summary
public final boolean hasOpenGLDesktopSupport() Implements abstract com.jogamp.opengl.GLDrawableFactory.hasOpenGLDesktopSupport. Doc from com.jogamp.opengl.GLDrawableFactory.hasOpenGLDesktopSupport. Method returns `true` if underlying implementation may support native desktop OpenGL, otherwise `false`. This factory always supports native desktop OpenGL profiles. Annotations @Override

public final boolean hasOpenGLDesktopSupport()

Implements abstract com.jogamp.opengl.GLDrawableFactory.hasOpenGLDesktopSupport.

Doc from com.jogamp.opengl.GLDrawableFactory.hasOpenGLDesktopSupport.

Method returns true if underlying implementation may support native desktop OpenGL, otherwise false.

This factory always supports native desktop OpenGL profiles.

Annotations

@Override

hasOpenGLESSupport back to summary

hasOpenGLESSupport	back to summary
public final boolean hasOpenGLESSupport() Implements abstract com.jogamp.opengl.GLDrawableFactory.hasOpenGLESSupport. Doc from com.jogamp.opengl.GLDrawableFactory.hasOpenGLESSupport. Method returns `true` if underlying implementation may support native embedded OpenGL ES, otherwise `false`. This factory never supports native GLES profiles. Annotations @Override

public final boolean hasOpenGLESSupport()

Implements abstract com.jogamp.opengl.GLDrawableFactory.hasOpenGLESSupport.

Doc from com.jogamp.opengl.GLDrawableFactory.hasOpenGLESSupport.

Method returns true if underlying implementation may support native embedded OpenGL ES, otherwise false.

This factory never supports native GLES profiles.

Annotations

@Override

isComplete	back to summary
protected final boolean isComplete() Implements abstract com.jogamp.opengl.GLDrawableFactory.isComplete. Doc from com.jogamp.opengl.GLDrawableFactory.isComplete. Returns true if this factory is complete, i.e. ready to be used. Otherwise return false. Annotations @Override

isComplete

back to summary

protected final boolean isComplete()

Implements abstract com.jogamp.opengl.GLDrawableFactory.isComplete.

Doc from com.jogamp.opengl.GLDrawableFactory.isComplete.

Returns true if this factory is complete, i.e. ready to be used. Otherwise return false.

Annotations

@Override

removeDeviceTried	back to summary
private void removeDeviceTried(final String connection)

resetGammaRamp	back to summary
protected void resetGammaRamp(final NativeSurface surface, final Buffer originalGammaRamp) Overrides jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp. Doc from jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp. Resets the gamma ramp, potentially using the specified Buffer as data to restore the original values. Parameters surface:NativeSurface TODO Annotations @Override

resetGammaRamp

back to summary

protected void resetGammaRamp(final NativeSurface surface, final Buffer originalGammaRamp)

Overrides jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp.

Doc from jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp.

Resets the gamma ramp, potentially using the specified Buffer as data to restore the original values.

Parameters

surface:NativeSurface: TODO

Annotations

@Override

resetGammaRamp	back to summary
protected final void resetGammaRamp(final GLDrawableFactoryImpl.DeviceScreenID deviceScreenID, final Buffer originalGammaRamp) Overrides jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp. Annotations @Override

resetGammaRamp

back to summary

protected final void resetGammaRamp(final GLDrawableFactoryImpl.DeviceScreenID deviceScreenID, final Buffer originalGammaRamp)

Overrides jogamp.opengl.GLDrawableFactoryImpl.resetGammaRamp.

Annotations

@Override

setGammaRamp	back to summary
protected boolean setGammaRamp(final NativeSurface surface, final float[] ramp) Overrides jogamp.opengl.GLDrawableFactoryImpl.setGammaRamp. Doc from jogamp.opengl.GLDrawableFactoryImpl.setGammaRamp. Sets the gamma ramp for the main screen. Returns false if gamma ramp changes were not supported. Parameters surface:NativeSurface TODO Annotations @Override

setGammaRamp

back to summary

protected boolean setGammaRamp(final NativeSurface surface, final float[] ramp)

Overrides jogamp.opengl.GLDrawableFactoryImpl.setGammaRamp.

Doc from jogamp.opengl.GLDrawableFactoryImpl.setGammaRamp.

Sets the gamma ramp for the main screen. Returns false if gamma ramp changes were not supported.

Parameters

surface:NativeSurface: TODO

Annotations

@Override

shutdownImpl	back to summary
protected final void shutdownImpl() Implements abstract com.jogamp.opengl.GLDrawableFactory.shutdownImpl. Annotations @Override

shutdownImpl

back to summary

protected final void shutdownImpl()

Implements abstract com.jogamp.opengl.GLDrawableFactory.shutdownImpl.

Annotations

@Override

jogamp.opengl.macosx.cgl back to summary

pack-priv Class MacOSXCGLDrawableFactory.SharedResource

Class Inheritance

extends Object
implements Resource

java.lang.Object
jogamp.opengl.macosx.cgl.MacOSXCGLDrawableFactory.SharedResource

All Implemented Interfaces

jogamp.opengl.SharedResourceRunner.Resource

Field Summary

Modifier and Type	Field and Description
pack-priv MacOSXGraphicsDevice	device
private final GLRendererQuirks	glRendererQuirks
pack-priv boolean	hasAppleFloatPixels
pack-priv boolean	hasNPOTTextures
pack-priv boolean	hasRECTTextures
pack-priv boolean	valid

Constructor Summary

Access	Constructor and Description
pack-priv	SharedResource(final MacOSXGraphicsDevice device, final boolean valid, final boolean hasNPOTTextures, final boolean hasRECTTextures, final boolean hasAppletFloatPixels, final GLRendererQuirks glRendererQuirks)

Method Summary

Modifier and Type	Method and Description
public GLContextImpl	getContext() Implements jogamp.opengl.SharedResourceRunner.Resource.getContext.
public final MacOSXGraphicsDevice	getDevice() Implements jogamp.opengl.SharedResourceRunner.Resource.getDevice.
public final GLDrawableImpl	getDrawable() Implements jogamp.opengl.SharedResourceRunner.Resource.getDrawable.
public GLRendererQuirks	getRendererQuirks(final GLProfile glp) Implements jogamp.opengl.SharedResourceRunner.Resource.getRendererQuirks.
public final AbstractGraphicsScreen	getScreen() Implements jogamp.opengl.SharedResourceRunner.Resource.getScreen.
pack-priv final boolean	isAppleFloatPixelsAvailable()
public final boolean	isAvailable() Implements jogamp.opengl.SharedResourceRunner.Resource.isAvailable.
pack-priv final boolean	isNPOTTextureAvailable()
pack-priv final boolean	isRECTTextureAvailable()

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

Field Detail

device	back to summary
pack-priv MacOSXGraphicsDevice device

glRendererQuirks	back to summary
private final GLRendererQuirks glRendererQuirks

hasAppleFloatPixels	back to summary
pack-priv boolean hasAppleFloatPixels

hasNPOTTextures	back to summary
pack-priv boolean hasNPOTTextures

hasRECTTextures	back to summary
pack-priv boolean hasRECTTextures

valid	back to summary
pack-priv boolean valid

Constructor Detail

SharedResource	back to summary
pack-priv SharedResource(final MacOSXGraphicsDevice device, final boolean valid, final boolean hasNPOTTextures, final boolean hasRECTTextures, final boolean hasAppletFloatPixels, final GLRendererQuirks glRendererQuirks)