Sets the size of arrays cached in thread-local storage to minimize allocations while decoding text.

The memory cost for the cache is up to two arrays per thread that does text decoding. When the text length is up to this value, a cached array will be used. When the text length is longer than this value, a new array buffer will be allocated.

If this option is not set, it defaults to 8192. Setting the value to 0 will disable the array cache.

Property: org.lwjgl.system.arrayTLCSize
   Usage: Static

Similar to LIBRARY_NAME for the Draco library (org.lwjgl.assimp.draco.libname).

Similar to LIBRARY_NAME for the AssImp library (org.lwjgl.assimp.libname).

Similar to LIBRARY_NAME for the BGFX library (org.lwjgl.bgfx.libname).

Sets the mapping algorithm used to resolve the name of bundled shared libraries.

Supported values:

• default - Maps <libname> to <libname>.
• legacy - Maps <libname> to is64bit(arch) ? <libname> : <libname>32.
• <classpath> - A class that implements the Function<String, String> interface. It will be instantiated using reflection.

When set programmatically, it can also be a Function<String, String> instance.

Property: org.lwjgl.system.bundledLibrary.nameMapper
    Type: String or a Function<String, String> instance
   Usage: Static

Sets the mapping algorithm used to resolve bundled shared libraries in the classpath/modulepath.

Supported values:

• default - Maps <libpath> to <arch>/<libpath>.
• legacy - Maps <libpath> to <libpath>.
• <classpath> - A class that implements the Function<String, String> interface. It will be instantiated using reflection.

When set programmatically, it can also be a Function<String, String> instance.

Property: org.lwjgl.system.bundledLibrary.nameMapper
    Type: String or a Function<String, String> instance
   Usage: Static

To enable per-thread synchronization, set this option to true before initializing the CUDA driver.

By default, CUDA uses the legacy default stream. To check if the CUDA driver supports PTDS, call org.lwjgl.cuda.CUDA.isPerThreadDefaultStreamSupported()

Property: org.lwjgl.cuda.ptds
   Usage: Static

Similar to LIBRARY_NAME for the CUDA Driver library – nvcuda (org.lwjgl.cuda.libname).

Similar to LIBRARY_NAME for the CUDA NVRTC Builtins library (org.lwjgl.cuda.nvrtc-builtins.libname).

Similar to LIBRARY_NAME for the CUDA NVRTC library (org.lwjgl.cuda.nvrtc.libname).

This option can be used to load toolkit libraries from a non-standard installation folder.

By default, LWJGL will try to detect CUDA Toolkits in the default installation folder.

Property: org.lwjgl.cuda.toolkit.path
   Usage: Static

This option can be used to force a specific CUDA Toolkit version.

By default, when LWJGL detects multiple CUDA Toolkits, it will use the toolkit with the greatest version.

Property: org.lwjgl.cuda.toolkit.version
   Usage: Static

Set to true to enable LWJGL's debug mode.

Information messages will be printed to the APIUtil#DEBUG_STREAM and extra runtime checks will be performed (some potentially expensive, performance-wise).

Property: org.lwjgl.util.Debug
   Usage: Static

When enabled, a warning message will be output to DEBUG_STREAM when LWJGL fails to retrieve a function pointer.

This option may generate a lot of output and false negatives for functions in unused classes.

This option requires DEBUG to be enabled.

Property: org.lwjgl.util.DebugFunctions
   Usage: Static

When enabled, SharedLibraryLoader exceptions will be printed to the DEBUG_STREAM.

This option requires DEBUG to be enabled.

Property: org.lwjgl.util.DebugLoader
   Usage: Static

Set to true to enable LWJGL's debug mode for the MemoryUtil explicit memory management API (memAlloc/memFree/etc).

All memory allocations through that API will be tracked and leaks will be reported on JVM exit. The memReport methods can also be used.

When this option is enabled, a stacktrace is generated on every allocation, which may negatively impact performance. If this becomes a serious issue, the JVM option -XX:MaxJavaStackTraceDepth=d (where d >= 6) can be used to reduce the overhead.

