From ed7bf3601a44f92bef4b9c5292f7fe03007c76e6 Mon Sep 17 00:00:00 2001
From: SpaiR <klimbetoo@gmail.com>
Date: Sat, 16 May 2020 17:22:19 +0300
Subject: [PATCH] Update binding API to Dear ImGui v1.76

---
 .../src/main/java/imgui/ImFontGlyph.java      | 26 +++++-
 imgui-binding/src/main/java/imgui/ImGui.java  | 81 +++++++++++--------
 .../src/main/java/imgui/ImGuiIO.java          | 57 ++++++++-----
 .../src/main/java/imgui/ImGuiStyle.java       |  6 +-
 imgui-binding/src/main/java/imgui/ImVec2.java |  3 +
 imgui-binding/src/main/java/imgui/ImVec4.java |  3 +
 .../java/imgui/enums/ImGuiColorEditFlags.java |  4 +
 .../java/imgui/enums/ImGuiFocusedFlags.java   |  2 +-
 .../java/imgui/enums/ImGuiHoveredFlags.java   |  4 +-
 .../java/imgui/enums/ImGuiKeyModFlags.java    | 15 ++++
 .../main/java/imgui/enums/ImGuiStyleVar.java  |  8 +-
 .../src/test/java/ImGuiGlfwExample.java       |  2 +-
 12 files changed, 143 insertions(+), 68 deletions(-)
 create mode 100644 imgui-binding/src/main/java/imgui/enums/ImGuiKeyModFlags.java

diff --git a/imgui-binding/src/main/java/imgui/ImFontGlyph.java b/imgui-binding/src/main/java/imgui/ImFontGlyph.java
index 9bd0a48..f791f86 100644
--- a/imgui-binding/src/main/java/imgui/ImFontGlyph.java
+++ b/imgui-binding/src/main/java/imgui/ImFontGlyph.java
@@ -1,5 +1,9 @@
 package imgui;
 
