org.bytedeco.javacpp

Class Loader

java.lang.Object

org.bytedeco.javacpp.Loader

@Properties(inherit=javacpp.class)
public class Loader
extends java.lang.Object

The Loader contains functionality to load native libraries, but also has a bit of everything that does not fit anywhere else. In addition to its library loading features, it also has utility methods to get the platform name, to load properties from Java resources and from Class annotations, to extract file resources to the temporary directory, and to get the offsetof() or sizeof() a native struct, class, or union with its Pointer peer class and a HashMap initialized by the native libraries inside JNI_OnLoad().

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Loader.Detector

Constructor Summary

Constructors

Constructor and Description
Loader()

Method Summary

Modifier and Type	Method and Description
static Pointer	addressof(java.lang.String symbol) Returns the address found under the given name in the "dynamic symbol tables" (Linux, Mac OS X, etc) or the "export tables" (Windows) of all libraries loaded, or null if not found.
static java.io.File	cacheResource(java.lang.Class cls, java.lang.String name) Extracts a resource using the ClassLoader of the specified Class, and returns the cached File.
static java.io.File	cacheResource(java.lang.String name) Extracts a resource using the ClassLoader of the caller class, and returns the cached File.
static java.io.File	cacheResource(java.net.URL resourceURL) Returns cacheResource(resourceUrl, null)
static java.io.File	cacheResource(java.net.URL resourceURL, java.lang.String target) Extracts a resource, if the size or last modified timestamp differs from what is in cache, and returns the cached File.
static java.io.File[]	cacheResources(java.lang.Class cls, java.lang.String name) Extracts resources using the ClassLoader of the specified Class, and returns the cached File objects.
static java.io.File[]	cacheResources(java.lang.String name) Extracts resources using the ClassLoader of the caller class, and returns the cached File objects.
static boolean	checkPlatform(java.lang.Class<?> cls, java.util.Properties properties)
static boolean	checkPlatform(Platform platform, java.util.Properties properties, java.lang.String... defaultNames)
static boolean	checkVersion(java.lang.String groupId, java.lang.String artifactId) Returns checkVersion(groupId, artifactId, "-", true, getCallerClass(2)).
static boolean	checkVersion(java.lang.String groupId, java.lang.String artifactId, java.lang.String separator, boolean logWarnings, java.lang.Class cls) Returns getVersion(groupId, artifactId, cls).split(separator)[n].equals(getVersion().split(separator)[0]) where n = versions.length - (versions[versions.length - 1].equals("SNAPSHOT") ? 2 : 1) or false on error.
static java.lang.String	createLibraryLink(java.lang.String filename, ClassProperties properties, java.lang.String libnameversion, java.lang.String... paths) Creates a version-less symbolic link to a library file, if needed.
static java.io.File	extractResource(java.lang.Class cls, java.lang.String name, java.io.File directory, java.lang.String prefix, java.lang.String suffix) Extracts by name a resource using the ClassLoader of the specified Class.
static java.io.File	extractResource(java.lang.String name, java.io.File directory, java.lang.String prefix, java.lang.String suffix) Extracts by name a resource using the ClassLoader of the caller.
static java.io.File	extractResource(java.net.URL resourceURL, java.io.File directoryOrFile, java.lang.String prefix, java.lang.String suffix) Returns extractResource(resourceURL, directoryOrFile, prefix, suffix, false).
static java.io.File	extractResource(java.net.URL resourceURL, java.io.File directoryOrFile, java.lang.String prefix, java.lang.String suffix, boolean cacheDirectory) Extracts a resource into the specified directory and with the specified prefix and suffix for the filename.
static java.io.File[]	extractResources(java.lang.Class cls, java.lang.String name, java.io.File directory, java.lang.String prefix, java.lang.String suffix) Extracts by name resources using the ClassLoader of the specified Class.
static java.io.File[]	extractResources(java.lang.String name, java.io.File directory, java.lang.String prefix, java.lang.String suffix) Extracts by name resources using the ClassLoader of the caller.
static java.net.URL[]	findLibrary(java.lang.Class cls, ClassProperties properties, java.lang.String libnameversion) Returns findLibrary(cls, properties, libnameversion, Loader.pathsFirst).
static java.net.URL[]	findLibrary(java.lang.Class cls, ClassProperties properties, java.lang.String libnameversion, boolean pathsFirst) Finds from where the library may be extracted and loaded among the Class resources.
static java.net.URL	findResource(java.lang.Class cls, java.lang.String name) Returns findResources(cls, name, 1)[0] or null if none.
static java.net.URL[]	findResources(java.lang.Class cls, java.lang.String name) Returns findResources(cls, name, -1).
static java.net.URL[]	findResources(java.lang.Class cls, java.lang.String name, int maxLength) Finds by name resources using the Class and its ClassLoader.
static java.io.File	getCacheDir() Creates and returns System.getProperty("org.bytedeco.javacpp.cachedir") or ~/.javacpp/cache/ when not set.
static java.lang.Class	getCallerClass(int i) Returns the Class object that contains a caller's method.
static java.lang.Class	getEnclosingClass(java.lang.Class cls) If annotated with properties, returns the argument as "enclosing Class".
static Pointer	getJavaVM() Returns the JavaVM JNI object, as required by some APIs for initialization.
static java.util.Map<java.lang.String,java.lang.String>	getLoadedLibraries() Returns a Map that relates each library name to the path of the loaded file.
static java.lang.String	getPlatform() Returns either the value of the "org.bytedeco.javacpp.platform" system property, or PLATFORM when the former is not set.
static java.io.File	getTempDir() Creates a unique name for tempDir out of System.getProperty("java.io.tmpdir") and System.nanoTime().
static java.lang.String	getVersion() Returns getVersion("org.bytedeco", "javacpp").
static java.lang.String	getVersion(java.lang.String groupId, java.lang.String artifactId) Returns getVersion(groupId, artifactId, getCallerClass(2)).
static java.lang.String	getVersion(java.lang.String groupId, java.lang.String artifactId, java.lang.Class cls) Returns version property from cls.getResource("META-INF/maven/" + groupId + "/" + artifactId + "/pom.properties").
static boolean	isLoadLibraries() Returns System.getProperty("org.bytedeco.javacpp.loadlibraries").
static java.lang.String	load() Returns load(getCallerClass(2), loadProperties(), Loader.pathsFirst).
static java.lang.String	load(boolean pathsFirst) Loads native libraries associated with the Class of the caller and initializes it.
static java.lang.String[]	load(java.lang.Class... classes) Returns load(classes, true).
static java.lang.String	load(java.lang.Class cls) Returns load(cls, loadProperties(), Loader.pathsFirst).
static java.lang.String[]	load(java.lang.Class[] classes, boolean logMessages) Calls load(Class) on all top-level enclosing classes found in the array.
static java.lang.String	load(java.lang.Class cls, java.util.Properties properties, boolean pathsFirst) Loads native libraries associated with the given Class and initializes it.
static void	loadGlobal(java.lang.String filename) Loads all symbols from a library globally, that is dlopen(filename, RTLD_LAZY | RTLD_GLOBAL), or simply by default with LoadLibrary(filename) on Windows.
static java.lang.String	loadLibrary(java.lang.Class<?> cls, java.lang.String libnameversion, java.lang.String... preloaded) Returns loadLibrary(findResources(cls, libnameversion), libnameversion, preloaded).
static java.lang.String	loadLibrary(java.lang.Class<?> cls, java.net.URL[] urls, java.lang.String libnameversion, java.lang.String... preloaded) Tries to load the library from the URLs in order, extracting resources as necessary.
static java.lang.String	loadLibrary(java.lang.String libnameversion, java.lang.String... preloaded) Returns loadLibrary(getCallerClass(2), libnameversion, preloaded).
static java.lang.String	loadLibrary(java.net.URL[] urls, java.lang.String libnameversion, java.lang.String... preloaded) Returns loadLibrary(null, urls, libnameversion, preloaded).
static java.util.Properties	loadProperties() Loads the Properties associated with the default getPlatform().
static ClassProperties	loadProperties(java.lang.Class[] cls, java.util.Properties properties, boolean inherit) For all the classes, loads all properties from each Class annotations for the given platform.
static ClassProperties	loadProperties(java.lang.Class cls, java.util.Properties properties, boolean inherit) Loads all properties from Class annotations for the given platform.
static java.util.Properties	loadProperties(java.lang.String name, java.lang.String defaults) Loads from resources the default Properties of the specified platform name.
static int	offsetof(java.lang.Class<? extends Pointer> type, java.lang.String member) Gets offsetof() values from memberOffsets filled by native libraries.
static int	sizeof(java.lang.Class<? extends Pointer> type) Gets sizeof() values from memberOffsets filled by native libraries.
static int	totalChips() Returns the number of CPU chips installed according to the operating system, or 0 if unknown.
static int	totalCores() Returns the number of CPU cores usable according to the operating system, or 0 if unknown.
static int	totalProcessors() Returns the number of processors configured according to the operating system, or 0 if unknown.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Loader