Property: org.lwjgl.util.DebugAllocator
   Usage: Static

Set to true to skip stacktrace generation on each tracked allocation.

When enabled, this option dramatically reduces the performance overhead of memory leak detection. After a leak is detected, disable this option and rerun the application to get the offending allocation's stacktrace.

This option can also be dynamically toggled on and off, to limit the performance impact in specific portions of the application that are prime suspects for memory leaks.

When reporting memory allocation aggregates, with memReport and the options GROUP_BY_METHOD or GROUP_BY_STACKTRACE, memory allocations without an associated stacktrace will not be included.

Property: org.lwjgl.util.DebugAllocator.fast
   Usage: Dynamic

Set to false to disable tracking of internal memory allocations, in native shared libraries that have been set up to use the LWJGL memory allocator.

If this option is not set, it defaults to true.

Property: org.lwjgl.util.DebugAllocator.internal
   Usage: Static

Set to true to enable LWJGL's debug mode for the MemoryStack.

When using the stack, each frame should be popped in the same method that pushed it. If this symmetry is broken, this mode will report it immediately.

When this option is enabled, a stacktrace is generated on every push or pop to the stack, which may negatively impact performance. If this becomes a serious issue, the JVM option -XX:MaxJavaStackTraceDepth=d (where d >= 5) can be used to reduce the overhead.

Property: org.lwjgl.util.DebugStack
   Usage: Static

Can be set to override the default APIUtil#DEBUG_STREAM.

It must be the name of a class that implements the Supplier<PrintStream> interface. The class will be instantiated using reflection and the result of get will become the #DEBUG_STREAM used by LWJGL.

When set programmatically, it can also be a PrintStream instance.

Property: org.lwjgl.util.DebugStream
    Type: String or a PrintStream instance
   Usage: Static

Set to true to disable LWJGL's basic checks.

These are trivial checks that LWJGL performs to avoid JVM crashes, very useful during development. Their performance impact is usually minimal, but they may be disabled for release builds.

Property: org.lwjgl.util.NoChecks
   Usage: Static

Set to true to disable LWJGL's function lookup checks.

These checks ensure that required functions are not missing from dynamically loaded shared libraries. This setting is useful when a trusted incompatible library must be loaded.

Property: org.lwjgl.util.NoFunctionChecks
   Usage: Dynamic

Set this property to false to disable automatic initialization of the EGL library.

By default, LWJGL will automatically initialize the EGL library when it is first accessed.

Property: org.lwjgl.egl.explicitInit
   Usage: Static

Similar to OPENGL_EXTENSION_FILTER for the EGL library (org.lwjgl.egl.extensionFilter).

Similar to LIBRARY_NAME for the EGL library (org.lwjgl.egl.libname).

EXPERIMENTAL: Emulates System#loadLibrary behavior in Library.loadNative.

Property: org.lwjgl.system.EmulateSystemLoadLibrary
   Usage: Dynamic

Similar to LIBRARY_NAME for the FMOD FSBank library (org.lwjgl.fmod.fsbank.libname).

Similar to LIBRARY_NAME for the FMOD Core library (org.lwjgl.fmod.libname).

Similar to LIBRARY_NAME for the FMOD Studio library (org.lwjgl.fmod.studio.libname).

Similar to LIBRARY_NAME for the FreeType library (org.lwjgl.freetype.libname).

macOS only: Set this property to false to disable first thread detection on glfwInit.

By default, LWJGL will check if glfwInit is called on the first thread of the process. If not, an IllegalStateException will be thrown.

The JVM can be launched with -XstartOnFirstThread to make the main thread the first thread of the process.

Property: org.lwjgl.glfw.checkThread0
   Usage: Dynamic

Similar to LIBRARY_NAME for the GLFW library (org.lwjgl.glfw.libname).

Similar to LIBRARY_NAME for the HarfBuzz library (org.lwjgl.harfbuzz.libname).

