What's Changed

• Change pointers casting type by @SpaiR in https://github.com/SpaiR/imgui-java/pull/265
• Image methods now accept the long type instead of int by @SpaiR in https://github.com/SpaiR/imgui-java/pull/265
• Fix missing bindings for TreePush and InputScalar by @SpaiR in https://github.com/SpaiR/imgui-java/pull/268

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.87.3...v1.87.4

What's Changed

• ArgVariant annotation for binding gen and plot* methods with count parameter for ImPlot extension in https://github.com/SpaiR/imgui-java/pull/264 (resolves #261)

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.87.2...v1.87.3

Regression

• Minor improvements and fixes for binding generation https://github.com/SpaiR/imgui-java/pull/263

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.87.1...v1.87.2

Regression

• fix: return methods lost during integration of binding generation API: https://github.com/SpaiR/imgui-java/commit/8f76b2083fed4aaf6d6870d3b499da78c27ded49

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.87.0...v1.87.1

What's Changed 🚀

Dear ImGui v1.87 + ImPlot v0.13

As part of PR #252, the versions of the main Dear ImGui module and the ImPlot extension have been upgraded. Initially, there was no plan to update the extension, but this became necessary due to compatibility issues.

It's important to note that both updates significantly change the way you interact with them. Therefore, it is HIGHLY recommended to review the corresponding release notes: Dear ImGui v1.87 and ImPlot v0.13.

Backend Refactor for GLFW and OpenGL

Since updating Dear ImGui required changes to the backend code, a refactor was carried out on the ImGuiImplGlfw and ImGuiImplGl3 classes. In addition to ensuring compatibility with the updated API, their code was aligned as closely as possible with the original code, within the constraints of the language. Which should make it easier to maintain these classes in the future.

As a small bonus, visibility modifiers have been revised. Now, all methods, except for the most internal ones, can be overridden. This should reduce the complexity of creating custom backends.

API for Binding Generation

This is the first release made using the new API for binding generation. You can read more about it here: #240. From a user perspective, these changes should have minimal impact. In some areas, there are now more ways to interact with native methods, but overall, everything should remain more or less the same. This is definitely not the final version, and currently, there is a lack of documentation on how to interact with the API. These are issues that will be addressed in the future. If you encounter any problems, such as missing methods that were previously available or the absence of certain flags, please report them in the issue tracker.

Optional FreeType

In the previous release, FreeType became part of the compiled library, and was enabled by default. It was noted in #244 that this default renderer appears slightly worse on macOS. This highlighted the need to toggle this renderer on and off. More details can be found in PR #254.

Migration Guide 📚

• See New IO keyboard/mouse/gamepad event API (1.87) recap to undestand changes in Dear ImGui API. Basically, you can replace all usages of GLFW keyboard constants with appropriate ImGui versions.
• Use ImGui.getIO().getFonts().setFreeTypeRenderer(true); to enable FreeType renderer. STB_TrueType will be used by default.

List of changes 📝

Major

• Binding Generator API by @SpaiR in https://github.com/SpaiR/imgui-java/pull/240
• Add missing ImGui.TableGetSortSpecs API (and related objects) by @ultraq in https://github.com/SpaiR/imgui-java/pull/246
• Dear ImGui 1.87 by @SpaiR in https://github.com/SpaiR/imgui-java/pull/252
• FreeType is a toggleable option which is disabled by default by @SpaiR in https://github.com/SpaiR/imgui-java/pull/254

Minor

• Refactor GenerateAst task by @SpaiR in https://github.com/SpaiR/imgui-java/pull/243
• Ast generator stores more info by @SpaiR in https://github.com/SpaiR/imgui-java/pull/245
• Add setup-gradle action by @SpaiR in https://github.com/SpaiR/imgui-java/pull/255

Major

• Dear ImGui from 1.86 to 1.87
• ImPlot from 0.12 to 0.13

Minor

• build(deps): bump com.gradleup.shadow from 7.1.2 to 8.3.0 by @SpaiR in https://github.com/SpaiR/imgui-java/pull/241
• build(deps): bump com.badlogicgames.gdx:gdx-jnigen from 2.4.0 to 2.5.1 by @SpaiR in https://github.com/SpaiR/imgui-java/pull/242

New Contributors 🎉

• @ultraq made their first contribution in https://github.com/SpaiR/imgui-java/pull/246

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.12...v1.87.0

What's Changed 🚀

Overview