public Loader()

Method Detail

getPlatform

public static java.lang.String getPlatform()

Returns either the value of the "org.bytedeco.javacpp.platform" system property, or PLATFORM when the former is not set.

Returns:

System.getProperty("org.bytedeco.javacpp.platform", platform)

See Also:

PLATFORM

loadProperties

public static java.util.Properties loadProperties()

Loads the Properties associated with the default getPlatform().

Returns:

loadProperties(getPlatform(), null)

See Also:

loadProperties(String, String)

loadProperties

public static java.util.Properties loadProperties(java.lang.String name,
                                                  java.lang.String defaults)

Loads from resources the default Properties of the specified platform name. The resource must be at "org/bytedeco/javacpp/properties/" + name + ".properties".

Parameters:

name - the platform name

defaults - the fallback platform name (null == "generic")

Returns:

the Properties from resources

checkVersion

public static boolean checkVersion(java.lang.String groupId,
                                   java.lang.String artifactId)

Returns checkVersion(groupId, artifactId, "-", true, getCallerClass(2)).

checkVersion

public static boolean checkVersion(java.lang.String groupId,
                                   java.lang.String artifactId,
                                   java.lang.String separator,
                                   boolean logWarnings,
                                   java.lang.Class cls)

Returns getVersion(groupId, artifactId, cls).split(separator)[n].equals(getVersion().split(separator)[0]) where n = versions.length - (versions[versions.length - 1].equals("SNAPSHOT") ? 2 : 1) or false on error. Also calls Logger.warn(String) on error when logWarnings && isLoadLibraries().

