|
1 | | -### 3.3.2 |
| 1 | +### 3.3.3 |
2 | 2 |
|
3 | | -_Released 2023 Apr 01_ |
| 3 | +_Released 2023 Sep 16_ |
4 | 4 |
|
5 | 5 | This build includes the following changes: |
6 | 6 |
|
7 | 7 | #### Bindings |
8 | 8 |
|
9 | | -- Added [FMOD](https://www.fmod.com) bindings. (#295) |
10 | | - * Native binaries are not included, because the license does not permit redistribution. They must be downloaded and deployed separately from LWJGL. |
11 | | -- Added [FreeType](https://freetype.org/) bindings. (#611) |
12 | | - * The default build includes HarfBuzz and exports its full API. |
13 | | -- Added [HarfBuzz](https://harfbuzz.github.io/) bindings. (#611) |
14 | | - * The default build works standalone. |
15 | | - * FreeType interop can be enabled by making HarfBuzz use FreeType's shared library (see `Configuration.HARFBUZZ_LIBRARY_NAME`). |
16 | | -- Added [hwloc](https://www.open-mpi.org/projects/hwloc/) bindings. (#98) |
17 | | -- Added [KTX (Khronos Texture)](https://www.khronos.org/ktx/) bindings. (#660) |
18 | | -- Windows: Added bindings to `dpapi.h`. (#851) |
19 | | -- Assimp: Updated to 5.2.5 (up from 5.2.2) |
20 | | - * `KHR_draco_mesh_compression` is now supported via the bundled [Draco](https://github.com/google/draco) library. (#773) |
21 | | -- bgfx: Updated to API version 118 (up from 115) |
22 | | -- CUDA: Updated to 12.1.0 (up from 11.5.0) |
23 | | -- glfw: Updated to latest 3.3.8 (up from 3.3.6) |
24 | | - * Added `GLFW_WAYLAND_LIBDECOR`, `GLFW_WAYLAND_PREFER_LIBDECOR` and `GLFW_WAYLAND_DISABLE_LIBDECOR`. |
25 | | - * Added `GLFW_CURSOR_CAPTURED`. |
26 | | - * Added `GLFW_WAYLAND_APP_ID`. |
27 | | - * Added `GLFW_POSITION_X`, `GLFW_POSITION_Y` and `GLFW_ANY_POSITION`. |
28 | | -- jemalloc: Updated to 5.3.0 (up from 5.2.1) |
29 | | -- libffi: Updated to 3.4.4 (up from 3.4.2) |
30 | | -- liburing: Updated to 2.4-dev (up from 2.1) |
31 | | -- lmdb: Updated to 0.9.30 (up from 0.9.28) |
32 | | -- lz4: Updated to 1.9.4 (up from 1.9.3) |
33 | | -- LLVM/Clang: Updated to 16.0.0 (up from 13.0.1) |
34 | | -- meshoptimizer: Updated to 0.18 (up from 0.17) |
35 | | -- NativeFileDialog: Switched to [Native File Dialog Extended](https://github.com/btzy/nativefiledialog-extended) (#823) |
36 | | - * This is a fork of the original library with new features and breaking API changes. |
37 | | -- Nuklear: Updated to 4.10.5 (up from 4.9.6) |
38 | | - * Added the font baking API. |
39 | | -- OpenAL Soft: Updated to 1.23.0 (up from 1.21.1) |
40 | | - * Added `ALC_SOFT_loopback_bformat` extension. |
41 | | - * Added `ALC_SOFT_output_mode` extension. |
42 | | - * Added `ALC_SOFT_reopen_device` extension. |
43 | | - * Added `AL_SOFT_callback_buffer` extension. |
44 | | - * Added `AL_SOFT_effect_target` extension. |
45 | | - * Added `AL_SOFT_events` extension. (#854) |
46 | | - * Added `AL_SOFT_UHJ` extension. |
47 | | - * Added `AL_SOFTX_hold_on_disconnect` extension. (#795) |
48 | | -- OpenGL(ES): Added latest extensions. |
49 | | - * `GL_EXT_framebuffer_blit_layers` |
50 | | - * `GL_EXT_fragment_shading_rate` |
51 | | - * `GL_EXT_fragment_shading_rate_attachment` |
52 | | - * `GL_EXT_fragment_shading_rate_primitive` |
53 | | - * `GL_EXT_separate_depth_stencil` |
54 | | - * `GL_EXT_shader_samples_identical` |
55 | | -- OpenVR: Updated to 1.23.7 (up from 1.16.8) |
56 | | -- OpenXR: Updated to 1.0.27 (up from 1.0.22) |
57 | | -- Remotery: Updated to 1.2.1 (up from 1.0.0) |
58 | | -- rpmalloc: Updated to 1.4.4 (up from 1.4.3) |
59 | | -- Shaderc: Updated to 2023.3 (up from 2022.1) |
60 | | -- SPIRV-Cross: Updated to 0.51.0 (up from 0.48.0) |
61 | | -- stb |
62 | | - * Updated `stb_image` to 2.28 (up from 2.27) |
63 | | -- tinyexr: Updated to 1.0.2 (up from 1.0.1) |
64 | | -- tinyfiledialogs: Updated to 3.9.0 (up from 3.8.8) |
65 | | -- vma: Updated to 3.0.1 (up from 3.0.0-development) |
66 | | -- Vulkan: Updated to 1.3.246 (up from 1.3.206) |
67 | | - * Includes MoltenVK 1.2.3 (up from 1.1.7) |
68 | | -- Zstd: Updated to 1.5.4 (up from 1.5.2) |
| 9 | +- bgfx: Updated to API version 122 (up from 118) |
| 10 | + * macOS: support for the OpenGL backend has been dropped. |
| 11 | +- EGL: Added latest extensions. |
| 12 | + * `EGL_EXT_gl_colorspace_bt2020_hlg` |
| 13 | +- FMOD: Updated to 2.02.16 (up from 2.02.13) |
| 14 | +- freetype: Updated to 2.13.2 (up from 2.13.0) |
| 15 | +- harfbuzz: Updated to 8.2.0 (up from 7.1.0) |
| 16 | +- hwloc: Updated to 2.9.3 (up from 2.9.0) |
| 17 | +- KTX: Updated to 4.3.0-alpha3 (up from 4.1.0-rc3) |
| 18 | +- liburing: Updated to 2.4 (up from 2.4-dev) |
| 19 | +- lmdb: Updated to 0.9.31 (up from 0.9.30) |
| 20 | +- meshoptimizer: Updated to 0.19 (up from 0.18) |
| 21 | +- NativeFileDialog: Update to 1.1.0 (up from 1.0.2) |
| 22 | + * Added `Configuration.NFD_LINUX_PORTAL` which enables the XDG Desktop Portal backend on Linux. (#893) |
| 23 | +- Nuklear: Updated to 4.10.6 (up from 4.10.5) |
| 24 | +- OpenAL Soft: Updated to 1.23.1 (up from 1.23.0) |
| 25 | + * Added `AL_SOFT_buffer_length_query` extension. |
| 26 | + * Added `AL_SOFT_source_start_delay` extension. |
| 27 | + * Added `AL_SOFT_UHJ_ex` extension. |
| 28 | +- OpenCL: Added latest extensions. |
| 29 | + * `cl_ext_image_from_buffer` |
| 30 | + * `cl_ext_image_requirements_info` |
| 31 | + * `cl_intel_bfloat16_conversions` |
| 32 | + * `cl_intel_split_work_group_barrier` |
| 33 | + * `cl_intel_subgroup_matrix_multiply_accumulate` |
| 34 | + * `cl_intel_subgroup_split_matrix_multiply_accumulate` |
| 35 | +- OpenGL: Added latest extensions. |
| 36 | + * `GL_NV_uniform_buffer_std430_layout` |
| 37 | +- OpenVR: Updated to 1.26.7 (up from 1.23.7) |
| 38 | +- OpenXR: Updated to 1.0.29 (up from 1.0.27) |
| 39 | +- Opus: Updated to 1.4.0 (up from 1.3.1) |
| 40 | +- Shaderc: Updated to 2023.6 (up from 2023.3) |
| 41 | +- SPIRV-Cross: Updated to 0.57.0 (up from 0.51.0) |
| 42 | +- tinyexr: Updated to 1.0.7 (up from 1.0.2) |
| 43 | +- tinyfiledialogs: Updated to 3.13.3 (up from 3.9.0) |
| 44 | +- Vulkan: Updated to 1.3.264 (up from 1.3.246) |
| 45 | + * Includes MoltenVK 1.2.5 (up from 1.2.3) |
| 46 | +- xxhash: Updated to 0.8.2 (up from 0.8.1) |
| 47 | +- Yoga: Updated to 2.0.0 (up from 1.19.0) |
| 48 | +- Zstd: Updated to 1.5.5 (up from 1.5.4) |
69 | 49 |
|
70 | 50 | #### Improvements |
71 | 51 |
|
72 | | -- Linux: x64 shared libraries are now built with GCC 11.2 (up from GCC 7.5) |
73 | | - * The minimum GLIBC version is now 2.17. (down from 2.27) (#842) |
74 | | -- Windows: Shared libraries are now built with Visual Studio 2022 (up from 2019) |
75 | | -- Core: Added support for JDK 19 (#799) |
76 | | -- Core: Added `MemoryUtil::memByteBuffer(Struct)`. It creates a `ByteBuffer` view of a struct value. |
77 | | -- Core: More `SharedLibraryLoader` improvements. (#790) |
78 | | - * The default `Configuration.SHARED_LIBRARY_EXTRACT_DIRECTORY` is now `lwjgl_<trimmed_user_name>`. |
79 | | - * The default `Configuration.SHARED_LIBRARY_EXTRACT_PATH` now includes the CPU architecture. (`<temp_root>/<extract_dir>/<version>/<arch>/`) |
80 | | - * Added `Configuration.SHARED_LIBRARY_EXTRACT_FORCE`. |
81 | | -- Core: The string returned by `Version::getVersion()` now follows the Java version format (`M.m.r+B` or `M.m.r-snapshot+B`). |
82 | | -- Core: Added `Configuration.DEBUG_MEMORY_ALLOCATOR_FAST`, a dynamic option that dramatically reduces the performance overhead of memory leak detection. |
83 | | -- Core: Reduced the performance overhead of `Configuration.DEBUG_STACK`. |
84 | | -- docs: The LWJGL javadoc is now generated with JDK 19 (up from JDK 10) for improved search functionality. |
85 | | -- The `.sha1` and `.git` files, used for validating LWJGL artifacts, are now stored under the `META-INF` folder. |
86 | | -- glfw: It will now always be patched with the latest [SDL_GameControllerDB](https://github.com/gabomdq/SDL_GameControllerDB) version. |
87 | | - * Reminder: `glfwUpdateGamepadMappings` can be used to update the mappings at runtime. |
88 | | -- Nuklear: `NK_BUTTON_TRIGGER_ON_RELEASE` is now also defined on Linux & macOS, not only Windows, for consistency. |
89 | | -- OpenXR: Added extension class javadoc. |
90 | | - * Currently, only the overview section is included. |
91 | | - * Also added a link that opens the OpenXR specification at the corresponding section for the extension. |
92 | | -- Remotery: Made it easier to get started with Remotery profiling: (#784) |
93 | | - * Users can now identify the commit used to build the Remotery bindings in the `Remotery` class javadoc. |
94 | | - * A script that quickly clones the Remotery repository at that commit is also included. |
95 | | - The viewer application at `vis/index.html` is guaranteed to be compatible with the LWJGL bindings. |
96 | | - * Ported two simple Remotery samples (`modules/samples/src/test/java/org/lwjgl/demo/util/remotery/`). |
| 52 | +- Core: LWJGL is now compatible with GraalVM Native Image. (#875) |
97 | 53 |
|
98 | 54 | #### Fixes |
99 | 55 |
|
100 | | -- Core: Fixed Java/native library incompatibility detection. (#737) |
101 | | -- Core: Fixed `dlerror` decoding to use UTF-8. (#738) |
102 | | -- Core: Fixed `Version::getVersion()` when LWJGL is in the module path. (#770) |
103 | | -- Core: Fixed handling of unsigned 8/16-bit integer parameters in JNI code. (#858) |
104 | | -- Core: Many debug messages can no longer tear under concurrency. (#825) |
105 | | -- Build: Fixed offline mode with multiple local architectures. (#740) |
106 | | -- NanoSVG: Fixed auto-sizing of `NSVGPath::pts` buffer. |
107 | | -- OpenCL: Fixed initialization on macOS 13. (#861) |
108 | | -- Opus: Fixed `pcm` parameter type of `opus_decode_float` function. (#785) |
109 | | -- Remotery: Fixed `rmtSettings::free` callback signature. |
110 | | -- stb: Fixed `stb_image_resize` flag values. (#857) |
111 | | -- Vulkan: Fixed definition of the `VK_API_VERSION_PATCH` macro. (#743) |
112 | | -- Vulkan: Fixed `EXT_debug_utils` function dispatch. (#755) |
113 | | - |
114 | | -#### Breaking Changes |
115 | | - |
116 | | -- Core: Introduced additional mangling of `org.lwjgl.system.JNI` method names for 8/16-bit integer parameters. (#858) (S) |
117 | | -- NanoVG: The `freeData` parameters of `nvgCreateFontMem*` functions are now mapped to Java `boolean`. (S) |
118 | | -- NativeFileDialog: Now uses the [btzy/nativefiledialog-extended](https://github.com/btzy/nativefiledialog-extended) API. (S) |
119 | | -- Nuklear: Renamed `NkConvertConfig::null_texture` to `tex_null` to match the change in the native API. (S) |
120 | | - |
121 | | -``` |
122 | | -(B): binary incompatible change |
123 | | -(S): source incompatible change |
124 | | -``` |
125 | | - |
126 | | -#### Known Issues |
127 | | - |
128 | | -- glfw: GLFW added support for libglvnd (https://github.com/NVIDIA/libglvnd) and prioritizes loading `libGLX.so.0` when available over `libGL.so.1`. This may cause failures: |
129 | | - * On context creation (`glfwCreateWindow`) if the host system is misconfigured. Workaround: Call `GLFWNativeGLX.setPath(GL.getFunctionProvider())` before `glfwInit` to force GLFW to load `libGL.so.1` instead. |
130 | | - * On GL bindings initialization (`GL.createCapabilities`) because of incompatibility with `libGL.so.1`, which is the library that LWJGL loads. Workaround: Set `Configuration.OPENGL_LIBRARY_NAME` to `libGLX.so.0` to force LWJGL to load `libGLX.so.0` instead. |
| 56 | +- Core: Java `memset`/`memcpy` implementations no longer touch memory outside the target range. (#892) |
| 57 | +- CUDA: Fixed library name on Linux. (#884) |
| 58 | +- Nuklear: Fixed the result auto-sizing of `nk_font_atlas_bake`. (#903) |
| 59 | +- OpenGL: Added support for [libglvnd](https://github.com/NVIDIA/libglvnd). (#880) |
| 60 | + * LWJGL will now try to load `libGLX.so.0` before `libGL.so.1` on Linux, matching GLFW. |
| 61 | + * Use `Configuration.OPENGL_LIBRARY_NAME` and `GLFWNativeGLX::setPath` to override this behavior. |
0 commit comments