All Versions
18
Latest Version
Avg Release Cycle
51 days
Latest Release
675 days ago

Changelog History
Page 1

  • v1.79 Changes

    November 25, 2020

    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 some features that you've been ignoring until now!

    ๐Ÿ’ฅ Breaking Changes

    • ๐Ÿšš Fonts: Removed Font::displayOffset in favor of FontConfig::glyphOffset. displayOffset was applied after scaling and not very meaningful/useful outside of being needed by the default ProggyClean font. It was also getting in the way of better font scaling, so let's get rid of it now! If you used displayOffset it was probably in association to rasterizing a font at a specific size, in which case the corresponding offset may be reported into glyphOffset. If you scaled this value after calling addFontDefault(), this is now done automatically. (#1619)
    • ListClipper: Renamed constructor parameters which created an ambiguous alternative to using the ListClipper::begin() function, with misleading edge cases. Always use ListClipper::begin()!
    • ๐Ÿ’… Style: Renamed style.tabMinWidthForUnselectedCloseButton to style.tabMinWidthForCloseButton.
    • ๐Ÿ“‡ Renamed SliderFlag.ClampOnInput to SliderFlag.AlwaysClamp.
    • โช Renamed openPopupContextItem() back to openPopupOnItemClick(), REVERTED CHANGE FROM 1.77. For variety of reason this is more self-explanatory and less error-prone.
    • โœ‚ Removed return value from openPopupOnItemClick() - returned true on mouse release on item - because it is inconsistent with other popups API and makes others misleading. It's also and unnecessary: you can use isWindowAppearing() after beginPopup() for a similar result.

    Other Changes

    • ๐Ÿ›  Vulkan backend fixed and available!
    • ๐Ÿ›  Window: Fixed using non-zero pivot in setNextWindowPos() when the window is collapsed. (#3433)
    • Nav:
      • Fixed navigation resuming on first visible item when using gamepad. [@rokups]
      • Fixed using Alt to toggle the Menu layer when inside a Modal window. (#787)
    • ๐Ÿ›  Scrolling: Fixed setScrollHere() functions edge snapping when called during a frame where contentSize is changing (issue introduced in 1.78). (#3452).
    • InputText:
      • Added support for Page Up/Down in inputTextMultiline(). (#3430) [@Xipiryon]
      • Added selection helpers in InputTextCallbackData().
      • Added InputTextFlag.CallbackEdit to modify internally owned buffer after an edit (note that inputText() already returns true on edit, the callback is useful mainly to manipulate the underlying buffer while focus is active).
      • Fixed using InputTextFlag.Password with inputTextMultiline(). It is a rather unusual or useless combination of features but no reason it shouldn't work! (#3427, #3428)
      • Fixed minor scrolling glitch when erasing trailing lines in inputTextMultiline().
      • Fixed cursor being partially covered after using CTRL+End key.
      • Fixed callback's helper deleteChars() function when cursor is inside the deleted block. (#3454)
      • Made pressing Down arrow on the last line when it doesn't have a carriage return not move to the end of the line (so it is consistent with Up arrow, and behave same as Notepad and Visual Studio. Note that some other text editors instead would move the cursor to the end of the line). [@Xipiryon]
    • Tab Bar:
      • Added tabItemButton() to submit tab that behave like a button. (#3291) [@Xipiryon]
      • Added TabItemFlag.Leading and TabItemFlag.Trailing flags to position tabs or button at either end of the tab bar. Those tabs won't be part of the scrolling region, and when reordering cannot be moving outside of their section. Most often used with tabItemButton(). (#3291) [@Xipiryon]
      • Added TabItemFlag.NoReorder flag to disable reordering a given tab.
      • Keep tab item close button visible while dragging a tab (independent of hovering state).
      • Fixed a small bug where closing a tab that is not selected would leave a tab hole for a frame.
      • Fixed a small bug where scrolling buttons (with TabBarFlag.FittingPolicyScroll) would generate an unnecessary extra draw call.
      • Fixed a small bug where toggling a tab bar from Reorderable to not Reorderable would leave tabs reordered in the tab list popup. [@Xipiryon]
    • dragFloat, dragScalar: Fixed SliderFlag.ClampOnInput not being honored in the special case where v_min == v_max. (#3361)
    • ๐Ÿ›  sliderInt, sliderScalar: Fixed reaching of maximum value with inverted integer min/max ranges, both with signed and unsigned types. Added reverse Sliders to Demo. (#3432, #3449) [@rokups]
    • Text: Bypass unnecessary formatting when using the textColored()/textWrapped()/textDisabled() helpers with a "%s" format string. (#3466)
    • CheckboxFlags: Display mixed-value/tristate marker when passed flags that have multiple bits set and stored value matches neither zero neither the full set.
    • ๐Ÿ›  BeginMenuBar: Fixed minor bug where cursorPosMax gets pushed to cursorPos prior to calling beginMenuBar() so e.g. calling the function at the end of a window would often add +itemSpacing.y to scrolling range.
    • ๐Ÿ‘ treeNode, collapsingHeader: Made clicking on arrow toggle toggle the open state on the Mouse Down event rather than the Mouse Down+Up sequence, even if the .OpenOnArrow flag isn't set. This is standard behavior and amends the change done in 1.76 which only affected cases were OpenOnArrow flag was set. (This is also necessary to support full multi/range-select/drag and drop operations.)
    • Columns: Fix inverted clipRect being passed to renderer when using certain primitives inside of a fully clipped column. (#3475) [@szreder]
    • Popups, Tooltips: Fix edge cases issues with positioning popups and tool-tips when they are larger than viewport on either or both axises. [@rokups]
    • 0๏ธโƒฃ Fonts: addFontDefault() adjust its vertical offset based on floor(size/13) instead of always +1. Was previously done by altering displayOffset.y but wouldn't work for DPI scaled font.
    • ๐Ÿ Metrics: Various tweaks, listing windows front-to-back, greying inactive items when possible.
    • Demo: Add simple inputText() callbacks demo (aside from the more elaborate ones in Examples->Console).
    • Backends:
      • Vulkan:
      • Some internal refactor aimed at allowing multi-viewport feature to create their own render pass. (#3455, #3459) [@FunMiles]
      • Reworked buffer resize handling, fix for Linux/X11. (#3390, #2626) [@RoryO]
      • Switch validation layer to use `VK\_LAYER\_KHRONOS\_validation instead ofVK_LAYER_LUNARG_standard_validation` which is deprecated (#3459) [@FunMiles]

    Tab Bar: tabItemButton() + TabItemFlag.Trailing

    image

    checkboxFlags() with visible tri-state (previously only in internals)

    image

    ๐Ÿš€ Original Changelogs

  • v1.78 Changes

    November 13, 2020

    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 some features that you've been ignoring until now!

    ๐Ÿ’ฅ Breaking Changes

    (Read carefully, not as scary as it sounds. If you maintain a language binding for dear imgui, you may want to evaluate how this might impact users, depending on the language provide dynamic dispatch functions, or simply let the low-level code handle it)

    • Obsoleted use of the trailing float power=1f parameter for those functions: [@ShironekoBen, @ocornut]
      • dragFloat(), dragFloat2(), dragFloat3(), dragFloat4(), dragFloatRange2(), dragScalar(), dragScalarN().
      • sliderFloat(), sliderFloat2(), sliderFloat3(), sliderFloat4(), sliderScalar(), sliderScalarN().
      • vSliderFloat(), vSliderScalar().
    • 0๏ธโƒฃ Replaced the final float power=1f argument with SliderFlags flags defaulting to None (aka 0, as with all our flags).
      In short, when calling those functions, if you omitted the 'power' parameter (likely in C++), you are not affected.
      DragInt, DragFloat, DragScalar: Obsoleted use of v_min > v_max to lock edits (introduced in 1.73, inconsistent, and was not demoed nor documented much, will be replaced a more generic ReadOnly feature).

    Other Changes

    • ๐Ÿ Nav: Fixed clicking on void (behind any windows) from not clearing the focused window. This would be problematic e.g. in situation where the application relies on io.wantCaptureKeyboard flag being cleared accordingly. (bug introduced in 1.77 WIP on 2020/06/16) (#3344, #2880)
    • ๐Ÿšš Window: Fixed clicking over an item which hovering has been disabled (e.g inhibited by a popup) from marking the window as moved.
    • Drag, Slider: Added SliderFlags parameters.
    • ๐Ÿ‘€ For float functions they replace the old trailing float power=1f parameter. (See #3361 and the "Breaking Changes" block above for all details).
    • โž• Added SliderFlag.Logarithmic flag to enable logarithmic editing (generally more precision around zero), as a replacement to the old 'float power' parameter which was obsoleted. (#1823, #1316, #642) [@ShironekoBen, @AndrewBelt]
    • โž• Added SliderFlag.ClampOnInput flag to force clamping value when using CTRL+Click to type in a value manually. (#1829, #3209, #946, #413).
    • โž• Added SliderFlag.NoRoundToFormat flag to disable rounding underlying value to match precision of the display format string. (#642)
    • โž• Added SliderFlag.NoInput flag to disable turning widget into a text input with CTRL+Click or Nav Enter.- Nav, Slider: Fix using keyboard/gamepad controls with certain logarithmic sliders where pushing a direction near zero values would be cancelled out. [@ShironekoBen]
    • ๐Ÿ›  dragFloatRange2, dragIntRange2: Fixed an issue allowing to drag out of bounds when both min and max value are on the same value. (#1441)
    • ๐Ÿ›  InputText, ImDrawList: Fixed assert triggering when drawing single line of text with more than ~16 KB characters. (Note that current code is going to show corrupted display if after clipping, more than 16 KB characters are visible in the same low-level DrawList::renderText() call. ImGui-level functions such as textUnformatted() are not affected. This is quite rare but it will be addressed later). (#3349)
    • ๐Ÿ›  Selectable: Fixed highlight/hit extent when used with horizontal scrolling (in or outside columns). Also fixed related text clipping when used in a column after the first one. (#3187, #3386)
    • ๐Ÿšš Scrolling: Avoid setScroll(), setScrollFromPos() functions from snapping on the edge of scroll limits when close-enough by (WindowPadding - ItemPadding), which was a tweak with too many side-effects. The behavior is still present in SetScrollHere() functions as they are more explicitly aiming at making widgets visible. May later be moved to a flag.
    • Tab Bar: Allow calling setTabItemClosed() after a tab has been submitted (will process next frame).
    • ๐Ÿ— InvisibleButton: Made public a small selection of ButtonFlags (previously in imgui_internal.h) and allowed to pass them to invisibleButton(): ButtonFlag.MouseButtonLeft/Right/Middle. This is a small but rather important change because lots of multi-button behaviors could previously only be achieved using lower-level/internal API. Now also available via high-level invisibleButton() with is a de-facto versatile building block to creating custom widgets with the public API.
    • ๐Ÿ”€ Fonts: Fixed FontConfig::glyphExtraSpacing and FontConfig::pixelSnapH settings being pulled from the merged/target font settings when merging fonts, instead of being pulled from the source font settings.
    • DrawList: Thick anti-aliased strokes (> 1.0f) with integer thickness now use a texture-based path, reducing the amount of vertices/indices and CPU/GPU usage. (#3245) [@ShironekoBen]
    • ๐Ÿ’… This change will facilitate the wider use of thick borders in future style changes.
    • 0๏ธโƒฃ Requires an extra bit of texture space (~64x64 by default), relies on GPU bilinear filtering.
    • Set io.antiAliasedLinesUseTex = false to disable rendering using this method.
    • Clear FontAtlasFlag.NoBakedLines in FontAtlas::flags to disable baking data in texture.
    • ๐Ÿ’… DrawList: changed addCircle(), addCircleFilled() default num_segments from 12 to 0, effectively enabling auto-tessellation by default. Tweak tessellation in Style Editor->Rendering section, or by modifying the style.circleSegmentMaxError value. [@ShironekoBen]
    • ๐Ÿš€ DrawList: Fixed minor bug introduced in 1.75 where addCircle() with 12 segments would generate an extra vertex. (This bug was mistakenly marked as fixed in earlier 1.77 release). [@ShironekoBen]
    • Demo: Improved "Custom Rendering"->"Canvas" demo with a grid, scrolling and context menu. Also showcase using invisibleButton() with multiple mouse buttons flags.
    • Demo: Improved "Layout & Scrolling" -> "Clipping" section.
    • ๐Ÿ Demo: Improved "Layout & Scrolling" -> "Child Windows" section.
    • ๐Ÿ’… Style Editor: Added preview of circle auto-tessellation when editing the corresponding value.

    ๐Ÿš€ Original Changelogs

  • v1.77 Changes

    October 20, 2020

    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 some features that you've been ignoring until now!

    ๐Ÿ’ฅ Breaking Changes

    (Read carefully, not as scary as it sounds. If you maintain a language binding for dear imgui, you may want to evaluate how this might impact users, depending on the language provide dynamic dispatch functions, or simply let the low-level code handle it)

    • โœ‚ Removed FontAtlas::addCustomRectRegular() unnecessary first argument ID. Please note that this is a Beta api and will likely be reworked in order to support multi-DPI across multiple monitor s.
    • ๐Ÿ“‡ Renamed openPopupOnItemClick() to openPopupContextItem(). Kept inline redirection function (will obsolete).
    • โœ‚ Removed beginPopupContextWindow(label: String, mouseButton: Int, alsoOverItems: Boolean) in favor of beginPopupContextWindow(label: String, flags: PopupFlag) with PopupFlag.NoOverItems.
    • โœ‚ Removed obsoleted calcItemRectClosestPoint() entry point (has been asserting since December 2017).

    Other Changes

    • TreeNode: Fixed bug where beginDragDropSource() failed when the _OpenOnDoubleClick flag is enabled (bug introduced in 1.76, but pre-1.76 it would also fail unless the _OpenOnArrow flag was also set, and _OpenOnArrow is frequently set along with _OpenOnDoubleClick).
    • TreeNode: Fixed bug where dragging a payload over a treeNode() with either _OpenOnDoubleClick or _OpenOnArrow would open the node. (#143)
    • ๐Ÿ Windows: Fix unintended feedback loops when resizing windows close to main viewport edges. [@rokups]
    • ๐Ÿ’… Tabs: Added style.tabMinWidthForUnselectedCloseButton settings:
      • Set to 0f (default) to always make a close button appear on hover (same as Chrome, VS).
      • Set to Float.MAX_VALUE to only display a close button when selected (merely hovering is not enough).
      • Set to an intermediary value to toggle behavior based on width (same as Firefox).
    • Tabs: Added a TabItemFlag.NoTooltip flag to disable the tooltip for individual tab item (vs TabBarFlag.NoTooltip for entire tab bar). - [@Xipiryon]
      Popups: All functions capable of opening popups (openPopup*, beginPopupContext*) now take a new PopupFlags sets of flags instead of a mouse button index. The API is automatically backward compatible as PopupFlags is guaranteed to hold mouse button index in the lower bits.
    • Popups: Added PopupFlag.NoOpenOverExistingPopup for openPopup*/beginPopupContext* functions to first test for the presence of another popup at the same level.
    • โœ… Popups: Added PopupFlag.NoOpenOverItems for beginPopupContextWindow() - similar to testing for !isAnyItemHovered() prior to doing an openPopup().
    • Popups: Added PopupFlag.AnyPopupId and PopupFlag.AnyPopupLevel flags for isPopupOpen(), allowing to check if any popup is open at the current level, if a given popup is open at any popup level, if any popup is open at all.
    • Popups: Fix an edge case where programmatically closing a popup while clicking on its empty space would attempt to focus it and close other popups. (#2880)
    • Popups: Fix beginPopupContextVoid() when clicking over the area made unavailable by a modal. (#1636)
    • Popups: Clarified some of the comments and function prototypes.
    • ๐Ÿ Modals: beginPopupModal() doesn't set the WindowFlag.NoSavedSettings flag anymore, and will not always be auto-centered. Note that modals are more similar to regular windows than they are to popups, so api and behavior may evolve further toward embracing this. (#915, #3091). Enforce centering using e.g. setNextWindowPos(io.displaySize * 0.5f, Cond.Appearing, Vec2(0.5f)).
    • Metrics: Added a "Settings" section with some details about persistent ini settings.
    • Nav, Menus: Fix vertical wrap-around in menus or popups created with multiple appending calls to beginMenu()/endMenu() or beginPopup()/endPopup(). (#3223, #1207) [@rokups]
    • ๐Ÿ›  Drag and Drop: Fixed unintended fallback "..." tooltip display during drag operation when
    • drag source uses SourceNoPreviewTooltip flags. (#3160) [@rokups]
    • Columns: Lower overhead on column switches and switching to background channel.
    • Benefits Columns but was primarily made with Tables in mind!
    • Fonts: Fix getGlyphRangesKorean() end-range to end at 0xD7A3 (instead of 0xD79D). (#348, #3217) [@marukrap]
    • ๐Ÿ”€ DrawList: Fixed an issue where draw command merging or primitive unreserve while crossing the VtxOffset boundary would lead to draw commands with wrong VtxOffset. (#3129, #3163, #3232, #2591) [@thedmd, @ShironekoBen, @sergeyn, @ocornut]
    • ๐Ÿ›  DrawList, DrawListSplitter, Columns: Fixed an issue where changing channels with different TextureId, VtxOffset would incorrectly apply new settings to draw channels. (#3129, #3163) [@ocornut, @thedmd, @ShironekoBen]
    • ๐Ÿ›  DrawList, DrawListSplitter, Columns: Fixed an issue where starting a split when current VtxOffset was not zero would lead to draw commands with wrong VtxOffset. (#2591)
    • ๐Ÿ›  DrawList, DrawListSplitter, Columns: Fixed an issue where starting a split right after a callback draw command would incorrectly override the callback draw command.
    • ๐Ÿ›  DrawList: Fixed minor bug introduced in 1.75 where addCircle() with 12 segments would generate an extra unrequired vertex. [@ShironekoBen]
    • ๐Ÿ“„ Docs: Improved and moved font documentation to docs/FONTS.md so it can be readable on the web. Updated various links/wiki accordingly. Added FAQ entry about DPI. (#2861) [@ButternCream, @ocornut]
    • Backends: OpenGL: Fixed handling of GL 4.5+ glClipControl(GL_UPPER_LEFT) by inverting the projection matrix top and bottom values. (#3143, #3146) [@u3shit]
    • ๐Ÿ Examples: GLFW+Vulkan, SDL+Vulkan: Fix for handling of minimized windows. (#3259)

    ๐Ÿš€ Original Changelogs

  • v1.76 Changes

    May 06, 2020

    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 some features that you've been ignoring until now!

    All Changes

    (No known API breaking changes)

    • Drag and Drop, Nav: Disabling navigation arrow keys when drag and drop is active. In the docking branch pressing arrow keys while dragging a window from a tab could trigger an assert. (#3025)
    • BeginMenu: Using same ID multiple times appends content to a menu. (#1207) [@rokups]
    • ๐Ÿ›  BeginMenu: Fixed a bug where setNextWindowXXX data before a beginMenu() would not be cleared when the menu is not open. (#3030)
    • ๐Ÿ›  InputText: Fixed password fields displaying ASCII spaces as blanks instead of using the '*' glyph. (#2149, #515)
    • ๐Ÿ’… Selectable: Fixed honoring style.selectableTextAlign with unspecified size. (#2347, #2601)
    • Selectable: Allow using SelectableFlag.SpanAllColumns in other columns than first. (#125)
    • TreeNode: Made clicking on arrow with _OpenOnArrow toggle the open state on the Mouse Down event rather than the Mouse Down+Up sequence (this is rather standard behavior).
    • ๐Ÿšš ColorButton: Added ColorEditFlag.NoBorder flag to remove the border normally enforced by default for standalone ColorButton.
    • ๐Ÿ›  Nav: Fixed interactions with ListClipper, so e.g. Home/End result would not clip the landing item on the landing frame. (#787)
    • ๐Ÿ›  Nav: Internals: Fixed currently focused item from ever being clipped by ItemAdd(). (#787)
    • ๐Ÿ›  Scrolling: Fixed scrolling centering API leading to non-integer scrolling values and initial cursor position. This would often get fixed after the fix item submission, but using the ListClipper as the first thing after begin() could largely break size calculations. (#3073)
    • โž• Added optional support for Unicode plane 1-16 (#2538, #2541, #2815) [@cloudwu, @samhocevar]
      • More onsistent handling of unsupported code points (0xFFFD).
      • Surrogate pairs are supported when submitting UTF-16 data via io.addInputCharacterUTF16(), allowing for more complete CJK input.
      • Various structures such as Font, GlyphRangesBuilder will use more memory, this is currently not particularly efficient.
    • Columns: undid the change in 1.75 were columns()/beginColumns() were preemptively limited to 64 columns with an assert. (#3037, #125)
    • ๐Ÿ›  Window: Fixed a bug with child window inheriting ItemFlags from their parent when the child window also manipulate the ItemFlags stack. (#3024) [@Stanbroek]
    • ๐Ÿ›  Font: Fixed non-ASCII space occasionally creating unnecessary empty looking polygons.
    • Misc: Added additional checks in endFrame() to verify that io.keyXXX values have not been tampered with between newFrame() and endFrame().
    • 0๏ธโƒฃ Misc: Made default clipboard handlers for Win32 and OSX use a buffer inside the main context instead of a static buffer, so it can be freed properly on Shutdown. (#3110)
    • ๐Ÿ Metrics: Made Tools section more prominent. Showing wire-frame mesh directly hovering the DrawCmd instead of requiring to open it. Added options to disable bounding box and mesh display. Added notes on inactive/gc-ed windows.
    • Demo: Added black and white and color gradients to Demo>Examples>Custom Rendering.
    • โœ… Backends: OpenGL3: Fixed version check mistakenly testing for GL 4.0+ instead of 3.2+ to enable BackendFlag.RendererHasVtxOffset, leaving 3.2 contexts without it. (#3119, #2866) [@wolfpld]
  • v1.75 Changes

    February 17, 2020

    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 some features that you've been ignoring until now!

    TL;DR;

    • ๐Ÿ‘ [JVM], completed the moving to full mirror native imgui support in terms of UTF8 and (double) Char
    • ๐Ÿ›  Dozens of fixes, e.g. for Ctrl+Tab, InputText, ColorEdit, in backends etc. among other things.
    • โž• Added DrawList::addNgon apis for explicit low-polygon count, in prevision for future version making all circles actually round. DrawList::addCircle apis can now takes a zero segment count to use auto-tesselation.
    • [JVM only] double click on a word in text selects only that world, up to the next space included. Native selects still everything

    ๐Ÿ’ฅ Breaking Changes

    • โœ‚ Removed implicit default parameter to IsMouseDragging(int button = 0) to be consistent with other mouse functions (none of the other functions have it).
    • DrawList::addCircle()/addCircleFilled() functions don't accept negative radius.
    • ๐Ÿ‘ Limiting columns()/beginColumns() api to 64 columns with an assert. While the current code technically supports it, future code may not so we're putting the restriction ahead.
    • ๐Ÿ”„ changed Rect() default constructor initializes all fields to 0f instead of Float.MAX_VALUE. If you used Rect::add() to create bounding boxes by adding multiple points into it without an explicit initialization, you may need to fix your initial value.

    Other Changes

    • ๐Ÿ†“ Inputs: Added MouseButton enum for convenience (e.g. MouseButton.Right.i=1). We forever guarantee that the existing value will not changes so existing code is free to use 0/1/2.
    • ๐Ÿ›  Nav: Fixed a bug where the initial CTRL-Tab press while in a child window sometimes selected the current root window instead of always selecting the previous root window. (#787)
    • ColorEdit: Fix label alignment when using ColorEditFlags.NoInputs. (#2955) [@rokups]
    • ๐Ÿ”’ ColorEdit: In HSV display of a RGB stored value, attempt to locally preserve Saturation when Value==0.0 (similar to changes done in 1.73 for Hue). Removed Hue editing lock since those improvements in 1.73 makes them unnecessary. (#2722, #2770). [@rokups]
    • ColorEdit: "Copy As" context-menu tool shows hex values with a '#' prefix instead of '0x'.
    • ColorEdit: "Copy As" content-menu tool shows hex values both with/without alpha when available.
    • โช InputText: Fix corruption or crash when executing undo after clearing input with ESC, as a byproduct we are allowing to later undo the revert with a CTRL+Z. (#3008).
    • MenuBar: Fix minor clipping issue where occasionally a menu text can overlap the right-most border.
    • Window: Fix setNextWindowBgAlpha(1f) failing to override alpha component. (#3007) [@Albog]
    • โœ… Window: When testing for the presence of the WindowFlags.NoBringToFrontOnFocus flag we test both the focused/clicked window (which could be a child window) and the root window.
    • ๐Ÿ’… DrawList: addCircle(), addCircleFilled() API can now auto-tessellate when provided a segment count of zero. Alter tessellation quality with style.CircleSegmentMaxError. [@ShironekoBen]
    • DrawList: Add addNgon(), addNgonFilled() API with a guarantee on the explicit segment count. In the current branch they are essentially the same as addCircle(), addCircleFilled() but as we will rework the circle rendering functions to use textures and automatic segment count selection, those new api can fill a gap. [@ShironekoBen]
    • Columns: DrawList::channels* functions now work inside columns. Added extra comments to suggest using user-owned DrawListSplitter instead of DrawList functions. [@rokups]
    • Misc: Added MouseCursor.NotAllowed enum so it can be used by more shared widgets. [@rokups]
    • ๐Ÿ‘ Backends: GLFW: (started) adding support for the missing mouse cursors newly added in GLFW 3.4+. [@rokups]
      [JVM] transition will be complete with the next lwjgl stable version

    Help wanted!

    • ๐Ÿ“š [JVM] Documentation is terrible outdated, we need help to update it
    • ๐Ÿ“š Dear ImGui is looking for a technical writer to help writing technical articles, tutorials and documentation. Please reach out if you are interesting in helping!.
    • ๐Ÿ‘€ The Vulkan renderer appears to have issues (see vulkan tag)
      Browsing issues and todo list you may find something something to contribute to!
  • v1.74 Changes

    December 12, 2019

    โšก๏ธ Updates:

    • kotlin 1.3.61
    • lwjgl 3.2.3
    • gradle 6.0.1
    • shadow 5.2.0
    • ๐Ÿ‘• kotlintest 3.4.2

    ๐Ÿ”„ Changelogs:

    ๐Ÿš€ This is a general release, 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 some features that you've been ignoring until now!

    Thanks for the last help:

    ๐Ÿ‘ @Sylvyrfysh (support help and coding)
    ๐Ÿ‘ @exuvo (support help)
    @yuraj11 and @ebak for donating

    and all the others opening issues and help tracking down bugs

    TL;DR;

    • โœ‚ Removed redirecting functions/enums names which were marked obsolete in 1.52 (October 2017). (it doesnt affect our port, we never keep them)
    • ๐Ÿ›  Quantity of fixes.
    • ๐Ÿ‘Œ Improved readme, docs, links, wiki hub.
    • ๐Ÿ‘Œ Improved our continuous integration and testing suite.

    ๐Ÿ’ฅ Breaking Changes:

    • ๐Ÿ›  Inputs: Fixed a miscalculation in the keyboard/mouse "typematic" repeat delay/rate calculation, used by keys and e.g. repeating mouse buttons as well as the GetKeyPressedAmount() function.
      0๏ธโƒฃ If you were using a non-default value for io.KeyRepeatRate (previous default was 0.250), you can add +io.KeyRepeatDelay to it to compensate for the fix.
      ๐Ÿ›  The function was triggering on: 0.0 and (delay+rate*N) where (N>=1). Fixed formula responds to (N>=0).
      Effectively it made io.KeyRepeatRate behave like it was set to (io.KeyRepeatRate + io.KeyRepeatDelay).
      ๐Ÿ›  Fixed the code and altered default io.KeyRepeatRate,Delay from 0.250,0.050 to 0.300,0.050 to compensate.
      If you never altered io.KeyRepeatRate nor used GetKeyPressedAmount() this won't affect you.
    • Fonts: FontAtlas::addCustomRectRegular() now requires an ID larger than 0x110000 (instead of 0x10000) to
      โšก๏ธ conform with supporting Unicode planes 1-16 in a future update. ID below 0x110000 will now assert.

    Other Changes:

    • ๐Ÿ›  InputText, Nav: Fixed Home/End key broken when activating Keyboard Navigation. (#787)
    • InputText: Filter out ASCII 127 (DEL) emitted by low-level OSX layer, as we are using the Key value. (#2578)
    • ๐Ÿ›  Layout: Fixed a couple of subtle bounding box vertical positioning issues relating to the handling of text baseline alignment. The issue would generally manifest when laying out multiple items on a same line, with varying heights and text baseline offsets. Some specific examples, e.g. a button with regular frame padding followed by another item with a multi-line label and no frame padding, such as: multi-line text, small button, tree node item, etc. The second item was correctly offset to match text baseline, and would interact/display correctly, but it wouldn't push the contents area boundary low enough.
    • ๐Ÿ›  Scrollbar: Fixed an issue where scrollbars wouldn't display on the frame following a frame where all child window contents would be culled.
    • ๐Ÿ›  ColorPicker: Fixed SV triangle gradient to block (broken in 1.73). (#2864, #2711). [@lewa-j]
    • ๐Ÿ›  TreeNode: Fixed combination of TreeNodeFlag.SpanFullWidth and TreeNodeFlag.OpenOnArrow incorrectly locating the arrow hit position to the left of the frame. (#2451, #2438, #1897)
    • TreeNode: The collapsing arrow accepts click even if modifier keys are being held, facilitating interactions with custom multi-selections patterns. (#2886, #1896, #1861)
    • TreeNode: Added IsItemToggledOpen() to explicitly query if item was just open/closed, facilitating interactions with custom multi-selections patterns. (#1896, #1861)
    • DragScalar, SliderScalar, InputScalar: Added p_ prefix to parameter that are pointers to the data to clarify how they are used, and more comments redirecting to the demo code. (#2844)
    • Error handling: Assert if user mistakenly calls End() instead of EndChild() on a child window. (#1651)
    • ๐Ÿ“„ Docs: Improved and moved FAQ to docs/FAQ.md so it can be readable on the web. [@ButternCream, @ocornut]
    • ๐Ÿ“„ Docs: Moved misc/fonts/README.txt to docs/FONTS.txt.
    • ๐Ÿ“„ Docs: Added permanent redirect from https://www.dearimgui.org/faq to FAQ page.
    • Demo: Added simple item reordering demo in Widgets -> Drag and Drop section. (#2823, #143) [@rokups]
    • Metrics: Show wire-frame mesh and approximate surface area when hovering ImDrawCmd. [@ShironekoBen]
    • Metrics: Expose basic details of each window key/value state storage.
    • ๐Ÿ— Backends: OpenGL3: Fix building with pre-3.2 GL loaders which do not expose glDrawElementsBaseVertex(), using runtime GL version to decide if we set ImGuiBackendFlags_RendererHasVtxOffset. (#2866, #2852) [@dpilawa]
    • Backends: OSX: Fix using Backspace key. (#2578, #2817, #2818) [@DiligentGraphics]
  • v1.71 Changes

    August 19, 2019

    ๐Ÿš€ Monthly release!

    ๐Ÿš€ This is a general release following 1.70, 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 some features that you've been ignoring until now!

    TL;DR;

    • ๐Ÿ‘€ Made SetNextWindowContentSize() actually useful (see details below).
    • ๐Ÿ›  Fixes for tree nodes, collapsing headers, tab bars, columns inside an horizontally scrolling region.
    • ๐Ÿ”€ Dozens of other fixes and small additions. Also synched the Docking branch accordingly.

    ๐Ÿ’ฅ Breaking Changes

    • IO: changed io.AddInputCharacter(unsigned short c) signature to io.AddInputCharacter(unsigned int c).
    • ๐Ÿ“‡ Renamed SetNextTreeNodeOpen() to SetNextItemOpen(). Kept inline redirection function (will obsolete).
    • ๐Ÿ Window: rendering of child windows outer decorations (e.g. bg color, border, scrollbars) is now performed as part of their parent window, avoiding the creation of an extraneous draw commands. If you have overlapping child windows with decorations, and relied on their relative z-order to be mapped to submission their order, this will affect your rendering. The optimization is disabled if the parent window has no visual output because it appears to be the most common situation leading to the creation of overlapping child windows. Please reach out if you are affected by this change!

    Other Changes:

    • ๐Ÿ Window: clarified behavior of SetNextWindowContentSize(). Content size is defined as the size available after removal of WindowPadding on each sides. So SetNextWindowContentSize(ImVec2(100,100)) + auto-resize will always allow submitting a 100x100 item without creating a scrollbar, regarding of the WindowPadding value. The exact meaning of ContentSize for decorated windows was previously ill-defined.
    • ๐Ÿ›  Window: Fixed auto-resize with AlwaysVerticalScrollbar or AlwaysHorizontalScrollbar flags.
    • ๐Ÿ›  Window: Fixed one case where auto-resize by double-clicking the resize grip would make either scrollbar appear for a single frame after the resize.
    • โช Separator: Revert 1.70 "Declare its thickness (1.0f) to the layout" change. It's not incorrect but it breaks existing some layout patterns. Will return back to it when we expose Separator flags.
    • ๐Ÿ›  Fixed InputScalar, InputScalarN, SliderScalarN, DragScalarN with non-visible label from inserting style.ItemInnerSpacing.x worth of trailing spacing.
    • ๐Ÿ›  Fixed InputFloatX, SliderFloatX, DragFloatX functions erroneously reporting IsItemEdited() multiple times when the text input doesn't match the formatted output value (e.g. input "1" shows "1.000"). It wasn't much of a problem because we typically use the return value instead of IsItemEdited() here.
    • ๐Ÿ›  Fixed uses of IsItemDeactivated(), IsItemDeactivatedAfterEdit() on multi-components widgets and after EndGroup(). (#2550, #1875)
    • ๐Ÿ›  Fixed crash when appending with BeginMainMenuBar() more than once and no other window are showing. (#2567)
    • ๐Ÿ›  ColorEdit: Fixed the color picker popup only displaying inputs as HSV instead of showing multiple options. (#2587, broken in 1.69 by #2384).
    • ๐Ÿ‘ CollapsingHeader: Better clipping when a close button is enabled and it overlaps the label. (#600)
    • Scrollbar: Minor bounding box adjustment to cope with various border size.
    • ๐Ÿ’… Scrollbar, Style: Changed default style.ScrollbarSize from 16 to 14.
    • ๐Ÿ›  Combo: Fixed rounding not applying with the ImGuiComboFlags_NoArrowButton flag. (#2607) [@DucaRii]
    • ๐Ÿšš Nav: Fixed gamepad/keyboard moving of window affecting contents size incorrectly, sometimes leading to -scrollbars appearing during the movement.
    • ๐Ÿš€ Nav: Fixed rare crash when e.g. releasing Alt-key while focusing a window with a menu at the same frame as clearing the focus. This was in most noticeable in back-ends such as Glfw and SDL which emits key release events when focusing another viewport, leading to Alt+clicking on void on another viewport triggering the issue. (#2609)
    • ๐Ÿ›  TreeNode, CollapsingHeader: Fixed highlight frame not covering horizontal area fully when using horizontal scrolling. (#2211, #2579)
    • ๐Ÿ›  TabBar: Fixed BeginTabBar() within a window with horizontal scrolling from creating a feedback loop with the horizontal contents size.
    • ๐Ÿ›  Columns: Fixed Columns() within a window with horizontal scrolling from not covering the full horizontal area (previously only worked with an explicit contents size). (#125)
    • ๐Ÿ›  Columns: Fixed Separator() from creating an extraneous draw command. (#125)
    • ๐Ÿ›  Columns: Fixed Selectable() with ImGuiSelectableFlags_SpanAllColumns from creating an extraneous draw command. (#125)
    • ๐Ÿ’… Style: Added style.WindowMenuButtonPosition (left/right, defaults to ImGuiDir_Left) to move the collapsing/docking button to the other side of the title bar.
    • ๐Ÿ’… Style: Made window close button cross slightly smaller.
    • ๐Ÿ›  Log/Capture: Fixed BeginTabItem() label not being included in a text log/capture.
    • ๐Ÿ‘ ImDrawList: Added ImDrawCmd::VtxOffset value to support large meshes (64k+ vertices) using 16-bits indices. The renderer back-end needs to set io.BackendFlags |= ImGuiBackendFlags_RendererHasVtxOffset to enable this, and honor the ImDrawCmd::VtxOffset field. Otherwise the value will always be zero. This has the advantage of preserving smaller index buffers and allowing to execute on hardware that do not support 32-bits indices. Most examples back-ends have been modified to support the VtxOffset field. (not on JVM)
    • ImDrawList: Added ImDrawCmd::IdxOffset value, equivalent to summing element count for each draw command. This is provided for convenience and consistency with VtxOffset.
    • ImDrawCallback: Allow to override the signature of ImDrawCallback by #define-ing it. This is meant to facilitate custom rendering back-ends passing local render-specific data to the draw callback.
    • ImFontAtlas: FreeType: Added RasterizerFlags::Monochrome flag to disable font anti-aliasing. Combine with RasterizerFlags::MonoHinting for best results. (#2545) [@HolyBlackCat]
    • ๐Ÿ›  ImFontGlyphRangesBuilder: Fixed unnecessarily over-sized buffer, which incidentally was also not fully cleared. Fixed edge-case overflow when adding character 0xFFFF. (#2568). [@NIKE3500]
    • ๐Ÿ Demo: Added full "Dear ImGui" prefix to the title of "Dear ImGui Demo" and "Dear ImGui Metrics" windows.
    • ๐Ÿ‘ Examples/Backends: Don't filter characters under 0x10000 before calling io.AddInputCharacter(), the filtering is done in io.AddInputCharacter() itself. This is in prevision for fuller Unicode support. (#2538, #2541)
  • v1.70 Changes

    June 13, 2019

    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]
  • v1.69 Changes

    May 04, 2019

    ๐Ÿš€ This is a general release, keeping with the beat 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 to explore that you've been ignoring until now!

    TL;DR;

    • โž• Added native support for u8/s8/u16/s16 data types in DragScalar, InputScalar, SliderScalar functions. [still WIP on JVM]
    • โž• Added GetBackgroundDrawList() helper to easily submit draw list primitives behind every windows.
    • โž• Added InputTextWithHint() to display a greyed out message when an input field is empty.
    • โž• Added ImGuiColorEditFlags_InputHSV to edit HSV colors without internal RGB<>HSV roundtrips.
    • ๐Ÿ’ป Various fixes in the LogXXX functions to capture UI as text.
    • ๐Ÿ›  Examples: OpenGL: Fixes to support GL ES 2.0 (WebGL 1.0).
    • ๐Ÿ›  Dozens of other fixes and improvements.

    InputTextWithHint()
    image

    ImGuiDataType_S8/ImGuiDataType_U8/ImGuiDataType_S16/ImGuiDataType_U16 [still WIP on JVM]
    image

    GetBackgroundDrawList()
    image

    ๐Ÿ’ฅ Breaking Changes

    • Renamed ColorEdit/ColorPicker's ImGuiColorEditFlags_RGB/_HSV/_HEX flags to respectively ImGuiColorEditFlags_DisplayRGB/_DisplayHSV/_DisplayHex. This is because the addition of new flag ImGuiColorEditFlags_InputHSV makes the earlier one ambiguous. Keep redirection enum values (will obsolete). (#2384) [@haldean]
    • ๐Ÿ“‡ Renamed GetOverlayDrawList() to GetForegroundDrawList(). Kept redirection function (will obsolete). (#2391)

    Other Changes:

    • โž• Added GetBackgroundDrawList() helper to quickly get access to a ImDrawList that will be rendered behind every other windows. (#2391, #545)
    • ๐Ÿ‘ DragScalar, InputScalar, SliderScalar: Added support for u8/s8/u16/s16 data types (ImGuiDataType_S8 etc.). We are reusing function instances of larger types to reduce code size. (#643, #320, #708, #1011)
    • โž• Added InputTextWithHint() to display a description/hint in the text box when no text has been entered. (#2400) [@Organic-Code, @ocornut]
    • ๐Ÿ›  Nav: Fixed a tap on AltGR (e.g. German keyboard) from navigating to the menu layer.
    • ๐Ÿ›  Nav: Fixed Ctrl+Tab keeping active InputText() of a previous window active after the switch. (#2380)
    • ๐Ÿ›  Fixed IsItemDeactivated()/IsItemDeactivatedAfterEdit() from not correctly returning true when tabbing out of a focusable widget (Input/Slider/Drag) in most situations. (#2215, #1875)
    • ๐Ÿ’… InputInt, InputFloat, InputScalar: Fix to keep the label of the +/- buttons centered when style.FramePadding.x is abnormally larger than style.FramePadding.y. Since the buttons are meant to be square (to align with e.g. color button) we always use FramePadding.y. (#2367)
    • InputInt, InputScalar: +/- buttons now respects the natural type limits instead of overflowing or underflowing the value.
    • ๐Ÿ›  InputText: Fixed an edge case crash that would happen if another widget sharing the same ID is being swapped with an InputText that has yet to be activated.
    • ๐Ÿ›  InputText: Fixed various display corruption related to swapping the underlying buffer while a input widget is active (both for writable and read-only paths). Often they would manifest when manipulating the scrollbar of a multi-line input text.
    • ColorEdit, ColorPicker, ColorButton: Added ImGuiColorEditFlags_InputHSV to manipulate color values encoded as HSV (in order to avoid HSV<>RGB round trips and associated singularities). (#2383, #2384) [@haldean]
    • ๐Ÿ›  ColorPicker: Fixed a bug/assertion when displaying a color picker in a collapsed window while dragging its title bar. (#2389)
    • ๐Ÿ›  ColorEdit: Fixed tooltip not honoring the ImGuiColorEditFlags_NoAlpha contract of never reading the 4th float in the array (value was read and discarded). (#2384) [@haldean]
    • ๐Ÿ›  MenuItem, Selectable: Fixed disabled widget interfering with navigation (fix c2db7f6 in 1.67).
    • ๐Ÿ›  TabBar: Fixed a crash when using many BeginTabBar() recursively (didn't affect docking). (#2371)
    • TabBar: Added extra mis-usage error recovery. Past the assert, common mis-usage don't lead to hard crashes any more, facilitating integration with scripting languages. (#1651)
    • ๐Ÿ›  TabBar: Fixed ImGuiTabItemFlags_SetSelected being ignored if the tab is not visible (with scrolling policy enabled) or if is currently appearing.
    • ๐Ÿ›ฐ TabBar: Fixed Tab tooltip code making drag and drop tooltip disappear during the frame where the drag payload activate a tab.
    • TabBar: Reworked scrolling policy (when ImGuiTabBarFlags_FittingPolicyScroll is set) to teleport the view when aiming at a tab far away the visible section, and otherwise accelerate the scrolling speed to cap the scrolling time to 0.3 seconds.
    • ๐Ÿ›  Text: Fixed large Text/TextUnformatted calls not declaring their size into layout when starting below the lower point of the current clipping rectangle. Somehow this bug has been there since v1.0! It was hardly noticeable but would affect the scrolling range, which in turn would affect some scrolling request functions when called during the appearing frame of a window.
    • ๐Ÿ›  Plot: Fixed divide-by-zero in PlotLines() when passing a count of 1. (#2387) [@Lectem]
    • ๐Ÿ›  Log/Capture: Fixed LogXXX functions emitting an extraneous leading carriage return.
    • ๐Ÿ›  Log/Capture: Fixed an issue when empty string on a new line would not emit a carriage return.
    • Log/Capture: Fixed LogXXX functions 'auto_open_depth' parameter being treated as an absolute tree depth instead of a relative one.
    • ๐Ÿ›  Log/Capture: Fixed CollapsingHeader trailing ascii representation being "#" instead of "##".
    • ImFont: Added GetGlyphRangesVietnamese() helper. (#2403)
    • ๐Ÿ’… Misc: Asserting in NewFrame() if style.WindowMinSize is zero or smaller than (1.0f,1.0f).
    • Demo: Using GetBackgroundDrawList() and GetForegroundDrawList() in "Custom Rendering" demo.
    • Demo: InputText: Demonstrating use of ImGuiInputTextFlags_CallbackResize. (#2006, #1443, #1008).
    • ๐Ÿ Examples: GLFW, SDL: Preserve DisplayFramebufferScale when main viewport is minimized. (This is particularly useful for the viewport branch because we are not supporting per-viewport frame-buffer scale. It fixes windows not refreshing when main viewport is minimized.) (#2416)
    • Examples: OpenGL: Fix to be able to run on ES 2.0 / WebGL 1.0. [@rmitton, @gabrielcuvillier]
    • Examples: OpenGL: Fix for OSX not supporting OpenGL 4.5, we don't try to read GL_CLIP_ORIGIN even if the OpenGL headers/loader happens to define the value. (#2366, #2186)
  • v1.69-build Changes

    May 04, 2019

    ๐Ÿš€ This is a general release, keeping with the beat 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 to explore that you've been ignoring until now!

    TL;DR;

    • โž• Added native support for u8/s8/u16/s16 data types in DragScalar, InputScalar, SliderScalar functions. [still WIP on JVM]
    • โž• Added GetBackgroundDrawList() helper to easily submit draw list primitives behind every windows.
    • โž• Added InputTextWithHint() to display a greyed out message when an input field is empty.
    • โž• Added ImGuiColorEditFlags_InputHSV to edit HSV colors without internal RGB<>HSV roundtrips.
    • ๐Ÿ’ป Various fixes in the LogXXX functions to capture UI as text.
    • ๐Ÿ›  Examples: OpenGL: Fixes to support GL ES 2.0 (WebGL 1.0).
    • ๐Ÿ›  Dozens of other fixes and improvements.

    InputTextWithHint()
    image

    ImGuiDataType_S8/ImGuiDataType_U8/ImGuiDataType_S16/ImGuiDataType_U16 [still WIP on JVM]
    image

    GetBackgroundDrawList()
    image

    ๐Ÿ’ฅ Breaking Changes

    • Renamed ColorEdit/ColorPicker's ImGuiColorEditFlags_RGB/_HSV/_HEX flags to respectively ImGuiColorEditFlags_DisplayRGB/_DisplayHSV/_DisplayHex. This is because the addition of new flag ImGuiColorEditFlags_InputHSV makes the earlier one ambiguous. Keep redirection enum values (will obsolete). (#2384) [@haldean]
    • ๐Ÿ“‡ Renamed GetOverlayDrawList() to GetForegroundDrawList(). Kept redirection function (will obsolete). (#2391)

    Other Changes:

    • โž• Added GetBackgroundDrawList() helper to quickly get access to a ImDrawList that will be rendered behind every other windows. (#2391, #545)
    • ๐Ÿ‘ DragScalar, InputScalar, SliderScalar: Added support for u8/s8/u16/s16 data types (ImGuiDataType_S8 etc.). We are reusing function instances of larger types to reduce code size. (#643, #320, #708, #1011)
    • โž• Added InputTextWithHint() to display a description/hint in the text box when no text has been entered. (#2400) [@Organic-Code, @ocornut]
    • ๐Ÿ›  Nav: Fixed a tap on AltGR (e.g. German keyboard) from navigating to the menu layer.
    • ๐Ÿ›  Nav: Fixed Ctrl+Tab keeping active InputText() of a previous window active after the switch. (#2380)
    • ๐Ÿ›  Fixed IsItemDeactivated()/IsItemDeactivatedAfterEdit() from not correctly returning true when tabbing out of a focusable widget (Input/Slider/Drag) in most situations. (#2215, #1875)
    • ๐Ÿ’… InputInt, InputFloat, InputScalar: Fix to keep the label of the +/- buttons centered when style.FramePadding.x is abnormally larger than style.FramePadding.y. Since the buttons are meant to be square (to align with e.g. color button) we always use FramePadding.y. (#2367)
    • InputInt, InputScalar: +/- buttons now respects the natural type limits instead of overflowing or underflowing the value.
    • ๐Ÿ›  InputText: Fixed an edge case crash that would happen if another widget sharing the same ID is being swapped with an InputText that has yet to be activated.
    • ๐Ÿ›  InputText: Fixed various display corruption related to swapping the underlying buffer while a input widget is active (both for writable and read-only paths). Often they would manifest when manipulating the scrollbar of a multi-line input text.
    • ColorEdit, ColorPicker, ColorButton: Added ImGuiColorEditFlags_InputHSV to manipulate color values encoded as HSV (in order to avoid HSV<>RGB round trips and associated singularities). (#2383, #2384) [@haldean]
    • ๐Ÿ›  ColorPicker: Fixed a bug/assertion when displaying a color picker in a collapsed window while dragging its title bar. (#2389)
    • ๐Ÿ›  ColorEdit: Fixed tooltip not honoring the ImGuiColorEditFlags_NoAlpha contract of never reading the 4th float in the array (value was read and discarded). (#2384) [@haldean]
    • ๐Ÿ›  MenuItem, Selectable: Fixed disabled widget interfering with navigation (fix c2db7f6 in 1.67).
    • ๐Ÿ›  TabBar: Fixed a crash when using many BeginTabBar() recursively (didn't affect docking). (#2371)
    • TabBar: Added extra mis-usage error recovery. Past the assert, common mis-usage don't lead to hard crashes any more, facilitating integration with scripting languages. (#1651)
    • ๐Ÿ›  TabBar: Fixed ImGuiTabItemFlags_SetSelected being ignored if the tab is not visible (with scrolling policy enabled) or if is currently appearing.
    • ๐Ÿ›ฐ TabBar: Fixed Tab tooltip code making drag and drop tooltip disappear during the frame where the drag payload activate a tab.
    • TabBar: Reworked scrolling policy (when ImGuiTabBarFlags_FittingPolicyScroll is set) to teleport the view when aiming at a tab far away the visible section, and otherwise accelerate the scrolling speed to cap the scrolling time to 0.3 seconds.
    • ๐Ÿ›  Text: Fixed large Text/TextUnformatted calls not declaring their size into layout when starting below the lower point of the current clipping rectangle. Somehow this bug has been there since v1.0! It was hardly noticeable but would affect the scrolling range, which in turn would affect some scrolling request functions when called during the appearing frame of a window.
    • ๐Ÿ›  Plot: Fixed divide-by-zero in PlotLines() when passing a count of 1. (#2387) [@Lectem]
    • ๐Ÿ›  Log/Capture: Fixed LogXXX functions emitting an extraneous leading carriage return.
    • ๐Ÿ›  Log/Capture: Fixed an issue when empty string on a new line would not emit a carriage return.
    • Log/Capture: Fixed LogXXX functions 'auto_open_depth' parameter being treated as an absolute tree depth instead of a relative one.
    • ๐Ÿ›  Log/Capture: Fixed CollapsingHeader trailing ascii representation being "#" instead of "##".
    • ImFont: Added GetGlyphRangesVietnamese() helper. (#2403)
    • ๐Ÿ’… Misc: Asserting in NewFrame() if style.WindowMinSize is zero or smaller than (1.0f,1.0f).
    • Demo: Using GetBackgroundDrawList() and GetForegroundDrawList() in "Custom Rendering" demo.
    • Demo: InputText: Demonstrating use of ImGuiInputTextFlags_CallbackResize. (#2006, #1443, #1008).
    • ๐Ÿ Examples: GLFW, SDL: Preserve DisplayFramebufferScale when main viewport is minimized. (This is particularly useful for the viewport branch because we are not supporting per-viewport frame-buffer scale. It fixes windows not refreshing when main viewport is minimized.) (#2416)
    • Examples: OpenGL: Fix to be able to run on ES 2.0 / WebGL 1.0. [@rmitton, @gabrielcuvillier]
    • Examples: OpenGL: Fix for OSX not supporting OpenGL 4.5, we don't try to read GL_CLIP_ORIGIN even if the OpenGL headers/loader happens to define the value. (#2366, #2186)