getVersion

public static java.lang.String getVersion()
                                   throws java.io.IOException

Returns getVersion("org.bytedeco", "javacpp").

Throws:

java.io.IOException

getVersion

public static java.lang.String getVersion(java.lang.String groupId,
                                          java.lang.String artifactId)
                                   throws java.io.IOException

Returns getVersion(groupId, artifactId, getCallerClass(2)).

Throws:

java.io.IOException

getVersion

public static java.lang.String getVersion(java.lang.String groupId,
                                          java.lang.String artifactId,
                                          java.lang.Class cls)
                                   throws java.io.IOException

Returns version property from cls.getResource("META-INF/maven/" + groupId + "/" + artifactId + "/pom.properties").

Throws:

java.io.IOException

getEnclosingClass

public static java.lang.Class getEnclosingClass(java.lang.Class cls)

If annotated with properties, returns the argument as "enclosing Class". If no properties are found on the Class, makes a search for the first Class with properties that we can use, and returns it as the enclosing Class found.

Parameters:

cls - the Class to start the search from

Returns:

the enclosing Class

See Also:

Platform, Properties

loadProperties

public static ClassProperties loadProperties(java.lang.Class[] cls,
                                             java.util.Properties properties,
                                             boolean inherit)

For all the classes, loads all properties from each Class annotations for the given platform.