The default LWJGL HarfBuzz build does not include FreeType support and the hb_ft_* functions will not be available. However, LWJGL's FreeType build includes HarfBuzz and exports its full API. When working with both HarfBuzz and FreeType, the HarfBuzz bindings can be made to use FreeType's shared library, with one of the following ways:

• launch the JVM with -Dorg.lwjgl.harfbuzz.libname=freetype
• run Configuration.HARFBUZZ_LIBRARY_NAME.set("freetype")
• run Configuration.HARFBUZZ_LIBRARY_NAME.set(FreeType.getLibrary()) - recommended

The org.lwjgl.harfbuzz.natives module is not necessary when enabling the above.

Property: org.lwjgl.harfbuzz.libname
    Type: String or a SharedLibrary instance
   Usage: Dynamic

Similar to LIBRARY_NAME for the hwloc library (org.lwjgl.hwloc.libname).

Similar to LIBRARY_NAME for the jawt library (org.lwjgl.system.jawt.libname).

Similar to LIBRARY_NAME for the jemalloc library (org.lwjgl.system.jemalloc.libname).

Overrides the number of functions in the JNINativeInterface_ struct.

This is only necessary when LWJGL runs on a JVM with a newer, unsupported JNI version, that has introduced new JNI functions. The function count must be accurate in order to use the OpenGL, OpenGL ES, or OpenAL bindings.

The currently known values are:

• 229 for Java 8
• 230 for Java 9 to Java 18
• 231 for Java 19 or higher

Property: org.lwjgl.system.JNINativeInterfaceSize
   Usage: Static

Similar to LIBRARY_NAME for the KTX library (org.lwjgl.ktx.libname).

Can be used to override the LWJGL library name.

It can be an absolute path.

Property: org.lwjgl.libname
   Usage: Dynamic

Takes priority over java.library.path.

It may contain one or more directory paths, separated by File#pathSeparator.

Property: org.lwjgl.librarypath
   Usage: Dynamic

Similar to LIBRARY_NAME for the LLVM/Clang Library (org.lwjgl.llvm.clang.libname).

Similar to LIBRARY_NAME for the LLVM library (org.lwjgl.llvm.libname).

Similar to LIBRARY_NAME for the LLVM/LTO library (org.lwjgl.llvm.clang.libname).

Sets the allocator used for the MemoryUtil explicit memory management API (memAlloc/memFree/etc).

Supported values:

• jemalloc - The allocator provided by the jemalloc library.
• rpmalloc - The allocator provided by the rpmalloc library.
  

  LWJGL calls rpmalloc_initialize once, when the allocator is created. It never calls rpmalloc_finalize. The user is responsible for calling rpmalloc_thread_initialize and rpmalloc_thread_finalize when appropriate.

• system - The default system memory allocator
• <classpath> - A class that implements the MemoryAllocator interface. It will be instantiated using reflection.

When set programmatically, it can also be a MemoryAllocator instance.

Property: org.lwjgl.system.allocator
    Type: String or a MemoryAllocator instance
   Usage: Static

Set to true to enable NativeFileDialog's XDG Desktop Portal backend on Linux.

Property: org.lwjgl.nfd.linux.portal
   Usage: Static

Similar to LIBRARY_NAME for the ODBC library (org.lwjgl.odbc.libname).

Similar to EGL_EXPLICIT_INIT for the OpenAL library (org.lwjgl.openal.explicitInit).

Similar to OPENGL_EXTENSION_FILTER for the OpenAL library (org.lwjgl.openal.extensionFilter).

Similar to LIBRARY_NAME for the OpenAL library (org.lwjgl.openal.libname).

Similar to EGL_EXPLICIT_INIT for the OpenCL library (org.lwjgl.opencl.explicitInit).

Similar to OPENGL_EXTENSION_FILTER for the OpenCL library (org.lwjgl.opencl.extensionFilter).

Similar to LIBRARY_NAME for the OpenCL library (org.lwjgl.opencl.libname).

Similar to EGL_EXPLICIT_INIT for the OpenGL library (org.lwjgl.opengl.explicitInit).

