imgui v1.70 Release Notes

Release Date: 2019-06-13 // almost 5 years ago
  • Hello!

    ๐Ÿš€ In spite of the greaaat looking version number, this is a general release following 1.69, keeping with the rhythm of having more frequent, smaller releases. Reading the full changelog is a good way to keep up to date with the things dear imgui has to offer, and maybe will give you ideas of features that you've been ignoring until now!

    ๐Ÿ‘€ See https://github.com/ocornut/imgui for the project homepage.
    ๐Ÿš€ See https://github.com/ocornut/imgui/releases for earlier release notes.
    ๐Ÿ‘€ See https://github.com/ocornut/imgui/wiki for language/framework bindings, links, 3rd parties helpers/extensions.
    ๐Ÿ‘ Issues and support: https://github.com/ocornut/imgui/issues
    ๐Ÿ‘ Technical support for new users: https://discourse.dearimgui.org (also search in GitHub Issues)
    Thank you

    ๐Ÿ‘€ Ongoing work on dear imgui is currently being sponsored by Blizzard Entertainment + general & community work by many individual users, hobbyists and studios. See the readme for details. Huge thank you to all of you, past and present supporters! You help is very meaningful.
    TL;DR;

    • ๐Ÿš€ First release since new multi-module structure (JVM specific)
    • โž• Added DrawCmd.resetRenderState to request back-end renderer to reset its render state, in a standardized manner.
    • Layout: Added SetNextItemWidth() helper to avoid using PushItemWidth()/PopItemWidth() for single items.
    • โช Popups: Closing a popup restores the focused/nav window in place at the time of the popup opening, instead of restoring the window that was in the window stack at the time of the OpenPopup call. (#2517).
    • ๐Ÿ›  Examples: Vulkan: Various fixes.
    • ๐Ÿ›  Many many other fixes, improvements, small additions. Read below!

    ๐Ÿ’ฅ Breaking Changes

    • ImDrawList: Improved algorithm for mitre joints on thick lines, preserving correct thickness up to 90 degrees angles (e.g. rectangles). If you have custom rendering using thick lines, they will appear a little thicker now (about +30%). (#2518) [@rmitton]
    • Obsoleted GetContentRegionAvailWidth(), use GetContentRegionAvail().x instead! Kept inline redirection function.
    • Examples Vulkan:
    • imgui_impl_vulkan: Added MinImageCount/ImageCount fields in ImGui_ImplVulkan_InitInfo, required during initialization to specify the number of in-flight image requested by swap chains. (was previously a hard #define IMGUI_VK_QUEUED_FRAMES 2). (#2071, #1677) [@nathanvoglsam]
    • Tidying up the demo/internals helpers (most engine/app should not rely on them but it is possible you have!).

    Other Changes:

    • ๐Ÿšš ImDrawList: Added DrawCmd.resetRenderState to request the renderer back-end to reset its render state. (#2037, #1639, #2452). Added support for ImDrawCallback_ResetRenderState in all renderer back-ends. Each renderer code setting up initial render state has been moved to a function so it could be called at the start of rendering and when a ResetRenderState is requested. [@ocornut, @bear24rw]
    • InputText:
    • ๐Ÿ›  Fixed selection background rendering one frame after the cursor movement when first transitioning from no-selection to has-selection. (Bug in 1.69) (#2436) [@Nazg-Gul]
    • ๐Ÿ–จ Work-around for buggy standard libraries where isprint('\t') returns true. (#2467, #1336)
    • ๐Ÿ›  Fixed ImGuiInputTextFlags_AllowTabInput leading to two tabs characters being inserted if the back-end provided both Key and Character input. (#2467, #1336)
    • Layout:
    • โž• Added SetNextItemWidth() helper to avoid using PushItemWidth()/PopItemWidth() for single items. Note that SetNextItemWidth() currently only affect the same subset of items as PushItemWidth(), generally referred to as the large framed+labeled items. Because the new SetNextItemWidth() function is explicit we may later extend its effect to more items.
    • ๐Ÿ›  Fixed PushItemWidth(-width) for right-side alignment laying out some items (button, listbox, etc.) with negative sizes if the 'width' argument was smaller than the available width at the time of item submission.
    • Window:
    • ๐Ÿ›  Fixed window with the ImGuiWindowFlags_AlwaysAutoResize flag unnecessarily extending their hovering boundaries by a few pixels (this is used to facilitate resizing from borders when available for a given window). One of the noticeable minor side effect was that navigating menus would have had a tendency to disable highlight from parent menu items earlier than necessary while approaching the child menu.
    • ๐Ÿ’… Close button is horizontally aligned with style.FramePadding.x.
    • ๐Ÿ›  Fixed contents region being off by WindowBorderSize amount on the right when scrollbar is active.
    • ๐Ÿ›  Fixed SetNextWindowSizeConstraints() with non-rounded positions making windows drift. (#2067, #2530)
    • Popups:
    • โช Closing a popup restores the focused/nav window in place at the time of the popup opening, instead of restoring the window that was in the window stack at the time of the OpenPopup call. (#2517). Among other things, this allows opening a popup while no window are focused, and pressing Escape to clear the focus again.
    • ๐Ÿ›  Fixed right-click from closing all popups instead of aiming at the hovered popup level (regression in 1.67).
    • ๐Ÿ‘ Selectable: With ImGuiSelectableFlags_AllowDoubleClick doesn't return true on the mouse button release following the double-click. Only first mouse release + second mouse down (double-click) returns true. Likewise for internal ButtonBehavior() with both _PressedOnClickRelease | _PressedOnDoubleClick. (#2503)
    • ๐Ÿš€ GetMouseDragDelta(): also returns the delta on the mouse button released frame. (#2419)
    • GetMouseDragDelta(): verify that mouse positions are valid otherwise returns zero.
    • ๐Ÿ‘ Inputs: Support for horizontal scroll with Shift+Mouse Wheel. (#2424, #1463) [@LucaRood]
    • PlotLines, PlotHistogram: Ignore NaN values when calculating min/max bounds. (#2485)
    • ๐Ÿ›  Columns: Fixed boundary of clipping being off by 1 pixel within the left column. (#125)
    • Separator: Declare its thickness (1.0f) to the layout, making items on both ends of a separator look more symmetrical.
    • Combo, Slider, Scrollbar: Improve rendering in situation when there's only a few pixels available (<3 pixels).
    • ๐Ÿ›  Nav: Fixed Drag/Slider functions going into text input mode when keyboard CTRL is held while pressing NavActivate.
    • ๐Ÿ›  Drag and Drop: Fixed drag source with ImGuiDragDropFlags_SourceAllowNullID and null ID from receiving click regardless of being covered by another window (it didn't honor correct hovering rules). (#2521)
    • ImDrawList: Improved algorithm for mitre joints on thick lines, preserving correct thickness up to 90 degrees angles, also faster to output. (#2518) [@rmitton]
    • ๐Ÿ Metrics: Added "Show windows rectangles" tool to visualize the different rectangles.
    • Demo: Improved trees in columns demo.
    • Examples:
    • OpenGL3: Minor tweaks + not calling glBindBuffer more than necessary in the render loop.
    • Vulkan:
    • ๐Ÿ›  Fixed in-flight buffers issues when using multi-viewports. (#2461, #2348, #2378, #2097)
    • โž• Added missing support for 32-bit indices (#define ImDrawIdx unsigned int).
    • Avoid passing negative coordinates to vkCmdSetScissor, which debug validation layers do not like.
    • Added ImGui_ImplVulkan_SetMinImageCount() to change min image count at runtime. (#2071) [@nathanvoglsam]