See Also:

loadProperties(Class, java.util.Properties, boolean)

loadProperties

public static ClassProperties loadProperties(java.lang.Class cls,
                                             java.util.Properties properties,
                                             boolean inherit)

Loads all properties from Class annotations for the given platform. The platform of interest needs to be specified as the value of the "platform" key in the properties argument. It is also possible to indicate whether to load all the classes specified in the Properties.inherit() annotation recursively via the inherit argument.

Parameters:

cls - the Class of which to return Properties

properties - the platform Properties to inherit

inherit - indicates whether or not to inherit properties from other classes

Returns:

all the properties associated with the Class for the given platform

getCallerClass

public static java.lang.Class getCallerClass(int i)

Returns the Class object that contains a caller's method.

Parameters:

i - the offset on the call stack of the method of interest

Returns:

the Class found from the calling context, or null if not found

cacheResource

public static java.io.File cacheResource(java.lang.String name)
                                  throws java.io.IOException

Extracts a resource using the ClassLoader of the caller class, and returns the cached File.

Parameters:

name - the name of the resource passed to Class.getResource(String)

Throws:

java.io.IOException

See Also:

cacheResource(Class, String)

cacheResource

public static java.io.File cacheResource(java.lang.Class cls,
                                         java.lang.String name)
                                  throws java.io.IOException

Extracts a resource using the ClassLoader of the specified Class, and returns the cached File.

Parameters:

cls - the Class from which to load resources

name - the name of the resource passed to Class.getResource(String)

Throws:

java.io.IOException

See Also:

cacheResource(URL)

cacheResources

public static java.io.File[] cacheResources(java.lang.String name)
                                     throws java.io.IOException

Extracts resources using the ClassLoader of the caller class, and returns the cached File objects.

Parameters:

name - of the resources passed to findResources(Class, String)

Throws:

java.io.IOException

See Also:

cacheResources(Class, String)

cacheResources

public static java.io.File[] cacheResources(java.lang.Class cls,
                                            java.lang.String name)
                                     throws java.io.IOException

Extracts resources using the ClassLoader of the specified Class, and returns the cached File objects.

Parameters:

cls - the Class from which to load resources

name - of the resources passed to findResources(Class, String)

Throws:

java.io.IOException

See Also:

cacheResource(URL)

cacheResource

public static java.io.File cacheResource(java.net.URL resourceURL)
                                  throws java.io.IOException

Returns cacheResource(resourceUrl, null)

Throws:

java.io.IOException

cacheResource

public static java.io.File cacheResource(java.net.URL resourceURL,
                                         java.lang.String target)
                                  throws java.io.IOException

Extracts a resource, if the size or last modified timestamp differs from what is in cache, and returns the cached File. If target is not null, creates instead a symbolic link where the resource would have been extracted.

Parameters:

resourceURL - the URL of the resource to extract and cache

target - of the symbolic link to create (must be null to have the resource actually extracted)

Returns:

the File object representing the extracted file from the cache

Throws:

java.io.IOException - if fails to extract resource properly

See Also:

extractResource(URL, File, String, String), cacheDir

extractResource

public static java.io.File extractResource(java.lang.String name,
                                           java.io.File directory,
                                           java.lang.String prefix,
                                           java.lang.String suffix)
                                    throws java.io.IOException

Extracts by name a resource using the ClassLoader of the caller.

Parameters:

name - the name of the resource passed to Class.getResource(String)

Throws:

java.io.IOException

See Also:

extractResource(URL, File, String, String)

extractResource

