@@ -32,11 +32,26 @@ HOW TO UPDATE?
32
32
33
33
34
34
-----------------------------------------------------------------------
35
- VERSION 1.89 WIP (In Progress )
35
+ VERSION 1.89 (Released 2022-11-15 )
36
36
-----------------------------------------------------------------------
37
37
38
+ Decorated log and release notes: https://github.com/ocornut/imgui/releases/tag/v1.89
39
+
38
40
Breaking changes:
39
41
42
+ - Layout: Obsoleted using SetCursorPos()/SetCursorScreenPos() to extend parent window/cell boundaries. (#5548)
43
+ This relates to when moving the cursor position beyond current boundaries WITHOUT submitting an item.
44
+ - Previously this would make the window content size ~200x200:
45
+ Begin(...) + SetCursorScreenPos(GetCursorScreenPos() + ImVec2(200,200)) + End();
46
+ - Instead, please submit an item:
47
+ Begin(...) + SetCursorScreenPos(GetCursorScreenPos() + ImVec2(200,200)) + Dummy(ImVec2(0,0)) + End();
48
+ - Alternative:
49
+ Begin(...) + Dummy(ImVec2(200,200)) + End();
50
+ Content size is now only extended when submitting an item.
51
+ With '#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS' this will now be detected and assert.
52
+ Without '#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS' this will silently be fixed until we obsolete it.
53
+ (This incorrect pattern has been mentioned or suggested in: #4510, #3355, #1760, #1490, #4152, #150,
54
+ threads have been amended to refer to this issue).
40
55
- Renamed and merged keyboard modifiers key enums and flags into a same set: (#4921, #456)
41
56
- ImGuiKey_ModCtrl and ImGuiModFlags_Ctrl -> ImGuiMod_Ctrl
42
57
- ImGuiKey_ModShift and ImGuiModFlags_Shift -> ImGuiMod_Shift
@@ -61,11 +76,11 @@ Breaking changes:
61
76
- Custom backends not writing to io.NavInputs[] -> no issue.
62
77
- Custom backends writing to io.NavInputs[] -> will build and convert gamepad inputs, unless IMGUI_DISABLE_OBSOLETE_KEYIO is defined. Need fixing!
63
78
- TL;DR: Backends should call io.AddKeyEvent()/io.AddKeyAnalogEvent() with ImGuiKey_GamepadXXX values instead of filling io.NavInput[].
64
- That data was essentially 1.60's attempt to combine keyboard and gamepad inputs with named
79
+ The ImGuiNavInput enum was essentially 1.60's attempt to combine keyboard and gamepad inputs with named
65
80
semantic, but the additional indirection and copy added complexity and got in the way of other
66
81
incoming work. User's code (other than backends) should not be affected, unless you have custom
67
82
widgets intercepting navigation events via the named enums (in which case you can upgrade your code).
68
- - Removed runtime patching of invalid "%f"/"%.0f" types of format strings for DragInt()/SliderInt() .
83
+ - DragInt()/SliderInt(): Removed runtime patching of invalid "%f"/"%.0f" types of format strings.
69
84
This was obsoleted in 1.61 (May 2018). See 1.61 changelog for details.
70
85
- Changed signature of ImageButton() function: (#5533, #4471, #2464, #1390)
71
86
- Added 'const char* str_id' parameter + removed 'int frame_padding = -1' parameter.
@@ -79,34 +94,15 @@ Breaking changes:
79
94
- Removed the bizarre legacy default argument for 'TreePush(const void* ptr = NULL)'. (#1057)
80
95
Must always pass a pointer value explicitly, NULL/nullptr is ok but require cast, e.g. TreePush((void*)nullptr);
81
96
If you used TreePush() replace with TreePush((void*)NULL);
82
- - Commented out redirecting functions/enums names that were marked obsolete in 1.77 and 1.79 (August 2020): (#3361)
83
- - DragScalar(), DragScalarN(), DragFloat(), DragFloat2(), DragFloat3(), DragFloat4()
84
- - SliderScalar(), SliderScalarN(), SliderFloat(), SliderFloat2(), SliderFloat3(), SliderFloat4()
85
- - For old signatures ending with (..., const char* format, float power = 1.0f) -> use (..., format ImGuiSliderFlags_Logarithmic) if power != 1.0f.
86
- - BeginPopupContextWindow(const char*, ImGuiMouseButton, bool) -> use BeginPopupContextWindow(const char*, ImGuiPopupFlags)
87
- - OpenPopupContextItem() (briefly existed from 1.77 to 1.79) -> use OpenPopupOnItemClick()
88
- - Obsoleted using SetCursorPos()/SetCursorScreenPos() to extend parent window/cell boundaries. (#5548)
89
- This relates to when moving the cursor position beyond current boundaries WITHOUT submitting an item.
90
- - Previously this would make the window content size ~200x200:
91
- Begin(...) + SetCursorScreenPos(GetCursorScreenPos() + ImVec2(200,200)) + End();
92
- - Instead, please submit an item:
93
- Begin(...) + SetCursorScreenPos(GetCursorScreenPos() + ImVec2(200,200)) + Dummy(ImVec2(0,0)) + End();
94
- - Alternative:
95
- Begin(...) + Dummy(ImVec2(200,200)) + End();
96
- Content size is now only extended when submitting an item.
97
- With '#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS' this will now be detected and assert.
98
- Without '#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS' this will silently be fixed until we obsolete it.
99
- (This incorrect pattern has been mentioned or suggested in: #4510, #3355, #1760, #1490, #4152, #150,
100
- threads have been amended to refer to this issue).
101
97
- Removed support for 1.42-era IMGUI_DISABLE_INCLUDE_IMCONFIG_H / IMGUI_INCLUDE_IMCONFIG_H. (#255)
102
98
They only made sense before we could use IMGUI_USER_CONFIG.
103
99
104
100
105
101
Other Changes:
106
102
107
- - Popups & Modals: fixed nested Begin() being erroneously input-inhibited. While it is
108
- unusual, you can nest a Begin() inside a popup or modal, it is occasionally useful to
109
- achieve certains things (e.g. some ways to implement suggestion popup #718, #4461).
103
+ - Popups & Modals: fixed nested Begin() inside a popup being erroneously input-inhibited.
104
+ While it is unusual, you can nest a Begin() inside a popup or modal, it is occasionally
105
+ useful to achieve certain things (e.g. to implement suggestion popups #718, #4461).
110
106
- Inputs: Standard widgets now claim for key/button ownership and test for them.
111
107
- Fixes scenario where e.g. a Popup with a Selectable() reacting on mouse down
112
108
(e.g. double click) closes, and behind it is another window with an item reacting
@@ -137,7 +133,7 @@ Other Changes:
137
133
- IsItemHovered: Added ImGuiHoveredFlags_DelayNormal and ImGuiHoveredFlags_DelayShort flags,
138
134
allowing to introduce a shared delay for tooltip idioms. The delays are respectively
139
135
io.HoverDelayNormal (default to 0.30f) and io.HoverDelayFast (default to 0.10f). (#1485)
140
- - IsItemHovered: Added ImGuiHoveredFlags_NoSharedDelay to disable sharing delays between itemm ,
136
+ - IsItemHovered: Added ImGuiHoveredFlags_NoSharedDelay to disable sharing delays between items ,
141
137
so moving from one item to a nearby one will requires delay to elapse again. (#1485)
142
138
- Tables: activating an ID (e.g. clicking button inside) column doesn't prevent columns
143
139
output flags from having ImGuiTableColumnFlags_IsHovered set. (#2957)
@@ -166,15 +162,15 @@ Other Changes:
166
162
the gap between a menu item inside a window and a child-menu in a secondary viewport. (#5614)
167
163
- Menus: Fixed using IsItemHovered()/IsItemClicked() on BeginMenu(). (#5775)
168
164
- Menus, Popups: Experimental fix for issue where clicking on an open BeginMenu() item called from
169
- a window which is neither a popup neither a menu used to incorrectly close and reopen the menu.
170
- (the fix may have side-effect so labelld as experimental as we may need to revert) (#5775)
165
+ a window which is neither a popup neither a menu used to incorrectly close and reopen the menu
166
+ (the fix may have side-effect and is labelld as experimental as we may need to revert). (#5775)
171
167
- Menus, Nav: Fixed keyboard/gamepad navigation occasionally erroneously landing on menu-item
172
168
in parent window when the parent is not a popup. (#5730)
173
169
- Menus, Nav: Fixed not being able to close a menu with Left arrow when parent is not a popup. (#5730)
174
170
- Menus, Nav: Fixed using left/right navigation when appending to an existing menu (multiple
175
171
BeginMenu() call with same names). (#1207)
176
172
- Menus: Fixed a one-frame issue where SetNextWindowXXX data are not consumed by a BeginMenu()
177
- returning false (specifically )
173
+ returning false.
178
174
- Nav: Fixed moving/resizing window with gamepad or keyboard when running at very high framerate.
179
175
- Nav: Pressing Space/GamepadFaceDown on a repeating button uses the same repeating rate as a mouse hold.
180
176
- Nav: Fixed an issue opening a menu with Right key from a non-menu window.
0 commit comments