Can be used to disable specific extensions.

This can be useful to ensure that an application behaves correctly with or without an extension. Supported values:

• comma-delimited string - A list of extension names to disable.
• <classpath> - A class that implements the Predicate<String> interface. It will be instantiated using reflection.

When set programmatically, it can also be:

• a List<String> instance - A list of extension names to disable.
• a Predicate<String> instance - A predicate that accepts an extension name and returns true if it should be disabled.

Similar to LIBRARY_NAME for the OpenGL library (org.lwjgl.opengl.libname).

Can be used to limit the maximum available OpenGL version.

This can be useful to ensure that an application has not accidentally used features only available in a higher OpenGL version. When set programmatically, it can also be an APIUtil.APIVersion instance.

Property: org.lwjgl.opengl.maxVersion
    Type: String (M.n) or an APIUtil.APIVersion instance
   Usage: Static

Defines the API that manages OpenGL ES contexts.

Supported values:

• EGL - context management is provided by EGL.
• native - context management is provided by the native platform.
  

If this option is not set, LWJGL will first attempt to use EGL. If EGL is not available, it will attempt to use the native platform API.

Property: org.lwjgl.opengl.contextAPI
    Type: String
   Usage: Dynamic

Similar to EGL_EXPLICIT_INIT for the OpenGL ES library (org.lwjgl.opengles.explicitInit).

Similar to OPENGL_EXTENSION_FILTER for the OpenGL ES library (org.lwjgl.opengles.extensionFilter).

Similar to LIBRARY_NAME for the OpenGL ES library (org.lwjgl.opengles.libname).

Similar to OPENGL_MAXVERSION for the OpenGL ES library (org.lwjgl.opengles.maxVersion).

Similar to LIBRARY_NAME for the OpenVR library (org.lwjgl.openvr.libname).

Similar to EGL_EXPLICIT_INIT for the OpenXR library (org.lwjgl.openxr.explicitInit).

Similar to LIBRARY_NAME for the OpenXR library (org.lwjgl.openxr.libname).

Similar to LIBRARY_NAME for the Opus library (org.lwjgl.opus.libname).

Similar to LIBRARY_NAME for the Shaderc libshaderc library (org.lwjgl.shaderc.libname).

Changes the temporary directory name created by LWJGL when extracting shared libraries from JAR files.

If this option is not set, it defaults to lwjgl_<user name>.

Property: org.lwjgl.system.SharedLibraryExtractDirectory
   Usage: Dynamic

When enabled, shared libraries found as regular files (not inside a JAR file) in the classpath will first be copied to the SHARED_LIBRARY_EXTRACT_PATH, then loaded from there.

Property: org.lwjgl.system.SharedLibraryExtractForce
   Usage: Dynamic

Changes the path where LWJGL extracts shared libraries from JAR files.

If this option is not set, LWJGL will try the following paths and the first successful will be used:

• System.getProperty("java.io.tmpdir")/extractDir/version/arch/
• <working directory>/.extractDir/version/arch/
• System.getProperty("user.home")/.extractDir/version/arch/
• Files.createTempDirectory("lwjgl", "")

extractDir = Configuration.SHARED_LIBRARY_EXTRACT_DIRECTORY
version = Version.getVersion().replace(' ', '-')

Property: org.lwjgl.system.SharedLibraryExtractPath
   Usage: Dynamic

Similar to LIBRARY_NAME for the SPIRV-Cross library (org.lwjgl.spvc.libname).

Sets the stack size, in kilobytes, that will be used in the default MemoryStack constructor.

This value is also used for the LWJGL-managed, thread-local, MemoryStack instances. If this option is not set, it defaults to 64.

Property: org.lwjgl.system.stackSize
   Usage: Static

Similar to EGL_EXPLICIT_INIT for the Vulkan library (org.lwjgl.vulkan.explicitInit).

Similar to LIBRARY_NAME for the Vulkan library (org.lwjgl.vulkan.libname).