public static java.io.File extractResource(java.lang.Class cls,
                                           java.lang.String name,
                                           java.io.File directory,
                                           java.lang.String prefix,
                                           java.lang.String suffix)
                                    throws java.io.IOException

Extracts by name a resource using the ClassLoader of the specified Class.

Parameters:

cls - the Class from which to load resources

name - the name of the resource passed to Class.getResource(String)

Throws:

java.io.IOException

See Also:

extractResource(URL, File, String, String)

extractResources

public static java.io.File[] extractResources(java.lang.String name,
                                              java.io.File directory,
                                              java.lang.String prefix,
                                              java.lang.String suffix)
                                       throws java.io.IOException

Extracts by name resources using the ClassLoader of the caller.

Parameters:

name - of the resources passed to findResources(Class, String)

Throws:

java.io.IOException

See Also:

extractResources(Class, String, File, String, String)

extractResources

public static java.io.File[] extractResources(java.lang.Class cls,
                                              java.lang.String name,
                                              java.io.File directory,
                                              java.lang.String prefix,
                                              java.lang.String suffix)
                                       throws java.io.IOException

Extracts by name resources using the ClassLoader of the specified Class.

Parameters:

cls - the Class from which to load resources

name - of the resources passed to findResources(Class, String)

Throws:

java.io.IOException

See Also:

extractResource(URL, File, String, String)

extractResource

public static java.io.File extractResource(java.net.URL resourceURL,
                                           java.io.File directoryOrFile,
                                           java.lang.String prefix,
                                           java.lang.String suffix)
                                    throws java.io.IOException

Returns extractResource(resourceURL, directoryOrFile, prefix, suffix, false).

Throws:

java.io.IOException

extractResource

public static java.io.File extractResource(java.net.URL resourceURL,
                                           java.io.File directoryOrFile,
                                           java.lang.String prefix,
                                           java.lang.String suffix,
                                           boolean cacheDirectory)
                                    throws java.io.IOException

Extracts a resource into the specified directory and with the specified prefix and suffix for the filename. If both prefix and suffix are null, the original filename is used, so directoryOrFile must not be null.

Parameters:

resourceURL - the URL of the resource to extract

directoryOrFile - the output directory or file (null == System.getProperty("java.io.tmpdir"))

prefix - the prefix of the temporary filename to use

suffix - the suffix of the temporary filename to use

cacheDirectory - to extract files from directories only when size or last modified timestamp differs

Returns:

the File object representing the extracted file

Throws:

java.io.IOException - if fails to extract resource properly

findResource

public static java.net.URL findResource(java.lang.Class cls,
                                        java.lang.String name)
                                 throws java.io.IOException

Returns findResources(cls, name, 1)[0] or null if none.

Throws:

java.io.IOException

findResources

public static java.net.URL[] findResources(java.lang.Class cls,
                                           java.lang.String name)
                                    throws java.io.IOException

Returns findResources(cls, name, -1).

Throws:

java.io.IOException

findResources

public static java.net.URL[] findResources(java.lang.Class cls,
                                           java.lang.String name,
                                           int maxLength)
                                    throws java.io.IOException

Finds by name resources using the Class and its ClassLoader. Names not prefixed with '/' are considered in priority relative to the Class, but parent packages, including the default one, also get searched.

Parameters:

cls - the Class from whose ClassLoader to load resources

name - of the resources passed to Class.getResource(String) and ClassLoader.getResources(String)

maxLength - of the array to return, or -1 for no limit

Returns:

URLs to the resources

Throws:

java.io.IOException

getCacheDir

public static java.io.File getCacheDir()
                                throws java.io.IOException

Creates and returns System.getProperty("org.bytedeco.javacpp.cachedir") or ~/.javacpp/cache/ when not set.

Throws:

java.io.IOException

getTempDir

public static java.io.File getTempDir()

Creates a unique name for tempDir out of System.getProperty("java.io.tmpdir") and System.nanoTime().

Returns:

tempDir