+/**
+ * Hold rendering data for one glyph.
+ * (Note: some language parsers may fail to convert the 31+1 bitfield members, in this case maybe drop store a single u32 or we can rework this)
+ */
 public final class ImFontGlyph implements ImDestroyable {
     final long ptr;
 
@@ -48,15 +52,29 @@ public final class ImFontGlyph implements ImDestroyable {
     /**
      * 0x0000..0xFFFF
      */
-    public native short getCodepoint(); /*
-        return (short)IM_FONT_GLYPH->Codepoint;
+    public native int getCodepoint(); /*
+        return (unsigned int)IM_FONT_GLYPH->Codepoint;
     */
 
     /**
      * 0x0000..0xFFFF
      */
-    public native void setCodepoint(short codepoint); /*
-        IM_FONT_GLYPH->Codepoint = (ImWchar)codepoint;
+    public native void setCodepoint(int codepoint); /*
+        IM_FONT_GLYPH->Codepoint = (unsigned int)codepoint;
+    */
+
+    /**
+     * Flag to allow early out when rendering
+     */
+    public native int getVisible(); /*
+        return (unsigned int)IM_FONT_GLYPH->Visible;
+    */
+
+    /**
+     * Flag to allow early out when rendering
+     */
+    public native void setVisible(int visible); /*
+        IM_FONT_GLYPH->Visible = (unsigned int)visible;
     */
 
     /**
diff --git a/imgui-binding/src/main/java/imgui/ImGui.java b/imgui-binding/src/main/java/imgui/ImGui.java
index 0d12502..eb94d1b 100644
--- a/imgui-binding/src/main/java/imgui/ImGui.java
+++ b/imgui-binding/src/main/java/imgui/ImGui.java
@@ -147,7 +147,7 @@ public final class ImGui {
     }
 
     /**
-     * Access the Style structure (colors, sizes). Always use PushStyleCol(), PushStyleVar() to modify style mid-frame.
+     * Access the Style structure (colors, sizes). Always use PushStyleCol(), PushStyleVar() to modify style mid-frame!
      */
     public static ImGuiStyle getStyle() {
         if (style == null) {
@@ -168,9 +168,8 @@ public final class ImGui {
     */
 
     /**
-     * Ends the Dear ImGui frame. automatically called by Render(), you likely don't need to call that yourself directly.
-     * If you don't need to render data (skipping rendering) you may call EndFrame() but you'll have wasted CPU already!
-     * If you don't need to render, better to not create any imgui windows and not call NewFrame() at all!
+     * Ends the Dear ImGui frame. automatically called by Render(). If you don't need to render data (skipping rendering) you may call EndFrame() without
+     * Render()... but you'll have wasted CPU already! If you don't need to render, better to not create any windows and not call NewFrame() at all!
      */
     public static native void endFrame(); /*
         ImGui::EndFrame();
@@ -178,7 +177,8 @@ public final class ImGui {
 
     /**
      * Ends the Dear ImGui frame, finalize the draw data.
-     * You can get call GetDrawData() to obtain it and run your rendering function.
+     * You can get call GetDrawData() to obtain it and run your rendering function (up to v1.60, this used to call io.RenderDrawListsFn().
+     * Nowadays, we allow and prefer calling your render function yourself.)
      */
     public static native void render(); /*
         ImGui::Render();
@@ -232,13 +232,17 @@ public final class ImGui {
     */
 
     /**
-     * Create Metrics/Debug window.
+     * Create Debug/Metrics window.
      * Display Dear ImGui internals: draw commands (with individual draw calls and vertices), window list, basic internal state, etc.
      */
     public static native void showMetricsWindow(); /*
         ImGui::ShowMetricsWindow();
     */
 
+    /**
+     * Create Debug/Metrics window.
+     * Display Dear ImGui internals: draw commands (with individual draw calls and vertices), window list, basic internal state, etc.
+     */
     public static void showMetricsWindow(ImBool pOpen) {
         nShowMetricsWindow(pOpen.data);
     }
@@ -945,7 +949,7 @@ public final class ImGui {
     // Parameters stacks (current window)
 
     /**
-     * Set width of items for common large "item+label" widgets. {@code > 0.0f}: width in pixels,
+     * Push width of items for common large "item+label" widgets. {@code > 0.0f}: width in pixels,
      * {@code <0.0f} align xx pixels to the right of window (so -1.0f always align width to the right side). 0.0f = default to ~2/3 of windows width,
      */
     public static native void pushItemWidth(float itemWidth); /*
@@ -972,16 +976,16 @@ public final class ImGui {
     */
 
     /**
-     * Word-wrapping for Text*() commands. {@code < 0.0f}: no wrapping; 0.0f: wrap to end of window (or column); {@code > 0.0f}: wrap at 'wrap_posX'
-     * position in window local space
+     * Push Word-wrapping positions for Text*() commands. {@code < 0.0f}: no wrapping; 0.0f: wrap to end of window (or column); {@code > 0.0f}: wrap at
+     * 'wrap_posX' position in window local space
      */
     public static native void pushTextWrapPos(); /*
         ImGui::PushTextWrapPos();
     */
 
     /**
-     * Word-wrapping for Text*() commands. {@code < 0.0f}: no wrapping; 0.0f: wrap to end of window (or column); {@code > 0.0f}: wrap at 'wrap_posX'
-     * position in window local space
+     * Push Word-wrapping positions for Text*() commands. {@code < 0.0f}: no wrapping; 0.0f: wrap to end of window (or column); {@code > 0.0f}: wrap at
+     * 'wrap_posX' position in window local space
      */
     public static native void pushTextWrapPos(float wrapLocalPosX); /*
         ImGui::PushTextWrapPos(wrapLocalPosX);
@@ -1018,6 +1022,9 @@ public final class ImGui {
     // - By "cursor" we mean the current output position.
     // - The typical widget behavior is to output themselves at the current cursor position, then move the cursor one line down.
     // - You can call SameLine() between widgets to undo the last carriage return and output at the right of the preceeding widget.
+    // - Attention! We currently have inconsistencies between window-local and absolute positions we will aim to fix with future API:
+    //    Window-local coordinates:   SameLine(), GetCursorPos(), SetCursorPos(), GetCursorStartPos(), GetContentRegionMax(), GetWindowContentRegion*(), PushTextWrapPos()
+    //    Absolute coordinate:        GetCursorScreenPos(), SetCursorScreenPos(), all ImDrawList:: functions.
 
     /**
      * Separator, generally horizontal. inside a menu bar or in horizontal layout mode, this becomes a vertical separator.
@@ -3568,7 +3575,8 @@ public final class ImGui {
 
     // Widgets: Menus
     // - Use BeginMenuBar() on a window ImGuiWindowFlags_MenuBar to append to its menu bar.
-    // - Use BeginMainMenuBar() to create a menu bar at the top of the screen.
+    // - Use BeginMainMenuBar() to create a menu bar at the top of the screen and append to it.
+    // - Use BeginMenu() to create a menu. You can call BeginMenu() multiple time with the same identifier to append more items to it.
 
     /**
      * Append to menu-bar of current window (requires ImGuiWindowFlags_MenuBar flag set on parent window).
@@ -3881,7 +3889,7 @@ public final class ImGui {
     // - You can also use SameLine(posX) to mimic simplified columns.
     // - The columns API is work-in-progress and rather lacking (columns are arguably the worst part of dear imgui at the moment!)
     // - There is a maximum of 64 columns.
-    // - Currently working on new 'Tables' api which will replace columns (see GitHub #2957)
+    // - Currently working on new 'Tables' api which will replace columns around Q2 2020 (see GitHub #2957).
 
     public static native void columns(); /*
         ImGui::Columns();
@@ -4108,7 +4116,7 @@ public final class ImGui {
     */
 
     // Drag and Drop
-    // [BETA API] API may evolve!
+    // - [BETA API] API may evolve!
 
     /**
      * Call when the current item is active. If this return true, you can call SetDragDropPayload() + EndDragDropSource()
@@ -4427,26 +4435,6 @@ public final class ImGui {
 
     // TODO SetStateStorage, GetStateStorage
 
-    public static native void calcTextSize(ImVec2 dstImVec2, String text); /*
-        ImVec2 src = ImGui::CalcTextSize(text);
-        Jni::ImVec2Cpy(env, src, dstImVec2);
-    */
-
-    public static native void calcTextSize(ImVec2 dstImVec2, String text, String textEnd); /*
-        ImVec2 src = ImGui::CalcTextSize(text, textEnd);
-        Jni::ImVec2Cpy(env, src, dstImVec2);
-    */
-
-    public static native void calcTextSize(ImVec2 dstImVec2, String text, String textEnd, boolean hideTextAfterDoubleHas); /*
-        ImVec2 src = ImGui::CalcTextSize(text, textEnd, hideTextAfterDoubleHas);
-        Jni::ImVec2Cpy(env, src, dstImVec2);
-    */
-
-    public static native void calcTextSize(ImVec2 dstImVec2, String text, String textEnd, boolean hideTextAfterDoubleHas, float wrapWidth); /*
-        ImVec2 src = ImGui::CalcTextSize(text, textEnd, hideTextAfterDoubleHas, wrapWidth);
-        Jni::ImVec2Cpy(env, src, dstImVec2);
-    */
-
     /**
      * Calculate coarse clipping for large list of evenly sized items. Prefer using the ImGuiListClipper higher-level helper if you can.
      */
@@ -4475,6 +4463,28 @@ public final class ImGui {
         ImGui::EndChildFrame();
     */
 
+    // Text Utilities
+
+    public static native void calcTextSize(ImVec2 dstImVec2, String text); /*
+        ImVec2 src = ImGui::CalcTextSize(text);
+        Jni::ImVec2Cpy(env, src, dstImVec2);
+    */
+
+    public static native void calcTextSize(ImVec2 dstImVec2, String text, String textEnd); /*
+        ImVec2 src = ImGui::CalcTextSize(text, textEnd);
+        Jni::ImVec2Cpy(env, src, dstImVec2);
+    */
+
+    public static native void calcTextSize(ImVec2 dstImVec2, String text, String textEnd, boolean hideTextAfterDoubleHas); /*
+        ImVec2 src = ImGui::CalcTextSize(text, textEnd, hideTextAfterDoubleHas);
+        Jni::ImVec2Cpy(env, src, dstImVec2);
+    */
+
+    public static native void calcTextSize(ImVec2 dstImVec2, String text, String textEnd, boolean hideTextAfterDoubleHas, float wrapWidth); /*
+        ImVec2 src = ImGui::CalcTextSize(text, textEnd, hideTextAfterDoubleHas, wrapWidth);
+        Jni::ImVec2Cpy(env, src, dstImVec2);
+    */
+
     // Color Utilities
 
     public static native void colorConvertU32ToFloat4(long in, ImVec4 dstImVec4); /*
@@ -4722,7 +4732,8 @@ public final class ImGui {
         ImGui::CaptureMouseFromApp(wantCaptureMouseValue);
     */
 
-    // Clipboard Utilities (also see the LogToClipboard() function to capture or output text data to the clipboard)
+    // Clipboard Utilities
+    // - Also see the LogToClipboard() function to capture GUI into clipboard, or easily output text data to the clipboard.
 
     public static native String getClipboardText(); /*
         return env->NewStringUTF(ImGui::GetClipboardText());
diff --git a/imgui-binding/src/main/java/imgui/ImGuiIO.java b/imgui-binding/src/main/java/imgui/ImGuiIO.java
index b22e1c9..cf6edb5 100644
--- a/imgui-binding/src/main/java/imgui/ImGuiIO.java
+++ b/imgui-binding/src/main/java/imgui/ImGuiIO.java
@@ -649,11 +649,14 @@ public final class ImGuiIO {
     */
 
     //------------------------------------------------------------------
-    // Output - Retrieve after calling NewFrame()
+    // Output - Updated by NewFrame() or EndFrame()/Render()
+    // (when reading from the io.WantCaptureMouse, io.WantCaptureKeyboard flags to dispatch your inputs, it is
+    //  generally easier and more correct to use their state BEFORE calling NewFrame(). See FAQ for details!)
     //------------------------------------------------------------------
 
     /**
-     * When io.WantCaptureMouse is true, imgui will use the mouse inputs, do not dispatch them to your main game/application (in both cases, always pass on mouse inputs to imgui).
+     * Set when Dear ImGui will use mouse inputs, in this case do not dispatch them to your main game/application
+     * (either way, always pass on mouse inputs to imgui).
      * (e.g. unclicked mouse is hovering over an imgui window, widget is active, mouse was clicked over an imgui window, etc.).
      */
     public native boolean getWantCaptureMouse(); /*
@@ -661,7 +664,8 @@ public final class ImGuiIO {
     */
 
     /**
-     * When io.WantCaptureMouse is true, imgui will use the mouse inputs, do not dispatch them to your main game/application (in both cases, always pass on mouse inputs to imgui).
+     * Set when Dear ImGui will use mouse inputs, in this case do not dispatch them to your main game/application
+     * (either way, always pass on mouse inputs to imgui).
      * (e.g. unclicked mouse is hovering over an imgui window, widget is active, mouse was clicked over an imgui window, etc.).
      */
     public native void setWantCaptureMouse(boolean wantCaptureMouse); /*
@@ -669,46 +673,46 @@ public final class ImGuiIO {
     */
 
     /**
-     * When io.WantCaptureKeyboard is true, imgui will use the keyboard inputs, do not dispatch them to your main game/application (in both cases, always pass keyboard inputs to imgui).
-     * (e.g. InputText active, or an imgui window is focused and navigation is enabled, etc.).
+     * Set when Dear ImGui will use keyboard inputs, in this case do not dispatch them to your main game/application
+     * (either way, always pass keyboard inputs to imgui). (e.g. InputText active, or an imgui window is focused and navigation is enabled, etc.).
      */
     public native boolean getWantCaptureKeyboard(); /*
         return ImGui::GetIO().WantCaptureKeyboard;
     */
 
     /**
-     * When io.WantCaptureKeyboard is true, imgui will use the keyboard inputs, do not dispatch them to your main game/application (in both cases, always pass keyboard inputs to imgui).
-     * (e.g. InputText active, or an imgui window is focused and navigation is enabled, etc.).
+     * Set when Dear ImGui will use keyboard inputs, in this case do not dispatch them to your main game/application
+     * (either way, always pass keyboard inputs to imgui). (e.g. InputText active, or an imgui window is focused and navigation is enabled, etc.).
      */
     public native void setWantCaptureKeyboard(boolean wantCaptureKeyboard); /*
         ImGui::GetIO().WantCaptureKeyboard = wantCaptureKeyboard;
     */
 
     /**
-     * Mobile/console: when io.WantTextInput is true, you may display an on-screen keyboard.
-     * This is set by ImGui when it wants textual keyboard input to happen (e.g. when a InputText widget is active).
+     * Mobile/console: when set, you may display an on-screen keyboard.
+     * This is set by Dear ImGui when it wants textual keyboard input to happen (e.g. when a InputText widget is active).
      */
     public native boolean getWantTextInput(); /*
         return ImGui::GetIO().WantTextInput;
     */
 
     /**
-     * Mobile/console: when io.WantTextInput is true, you may display an on-screen keyboard.
-     * This is set by ImGui when it wants textual keyboard input to happen (e.g. when a InputText widget is active).
+     * Mobile/console: when set, you may display an on-screen keyboard.
+     * This is set by Dear ImGui when it wants textual keyboard input to happen (e.g. when a InputText widget is active).
      */
     public native void setWantTextInput(boolean wantTextInput); /*
         ImGui::GetIO().WantTextInput = wantTextInput;
     */
 
     /**
-     * MousePos has been altered, back-end should reposition mouse on next frame. Set only when ImGuiConfigFlags_NavEnableSetMousePos flag is enabled.
+     * MousePos has been altered, back-end should reposition mouse on next frame. Rarely used! Set only when ImGuiConfigFlags_NavEnableSetMousePos flag is enabled.
      */
     public native boolean getWantSetMousePos(); /*
         return ImGui::GetIO().WantSetMousePos;
     */
 
     /**
-     * MousePos has been altered, back-end should reposition mouse on next frame. Set only when ImGuiConfigFlags_NavEnableSetMousePos flag is enabled.
+     * MousePos has been altered, back-end should reposition mouse on next frame. Rarely used! Set only when ImGuiConfigFlags_NavEnableSetMousePos flag is enabled.
      */
     public native void setWantSetMousePos(boolean wantSetMousePos); /*
         ImGui::GetIO().WantSetMousePos = wantSetMousePos;
@@ -717,7 +721,7 @@ public final class ImGuiIO {
     /**
      * When manual .ini load/save is active (io.IniFilename == NULL),
      * this will be set to notify your application that you can call SaveIniSettingsToMemory() and save yourself.
-     * IMPORTANT: You need to clear io.WantSaveIniSettings yourself.
+     * Important: clear io.WantSaveIniSettings yourself after saving!
      */
     public native boolean getWantSaveIniSettings(); /*
         return ImGui::GetIO().WantSaveIniSettings;
@@ -726,49 +730,53 @@ public final class ImGuiIO {
     /**
      * When manual .ini load/save is active (io.IniFilename == NULL),
      * this will be set to notify your application that you can call SaveIniSettingsToMemory() and save yourself.
-     * IMPORTANT: You need to clear io.WantSaveIniSettings yourself.
+     * Important: clear io.WantSaveIniSettings yourself after saving!
      */
     public native void setWantSaveIniSettings(boolean wantSaveIniSettings); /*
         ImGui::GetIO().WantSaveIniSettings = wantSaveIniSettings;
     */
 
     /**
-     * Directional navigation is currently allowed (will handle ImGuiKey_NavXXX events) = a window is focused and it doesn't use the ImGuiWindowFlags_NoNavInputs flag.
+     * Keyboard/Gamepad navigation is currently allowed (will handle ImGuiKey_NavXXX events) = a window is focused
+     * and it doesn't use the ImGuiWindowFlags_NoNavInputs flag.
      */
     public native boolean getNavActive(); /*
         return ImGui::GetIO().NavActive;
     */
 
     /**
-     * Directional navigation is currently allowed (will handle ImGuiKey_NavXXX events) = a window is focused and it doesn't use the ImGuiWindowFlags_NoNavInputs flag.
+     * Keyboard/Gamepad navigation is currently allowed (will handle ImGuiKey_NavXXX events) = a window is focused
+     * and it doesn't use the ImGuiWindowFlags_NoNavInputs flag.
      */
     public native void setNavActive(boolean navActive); /*
         ImGui::GetIO().NavActive = navActive;
     */
 
     /**
-     * Directional navigation is visible and allowed (will handle ImGuiKey_NavXXX events).
+     * Keyboard/Gamepad navigation is visible and allowed (will handle ImGuiKey_NavXXX events).
      */
     public native boolean getNavVisible(); /*
         return ImGui::GetIO().NavVisible;
     */
 
     /**
-     * Directional navigation is visible and allowed (will handle ImGuiKey_NavXXX events).
+     * Keyboard/Gamepad navigation is visible and allowed (will handle ImGuiKey_NavXXX events).
      */
     public native void setNavVisible(boolean navVisible); /*
         ImGui::GetIO().NavVisible = navVisible;
     */
 
     /**
-     * Application framerate estimation, in frame per second. Solely for convenience. Rolling average estimation based on IO.DeltaTime over 120 frames
+     * Application framerate estimate, in frame per second. Solely for convenience. Rolling average estimation based on io.DeltaTime over 120 frames.
+     * Solely for convenience. Rolling average estimation based on IO.DeltaTime over 120 frames
      */
     public native float getFramerate(); /*
         return ImGui::GetIO().Framerate;
     */
 
     /**
-     * Application framerate estimation, in frame per second. Solely for convenience. Rolling average estimation based on IO.DeltaTime over 120 frames
+     * Application framerate estimate, in frame per second. Solely for convenience. Rolling average estimation based on io.DeltaTime over 120 frames.
+     * Solely for convenience. Rolling average estimation based on IO.DeltaTime over 120 frames
      */
     public native void setFramerate(float framerate); /*
         ImGui::GetIO().Framerate = framerate;
@@ -868,6 +876,13 @@ public final class ImGuiIO {
         ImGui::GetIO().AddInputCharacter((unsigned int)c);
     */
 
+    /**
+     * Queue new character input from an UTF-16 character, it can be a surrogate
+     */
+    public native void addInputCharacterUTF16(short c); /*
+        ImGui::GetIO().AddInputCharacterUTF16((ImWchar16)c);
+    */
+
     /**
      * Queue new characters input from an UTF-8 string.
      */
diff --git a/imgui-binding/src/main/java/imgui/ImGuiStyle.java b/imgui-binding/src/main/java/imgui/ImGuiStyle.java
index ccaa5f5..9f05008 100644
--- a/imgui-binding/src/main/java/imgui/ImGuiStyle.java
+++ b/imgui-binding/src/main/java/imgui/ImGuiStyle.java
@@ -439,14 +439,16 @@ public final class ImGuiStyle implements ImDestroyable {
     */
 
     /**
-     * Alignment of selectable text when selectable is larger than text. Defaults to (0.0f, 0.0f) (top-left aligned).
+     * Alignment of selectable text. Defaults to (0.0f, 0.0f) (top-left aligned).
+     * It's generally important to keep this left-aligned if you want to lay multiple items on a same line.
      */
     public native void getSelectableTextAlign(ImVec2 dstImVec2); /*
         Jni::ImVec2Cpy(env, &IMGUI_STYLE->SelectableTextAlign, dstImVec2);
     */
 
     /**
-     * Alignment of selectable text when selectable is larger than text. Defaults to (0.0f, 0.0f) (top-left aligned).
+     * Alignment of selectable text. Defaults to (0.0f, 0.0f) (top-left aligned).
+     * It's generally important to keep this left-aligned if you want to lay multiple items on a same line.
      */
     public native void setSelectableTextAlign(float x, float y); /*
         IMGUI_STYLE->SelectableTextAlign.x = x;
diff --git a/imgui-binding/src/main/java/imgui/ImVec2.java b/imgui-binding/src/main/java/imgui/ImVec2.java
index acc0057..249ec0c 100644
--- a/imgui-binding/src/main/java/imgui/ImVec2.java
+++ b/imgui-binding/src/main/java/imgui/ImVec2.java
@@ -2,6 +2,9 @@ package imgui;
 
 import java.util.Objects;
 
+/**
+ * 2D vector (often used to store positions or sizes)
+ */
 public final class ImVec2 {
     public float x;
     public float y;
diff --git a/imgui-binding/src/main/java/imgui/ImVec4.java b/imgui-binding/src/main/java/imgui/ImVec4.java
index 9da817a..f1b2d98 100644
--- a/imgui-binding/src/main/java/imgui/ImVec4.java
+++ b/imgui-binding/src/main/java/imgui/ImVec4.java
@@ -2,6 +2,9 @@ package imgui;
 
 import java.util.Objects;
 
+/**
+ * 4D vector (often used to store floating-point colors)
+ */
 public final class ImVec4 {
     public float x;
     public float y;
diff --git a/imgui-binding/src/main/java/imgui/enums/ImGuiColorEditFlags.java b/imgui-binding/src/main/java/imgui/enums/ImGuiColorEditFlags.java
index 0f78547..0756c13 100644
--- a/imgui-binding/src/main/java/imgui/enums/ImGuiColorEditFlags.java
+++ b/imgui-binding/src/main/java/imgui/enums/ImGuiColorEditFlags.java
@@ -44,6 +44,10 @@ public final class ImGuiColorEditFlags {
      * ColorEdit: disable drag and drop target. ColorButton: disable drag and drop source.
      */
     public static final int NoDragDrop = 1 << 9;
+    /**
+     * ColorButton: disable border (which is enforced by default)
+     */
+    public static final int NoBorder = 1 << 10;
 
     // User Options (right-click on widget to change some of them).
 
diff --git a/imgui-binding/src/main/java/imgui/enums/ImGuiFocusedFlags.java b/imgui-binding/src/main/java/imgui/enums/ImGuiFocusedFlags.java
index 414a463..629fca5 100644
--- a/imgui-binding/src/main/java/imgui/enums/ImGuiFocusedFlags.java
+++ b/imgui-binding/src/main/java/imgui/enums/ImGuiFocusedFlags.java
@@ -18,7 +18,7 @@ public final class ImGuiFocusedFlags {
     public static final int RootWindow = 1 << 1;
     /**
      * IsWindowFocused(): Return true if any window is focused.
-     * Important: If you are trying to tell how to dispatch your low-level inputs, do NOT use this. Use ImGui::GetIO().WantCaptureMouse instead.
+     * Important: If you are trying to tell how to dispatch your low-level inputs, do NOT use this. Use 'io.WantCaptureMouse' instead! Please read the FAQ!
      */
     public static final int AnyWindow = 1 << 2;
     public static final int RootAndChildWindows = RootWindow | ChildWindows;
diff --git a/imgui-binding/src/main/java/imgui/enums/ImGuiHoveredFlags.java b/imgui-binding/src/main/java/imgui/enums/ImGuiHoveredFlags.java
index ebc3863..0676007 100644
--- a/imgui-binding/src/main/java/imgui/enums/ImGuiHoveredFlags.java
+++ b/imgui-binding/src/main/java/imgui/enums/ImGuiHoveredFlags.java
@@ -2,8 +2,8 @@ package imgui.enums;
 
 /**
  * Flags for ImGui::IsItemHovered(), ImGui::IsWindowHovered()
- * Note: if you are trying to check whether your mouse should be dispatched to imgui or to your app, you should use the 'io.WantCaptureMouse' boolean for that. Please read the FAQ!
- * Note: windows with the ImGuiWindowFlags_NoInputs flag are ignored by IsWindowHovered() calls.
+ * Note:if you are trying to check whether your mouse should be dispatched to Dear ImGui or to your app,
+ * you should use'io.WantCaptureMouse'instead!Please read the FAQ!Note: windows with the ImGuiWindowFlags_NoInputs flag are ignored by IsWindowHovered() calls.
  */
 public final class ImGuiHoveredFlags {
     private ImGuiHoveredFlags() {
diff --git a/imgui-binding/src/main/java/imgui/enums/ImGuiKeyModFlags.java b/imgui-binding/src/main/java/imgui/enums/ImGuiKeyModFlags.java
new file mode 100644
index 0000000..19967b6
--- /dev/null
+++ b/imgui-binding/src/main/java/imgui/enums/ImGuiKeyModFlags.java
@@ -0,0 +1,15 @@
+package imgui.enums;
+
+/**
+ * To test io.KeyMods (which is a combination of individual fields io.KeyCtrl, io.KeyShift, io.KeyAlt set by user/back-end)
+ */
+public final class ImGuiKeyModFlags {
+    private ImGuiKeyModFlags() {
+    }
+
+    public static final int None = 0;
+    public static final int Ctrl = 1;
+    public static final int Shift = 1 << 1;
+    public static final int Alt = 1 << 2;
+    public static final int Super = 1 << 3;
+}
diff --git a/imgui-binding/src/main/java/imgui/enums/ImGuiStyleVar.java b/imgui-binding/src/main/java/imgui/enums/ImGuiStyleVar.java
index cfa7ec6..5cd127c 100644
--- a/imgui-binding/src/main/java/imgui/enums/ImGuiStyleVar.java
+++ b/imgui-binding/src/main/java/imgui/enums/ImGuiStyleVar.java
@@ -2,8 +2,12 @@ package imgui.enums;
 
 /**
  * Enumeration for PushStyleVar() / PopStyleVar() to temporarily modify the ImGuiStyle structure.
- * NB: the enum only refers to fields of ImGuiStyle which makes sense to be pushed/popped inside UI code. During initialization, feel free to just poke into ImGuiStyle directly.
- * NB: if changing this enum, you need to update the associated internal table GStyleVarInfo[] accordingly. This is where we link enum values to members offset/type.
+ * - The enum only refers to fields of ImGuiStyle which makes sense to be pushed/popped inside UI code.
+ *   During initialization or between frames, feel free to just poke into ImGuiStyle directly.
+ * - Tip: Use your programming IDE navigation facilities on the names in the _second column_ below to find the actual members and their description.
+ *   In Visual Studio IDE: CTRL+comma ("Edit.NavigateTo") can follow symbols in comments, whereas CTRL+F12 ("Edit.GoToImplementation") cannot.
+ *   With Visual Assist installed: ALT+G ("VAssistX.GoToImplementation") can also follow symbols in comments.
+ * - When changing this enum, you need to update the associated internal table GStyleVarInfo[] accordingly. This is where we link enum values to members offset/type.
  */
 public final class ImGuiStyleVar {
     private ImGuiStyleVar() {
diff --git a/imgui-lwjgl3/src/test/java/ImGuiGlfwExample.java b/imgui-lwjgl3/src/test/java/ImGuiGlfwExample.java
index 0227ba1..d28536f 100644
--- a/imgui-lwjgl3/src/test/java/ImGuiGlfwExample.java
+++ b/imgui-lwjgl3/src/test/java/ImGuiGlfwExample.java
@@ -59,7 +59,7 @@ public final class ImGuiGlfwExample {
     private final ImGuiImplGl3 imGuiGl3 = new ImGuiImplGl3();
 
     // Local variables for application goes here
-    private final String imguiDemoLink = "https://raw.githubusercontent.com/ocornut/imgui/v1.75/imgui_demo.cpp"; // Link to put into clipboard
+    private final String imguiDemoLink = "https://raw.githubusercontent.com/ocornut/imgui/v1.76/imgui_demo.cpp"; // Link to put into clipboard
     private final byte[] testPayload = "Test Payload".getBytes(); // Test data for payload. Should be represented as raw byt array.
     private String dropTargetText = "Drop Here";
     private float[] backgroundColor = new float[]{0.5f, 0, 0}; // To modify background color dynamically