Update binding to Dear ImGui v1.77

Author: SpaiR

imgui-binding/src/main/java/imgui/ImDrawList.java

@@ -377,7 +377,7 @@ public void addText(final ImFont imFont, final float fontSize, final float posX,
     // Advanced: Channels
     // - Use to split render into layers. By switching channels to can render out-of-order (e.g. submit FG primitives before BG primitives)
     // - Use to minimize draw calls (e.g. if going back-and-forth between multiple clipping rectangles, prefer to append into separate channels then merge at the end)
-    //   Prefer using your own persistent copy of ImDrawListSplitter as you can stack them.
+    //   Prefer using your own persistent instance of ImDrawListSplitter as you can stack them.
     //   Using the ImDrawList::ChannelsXXXX you cannot stack a split over another.
 
     public native void channelsSplit(int count); /*

imgui-binding/src/main/java/imgui/ImFontAtlas.java

@@ -473,18 +473,13 @@ private ByteBuffer createRgba32Pixels(final int size) {
     // After calling Build(), you can query the rectangle position and render your pixels.
     // You can also request your rectangles to be mapped as font glyph (given a font + Unicode point),
     // so you can render e.g. custom colorful icons and use them as regular glyphs.
-    // Read docs/FONTS.txt for more details about using colorful icons.
+    // Read docs/FONTS.md for more details about using colorful icons.
+    // Note: this API may be redesigned later in order to support multi-monitor varying DPI settings.
 
-    /**
-     * Id needs to be {@code >=} 0x110000. Id {@code >=} 0x80000000 are reserved for ImGui and ImDrawList
-     */
-    public native int addCustomRectRegular(int id, int width, int height); /*
-        return IM_FONT_ATLAS->AddCustomRectRegular((unsigned int)id, width, height);
+    public native int addCustomRectRegular(int width, int height); /*
+        return IM_FONT_ATLAS->AddCustomRectRegular(width, height);
     */
 
-    /**
-     * Id needs to be {@code <} 0x110000 to register a rectangle to map into a specific font.
-     */
     public int addCustomRectFontGlyph(final ImFont imFont, final short id, final int width, final int height, final float advanceX) {
         return nAddCustomRectFontGlyph(imFont.ptr, id, width, height, advanceX);
     }

imgui-binding/src/main/java/imgui/ImGui.java

@@ -546,22 +546,22 @@ void setClipboardTextStub(void* userData, const char* text) {
     */
 
     /**
-     * Mouse position, in pixels. Set to ImVec2(-FLT_MAX,-FLT_MAX) if mouse is unavailable (on another screen, etc.)
+     * Mouse position, in pixels. Set to ImVec2(-FLT_MAX, -FLT_MAX) if mouse is unavailable (on another screen, etc.)
      */
     public native void getMousePos(ImVec2 dstImVec2); /*
         Jni::ImVec2Cpy(env, &ImGui::GetIO().MousePos, dstImVec2);
     */
 
     /**
-     * Mouse position, in pixels. Set to ImVec2(-FLT_MAX,-FLT_MAX) if mouse is unavailable (on another screen, etc.)
+     * Mouse position, in pixels. Set to ImVec2(-FLT_MAX, -FLT_MAX) if mouse is unavailable (on another screen, etc.)
      */
     public native void setMousePos(float x, float y); /*
         ImGui::GetIO().MousePos.x = x;
         ImGui::GetIO().MousePos.y = y;
     */
 
     /**
-     * Mouse buttons: 0=left, 1=right, 2=middle + extras. ImGui itself mostly only uses left button (BeginPopupContext** are using right button).
+     * Mouse buttons: 0=left, 1=right, 2=middle + extras (ImGuiMouseButton_COUNT == 5). Dear ImGui mostly uses left and right buttons.
      * Others buttons allows us to track if the mouse is being used by your application + available to user as a convenience via IsMouse** API.
      */
     public native void getMouseDown(boolean[] buff); /*
@@ -570,23 +570,23 @@ void setClipboardTextStub(void* userData, const char* text) {
     */
 
     /**
-     * Mouse buttons: 0=left, 1=right, 2=middle + extras. ImGui itself mostly only uses left button (BeginPopupContext** are using right button).
+     * Mouse buttons: 0=left, 1=right, 2=middle + extras (ImGuiMouseButton_COUNT == 5). Dear ImGui mostly uses left and right buttons.
      * Others buttons allows us to track if the mouse is being used by your application + available to user as a convenience via IsMouse** API.
      */
     public native boolean getMouseDown(int idx); /*
         return ImGui::GetIO().MouseDown[idx];
     */
 
     /**
-     * Mouse buttons: 0=left, 1=right, 2=middle + extras. ImGui itself mostly only uses left button (BeginPopupContext** are using right button).
+     * Mouse buttons: 0=left, 1=right, 2=middle + extras (ImGuiMouseButton_COUNT == 5). Dear ImGui mostly uses left and right buttons.
      * Others buttons allows us to track if the mouse is being used by your application + available to user as a convenience via IsMouse** API.
      */
     public native void setMouseDown(int idx, boolean down); /*
         ImGui::GetIO().MouseDown[idx] = down;
     */
 
     /**
-     * Mouse buttons: 0=left, 1=right, 2=middle + extras. ImGui itself mostly only uses left button (BeginPopupContext** are using right button).
+     * Mouse buttons: 0=left, 1=right, 2=middle + extras (ImGuiMouseButton_COUNT == 5). Dear ImGui mostly uses left and right buttons.
      * Others buttons allows us to track if the mouse is being used by your application + available to user as a convenience via IsMouse** API.
      */
     public native void setMouseDown(boolean[] mouseDown); /*

imgui-binding/src/main/java/imgui/ImGuiIO.java

@@ -81,13 +81,15 @@ public void destroy() {
 
     /**
      * Radius of window corners rounding. Set to 0.0f to have rectangular windows.
+     * Large values tend to lead to variety of artifacts and are not recommended.
      */
     public native float getWindowRounding(); /*
         return IMGUI_STYLE->WindowRounding;
     */
 
     /**
      * Radius of window corners rounding. Set to 0.0f to have rectangular windows.
+     * Large values tend to lead to variety of artifacts and are not recommended.
      */
     public native void setWindowRounding(float windowRounding); /*
         IMGUI_STYLE->WindowRounding = windowRounding;
@@ -409,6 +411,22 @@ public void destroy() {
         IMGUI_STYLE->TabBorderSize = tabBorderSize;
     */
 
+    /**
+     * Minimum width for close button to appears on an unselected tab when hovered.
+     * Set to 0.0f to always show when hovering, set to FLT_MAX to never show close button unless selected.
+     */
+    public native float getTabMinWidthForUnselectedCloseButton(); /*
+        return IMGUI_STYLE->TabMinWidthForUnselectedCloseButton;
+    */
+
+    /**
+     * Minimum width for close button to appears on an unselected tab when hovered.
+     * Set to 0.0f to always show when hovering, set to FLT_MAX to never show close button unless selected.
+     */
+    public native void setTabMinWidthForUnselectedCloseButton(float tabMinWidthForUnselectedCloseButton); /*
+        IMGUI_STYLE->TabMinWidthForUnselectedCloseButton = tabMinWidthForUnselectedCloseButton;
+    */
+
     /**
      * Side of the color button in the ColorEdit4 widget (left/right). Defaults to ImGuiDir_Right.
      */

imgui-binding/src/main/java/imgui/ImGuiStyle.java

@@ -10,11 +10,15 @@ private ImGuiCond() {
     }
 
     /**
-     * Set the variable
+     * No condition (always set the variable), same as Always.
+     */
+    public static final int None = 0;
+    /**
+     * No condition (always set the variable)
      */
     public static final int Always = 1;
     /**
-     * Set the variable once per runtime session (only the first call with succeed)
+     * Set the variable once per runtime session (only the first call will succeed)
      */
     public static final int Once = 1 << 1;
     /**

imgui-binding/src/main/java/imgui/flag/ImGuiCond.java

@@ -0,0 +1,46 @@
+package imgui.flag;
+
+/**
+ * Flags for OpenPopup*(), BeginPopupContext*(), IsPopupOpen() functions.
+ * - To be backward compatible with older API which took an 'int mouse_button = 1' argument, we need to treat
+ *   small flags values as a mouse button index, so we encode the mouse button in the first few bits of the flags.
+ *   It is therefore guaranteed to be legal to pass a mouse button index in ImGuiPopupFlags.
+ * - For the same reason, we exceptionally default the ImGuiPopupFlags argument of BeginPopupContextXXX functions to 1 instead of 0.
+ */
+public final class ImGuiPopupFlags {
+    private ImGuiPopupFlags() {
+    }
+
+    public static final int None = 0;
+    /**
+     * For BeginPopupContext*(): open on Left Mouse release. Guaranted to always be == 0 (same as ImGuiMouseButton_Left)
+     */
+    public static final int MouseButtonLeft = 0;
+    /**
+     * For BeginPopupContext*(): open on Right Mouse release. Guaranted to always be == 1 (same as ImGuiMouseButton_Right)
+     */
+    public static final int MouseButtonRight = 1;
+    /**
+     * For BeginPopupContext*(): open on Middle Mouse release. Guaranted to always be == 2 (same as ImGuiMouseButton_Middle)
+     */
+    public static final int MouseButtonMiddle = 2;
+    public static final int MouseButtonMask = 0x1F;
+    public static final int MouseButtonDefault = 1;
+    /**
+     * For OpenPopup*(), BeginPopupContext*(): don't open if there's already a popup at the same level of the popup stack
+     */
+    public static final int NoOpenOverExistingPopup = 1 << 5;
+    /**
+     * For BeginPopupContextWindow(): don't return true when hovering items, only when hovering empty space
+     */
+    public static final int NoOpenOverItems = 1 << 6;
+    /**
+     * For IsPopupOpen(): ignore the ImGuiID parameter and test for any popup.
+     */
+    public static final int AnyPopupId = 1 << 7;
+    /**
+     * For IsPopupOpen(): search/test at any level of the popup stack (default test in the current level)
+     */
+    public static final int AnyPopupLevel = 1 << 8;
+    public static final int AnyPopup = AnyPopupId | AnyPopupLevel;
+}

imgui-binding/src/main/java/imgui/flag/ImGuiPopupFlags.java

@@ -26,4 +26,8 @@ private ImGuiTabItemFlags() {
      * Don't call PushID(tab.ID)/PopID() on BeginTabItem()/EndTabItem()
      */
     public static final int NoPushId = 1 << 3;
+    /**
+     * Disable tooltip for the given tab
+     */
+    public static final int NoTooltip = 1 << 4;
 }