[API] Add API for Dear ImGui v1.78

Author: SpaiR

README.md

@@ -225,7 +225,7 @@ If you're using native libs directly, you'll need to provide a VM option: `imgui
 **You are ready to use imgui-java binding!**
 
 ## Using Multi-Viewports and Docking
-Binding based on the Dear ImGui [docking](https://github.com/ocornut/imgui/tree/docking) branch, commit: [90ea7e2f2f3c4096a58b8bd14c274d80ae63e1ce](https://github.com/ocornut/imgui/tree/90ea7e2f2f3c4096a58b8bd14c274d80ae63e1ce).
+Binding based on the Dear ImGui [docking](https://github.com/ocornut/imgui/tree/docking) branch, commit: [05bc204dbd80dfebb3dab1511caf1cb980620c76](https://github.com/ocornut/imgui/tree/05bc204dbd80dfebb3dab1511caf1cb980620c76).
 That branch contains two important features: [multi-viewports](https://github.com/ocornut/imgui/issues/1542) and [docking](https://github.com/ocornut/imgui/issues/2109).
 See an official documentation about how to work with them.
 

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

@@ -123,6 +123,7 @@ public boolean hasImDrawListFlags(final int flags) {
     // Primitives
     // - For rectangular primitives, "pMin" and "pMax" represent the upper-left and lower-right corners.
     // - For circle primitives, use "num_segments == 0" to automatically calculate tessellation (preferred).
+    //   In older versions (until Dear ImGui 1.77) the AddCircle functions defaulted to num_segments == 12.
     //   In future versions we will use textures to provide cheaper and higher-quality circles.
     //   Use AddNgon() and AddNgonFilled() functions if you need to guaranteed a specific number of sides.
 

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

@@ -16,7 +16,7 @@
  * </pre>
  * - Step 0: the clipper let you process the first element, regardless of it being visible or not, so we can measure the element height (step skipped if we passed a known height as second arg to constructor).
  * - Step 1: the clipper infer height from first element, calculate the actual range of elements to display, and position the cursor before the first element.
- * - (Step 2: dummy step only required if an explicit items_height was passed to constructor or Begin() and user call Step(). Does nothing and switch to Step 3.)
+ * - (Step 2: empty step only required if an explicit items_height was passed to constructor or Begin() and user call Step(). Does nothing and switch to Step 3.)
  * - Step 3: the clipper validate that we have reached the expected Y position (corresponding to element DisplayEnd), advance the cursor to the end of the list and then returns 'false' to end the loop.
  * <p>
  * BINDING NOTICE:

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

@@ -466,6 +466,20 @@ protected long create() {
         IMGUI_STYLE->GrabRounding = grabRounding;
     */
 
+    /**
+     * The size in pixels of the dead-zone around zero on logarithmic sliders that cross zero.
+     */
+    public native float getLogSliderDeadzone(); /*
+        return IMGUI_STYLE->LogSliderDeadzone;
+    */
+
+    /**
+     * The size in pixels of the dead-zone around zero on logarithmic sliders that cross zero.
+     */
+    public native void setLogSliderDeadzone(float logSliderDeadzone); /*
+        IMGUI_STYLE->LogSliderDeadzone = logSliderDeadzone;
+    */
+
     /**
      * Radius of upper corners of a tab. Set to 0.0f to have rectangular tabs.
      */
@@ -663,28 +677,48 @@ protected long create() {
     */
 
     /**
-     * Enable anti-aliasing on lines/borders. Disable if you are really tight on CPU/GPU.
+     * Enable anti-aliased lines/borders. Disable if you are really tight on CPU/GPU. Latched at the beginning of the frame (copied to ImDrawList).
      */
     public native boolean getAntiAliasedLines(); /*
         return IMGUI_STYLE->AntiAliasedLines;
     */
 
     /**
-     * Enable anti-aliasing on lines/borders. Disable if you are really tight on CPU/GPU.
+     * Enable anti-aliased lines/borders. Disable if you are really tight on CPU/GPU. Latched at the beginning of the frame (copied to ImDrawList).
      */
     public native void setAntiAliasedLines(boolean antiAliasedLines); /*
         IMGUI_STYLE->AntiAliasedLines = antiAliasedLines;
     */
 
     /**
-     * Enable anti-aliasing on filled shapes (rounded rectangles, circles, etc.)
+     * Enable anti-aliased lines/borders using textures where possible.
+     * Require back-end to render with bilinear filtering.
+     * Latched at the beginning of the frame (copied to ImDrawList).
+     */
+    public native boolean getAntiAliasedLinesUseTex(); /*
+        return IMGUI_STYLE->AntiAliasedLinesUseTex;
+    */
+
+    /**
+     * Enable anti-aliased lines/borders using textures where possible.
+     * Require back-end to render with bilinear filtering.
+     * Latched at the beginning of the frame (copied to ImDrawList).
+     */
+    public native void setAntiAliasedLinesUseTex(boolean antiAliasedLinesUseTex); /*
+        IMGUI_STYLE->AntiAliasedLinesUseTex = antiAliasedLinesUseTex;
+    */
+
+    /**
+     * Enable anti-aliased edges around filled shapes (rounded rectangles, circles, etc.).
+     * Disable if you are really tight on CPU/GPU. Latched at the beginning of the frame (copied to ImDrawList).
      */
     public native boolean getAntiAliasedFill(); /*
         return IMGUI_STYLE->AntiAliasedFill;
     */
 
     /**
-     * Enable anti-aliasing on filled shapes (rounded rectangles, circles, etc.)
+     * Enable anti-aliased edges around filled shapes (rounded rectangles, circles, etc.).
+     * Disable if you are really tight on CPU/GPU. Latched at the beginning of the frame (copied to ImDrawList).
      */
     public native void setAntiAliasedFill(boolean antiAliasedFill); /*
         IMGUI_STYLE->AntiAliasedFill = antiAliasedFill;

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

@@ -1,21 +1,28 @@
 package imgui.flag;
 
+/**
+ * Flags for ImDrawList. Those are set automatically by ImGui:: functions from ImGuiIO settings, and generally not manipulated directly.
+ * It is however possible to temporarily alter flags between calls to ImDrawList:: functions.
+ */
 public final class ImDrawListFlags {
     private ImDrawListFlags() {
     }
 
     public static final int None = 0;
-
     /**
-     * Lines are anti-aliased (*2 the number of triangles for 1.0f wide line, otherwise *3 the number of triangles)
+     * Enable anti-aliased lines/borders (*2 the number of triangles for 1.0f wide line or lines thin enough to be drawn using textures, otherwise *3 the number of triangles)
      */
     public static final int AntiAliasedLines = 1;
     /**
-     * Filled shapes have anti-aliased edges (*2 the number of vertices)
+     * Enable anti-aliased lines/borders using textures when possible. Require back-end to render with bilinear filtering.
+     */
+    public static final int AntiAliasedLinesUseTex = 1 << 1;
+    /**
+     * Enable anti-aliased edge around filled shapes (rounded rectangles, circles).
      */
-    public static final int AntiAliasedFill = 1 << 1;
+    public static final int AntiAliasedFill = 1 << 2;
     /**
-     * Can emit 'VtxOffset {@code >} 0' to allow large meshes. Set when 'ImGuiBackendFlags_RendererHasVtxOffset' is enabled.
+     * Can emit 'VtxOffset > 0' to allow large meshes. Set when 'ImGuiBackendFlags_RendererHasVtxOffset' is enabled.
      */
-    public static final int AllowVtxOffset = 1 << 2;
+    public static final int AllowVtxOffset = 1 << 3;
 }

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

@@ -1,5 +1,8 @@
 package imgui.flag;
 
+/**
+ * Flags for ImFontAtlas build
+ */
 public final class ImFontAtlasFlags {
     private ImFontAtlasFlags() {
     }
@@ -13,4 +16,9 @@ private ImFontAtlasFlags() {
      * Don't build software mouse cursors into the atlas
      */
     public static final int NoMouseCursors = 1 << 1;
+    /**
+     * Don't build thick line textures into the atlas (save a little texture memory).
+     * The AntiAliasedLinesUseTex features uses them, otherwise they will be rendered using polygons (more expensive for CPU/GPU).
+     */
+    public static final int NoBakedLines = 1 << 2;
 }

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

@@ -0,0 +1,20 @@
+package imgui.flag;
+
+public final class ImGuiButtonFlags {
+    private ImGuiButtonFlags() {
+    }
+
+    public static final int None = 0;
+    /**
+     * React on left mouse button (default).
+     */
+    public static final int MouseButtonLeft = 0;
+    /**
+     *  React on right mouse button.
+     */
+    public static final int MouseButtonRight = 1 << 1;
+    /**
+     * React on center mouse button.
+     */
+    public static final int MouseButtonMiddle = 1 << 2;
+}

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

@@ -6,6 +6,7 @@
  *   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.
+ * - Multiple buttons currently cannot be combined/or-ed in those functions (we could allow it later).
  */
 public final class ImGuiPopupFlags {
     private ImGuiPopupFlags() {

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

@@ -0,0 +1,25 @@
+package imgui.flag;
+
+public final class ImGuiSliderFlags {
+    private ImGuiSliderFlags() {
+    }
+
+    public static final int None = 0;
+    /**
+     * Clamp value to min/max bounds when input manually with CTRL+Click. By default CTRL+Click allows going out of bounds.
+     */
+    public static final int ClampOnInput = 1 << 4;
+    /**
+     * Make the widget logarithmic (linear otherwise).
+     * Consider using ImGuiSliderFlags_NoRoundToFormat with this if using a format-string with small amount of digits.
+     */
+    public static final int Logarithmic = 1 << 5;
+    /**
+     * Disable rounding underlying value to match precision of the display format string (e.g. %.3f values are rounded to those 3 digits).
+     */
+    public static final int NoRoundToFormat = 1 << 6;
+    /**
+     * Disable CTRL+Click or Enter key allowing to input text directly into the widget
+     */
+    public static final int NoInput = 1 << 7;
+}