Top Description Fields Constructors Methods
jogamp.opengl.egl

public abstract Class EGLDynamicLibraryBundleInfo

extends GLDynamicLibraryBundleInfo
Class Inheritance
Known Direct Subclasses
jogamp.opengl.egl.EGLES1DynamicLibraryBundleInfo, jogamp.opengl.egl.EGLES2DynamicLibraryBundleInfo, jogamp.opengl.egl.EGLGLnDynamicLibraryBundleInfo
Imports
java.util.ArrayList, .List, jogamp.common.os.PlatformPropsImpl, jogamp.opengl.GLDynamicLibraryBundleInfo, com.jogamp.common.os.AndroidVersion, .Platform, com.jogamp.opengl.egl.EGL
Abstract implementation of the DynamicLookupHelper for EGL, which decouples it's dependencies to EGLDrawable. Currently two implementations exist, one for ES1 and one for ES3 and ES2.

Field Summary

Modifier and TypeField and Description
private static final List<String>
glueLibNames

Constructor Summary

AccessConstructor and Description
protected
EGLDynamicLibraryBundleInfo()

Method Summary

Modifier and TypeMethod and Description
protected final List<String>
getEGLLibNamesList()

public final List<String>
getGlueLibNames()

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.getGlueLibNames.

If a SecurityManager is installed, user needs link permissions for the named libraries.
public final List<String>
getToolGetProcAddressFuncNameList()

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.getToolGetProcAddressFuncNameList.

May return the native libraries 
GetProcAddressFunc
public final boolean
shallLookupGlobal()

Overrides jogamp.opengl.GLDynamicLibraryBundleInfo.shallLookupGlobal.

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.shallLookupGlobal.

Returns true on Android, and false otherwise.
public final long
toolGetProcAddress(final long toolGetProcAddressHandle, final String funcName)

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.toolGetProcAddress.

May implement the lookup function using the Tools facility.
public final boolean
useToolGetProcAdressFirst(final String funcName)

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.useToolGetProcAdressFirst.

Inherited from jogamp.opengl.GLDynamicLibraryBundleInfo:
getLibLoaderExecutorshallLinkGlobal

Field Detail

glueLibNamesback to summary
private static final List<String> glueLibNames

Constructor Detail

EGLDynamicLibraryBundleInfoback to summary
protected EGLDynamicLibraryBundleInfo()

Method Detail

getEGLLibNamesListback to summary
protected final List<String> getEGLLibNamesList()
getGlueLibNamesback to summary
public final List<String> getGlueLibNames()

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.getGlueLibNames.

Doc from com.jogamp.common.os.DynamicLibraryBundleInfo.getGlueLibNames.

If a SecurityManager is installed, user needs link permissions for the named libraries.

Returns:List<String>

a list of Glue library names.

  • GL: [ "nativewindow_x11", "jogl_gl2es12", "jogl_desktop" ]
  • NEWT: [ "nativewindow_x11", "newt" ]
  • Cg: [ "nativewindow_x11", "jogl_cg" ]

Only the last entry is crucial, ie all other are optional preload dependencies and may generate errors, which are ignored.
Annotations
@Override
getToolGetProcAddressFuncNameListback to summary
public final List<String> getToolGetProcAddressFuncNameList()

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.getToolGetProcAddressFuncNameList.

Doc from com.jogamp.common.os.DynamicLibraryBundleInfo.getToolGetProcAddressFuncNameList.

May return the native libraries 

GetProcAddressFunc
names, the first found function is being used.
This could be eg: 
 glXGetProcAddressARB, glXGetProcAddressARB
.
If your Tool does not has this facility, just return null.
Annotations
@Override
shallLookupGlobalback to summary
public final boolean shallLookupGlobal()

Overrides jogamp.opengl.GLDynamicLibraryBundleInfo.shallLookupGlobal.

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.shallLookupGlobal.

Doc from jogamp.opengl.GLDynamicLibraryBundleInfo.shallLookupGlobal.

Returns true on Android, and false otherwise.

If method returns true and if a SecurityManager is installed, user needs link permissions for all libraries, i.e. for new RuntimePermission("loadLibrary.*");!

Returns false.

Returns:boolean

Doc from com.jogamp.common.os.DynamicLibraryBundleInfo.shallLookupGlobal.

true if the dynamic symbol lookup shall happen system wide, over all loaded libraries. Otherwise only the loaded native libraries are used for lookup, which shall be the default.

Annotations
@Override
toolGetProcAddressback to summary
public final long toolGetProcAddress(final long toolGetProcAddressHandle, final String funcName)

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.toolGetProcAddress.

Doc from com.jogamp.common.os.DynamicLibraryBundleInfo.toolGetProcAddress.

May implement the lookup function using the Tools facility.
The actual function pointer is provided to allow proper bootstrapping of the ProcAddressTable, using one of the provided function names by getToolGetProcAddressFuncNameList().

Annotations
@Override
useToolGetProcAdressFirstback to summary
public final boolean useToolGetProcAdressFirst(final String funcName)

Implements com.jogamp.common.os.DynamicLibraryBundleInfo.useToolGetProcAdressFirst.

Returns:boolean

Doc from com.jogamp.common.os.DynamicLibraryBundleInfo.useToolGetProcAdressFirst.

true if toolGetProcAddress(long, String) shall be tried before the system loader for the given function lookup. Otherwise false. Default is true.

Annotations
@Override