Releases: LWJGL/lwjgl3
Releases · LWJGL/lwjgl3
LWJGL 3.1.6
Changes since 3.1.5
:
Bindings
- bgfx: Updated to API version 60 (up from 55)
- glfw: Updated to pre-release 3.3.0 version (up from 3.3.0 pre-release):
- Support for lock key modifiers (
GLFW_LOCK_KEY_MODS
input mode,GLFW_MOD_CAPS_LOCK
,GLFW_MOD_NUM_LOCK
) - Support for string window hints (
glfwWindowHintString
,GLFW_COCOA_FRAME_NAME
,GLFW_X11_CLASS_NAME
,GLFW_X11_INSTANCE_NAME
) - Support monitor & joystick user ponters (
glfwSetMonitorUserPointer
,glfwGetMonitorUserPointer
,glfwSetJoystickUserPointer
,glfwGetJoystickUserPointer
) - Support for window content scale callbacks (
glfwSetWindowContentScaleCallback
) - Support for cursor hover tests (
GLFW_HOVERED
)
- Support for lock key modifiers (
- lz4: Update to 1.8.1 (up from 1.8.0)
- Nuklear: Update to 3.00.2 (up from 2.00.4)
- OpenVR: Updated to 1.0.12 (up from 1.0.10)
- rpmalloc: Updated to 1.2.2 (up from 1.2.0)
- stb
- Updated
stb_dxt
to 1.08b (up from 1.0.7) - Updated
stb_image
to 2.18 (up from 2.16) - Updated
stb_image_write
to 1.08 (up from 1.07)STBIW_ZLIB_COMPRESS
can be overridden at runtime withstbi_zlib_compress
.
- Updated
stb_truetype
to 1.18 (up from 1.17) - Updated
stb_vorbis
to 1.13b (up from 1.11)
- Updated
- tinyfiledialogs: Updated to 3.2.9 (up from 3.2.4)
- Vulkan: Updated to 1.0.68 (up from 1.0.65)
- xxhash: Updated to 0.6.4 (up from 0.6.3)
- Zstd: Updated to 1.3.4 (up from 1.3.2)
- Yoga: Updated to 1.9.0 (up from 1.7.0)
Improvements
- Added JSR-305 nullability annotations to the core and all bindings. (#344)
- Enables static analysis tools (FindBugs, IDEs) to detect accesses that could cause
NullPointerException
. Eliminating those improves the quality of LWJGL applications. - Enables better interopation with JVM-based languages that feature built-in null-safety. For example, see Kotlin's JSR-305 support.
- Enables static analysis tools (FindBugs, IDEs) to detect accesses that could cause
- Added
Configuration
setting to disable function lookup checks. - lmdb: Databases are now binary compatible across 32 & 64-bit architectures. (#364)
MDB_VL32
is enabled on 32-bit builds.
- par_shapes: Patched to support 32-bit indices and extremely dense meshes.
- stb_truetype: Exposed members of internal structures for advanced glyph packing customization. (#358)
- Tootle: Now supports the Direct3D rasterizer for overdraw optimization.
Fixes
- JPMS: A natives module now
requires transitive
the corresponding Java module, instead of the opposite. (#334)- Enables loading shared libraries from non-modular paths/JARs.
- JPMS:
module-info
files have been moved underMETA-INF/version/9/
(#334)- All LWJGL artifacts are now multi-release JAR files to avoid trouble with older tools that are not compatible with Java 9.
- JPMS: Added appropriate
requires static
declarations to satisfy optional binding interop dependencies. (#369) - Fixed broken javadoc links in all bindings. Also updated URLs to avoid redirects.
- bgfx: Restored default API thread encoder functions, that were erroneously removed in
3.1.4
. - LibOVR: Fixed
ovr_TraceMessage
signature. - OpenAL: Fixed capability name of the
AL_SOFT_source_resampler
extension. - Tootle: Fixed
pnClusterRemapOut
parameter validation.
Breaking Changes
- Several methods that previously accepted
null
/NULL
and returnednull
, now require non-null input.- Applies to: struct & callback creation methods and
memByteBuffer
/memUTF8
/stack.UTF8
/etc. - Added corresponding methods with the
Safe
suffix that acceptnull
/NULL
, matching the old behavior. - With this change the common case (non-null input) requires no code changes and is warning/error-free. The uncommon case (null input) is recognizable (the suffix) and must be handled properly to eliminate warnings/errors.
- Applies to: struct & callback creation methods and
- Allocation methods that returned
null
/NULL
on allocation failure, now throwOutOfMemoryError
instead. This matches the behavior ofByteBuffer.allocateDirect
.- Applies to: struct allocation methods and
memAlloc
/memCalloc
/etc. - Does not apply to allocations via direct binding calls (e.g.
LibCStdlib.malloc
).
- Applies to: struct allocation methods and
- Getters of struct members that should never be
NULL
, throwNullPointerException
instead of returningnull
when the struct instance is not initialized.- Use
Struct::isNull
to test pointer members of untrusted struct instances.
- Use
- bgfx: Restored native mapping of
bgfx_init(_vendorId)
andbgfx_update_texture_cube(_side)
parameters. (#368) - bgfx:
uint16_t
bitfield constants are now mapped toint
. (#368) - glfw:
glfwInitHintString
has been renamed toglfwWindowHintString
. - lmdb: Databases developed on 32-bit architectures must be recreated. (#364)
- par_shapes: Changed
par_shapes_mesh::triangles
fromuint16_t/ShortBuffer
touint32_t/IntBuffer
. - stb_rect_pack:
stbrp_rect::was_packed
is now mapped to Javaboolean
.
LWJGL 3.1.5
Changes since 3.1.4
:
Bindings
- Added AMD Tootle bindings.
- Only the software rasterizer is supported.
Fixes
- Fixed various javadoc links.
- par: Parsing of floating point values in L-systems is now locale-insensitive.
- stb: Fixed buffer checks to account for row stride, when specified.
- Generator: Fixed auto-size transformations by non-constant expressions.
Breaking Changes
- Removed array overloads from the LZ4 & ODBC bindings.
- They were added by mistake in LWJGL
3.1.4
.
- They were added by mistake in LWJGL
LWJGL 3.1.4
Changes since 3.1.3
:
Bindings
- Added LZ4 bindings.
- Added NanoSVG to the existing
NanoVG
bindings. - Added ODBC bindings.
- Added Remotery bindings.
- Added Zstandard bindings.
- bgfx: Updated to API version 55 (up from 48)
- glfw: Updated to pre-release 3.3.0 version (up from 3.3.0 pre-release):
- Support for transparent window framebuffers (
GLFW_TRANSPARENT_FRAMEBUFFER
window hint) - Support for whole window opacity (
glfwGetWindowOpacity
andglfwSetWindowOpacity
) - Support for content scale queries (
glfwGetMonitorContentScale
andglfwGetWindowContentScale
) - Linux: Added support for the experimental Wayland backend. Enable with
-Dorg.lwjgl.glfw.libname=glfw_wayland
.
- Support for transparent window framebuffers (
- LibOVR: Updated to 1.20.0 (up from 1.18.0)
- Nuklear: Updated to 2.00.4 (up from 2.00.2)
- tinyfiledialogs: Updated to 3.2.4 (up from 3.0.5)
- Vulkan: Updated to 1.0.65 (up from 1.0.61)
- Yoga: Updated to 1.7.0 (up from 1.6.0)
Improvements
- Replaced
Automatic-Module-Name
with explicit JPMS modules.- Enables applications using LWJGL to be bundled in custom run-time images with the
jlink
tool.
- Enables applications using LWJGL to be bundled in custom run-time images with the
- lmdb: Significantly improved incremental growth performance on Windows.
- Granularity of mapped memory commits increased from
4KB
(page size) to2MB
. - This is an unofficial patch of
ITS#8324
.
- Granularity of mapped memory commits increased from
Fixes
- EGL: Fixed nullability of
eglMakeCurrent
arguments. - OpenVR: Fixed mapping of Vulkan forward declarations.
- Fixed native library resource discovery when running LWJGL as JPMS modules.
- Fixed invalid size calculation in
<StructType>.malloc(capacity)
methods. - Fixed
MemoryStack
debugging when a try-with-resources block does not inline the call toAutoCloseable::close
.- Supports Java 9 try-with-resources, which generates a synthetic
$closeResource
method. - Supports Kotlin's
T.use
, which uses thekotlin.AutoCloseable::closeFinally
extension function.
- Supports Java 9 try-with-resources, which generates a synthetic
- Fixed build number lookup from the jar manifest.
LWJGL 3.1.3
Changes since 3.1.2
:
Bindings
- Added rpmalloc bindings.
- Use
-Dorg.lwjgl.system.allocator=rpmalloc
to make it the default memory allocator.
- Use
- Added new extensions to OpenCL, EGL, OpenGL and OpenGL ES.
- Assimp: Updated to 4.0.1 (up from 3.3.1)
- bgfx: Updated to API version 48 (up from 41)
- EGL: Added support for latest extensions
- glfw: Updated to pre-release 3.3.0 version (up from 3.3.0 pre-release):
- Improvements to error code query (
glfwGetError
) - More library initialization hints (
glfwInitHintString
) - SDL_GameControllerDB support
- Import gamepad mappings (
glfwUpdateGamepadMappings
) - Query to determine whether a joystick has a gamepad mapping (
glfwJoystickIsGamepad
) - Query the name of a controller provided by its gamepad mapping (
glfwGetGamepadName
) - Retrieve gamepad input state (
glfwGetGamepadState
,GLFW_GAMEPAD_*
,GLFWgamepadstate
) - Query the SDL compatible GUID of a joystick (
glfwGetJoystickGUID
)
- Import gamepad mappings (
- Linux: Moved to evdev for joystick input
- EGL: Fixed support for
EGL_KHR_create_context_no_error
- GLX: Added support for
GLX_ARB_create_context_no_error
- WGL: Added support for
WGL_ARB_create_context_no_error
andWGL_EXT_colorspace
- Improvements to error code query (
- jemalloc: Updated to 5.0.1 (up from 4.5.0)
- LibOVR: Updated to 1.18.0 (up from 1.14.0)
- lmdb: Updated to 0.9.21 (up from withdrawn 0.9.20)
- NanoVG: Updated to latest version (performance updates and new
nvgShapeAntiAlias
function). - Nuklear: Updated to 2.00.2 (up from 1.37.0)
- OpenAL: Added
ALC_SOFT_output_limiter
extension. - OpenAL Soft: Updated to 1.18.2 (up from 1.17.2)
- OpenCL: Added support for OpenCL 2.2
- OpenGL: Added support for OpenGL 4.6 and latest extensions
- OpenGL ES: Added support for latest extensions
- OpenVR: Update to 1.0.10 (up from 1.0.7)
- stb
- Updated
stb_dxt
to 1.07 (up from 1.06) - Updated
stb_image
to 2.16 (up from 2.15) - Updated
stb_image_resize
to 0.95 (up from 0.94) - Updated
stb_image_write
to 1.07 (up from 1.05) - Updated
stb_truetype
to 1.17 (up from 1.15) - Updated
stb_vorbis
to 1.11 (up from 1.10)
- Updated
- tinyfiledialogs: Updated to 3.0.5 (up from 2.8.3)
- Vulkan: Updated to 1.0.61 (up from 1.0.49)
- xxhash: Updated to 0.6.3 (up from 0.6.2)
- Yoga: Updated to 1.6.0 (up from 1.5.0)
Improvements
- Generator: Added
@NativeType
annotations to generated bindings. Documents the native type of:- Callback and struct classes.
- Struct members.
- Function parameters and return values.
- The default memory allocator on Windows is now the system allocator instead of jemalloc.
- jemalloc is not properly optimized for Windows and its performance is not competitive.
- jemalloc is still a major performance win on Linux and macOS.
- rpmalloc is faster on all platforms but requires per-thread setup, so must be enabled manually.
- Buffers created via
MemoryUtil
may now have up toInteger.MAX_VALUE
elements, regardless of element size.- For example this allows a
LongBuffer
allocation of up to 16GB.
- For example this allows a
- Added typed overloads to
MemoryUtil::memSet
andMemoryUtil::memCopy
. StructBuffer
subclasses are nowIterable
and havestream()
andparallelStream()
methods.- OpenGL: Added
LongBuffer
overloads to buffer object functions.
Fixes
- bgfx: Fixed signature of
bgfx_create_frame_buffer_from_attachment
. - OpenGL: Fixed signature of
glPixelStoref
. - OpenGL:
ARB_direct_state_access
interactions are now respected when checking if the extension is available. - stb_image: added
ShortBuffer
overload tostbi_image_free
. - stb_truetype: Fixed signature of
stbtt_PackFontRangesGatherRects
andstbtt_PackFontRangesRenderIntoRects
.
Breaking Changes
- glfw: Signature of
glfwGetError
has changed. - jemalloc: Removed
JEmacros
and moved its functionality toJEmalloc
. - jemalloc:
ChunkHooks
has been replaced byExtentHooks
. - OpenCL: Removed two confusing
clCompileProgram
overloads.
LWJGL 3.1.2
Changes since 3.1.1
:
Bindings
- Added OpenVR bindings.
- Added Tiny OpenEXR bindings.
- Added Yoga bindings.
- bgfx: Updated to API version 41 (up from 34)
- glfw: Updated to pre-release 3.3.0 version (up from 3.2.1). Includes many fixes and new features:
- Last error code query (
glfwGetError
) - Requesting attention from the user (
glfwRequestWindowAttention
) - Platform dependent scancodes for keys (
glfwGetKeyScancode
) - Window maximization events (
glfwSetWindowMaximizeCallback
) - Window attribute modification (
glfwSetWindowAttrib
) - Joystick hats (
glfwGetJoystickHats
) - Library initialization hints (
glfwInitHint
) - Headless OSMesa backend
- Cursor centering control (
GLFW_CENTER_CURSOR
) - macOS: Cocoa hints (
GLFW_COCOA_RETINA_FRAMEBUFFER
,GLFW_COCOA_FRAME_AUTOSAVE
,GLFW_COCOA_GRAPHICS_SWITCHING
,GLFW_COCOA_CHDIR_RESOURCES
,GLFW_COCOA_MENUBAR
) - macOS: Vulkan support via MoltenVK
- X11: Moved to XI2
XI_RawMotion
for disabled cursor mode motion input - EGL: Added support for
EGL_KHR_get_all_proc_addresses
andEGL_KHR_context_flush_control
- Last error code query (
- jemalloc: Updated to 4.5.0 (up from 4.4.0)
- LibOVR: Update to 1.14.0 (up from 1.10.0)
- lmdb: Updated to 0.9.20 (up from 0.9.18)
- NanoVG: Added support for fallback fonts.
- nuklear: Updated to 1.37.0 (up from 1.29.1, with the new versioning)
- OpenAL: Added
AL_SOFT_source_resampler
extension. - stb
- Updated
stb_dxt
to 1.0.6 (up from 1.0.4) - Updated
stb_easy_font
to 1.0 (up from 0.7) - Updated
stb_image
to 2.15 (up from 2.13) - Updated
stb_image_resize
to 0.94 (up from 0.91) - Updated
stb_image_write
to 1.05 (up from 1.02) - Updated
stb_perlin
to 0.3 (up from 0.2) - Updated
stb_rect_pack
to 0.11 (up from 0.10) - Updated
stb_truetype
to 1.15 (up from 1.12) - Updated
stb_vorbis
to 1.10 (up from 1.09)
- Updated
- tinyfiledialogs: Updated to 2.8.3 (up from 2.7.2)
- Vulkan: Updated to 1.0.49 (up from 1.0.38)
Improvements
MemoryStack
: Increased default stack size to 64kb (up from 32kb)- Shared library loading can now utilize a
ClassLoader
specified by the caller. (#277) - Significantly reduced
DEBUG_MEMORY_ALLOCATOR
andDEBUG_STACK
overhead in Java 9 using the newStackWalker
API. - Migrated windows builds to appveyor and updated to Visual Studio 2017 (up from 2015)
- EGL: The core API now includes javadoc links to the Khronos references pages
- OpenGL ES: The core API now includes javadoc links to the Khronos references pages
Fixes
- Assimp: Struct member nullability fixes
- Linux: Removed dependencies to newer GLIBC versions.
- LibOVR: Fixed layout of the
ovrInputState
struct. - OpenAL: Removed buffer auto-sizing from
alcCaptureSamples
. The number of samples must now be specified explicitly, similar toalcRenderSamplesSOFT
. - Vulkan: Function addresses are now retrieved only once, using the optimal method for each function type.
- This avoids warnings on pedantic validation layers.
- Fixed callback invocation bugs on 32-bit architectures.
- Fixed various javadoc formatting issues (#308)
Breaking Changes
- Mapped more integer parameters and return values to Java
boolean
, that were missed while working on #181.- Xlib's
Bool
- OpenCL's
cl_bool
- DynCall's
DCbool
- Xlib's
- Moved JNI global reference functions from
MemoryUtil
to the generatedorg.lwjgl.system.jni.JNINativeInterface
. - The Vulkan capabilities have been split into two classes:
VKCapabilitiesInstance
andVKCapabilitiesDevice
.- Flags for core Vulkan versions exist in both classes.
- Flags for instance extensions exist only in
VKCapabilitiesInstance
. - Flags for device extensions exist only in
VKCapabilitiesDevice
. - Functions that dispatch on
VkInstance
orVkPhysicalDevice
exist only inVKCapabilitiesInstance
. - Functions that dispatch on
VkDevice
and device-derived handles exist only inVKCapabilitiesDevice
. - Bootstrapping functions can be retrieved with
VK.getFunctionProvider()
.
LWJGL 3.1.1
Changes since 3.1.0
:
Bindings
- Added Assimp bindings.
- bgfx: Updated to API version 34 (up from 28)
- jemalloc: Updated to version 4.4.0 (up from 4.2.1)
- LibOVR: Updated to version 1.10.0 (up from 1.9.0)
- nuklear: Updated to version 1.191 (up from 1.17)
- Vulkan: Updated to version 1.0.38 (up from 1.0.32)
- stb: Updated stb_image to 2.13 (up from 2.12)
- tinyfiledialogs: Updated to version 2.7.2 (up from 2.6.1)
Improvements
- Refactored function pointer lookups in OpenAL, OpenGL and OpenGL ES.
- Significant reduction in bytecode size (and corresponding JIT code).
- No thread-local lookup in GL and GLES, even with incompatible contexts.
- Removed obsolete thread-local and capabilities state
Configuration
options.
- Linux: All natives are now built with GCC 6.2 (up from 4.8)
- Loader: If
jemalloc
initialization fails andorg.lwjgl.system.allocator
has not been set, a simple warning is now shown instead of an exception. - Structs: Added bound checks to element accessors of array members.
- Generator: Validation is now required for all data pointer parameters. If validation is not possible, such parameters must be marked as potentially unsafe.
- The SHA-1 hash of shared libraries is now included in the corresponding
natives
JAR files. - The upstream git revision used to build shared libraries is now included in the corresponding
natives
JAR files.
Fixes
- Fixed loader diagnostics when
System.loadLibrary
fails. - Fixed setters of struct members with optional AutoSize. (#255)
- Fixed
MemoryUtil.memRealloc
to returnnull
when the allocation fails. - Vulkan: Function pointer loading of disabled extensions is now skipped.
- Generator:
binding.DISABLE_CHECKS
is now respected in structs.
Breaking Changes
- macOS: LWJGL now requires macOS 10.9/Mavericks or later (up from 10.7/Lion)
- A small number of method signatures have changed because of auto-size transformations that were missing in previous releases.
- NanoVG: Text functions with an
end
pointer to the end of the string are now auto-size transformed. Buffers passed to them should not include a null-terminating byte. - Added
LibC
prefix to all class names in thelibc
bindings, to avoid conflicts with standard Java classes (Locale
,String
, etc.) - OpenGL and OpenGL ES now come with native libraries (
lwjgl_opengl
andlwjgl_opengles
respectively). - Removed
MemoryUtil.memSetupBuffer
.
LWJGL 3.1.0
Changes since 3.0.0
:
Bindings
- Bindings have been split into modules and are available as separate artifacts. (#100)
- The download configurator on the website can be used to customize LWJGL builds and Maven/Gradle projects.
- Added LMDB bindings.
- Added Nuklear bindings. (#101)
- Added Tiny File Dialogs bindings.
- Added bgfx bindings. (#240)
- Added support for new EGL, OpenCL, OpenGL, OpenGL ES and Vulkan extensions.
- Updated all bindings to latest versions.
- Vulkan javadoc is now almost identical to the Vulkan man pages, with links to the online Vulkan specification.
Improvements
- Generator: Removed buffer object binding checks. (#197)
- Generator: Added support for mapping
byte/short
parameters toint
. - Generator: Added support for
va_list
parameters. - Generator: Reduced bytecode size of generated methods.
- Generator: The Vulkan bindings are now automatically generated.
- Optimized
strlen
methods used internally by LWJGL. - Optimized misaligned
memSet
andmemCopy
. - Added support for stack allocations with custom alignment.
- Removed allocation functionality from read-only, externally managed structs.
- Improved library loading diagnostics and added
Configuration.DEBUG_LOADER
option. - Libraries extracted by the
SharedLibraryLoader
are now locked to avoid conflicts with other processes (e.g. antivirus software). (#225) - Simplified javadoc of unsafe versions.
Fixes
- Callback instances are now tracked when the
DEBUG_MEMORY_ALLOCATOR
option is enabled. - Fixed
realloc
tracking in the debug allocator. - Shared libraries that ship with LWJGL are now always preferred over system libraries.
- Fixed return type of functions that return pointer to boolean.
- stb_image: Fixed result auto-sizing of
stbi_load*
functions. - Functions that deallocate memory no longer have Java array overloads.
- Fixed
memSet
bugs. - Fixed Java array overload generation for functions with multiple auto-size-result parameters.
- Fixed custom checks in Java array overloads.
- Fixed lookup of Critical JNI natives on Windows x86.
- Disabled Critical JNI natives for functions affected by JDK-8167409 on Linux & MacOS.
Breaking Changes
- xxHash: Added support for stack allocation of streaming hash state. Opaque handles have been replaced by the
XXH*State
structs. - NanoVG: Dropped version suffixes from NanoVGGL classes.
- Mapped more integer parameters and return values to Java booleans, that were missed while working on #181.
- Dropped VKUtil class and moved the version macros to VK10.
LWJGL 3.0.0
Changes since 3.0.0b
:
BINDINGS
- Added support for Java array parameters and HotSpot Critical Natives. (#175)
- Added Vulkanl bindings. (#50)
- Added NanoVG bindings. (#99)
- Added NativeFileDialog bindings.
- Added par_shapes.h bindings.
- Added dyncall bindings.
- Added jawt bindings for AWT/Swing integration. (#125)
- Added simple OS-specific window creation bindings, for custom window/context creation. (#105)
- Added missing OpenCL and OpenAL extensions.
- Fully documented OpenCL and OpenAL.
- Moved WGL and GLX capabilities to the new
WGLCapabilities
andGLXCapabilities
classes, respectively. Functionality in WGL, GLX and corresponding extensions that does not require a current context can now be used without creating a dummy context first. (#171)
IMPROVEMENTS
- Added stack allocation APIs (the
MemoryStack
class and new allocation methods in struct classes andMemoryUtil
). - Made the implementations of
PointerBuffer
andStruct/StructBuffer
subclasses as lightweight as possible. This makes it easier for escape analysis to eliminate allocations. - Minor struct API improvements.
- Added nullability information to struct members, to protect against buggy code crashing the JVM.
- All bindings are updated to the latest versions of the corresponding libraries. Notably, GLFW now has
glfwSetWindowIcon
andglfwSetWindowMonitor
, it now doesn't lack anything compared to LWJGL 2's Display. - Refactored callbacks for Java 8. (#182)
- Added
NativeResource
interface and made freeable objects usable as resources in try-with-resources statements. (#186) - Faster thread-local lookups for the stack and current capabilities. New options in Configuration can be used to complete eliminate thread-local lookup in OpenGL, OpenGL ES and OpenAL, when it is known that only a single context will be used, or that all contexts will be compatible (same capabilities and same function pointers).
- Added
memSlice
for all buffers types inMemoryUtil
. (#179) - Refactored the
Configuration
class for type safety and added more options. - JDK 9 can now be used to build and run LWJGL.
- Javadoc is now generated with JDK 9. The API is fully indexed and search functionality is available. Also made multiple Javadoc formatting improvements.
- Improved debug diagnostics on startup and when loading the LWJGL shared library fails.
- Optimized
memSet
andmemCopy
for small buffers.
FIXES
- Stopped using UPX compression for binaries. This eliminates various integration issues and virus scanning false-positives.
- The
SharedLibraryLoader
now works with any shared library, not only libraries LWJGL knows about. (#176)
BREAKING CHANGES
- LWJGL now requires Java 8 to build and run. Certain custom interfaces have been replaced with
java.util.function
interfaces. (#177) - Dropped support for Linux x86. (#162)
- Dropped libffi bindings.
- Dropped
ALDevice/ALContext
wrappers from OpenAL andCLPlatform/CLDevice
wrappers from OpenCL. (#152) - Dropped the
getInstance()
method from bindings loaded from shared libraries. Function pointers are now stored either in capabilities classes or in a nested Functions inner class. - Dropped infrequently used method overloads in bindings. Full javadoc is now generated on (almost) all overloads.
- Dropped utility classes that were not useful.
- Added AutoSize support to struct members. Instance setters for the corresponding count/size members were removed to avoid bugs and confusion.
- Replaced
MemoryUtil.memFree(StructBuffer)
withStructBuffer.free()
. - Renamed
__ALIGNMENT
toALIGNOF
in struct classes. - Removed
org.lwjgl.system.Retainable
interface.Closure
andFunctionProvider
subclasses are now destroyed using.free()
instead of.release()
. - Moved xxHash and SSE bindings to the
org.lwjgl.util
package. - Integer-boolean native types (0 or 1 are the only legal values) are now mapped to Java booleans. (#181)
- Macros without parameters are now generated as static final values, not methods.
LWJGL 3.0.0b
This build includes the following changes:
- The API is now considered stable. There were several API changes, especially to struct and callback classes.
- Moved advanced functionality from the base package to the system package. Public API in the system package may change between releases.
- Critical methods have been optimized for better performance and garbage elimination.
- JNI methods are now deduplicated and struct layout is calculated in Java. This means much smaller shared libraries.
- Introduced the Configuration class that can be used to programmatically configure LWJGL.
- Introduced explicit memory management API, which is also used internally by LWJGL.
- Introduced a debug allocator that can be enabled for the explicit memory management API. It reports memory leaks with full stack-traces to the leaked allocations.
- All struct classes now have a corresponding StructBuffer implementation. Bindings now use Struct and StructBuffer parameters and return values, instead of ByteBuffer, which improves type safety.
- Struct fields and accessors are now documented.
- Many other fixes and minor features.
Changes to bindings:
- Removed obsolete OS-specific bindings.
- Added bindings to many OpenGL extensions that were missing in 3.0.0a.
- Added bindings to jemalloc.
- Added bindings to EGL.
- Added bindings to OpenGL ES.
- Added bindings to xxHash.
- The bindings to LibOVR were updated to 0.8.0.0 and are now included in the official build.
- Several other fixes and updates to existing bindings.
LWJGL 3.0.0a
The first official release. This build suffers from several bugs and the API is very different from subsequent releases.