This release adds support for the ARM64 architecture on macOS and includes FreeType integration by default. It also introduces a new extension for imgui-knobs (#211) and updates LWJGL to 3.3.4.

As a minor update, the project has moved to the MIT license. While Apache 2 is quite permissive, this is mostly my personal preference for a shorter licensing text.

Initial support was introduced in PRs #111, #112, #136, #190, and #223. The final PR has been merged.
Thanks to the author @rexfleischer and co-authors @Tom-Ski and @zly2006, whose PRs contributed to these changes. 🙏

In a subsequent PR #239, I refined the solution into its final version, which is included in this release.

As a result, the dylib built for the release is universal and can be used on both x86_64 and arm64 architectures. No additional actions or changes to dependencies are required from the user.

For more information, see the article on FreeType.

Initially, the binding provided two versions of the native part for the three main OSes. One was built with FreeType included, and the other without. The latter was primarily recommended, as the FreeType version required the library to be installed on the user's system (relevant only for Unix users). Starting with this release, FreeType is statically compiled into the native part of the library. Thus, there is no longer a need to install the library on the user's system.

In terms of impact, you will notice an overall improvement in font quality across all platforms. Additionally, you can start using the ImGuiFreeTypeBuilderFlags for your purposes. (And colorful glyphs, yep 🍰). l No additional actions are required, as FreeType will be included by default.

Since there is no longer a need to maintain separate libraries without FreeType, the corresponding files have been removed from the bin folder and excluded from release artifacts.

Migration Guide 📚

• If you had any workarounds for non-functional macOS ARM64 applications, you can remove them and use the native JDK for the platform.
• If you were using native modules with the -ft suffix when integrating the library, you need to remove the suffix. In the new release, a separate module for the FreeType version is not provided, as it is included in the default module.

List of changes 📝

• Added bindings for imgui-knobs by @1312Delta in https://github.com/SpaiR/imgui-java/pull/211
• MacOS ARM64 native binaries by @rexfleischer in https://github.com/SpaiR/imgui-java/pull/223
• Universal macOS ARM64 binary and statically compiled FreeType by @SpaiR https://github.com/SpaiR/imgui-java/pull/239

Major

• build(deps): bump org.lwjgl:lwjgl-bom from 3.3.3 to 3.3.4

Minor

• build(deps): bump org.junit.jupiter:junit-jupiter-engine from 5.10.0 to 5.10.3
• build(deps): bump org.junit.jupiter:junit-jupiter-api from 5.10.0 to 5.10.3
• build(deps): bump actions/checkout from 3 to 4
• build(deps): bump actions/setup-java from 3 to 4
• build(deps): bump softprops/action-gh-release from 1 to 2

New Contributors 🎉

• @1312Delta made their first contribution in https://github.com/SpaiR/imgui-java/pull/211
• @rexfleischer made their first contribution in https://github.com/SpaiR/imgui-java/pull/223

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.11...v1.86.12

What's Changed

• Fix glyph range size by @kusaanko in https://github.com/SpaiR/imgui-java/pull/196
• Fix native libraries loading by stopping of creating tmpDir every time by @kusaanko in https://github.com/SpaiR/imgui-java/pull/197
  This effectively resolves the problem, when the binding created a lot of unneeded files in the temporal folder on every library usage.
• Move LICENSE into META-INF folder by @SpaiR in https://github.com/SpaiR/imgui-java/pull/203
• Add missing import in example in readme by @Trolobezka in https://github.com/SpaiR/imgui-java/pull/186
• Bump org.lwjgl:lwjgl from 3.3.1 to 3.3.2 by @dependabot in https://github.com/SpaiR/imgui-java/pull/175
• Bump org.lwjgl:lwjgl from 3.3.2 to 3.3.3 by @SpaiR in https://github.com/SpaiR/imgui-java/pull/205

New Contributors

• @Trolobezka made their first contribution in https://github.com/SpaiR/imgui-java/pull/186
• @kusaanko made their first contribution in https://github.com/SpaiR/imgui-java/pull/196

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.10...v1.86.11

What's Changed

• Added missing ImNodes bindings by @brunopj1 in https://github.com/SpaiR/imgui-java/pull/167

New Contributors

• @brunopj1 made their first contribution in https://github.com/SpaiR/imgui-java/pull/167

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.9...v1.86.10

What's Changed

• Added ability to set inputBuffer in ImGuiTextFilter in 4a5c587

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.8...v1.86.9

What's Changed

• Added inputTextWithHint with ability to use callback by @Boginsky in https://github.com/SpaiR/imgui-java/pull/159
• Make all imgui.type classes to implement Comparable<> interface in 25fc8bae8f6c5b358b0b554123637ba4097ebaa3
• Make classes from imgui.type which are represent numbers to extend Number class in d8f8f41a763b068e29d61d39527c0b2c562c8e64
• Fix inputText with resizable ImString crashes if the ImGuiInputTextCallback is null in bf92f04c2104f72219de6d2fd0bfa7f1dd50ffcd (Fixes #158)

New Contributors

• @Boginsky made their first contribution in https://github.com/SpaiR/imgui-java/pull/159

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.7...v1.86.8

What's Changed

• Fix nHasDragDropPayload SIGSEGV when payload doesn't exist by @Moulberry in https://github.com/SpaiR/imgui-java/pull/155
• Added callback binding for InputText by @moheng233 in https://github.com/SpaiR/imgui-java/pull/156

New Contributors

• @Moulberry made their first contribution in https://github.com/SpaiR/imgui-java/pull/155
• @moheng233 made their first contribution in https://github.com/SpaiR/imgui-java/pull/156

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.6...v1.86.7

What's Changed

• Added missing ImNodes::EditorContextGetPanning by @virusbear in https://github.com/SpaiR/imgui-java/pull/152
• Fixed missing Nexus natives for Windows/macOS in https://github.com/SpaiR/imgui-java/commit/cb381e9521c5c1ee6d47d9dd5134ade0f24fc23f https://github.com/SpaiR/imgui-java/commit/09da8c4aaebb2d262dbc122057e64d23a313136f

New Contributors

• @virusbear made their first contribution in https://github.com/SpaiR/imgui-java/pull/152

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.5...v1.86.6

Maintenance Release

This is mostly a maintenance release to target CI problems and add minor tweaks and fixes.

CI was refactored and simplified. Now it became much easier to push new releases.
From the user perspective - all release artefacts are now located in zip files.

• java-libraries.zip - contains all jars with sources and javadocs;
• native-libraries.zip - contains all native libraries required for ImGui Java binding;
• native-libraries-with-freetype.zip - same as native-libraries.zip, but libraries are built to use with FreeType font renderer.

What's Changed

• Added example of Canvas Editor by @davidalmarinho in https://github.com/SpaiR/imgui-java/pull/126
• Fixed calcTextSize to be used in a static context by @davfsa in https://github.com/SpaiR/imgui-java/pull/143
• Added GLFW callback freeing by @theVerySharpFlat in https://github.com/SpaiR/imgui-java/pull/146
• Fixed invalid setNextPlotFormatY in https://github.com/SpaiR/imgui-java/commit/142e3129719349409ea1fe59c807c954a88b8642
• Added convenient methods to ImColor helper in https://github.com/SpaiR/imgui-java/commit/ff9b88ddbbfbd936e55150e3119da4af8eb0edaf
• Fixed dependency tree issue for imgui-java-app in https://github.com/SpaiR/imgui-java/commit/8a560ca4398cf7865c084b1ceec9bdbad9e29f17
• Added arithmetic operations to ImVec2 and ImVec4 in https://github.com/SpaiR/imgui-java/commit/47baed3b42195ef966a6d864a8cd6490f47c04a9

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.4...v1.86.5

New Contributors

• @davidalmarinho made their first contribution in https://github.com/SpaiR/imgui-java/pull/126
• @davfsa made their first contribution in https://github.com/SpaiR/imgui-java/pull/143
• @theVerySharpFlat made their first contribution in https://github.com/SpaiR/imgui-java/pull/146

Future Plans

To justify, why there is no major updates in binding, like updating to the latest Dear ImGui version, it's required to say about future plans:

• Binding Generation API - there is a PR https://github.com/SpaiR/imgui-java/pull/132, which presents a new way of binding creation. Instead of writing everything manually, there will be a declarative API to generate almost everything. Generator will be integrated with cimgui. When the API will come, updating process will be drastically improved.
• Decouple Extensions - ImGui Java has a lot of extensions to use. The problem here is that all of those extensions are hardcoded into one binding bundle. There is a point to decouple extensions and make them fully optional to use. First of all, that decision will result in reducing of the library size.

After those things - yeah, ImGui Java and all of its extensions will be updated to the latest versions for sure. 😊

What's Changed

• Adjust module name depending on deploy type by @tmvkrpxl0 in https://github.com/SpaiR/imgui-java/pull/122

New Contributors

• @tmvkrpxl0 made their first contribution in https://github.com/SpaiR/imgui-java/pull/122

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.3...v1.86.4

• 3cd0eeb - [Build] Adjust module name depending on deploy type (#122)
• 67b23dd - [Doc] Update README about automatic module names

What's Changed

• Update lwjgl from 3.3.0 to 3.3.1 by @Illithidek in https://github.com/SpaiR/imgui-java/pull/116
• ImPlot Performance Improvement by @calvertdw in https://github.com/SpaiR/imgui-java/pull/115
• Repository documentation by @SpaiR in https://github.com/SpaiR/imgui-java/pull/117

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.2...v1.86.3

• a6ca631 - [Build] Add more logs to the release script
• 57cb0c9 - [API] Update lwjgl from 3.3.0 to 3.3.1 (#116)
• bfbe56c - [API] ImPlot Performance Improvement (#115)
• cca6c47 - [Doc] Repository documentation (#117)

What's Changed

• Memory editor extension by @tlf30 in https://github.com/SpaiR/imgui-java/pull/110

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.1...v1.86.2

• fefac80 - [API] Memory editor extension (#110)

What's Changed

• Fixed typo in lwjgl opengl3 backendRenderName string by @rmarquis in https://github.com/SpaiR/imgui-java/pull/103
• Automatic Module Names by @tlf30 in https://github.com/SpaiR/imgui-java/pull/105

New Contributors

• @rmarquis made their first contribution in https://github.com/SpaiR/imgui-java/pull/103

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.86.0...v1.86.1

• 6f48a70 - [API] Fixed typo in lwjgl opengl3 backendRenderName string (#103)
• 8c1ef20 - [API] Automatic Module Names (#105)

Dear ImGui v1.86

Consider reading the official changelog to see other Dear ImGui changes.

What's Changed

• [API] Add a mechanism for Dear ImGui assertion callbacks by @tlf30 in https://github.com/SpaiR/imgui-java/pull/100
• [Build] Gradle 7.3.3 by @SpaiR in https://github.com/SpaiR/imgui-java/pull/101
• [API] Dear ImGui v1.86 by @SpaiR in https://github.com/SpaiR/imgui-java/pull/102

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.85.1...v1.86.0

• adf9d5f - [Build] Update publish scripts
• 74203bc - [API] Add a mechanism for Dear ImGui assertion callbacks (#100)
• dcf0dea - [Build] Gradle 7.3.3 (#101)
• e972af8 - [API] Dear ImGui v1.86 (#102)
• 384e24a - [API] Up OpenGL impl
• 0c37ac6 - [API] Up GLFW impl

What's Changed

• [API] Update imnodes with minimap support by @Tyruiop in https://github.com/SpaiR/imgui-java/pull/87
• [API] Allow for null passed as file filter for ImGuiFileDialog by @tlf30 in https://github.com/SpaiR/imgui-java/pull/98

New Contributors

• @Tyruiop made their first contribution in https://github.com/SpaiR/imgui-java/pull/87

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.85.0...v1.85.1

• a78f0b9 - [API] Update imnodes with minimap support (#87)
• 45f625a - [API] Allow for null passed as file filter for ImGuiFileDialog (#98)
• f47d44e - [API] Update lwjgl from 3.2.3 to 3.3.0 (#96)

Dear ImGui v1.85

Consider reading the official changelog to see other Dear ImGui changes.

What's Changed

• Bindings for ImGuiColorTextEdit 🙂 by @SocketByte in https://github.com/SpaiR/imgui-java/pull/79
• Implemented binding for ImGui::getWindowScrollbarRect by @AlTsayun in https://github.com/SpaiR/imgui-java/pull/81
• Added multi Y plotShaded by @tlf30 in https://github.com/SpaiR/imgui-java/pull/84
• Initial setup for ImGuiFileDialog extension by @tlf30 in https://github.com/SpaiR/imgui-java/pull/89
• Update readme for ImGuiFileDialog by @tlf30 in https://github.com/SpaiR/imgui-java/pull/90

New Contributors

• @SocketByte made their first contribution in https://github.com/SpaiR/imgui-java/pull/79
• @AlTsayun made their first contribution in https://github.com/SpaiR/imgui-java/pull/81
• @tlf30 made their first contribution in https://github.com/SpaiR/imgui-java/pull/84

Full Changelog: https://github.com/SpaiR/imgui-java/compare/v1.84.1.0...v1.85.0