getLoadedLibraries

public static java.util.Map<java.lang.String,java.lang.String> getLoadedLibraries()

Returns a Map that relates each library name to the path of the loaded file.

isLoadLibraries

public static boolean isLoadLibraries()

Returns System.getProperty("org.bytedeco.javacpp.loadlibraries"). Flag set by the Builder to tell us not to try to load anything.

checkPlatform

public static boolean checkPlatform(java.lang.Class<?> cls,
                                    java.util.Properties properties)

checkPlatform

public static boolean checkPlatform(Platform platform,
                                    java.util.Properties properties,
                                    java.lang.String... defaultNames)

load

public static java.lang.String[] load(java.lang.Class... classes)

Returns load(classes, true).

load

public static java.lang.String[] load(java.lang.Class[] classes,
                                      boolean logMessages)

Calls load(Class) on all top-level enclosing classes found in the array.

Parameters:

classes - to try to load

logMessages - on load or fail silently

Returns:

filenames from each successful call to load(Class) or null otherwise

load

public static java.lang.String load()

Returns load(getCallerClass(2), loadProperties(), Loader.pathsFirst).

load

public static java.lang.String load(boolean pathsFirst)

Loads native libraries associated with the Class of the caller and initializes it.

Parameters:

pathsFirst - search the paths first before bundled resources

Returns:

load(getCallerClass(2), loadProperties(), pathsFirst)

See Also:

getCallerClass(int), load(Class, Properties, boolean)

load

public static java.lang.String load(java.lang.Class cls)

Returns load(cls, loadProperties(), Loader.pathsFirst).

load

public static java.lang.String load(java.lang.Class cls,
                                    java.util.Properties properties,
                                    boolean pathsFirst)

Loads native libraries associated with the given Class and initializes it.

Parameters:

cls - the Class to get native library information from and to initialize

properties - the platform Properties to inherit

pathsFirst - search the paths first before bundled resources

Returns:

the full path to the main file loaded, or the library name if unknown (but if (!isLoadLibraries() || cls == null) { return null; })

Throws:

java.lang.NoClassDefFoundError - on Class initialization failure

java.lang.UnsatisfiedLinkError - on native library loading failure or when interrupted

See Also:

findLibrary(Class, ClassProperties, String, boolean), loadLibrary(URL[], String, String...)

findLibrary

public static java.net.URL[] findLibrary(java.lang.Class cls,
                                         ClassProperties properties,
                                         java.lang.String libnameversion)

Returns findLibrary(cls, properties, libnameversion, Loader.pathsFirst).

findLibrary

public static java.net.URL[] findLibrary(java.lang.Class cls,
                                         ClassProperties properties,
                                         java.lang.String libnameversion,
                                         boolean pathsFirst)

Finds from where the library may be extracted and loaded among the Class resources. But in case that fails, and depending on the value of pathsFirst, either as a fallback or in priority over bundled resources, also searches the paths found in the "platform.preloadpath" and "platform.linkpath" class properties (as well as the "java.library.path" system property if pathsFirst || !loadLibraries), in that order.

Parameters:

cls - the Class whose package name and ClassLoader are used to extract from resources

properties - contains the directories to scan for if we fail to extract the library from resources

libnameversion - the name of the library + ":" + optional exact path to library + "@" + optional version tag + "#" + a second optional name used at extraction (or empty to prevent it, unless it is a second "#") + "!" to load all symbols globally

pathsFirst - search the paths first before bundled resources

Returns:

URLs that point to potential locations of the library

loadLibrary

public static java.lang.String loadLibrary(java.lang.String libnameversion,
                                           java.lang.String... preloaded)

Returns loadLibrary(getCallerClass(2), libnameversion, preloaded).

loadLibrary

public static java.lang.String loadLibrary(java.lang.Class<?> cls,
                                           java.lang.String libnameversion,
                                           java.lang.String... preloaded)

Returns loadLibrary(findResources(cls, libnameversion), libnameversion, preloaded).

loadLibrary

public static java.lang.String loadLibrary(java.net.URL[] urls,
                                           java.lang.String libnameversion,
                                           java.lang.String... preloaded)

Returns loadLibrary(null, urls, libnameversion, preloaded).

loadLibrary

public static java.lang.String loadLibrary(java.lang.Class<?> cls,
                                           java.net.URL[] urls,
                                           java.lang.String libnameversion,
                                           java.lang.String... preloaded)

Tries to load the library from the URLs in order, extracting resources as necessary. Finally, if all fails, falls back on System.loadLibrary(String).

Parameters:

cls - the Class whose ClassLoader is used to load the library, may be null

urls - the URLs to try loading the library from

libnameversion - the name of the library + ":" + optional exact path to library + "@" + optional version tag + "#" + a second optional name used at extraction (or empty to prevent it, unless it is a second "#") + "!" to load all symbols globally

preloaded - libraries for which to create symbolic links in same cache directory

Returns:

the full path of the file loaded, or the library name if unknown (but if (!isLoadLibraries) { return null; })

Throws:

java.lang.UnsatisfiedLinkError - on failure or when interrupted

createLibraryLink

public static java.lang.String createLibraryLink(java.lang.String filename,
                                                 ClassProperties properties,
                                                 java.lang.String libnameversion,
                                                 java.lang.String... paths)

Creates a version-less symbolic link to a library file, if needed. Also creates symbolic links in given paths, with and without version.

Parameters:

filename - of the probably versioned library

properties - of the class associated with the library

libnameversion - the library name and version as with loadLibrary(URL[], String, String...) (can be null)

paths - where to create links, in addition to the parent directory of filename

Returns:

the version-less filename (or null on failure), a symbolic link only if needed

offsetof

public static int offsetof(java.lang.Class<? extends Pointer> type,
                           java.lang.String member)

Gets offsetof() values from memberOffsets filled by native libraries.

Parameters:

type - the peer Class acting as interface to the native type

member - the name of the native member variable

Returns:

memberOffsets.get(type).get(member)

sizeof

public static int sizeof(java.lang.Class<? extends Pointer> type)

Gets sizeof() values from memberOffsets filled by native libraries.

Parameters:

type - the peer Class acting as interface to the native type

Returns:

memberOffsets.get(type).get("sizeof")

totalProcessors

@Name(value="JavaCPP_totalProcessors")
public static int totalProcessors()

Returns the number of processors configured according to the operating system, or 0 if unknown. This value can be greater than Runtime.availableProcessors() and totalCores().

totalCores

@Name(value="JavaCPP_totalCores")
public static int totalCores()

Returns the number of CPU cores usable according to the operating system, or 0 if unknown. For SMT-capable systems, this value may be less than totalProcessors().

totalChips

@Name(value="JavaCPP_totalChips")
public static int totalChips()

Returns the number of CPU chips installed according to the operating system, or 0 if unknown. For multi-core processors, this value may be less than totalCores().

addressof

@Name(value="JavaCPP_addressof")
public static Pointer addressof(java.lang.String symbol)

Returns the address found under the given name in the "dynamic symbol tables" (Linux, Mac OS X, etc) or the "export tables" (Windows) of all libraries loaded, or null if not found.

loadGlobal

@Name(value="JavaCPP_loadGlobal")
 @Raw(withEnv=true)
public static void loadGlobal(java.lang.String filename)

Loads all symbols from a library globally, that is dlopen(filename, RTLD_LAZY | RTLD_GLOBAL), or simply by default with LoadLibrary(filename) on Windows. If the library name passed to one of the other load functions in this class ends with "!", this function will get called on them.

getJavaVM

@Name(value="JavaCPP_getJavaVM")
 @Cast(value="JavaVM*")
public static Pointer getJavaVM()

Returns the JavaVM JNI object, as required by some APIs for initialization.