imgui-bindings 0.1.15 → 0.1.16

data/lib/imgui.rb

@@ -20,6 +20,7 @@ FFI.typedef :int, :ImGuiComboFlags
 FFI.typedef :int, :ImGuiCond
 FFI.typedef :int, :ImGuiConfigFlags
 FFI.typedef :int, :ImGuiDataType
+FFI.typedef :int, :ImGuiDockNodeFlags
 FFI.typedef :int, :ImGuiDragDropFlags
 FFI.typedef :int, :ImGuiFocusedFlags
 FFI.typedef :int, :ImGuiHoveredFlags
@@ -51,7 +52,7 @@ FFI.typedef :short, :ImS16
 FFI.typedef :int, :ImS32
 FFI.typedef :int64, :ImS64
 FFI.typedef :char, :ImS8
-FFI.typedef :pointer, :ImTextureID
+FFI.typedef :uint64, :ImTextureID
 FFI.typedef :ushort, :ImU16
 FFI.typedef :uint, :ImU32
 FFI.typedef :uint64, :ImU64
@@ -77,8 +78,10 @@ FFI.typedef :int32, :ImGuiCond_
 FFI.typedef :int32, :ImGuiConfigFlags_
 FFI.typedef :int32, :ImGuiDataType_
 FFI.typedef :int32, :ImGuiDir
+FFI.typedef :int32, :ImGuiDockNodeFlags_
 FFI.typedef :int32, :ImGuiDragDropFlags_
 FFI.typedef :int32, :ImGuiFocusedFlags_
+FFI.typedef :int32, :ImGuiFreeTypeBuilderFlags
 FFI.typedef :int32, :ImGuiHoveredFlags_
 FFI.typedef :int32, :ImGuiInputFlags_
 FFI.typedef :int32, :ImGuiInputTextFlags_
@@ -140,11 +143,14 @@ ImFontAtlasFlags_NoBakedLines = 4       # 1 << 2 # Don't build thick line textur
 
 # ImGuiBackendFlags_
 # Backend capabilities flags stored in io.BackendFlags. Set by imgui_impl_xxx or custom backend.
-ImGuiBackendFlags_None = 0                 # 0
-ImGuiBackendFlags_HasGamepad = 1           # 1 << 0 # Backend Platform supports gamepad and currently has one connected.
-ImGuiBackendFlags_HasMouseCursors = 2      # 1 << 1 # Backend Platform supports honoring GetMouseCursor() value to change the OS cursor shape.
-ImGuiBackendFlags_HasSetMousePos = 4       # 1 << 2 # Backend Platform supports io.WantSetMousePos requests to reposition the OS mouse position (only used if ImGuiConfigFlags_NavEnableSetMousePos is set).
-ImGuiBackendFlags_RendererHasVtxOffset = 8 # 1 << 3 # Backend Renderer supports ImDrawCmd::VtxOffset. This enables output of large meshes (64K+ vertices) while still using 16-bit indices.
+ImGuiBackendFlags_None = 0                       # 0
+ImGuiBackendFlags_HasGamepad = 1                 # 1 << 0 # Backend Platform supports gamepad and currently has one connected.
+ImGuiBackendFlags_HasMouseCursors = 2            # 1 << 1 # Backend Platform supports honoring GetMouseCursor() value to change the OS cursor shape.
+ImGuiBackendFlags_HasSetMousePos = 4             # 1 << 2 # Backend Platform supports io.WantSetMousePos requests to reposition the OS mouse position (only used if io.ConfigNavMoveSetMousePos is set).
+ImGuiBackendFlags_RendererHasVtxOffset = 8       # 1 << 3 # Backend Renderer supports ImDrawCmd::VtxOffset. This enables output of large meshes (64K+ vertices) while still using 16-bit indices.
+ImGuiBackendFlags_PlatformHasViewports = 1024    # 1 << 10 # Backend Platform supports multiple viewports.
+ImGuiBackendFlags_HasMouseHoveredViewport = 2048 # 1 << 11 # Backend Platform supports calling io.AddMouseViewportEvent() with the viewport under the mouse. IF POSSIBLE, ignore viewports with the ImGuiViewportFlags_NoInputs flag (Win32 backend, GLFW 3.30+ backend can do this, SDL backend cannot). If this cannot be done, Dear ImGui needs to use a flawed heuristic to find the viewport under.
+ImGuiBackendFlags_RendererHasViewports = 4096    # 1 << 12 # Backend Renderer supports multiple viewports.
 
 # ImGuiButtonFlags_
 # Flags for InvisibleButton() [extended in imgui_internal.h]
@@ -153,6 +159,7 @@ ImGuiButtonFlags_MouseButtonLeft = 1   # 1 << 0 # React on left mouse button (de
 ImGuiButtonFlags_MouseButtonRight = 2  # 1 << 1 # React on right mouse button
 ImGuiButtonFlags_MouseButtonMiddle = 4 # 1 << 2 # React on center mouse button
 ImGuiButtonFlags_MouseButtonMask_ = 7  # ImGuiButtonFlags_MouseButtonLeft | ImGuiButtonFlags_MouseButtonRight | ImGuiButtonFlags_MouseButtonMiddle # [Internal]
+ImGuiButtonFlags_EnableNav = 8         # 1 << 3 # InvisibleButton(): do not disable navigation/tabbing. Otherwise disabled by default.
 
 # ImGuiChildFlags_
 # Flags for ImGui::BeginChild()
@@ -173,7 +180,7 @@ ImGuiChildFlags_AutoResizeX = 16           # 1 << 4 # Enable auto-resizing width
 ImGuiChildFlags_AutoResizeY = 32           # 1 << 5 # Enable auto-resizing height. Read "IMPORTANT: Size measurement" details above.
 ImGuiChildFlags_AlwaysAutoResize = 64      # 1 << 6 # Combined with AutoResizeX/AutoResizeY. Always measure size even when child is hidden, always return true, always disable clipping optimization! NOT RECOMMENDED.
 ImGuiChildFlags_FrameStyle = 128           # 1 << 7 # Style the child window like a framed item: use FrameBg, FrameRounding, FrameBorderSize, FramePadding instead of ChildBg, ChildRounding, ChildBorderSize, WindowPadding.
-ImGuiChildFlags_NavFlattened = 256         # 1 << 8 # [BETA] Share focus scope, allow gamepad/keyboard navigation to cross over parent border to this child or between sibling child windows.
+ImGuiChildFlags_NavFlattened = 256         # 1 << 8 # [BETA] Share focus scope, allow keyboard/gamepad navigation to cross over parent border to this child or between sibling child windows.
 
 # ImGuiCol_
 # Enumeration for PushStyleColor() / PopStyleColor()
@@ -217,23 +224,25 @@ ImGuiCol_TabSelectedOverline = 36       # 36 # Tab horizontal overline, when tab
 ImGuiCol_TabDimmed = 37                 # 37 # Tab background, when tab-bar is unfocused & tab is unselected
 ImGuiCol_TabDimmedSelected = 38         # 38 # Tab background, when tab-bar is unfocused & tab is selected
 ImGuiCol_TabDimmedSelectedOverline = 39 # 39 #..horizontal overline, when tab-bar is unfocused & tab is selected
-ImGuiCol_PlotLines = 40                 # 40
-ImGuiCol_PlotLinesHovered = 41          # 41
-ImGuiCol_PlotHistogram = 42             # 42
-ImGuiCol_PlotHistogramHovered = 43      # 43
-ImGuiCol_TableHeaderBg = 44             # 44 # Table header background
-ImGuiCol_TableBorderStrong = 45         # 45 # Table outer and header borders (prefer using Alpha=1.0 here)
-ImGuiCol_TableBorderLight = 46          # 46 # Table inner borders (prefer using Alpha=1.0 here)
-ImGuiCol_TableRowBg = 47                # 47 # Table row background (even rows)
-ImGuiCol_TableRowBgAlt = 48             # 48 # Table row background (odd rows)
-ImGuiCol_TextLink = 49                  # 49 # Hyperlink color
-ImGuiCol_TextSelectedBg = 50            # 50
-ImGuiCol_DragDropTarget = 51            # 51 # Rectangle highlighting a drop target
-ImGuiCol_NavHighlight = 52              # 52 # Gamepad/keyboard: current highlighted item
-ImGuiCol_NavWindowingHighlight = 53     # 53 # Highlight window when using CTRL+TAB
-ImGuiCol_NavWindowingDimBg = 54         # 54 # Darken/colorize entire screen behind the CTRL+TAB window list, when active
-ImGuiCol_ModalWindowDimBg = 55          # 55 # Darken/colorize entire screen behind a modal window, when one is active
-ImGuiCol_COUNT = 56                     # 56
+ImGuiCol_DockingPreview = 40            # 40 # Preview overlay color when about to docking something
+ImGuiCol_DockingEmptyBg = 41            # 41 # Background color for empty node (e.g. CentralNode with no window docked into it)
+ImGuiCol_PlotLines = 42                 # 42
+ImGuiCol_PlotLinesHovered = 43          # 43
+ImGuiCol_PlotHistogram = 44             # 44
+ImGuiCol_PlotHistogramHovered = 45      # 45
+ImGuiCol_TableHeaderBg = 46             # 46 # Table header background
+ImGuiCol_TableBorderStrong = 47         # 47 # Table outer and header borders (prefer using Alpha=1.0 here)
+ImGuiCol_TableBorderLight = 48          # 48 # Table inner borders (prefer using Alpha=1.0 here)
+ImGuiCol_TableRowBg = 49                # 49 # Table row background (even rows)
+ImGuiCol_TableRowBgAlt = 50             # 50 # Table row background (odd rows)
+ImGuiCol_TextLink = 51                  # 51 # Hyperlink color
+ImGuiCol_TextSelectedBg = 52            # 52
+ImGuiCol_DragDropTarget = 53            # 53 # Rectangle highlighting a drop target
+ImGuiCol_NavCursor = 54                 # 54 # Color of keyboard/gamepad navigation cursor/rectangle, when visible
+ImGuiCol_NavWindowingHighlight = 55     # 55 # Highlight window when using CTRL+TAB
+ImGuiCol_NavWindowingDimBg = 56         # 56 # Darken/colorize entire screen behind the CTRL+TAB window list, when active
+ImGuiCol_ModalWindowDimBg = 57          # 57 # Darken/colorize entire screen behind a modal window, when one is active
+ImGuiCol_COUNT = 58                     # 58
 
 # ImGuiColorEditFlags_
 # Flags for ColorEdit3() / ColorEdit4() / ColorPicker3() / ColorPicker4() / ColorButton()
@@ -292,16 +301,18 @@ ImGuiCond_Appearing = 8    # 1 << 3 # Set the variable if the object/window is a
 
 # ImGuiConfigFlags_
 # Configuration flags stored in io.ConfigFlags. Set by user/application.
-ImGuiConfigFlags_None = 0                 # 0
-ImGuiConfigFlags_NavEnableKeyboard = 1    # 1 << 0 # Master keyboard navigation enable flag. Enable full Tabbing + directional arrows + space/enter to activate.
-ImGuiConfigFlags_NavEnableGamepad = 2     # 1 << 1 # Master gamepad navigation enable flag. Backend also needs to set ImGuiBackendFlags_HasGamepad.
-ImGuiConfigFlags_NavEnableSetMousePos = 4 # 1 << 2 # Instruct navigation to move the mouse cursor. May be useful on TV/console systems where moving a virtual mouse is awkward. Will update io.MousePos and set io.WantSetMousePos=true. If enabled you MUST honor io.WantSetMousePos requests in your backend, otherwise ImGui will react as if the mouse is jumping around back and forth.
-ImGuiConfigFlags_NavNoCaptureKeyboard = 8 # 1 << 3 # Instruct navigation to not set the io.WantCaptureKeyboard flag when io.NavActive is set.
-ImGuiConfigFlags_NoMouse = 16             # 1 << 4 # Instruct dear imgui to disable mouse inputs and interactions.
-ImGuiConfigFlags_NoMouseCursorChange = 32 # 1 << 5 # Instruct backend to not alter mouse cursor shape and visibility. Use if the backend cursor changes are interfering with yours and you don't want to use SetMouseCursor() to change mouse cursor. You may want to honor requests from imgui by reading GetMouseCursor() yourself instead.
-ImGuiConfigFlags_NoKeyboard = 64          # 1 << 6 # Instruct dear imgui to disable keyboard inputs and interactions. This is done by ignoring keyboard events and clearing existing states.
-ImGuiConfigFlags_IsSRGB = 1048576         # 1 << 20 # Application is SRGB-aware.
-ImGuiConfigFlags_IsTouchScreen = 2097152  # 1 << 21 # Application is using a touch screen instead of a mouse.
+ImGuiConfigFlags_None = 0                        # 0
+ImGuiConfigFlags_NavEnableKeyboard = 1           # 1 << 0 # Master keyboard navigation enable flag. Enable full Tabbing + directional arrows + space/enter to activate.
+ImGuiConfigFlags_NavEnableGamepad = 2            # 1 << 1 # Master gamepad navigation enable flag. Backend also needs to set ImGuiBackendFlags_HasGamepad.
+ImGuiConfigFlags_NoMouse = 16                    # 1 << 4 # Instruct dear imgui to disable mouse inputs and interactions.
+ImGuiConfigFlags_NoMouseCursorChange = 32        # 1 << 5 # Instruct backend to not alter mouse cursor shape and visibility. Use if the backend cursor changes are interfering with yours and you don't want to use SetMouseCursor() to change mouse cursor. You may want to honor requests from imgui by reading GetMouseCursor() yourself instead.
+ImGuiConfigFlags_NoKeyboard = 64                 # 1 << 6 # Instruct dear imgui to disable keyboard inputs and interactions. This is done by ignoring keyboard events and clearing existing states.
+ImGuiConfigFlags_DockingEnable = 128             # 1 << 7 # Docking enable flags.
+ImGuiConfigFlags_ViewportsEnable = 1024          # 1 << 10 # Viewport enable flags (require both ImGuiBackendFlags_PlatformHasViewports + ImGuiBackendFlags_RendererHasViewports set by the respective backends)
+ImGuiConfigFlags_DpiEnableScaleViewports = 16384 # 1 << 14 # [BETA: Don't use] FIXME-DPI: Reposition and resize imgui windows when the DpiScale of a viewport changed (mostly useful for the main viewport hosting other window). Note that resizing the main window itself is up to your application.
+ImGuiConfigFlags_DpiEnableScaleFonts = 32768     # 1 << 15 # [BETA: Don't use] FIXME-DPI: Request bitmap-scaled fonts to match DpiScale. This is a very low-quality workaround. The correct way to handle DPI is _currently_ to replace the atlas and/or fonts in the Platform_OnChangedViewport callback, but this is all early work in progress.
+ImGuiConfigFlags_IsSRGB = 1048576                # 1 << 20 # Application is SRGB-aware.
+ImGuiConfigFlags_IsTouchScreen = 2097152         # 1 << 21 # Application is using a touch screen instead of a mouse.
 
 # ImGuiDataType_
 # A primary data type
@@ -327,6 +338,19 @@ ImGuiDir_Up = 2    # 2
 ImGuiDir_Down = 3  # 3
 ImGuiDir_COUNT = 4 # 4
 
+# ImGuiDockNodeFlags_
+# Flags for ImGui::DockSpace(), shared/inherited by child nodes.
+# (Some flags can be applied to individual nodes directly)
+# FIXME-DOCK: Also see ImGuiDockNodeFlagsPrivate_ which may involve using the WIP and internal DockBuilder api.
+ImGuiDockNodeFlags_None = 0                     # 0
+ImGuiDockNodeFlags_KeepAliveOnly = 1            # 1 << 0 #       // Don't display the dockspace node but keep it alive. Windows docked into this dockspace node won't be undocked.
+ImGuiDockNodeFlags_NoDockingOverCentralNode = 4 # 1 << 2 #       // Disable docking over the Central Node, which will be always kept empty.
+ImGuiDockNodeFlags_PassthruCentralNode = 8      # 1 << 3 #       // Enable passthru dockspace: 1) DockSpace() will render a ImGuiCol_WindowBg background covering everything excepted the Central Node when empty. Meaning the host window should probably use SetNextWindowBgAlpha(0.0f) prior to Begin() when using this. 2) When Central Node is empty: let inputs pass-through + won't display a DockingEmptyBg background. See demo for details.
+ImGuiDockNodeFlags_NoDockingSplit = 16          # 1 << 4 #       // Disable other windows/nodes from splitting this node.
+ImGuiDockNodeFlags_NoResize = 32                # 1 << 5 # Saved // Disable resizing node using the splitter/separators. Useful with programmatically setup dockspaces.
+ImGuiDockNodeFlags_AutoHideTabBar = 64          # 1 << 6 #       // Tab bar will automatically hide when there is a single window in the dock node.
+ImGuiDockNodeFlags_NoUndocking = 128            # 1 << 7 #       // Disable undocking this node.
+
 # ImGuiDragDropFlags_
 # Flags for ImGui::BeginDragDropSource(), ImGui::AcceptDragDropPayload()
 ImGuiDragDropFlags_None = 0                       # 0
@@ -350,8 +374,21 @@ ImGuiFocusedFlags_ChildWindows = 1        # 1 << 0 # Return true if any children
 ImGuiFocusedFlags_RootWindow = 2          # 1 << 1 # Test from root window (top most parent of the current hierarchy)
 ImGuiFocusedFlags_AnyWindow = 4           # 1 << 2 # Return true if any window is focused. Important: If you are trying to tell how to dispatch your low-level inputs, do NOT use this. Use 'io.WantCaptureMouse' instead! Please read the FAQ!
 ImGuiFocusedFlags_NoPopupHierarchy = 8    # 1 << 3 # Do not consider popup hierarchy (do not treat popup emitter as parent of popup) (when used with _ChildWindows or _RootWindow)
+ImGuiFocusedFlags_DockHierarchy = 16      # 1 << 4 # Consider docking hierarchy (treat dockspace host as parent of docked window) (when used with _ChildWindows or _RootWindow)
 ImGuiFocusedFlags_RootAndChildWindows = 3 # ImGuiFocusedFlags_RootWindow | ImGuiFocusedFlags_ChildWindows
 
+# ImGuiFreeTypeBuilderFlags
+ImGuiFreeTypeBuilderFlags_NoHinting = 1     # 1 << 0
+ImGuiFreeTypeBuilderFlags_NoAutoHint = 2    # 1 << 1
+ImGuiFreeTypeBuilderFlags_ForceAutoHint = 4 # 1 << 2
+ImGuiFreeTypeBuilderFlags_LightHinting = 8  # 1 << 3
+ImGuiFreeTypeBuilderFlags_MonoHinting = 16  # 1 << 4
+ImGuiFreeTypeBuilderFlags_Bold = 32         # 1 << 5
+ImGuiFreeTypeBuilderFlags_Oblique = 64      # 1 << 6
+ImGuiFreeTypeBuilderFlags_Monochrome = 128  # 1 << 7
+ImGuiFreeTypeBuilderFlags_LoadColor = 256   # 1 << 8
+ImGuiFreeTypeBuilderFlags_Bitmap = 512      # 1 << 9
+
 # ImGuiHoveredFlags_
 # Flags for ImGui::IsItemHovered(), ImGui::IsWindowHovered()
 # Note: if you are trying to check whether your mouse should be dispatched to Dear ImGui or to your app, you should use 'io.WantCaptureMouse' instead! Please read the FAQ!
@@ -361,12 +398,13 @@ ImGuiHoveredFlags_ChildWindows = 1                   # 1 << 0 # IsWindowHovered(
 ImGuiHoveredFlags_RootWindow = 2                     # 1 << 1 # IsWindowHovered() only: Test from root window (top most parent of the current hierarchy)
 ImGuiHoveredFlags_AnyWindow = 4                      # 1 << 2 # IsWindowHovered() only: Return true if any window is hovered
 ImGuiHoveredFlags_NoPopupHierarchy = 8               # 1 << 3 # IsWindowHovered() only: Do not consider popup hierarchy (do not treat popup emitter as parent of popup) (when used with _ChildWindows or _RootWindow)
+ImGuiHoveredFlags_DockHierarchy = 16                 # 1 << 4 # IsWindowHovered() only: Consider docking hierarchy (treat dockspace host as parent of docked window) (when used with _ChildWindows or _RootWindow)
 ImGuiHoveredFlags_AllowWhenBlockedByPopup = 32       # 1 << 5 # Return true even if a popup window is normally blocking access to this item/window
 ImGuiHoveredFlags_AllowWhenBlockedByActiveItem = 128 # 1 << 7 # Return true even if an active item is blocking access to this item/window. Useful for Drag and Drop patterns.
 ImGuiHoveredFlags_AllowWhenOverlappedByItem = 256    # 1 << 8 # IsItemHovered() only: Return true even if the item uses AllowOverlap mode and is overlapped by another hoverable item.
 ImGuiHoveredFlags_AllowWhenOverlappedByWindow = 512  # 1 << 9 # IsItemHovered() only: Return true even if the position is obstructed or overlapped by another window.
 ImGuiHoveredFlags_AllowWhenDisabled = 1024           # 1 << 10 # IsItemHovered() only: Return true even if the item is disabled
-ImGuiHoveredFlags_NoNavOverride = 2048               # 1 << 11 # IsItemHovered() only: Disable using gamepad/keyboard navigation state when active, always query mouse
+ImGuiHoveredFlags_NoNavOverride = 2048               # 1 << 11 # IsItemHovered() only: Disable using keyboard/gamepad navigation state when active, always query mouse
 ImGuiHoveredFlags_AllowWhenOverlapped = 768          # ImGuiHoveredFlags_AllowWhenOverlappedByItem | ImGuiHoveredFlags_AllowWhenOverlappedByWindow
 ImGuiHoveredFlags_RectOnly = 928                     # ImGuiHoveredFlags_AllowWhenBlockedByPopup | ImGuiHoveredFlags_AllowWhenBlockedByActiveItem | ImGuiHoveredFlags_AllowWhenOverlapped
 ImGuiHoveredFlags_RootAndChildWindows = 3            # ImGuiHoveredFlags_RootWindow | ImGuiHoveredFlags_ChildWindows
@@ -403,7 +441,7 @@ ImGuiInputTextFlags_CharsScientific = 4          # 1 << 2 # Allow 0123456789.+-*
 ImGuiInputTextFlags_CharsUppercase = 8           # 1 << 3 # Turn a..z into A..Z
 ImGuiInputTextFlags_CharsNoBlank = 16            # 1 << 4 # Filter out spaces, tabs
 ImGuiInputTextFlags_AllowTabInput = 32           # 1 << 5 # Pressing TAB input a '\t' character into the text field
-ImGuiInputTextFlags_EnterReturnsTrue = 64        # 1 << 6 # Return 'true' when Enter is pressed (as opposed to every time the value was modified). Consider looking at the IsItemDeactivatedAfterEdit() function.
+ImGuiInputTextFlags_EnterReturnsTrue = 64        # 1 << 6 # Return 'true' when Enter is pressed (as opposed to every time the value was modified). Consider using IsItemDeactivatedAfterEdit() instead!
 ImGuiInputTextFlags_EscapeClearsAll = 128        # 1 << 7 # Escape key clears content if not empty, and deactivate otherwise (contrast to default behavior of Escape to revert)
 ImGuiInputTextFlags_CtrlEnterForNewLine = 256    # 1 << 8 # In multi-line mode, validate with Enter, add new line with Ctrl+Enter (default is opposite: validate with Ctrl+Enter, add line with Enter).
 ImGuiInputTextFlags_ReadOnly = 512               # 1 << 9 # Read-only mode
@@ -414,12 +452,13 @@ ImGuiInputTextFlags_ParseEmptyRefVal = 8192      # 1 << 13 # InputFloat(), Input
 ImGuiInputTextFlags_DisplayEmptyRefVal = 16384   # 1 << 14 # InputFloat(), InputInt(), InputScalar() etc. only: when value is zero, do not display it. Generally used with ImGuiInputTextFlags_ParseEmptyRefVal.
 ImGuiInputTextFlags_NoHorizontalScroll = 32768   # 1 << 15 # Disable following the cursor horizontally
 ImGuiInputTextFlags_NoUndoRedo = 65536           # 1 << 16 # Disable undo/redo. Note that input text owns the text data while active, if you want to provide your own undo/redo stack you need e.g. to call ClearActiveID().
-ImGuiInputTextFlags_CallbackCompletion = 131072  # 1 << 17 # Callback on pressing TAB (for completion handling)
-ImGuiInputTextFlags_CallbackHistory = 262144     # 1 << 18 # Callback on pressing Up/Down arrows (for history handling)
-ImGuiInputTextFlags_CallbackAlways = 524288      # 1 << 19 # Callback on each iteration. User code may query cursor position, modify text buffer.
-ImGuiInputTextFlags_CallbackCharFilter = 1048576 # 1 << 20 # Callback on character inputs to replace or discard them. Modify 'EventChar' to replace or discard, or return 1 in callback to discard.
-ImGuiInputTextFlags_CallbackResize = 2097152     # 1 << 21 # Callback on buffer capacity changes request (beyond 'buf_size' parameter value), allowing the string to grow. Notify when the string wants to be resized (for string types which hold a cache of their Size). You will be provided a new BufSize in the callback and NEED to honor it. (see misc/cpp/imgui_stdlib.h for an example of using this)
-ImGuiInputTextFlags_CallbackEdit = 4194304       # 1 << 22 # Callback on any edit (note that InputText() already returns true on edit, the callback is useful mainly to manipulate the underlying buffer while focus is active)
+ImGuiInputTextFlags_ElideLeft = 131072           # 1 << 17 # When text doesn't fit, elide left side to ensure right side stays visible. Useful for path/filenames. Single-line only!
+ImGuiInputTextFlags_CallbackCompletion = 262144  # 1 << 18 # Callback on pressing TAB (for completion handling)
+ImGuiInputTextFlags_CallbackHistory = 524288     # 1 << 19 # Callback on pressing Up/Down arrows (for history handling)
+ImGuiInputTextFlags_CallbackAlways = 1048576     # 1 << 20 # Callback on each iteration. User code may query cursor position, modify text buffer.
+ImGuiInputTextFlags_CallbackCharFilter = 2097152 # 1 << 21 # Callback on character inputs to replace or discard them. Modify 'EventChar' to replace or discard, or return 1 in callback to discard.
+ImGuiInputTextFlags_CallbackResize = 4194304     # 1 << 22 # Callback on buffer capacity changes request (beyond 'buf_size' parameter value), allowing the string to grow. Notify when the string wants to be resized (for string types which hold a cache of their Size). You will be provided a new BufSize in the callback and NEED to honor it. (see misc/cpp/imgui_stdlib.h for an example of using this)
+ImGuiInputTextFlags_CallbackEdit = 8388608       # 1 << 23 # Callback on any edit (note that InputText() already returns true on edit, the callback is useful mainly to manipulate the underlying buffer while focus is active)
 
 # ImGuiItemFlags_
 # Flags for ImGui::PushItemFlag()
@@ -430,15 +469,17 @@ ImGuiItemFlags_NoNav = 2             # 1 << 1 # false    // Disable any form of
 ImGuiItemFlags_NoNavDefaultFocus = 4 # 1 << 2 # false    // Disable item being a candidate for default focus (e.g. used by title bar items).
 ImGuiItemFlags_ButtonRepeat = 8      # 1 << 3 # false    // Any button-like behavior will have repeat mode enabled (based on io.KeyRepeatDelay and io.KeyRepeatRate values). Note that you can also call IsItemActive() after any button to tell if it is being held.
 ImGuiItemFlags_AutoClosePopups = 16  # 1 << 4 # true     // MenuItem()/Selectable() automatically close their parent popup window.
+ImGuiItemFlags_AllowDuplicateId = 32 # 1 << 5 # false    // Allow submitting an item with the same identifier as an item already submitted this frame without triggering a warning tooltip if io.ConfigDebugHighlightIdConflicts is set.
 
 # ImGuiKey
 # A key identifier (ImGuiKey_XXX or ImGuiMod_XXX value): can represent Keyboard, Mouse and Gamepad values.
-# All our named keys are >= 512. Keys value 0 to 511 are left unused as legacy native/opaque key values (< 1.87).
-# Since >= 1.89 we increased typing (went from int to enum), some legacy code may need a cast to ImGuiKey.
-# Read details about the 1.87 and 1.89 transition : https://github.com/ocornut/imgui/issues/4921
+# All our named keys are >= 512. Keys value 0 to 511 are left unused and were legacy native/opaque key values (< 1.87).
+# Support for legacy keys was completely removed in 1.91.5.
+# Read details about the 1.87+ transition : https://github.com/ocornut/imgui/issues/4921
 # Note that "Keys" related to physical keys and are not the same concept as input "Characters", the later are submitted via io.AddInputCharacter().
 # The keyboard key enum values are named after the keys on a standard US keyboard, and on other keyboard types the keys reported may not match the keycaps.
 ImGuiKey_None = 0                  # 0
+ImGuiKey_NamedKey_BEGIN = 512      # 512 # First valid key value (other than 0)
 ImGuiKey_Tab = 512                 # 512 # == ImGuiKey_NamedKey_BEGIN
 ImGuiKey_LeftArrow = 513           # 513
 ImGuiKey_RightArrow = 514          # 514
@@ -593,18 +634,14 @@ ImGuiKey_ReservedForModCtrl = 662  # 662
 ImGuiKey_ReservedForModShift = 663 # 663
 ImGuiKey_ReservedForModAlt = 664   # 664
 ImGuiKey_ReservedForModSuper = 665 # 665
-ImGuiKey_COUNT = 666               # 666
+ImGuiKey_NamedKey_END = 666        # 666
 ImGuiMod_None = 0                  # 0
 ImGuiMod_Ctrl = 4096               # 1 << 12 # Ctrl (non-macOS), Cmd (macOS)
 ImGuiMod_Shift = 8192              # 1 << 13 # Shift
 ImGuiMod_Alt = 16384               # 1 << 14 # Option/Menu
 ImGuiMod_Super = 32768             # 1 << 15 # Windows/Super (non-macOS), Ctrl (macOS)
 ImGuiMod_Mask_ = 61440             # 0xF000 # 4-bits
-ImGuiKey_NamedKey_BEGIN = 512      # 512
-ImGuiKey_NamedKey_END = 666        # ImGuiKey_COUNT
 ImGuiKey_NamedKey_COUNT = 154      # ImGuiKey_NamedKey_END - ImGuiKey_NamedKey_BEGIN
-ImGuiKey_KeysData_SIZE = 154       # ImGuiKey_NamedKey_COUNT # Size of KeysData[]: hold legacy 0..512 keycodes + named keys
-ImGuiKey_KeysData_OFFSET = 512     # ImGuiKey_NamedKey_BEGIN # Accesses to io.KeysData[] must use (key - ImGuiKey_KeysData_OFFSET) index.
 
 # ImGuiMouseButton_
 # Identify a mouse button.
@@ -700,13 +737,16 @@ ImGuiSelectionRequestType_SetRange = 2 # 2 # Request app to select/unselect [Ran
 # ImGuiSliderFlags_
 # Flags for DragFloat(), DragInt(), SliderFloat(), SliderInt() etc.
 # We use the same sets of flags for DragXXX() and SliderXXX() functions as the features are the same and it makes it easier to swap them.
-# (Those are per-item flags. There are shared flags in ImGuiIO: io.ConfigDragClickToInputText)
+# (Those are per-item flags. There is shared behavior flag too: ImGuiIO: io.ConfigDragClickToInputText)
 ImGuiSliderFlags_None = 0                  # 0
-ImGuiSliderFlags_AlwaysClamp = 16          # 1 << 4 # Clamp value to min/max bounds when input manually with CTRL+Click. By default CTRL+Click allows going out of bounds.
 ImGuiSliderFlags_Logarithmic = 32          # 1 << 5 # Make the widget logarithmic (linear otherwise). Consider using ImGuiSliderFlags_NoRoundToFormat with this if using a format-string with small amount of digits.
 ImGuiSliderFlags_NoRoundToFormat = 64      # 1 << 6 # Disable rounding underlying value to match precision of the display format string (e.g. %.3f values are rounded to those 3 digits).
 ImGuiSliderFlags_NoInput = 128             # 1 << 7 # Disable CTRL+Click or Enter key allowing to input text directly into the widget.
-ImGuiSliderFlags_WrapAround = 256          # 1 << 8 # Enable wrapping around from max to min and from min to max (only supported by DragXXX() functions for now.
+ImGuiSliderFlags_WrapAround = 256          # 1 << 8 # Enable wrapping around from max to min and from min to max. Only supported by DragXXX() functions for now.
+ImGuiSliderFlags_ClampOnInput = 512        # 1 << 9 # Clamp value to min/max bounds when input manually with CTRL+Click. By default CTRL+Click allows going out of bounds.
+ImGuiSliderFlags_ClampZeroRange = 1024     # 1 << 10 # Clamp even if min==max==0.0f. Otherwise due to legacy reason DragXXX functions don't clamp with those values. When your clamping limits are dynamic you almost always want to use it.
+ImGuiSliderFlags_NoSpeedTweaks = 2048      # 1 << 11 # Disable keyboard modifiers altering tweak speed. Useful if you want to alter tweak speed yourself based on your own logic.
+ImGuiSliderFlags_AlwaysClamp = 1536        # ImGuiSliderFlags_ClampOnInput | ImGuiSliderFlags_ClampZeroRange
 ImGuiSliderFlags_InvalidMask_ = 1879048207 # 0x7000000F # [Internal] We treat using those bits as being potentially a 'float power' argument from the previous API that has got miscast to this enum, and will trigger an assert if needed.
 
 # ImGuiSortDirection
@@ -757,7 +797,8 @@ ImGuiStyleVar_SelectableTextAlign = 29         # 29 # ImVec2    SelectableTextAl
 ImGuiStyleVar_SeparatorTextBorderSize = 30     # 30 # float     SeparatorTextBorderSize
 ImGuiStyleVar_SeparatorTextAlign = 31          # 31 # ImVec2    SeparatorTextAlign
 ImGuiStyleVar_SeparatorTextPadding = 32        # 32 # ImVec2    SeparatorTextPadding
-ImGuiStyleVar_COUNT = 33                       # 33
+ImGuiStyleVar_DockingSeparatorSize = 33        # 33 # float     DockingSeparatorSize
+ImGuiStyleVar_COUNT = 34                       # 34
 
 # ImGuiTabBarFlags_
 # Flags for ImGui::BeginTabBar()
@@ -922,10 +963,21 @@ ImGuiTreeNodeFlags_CollapsingHeader = 26        # ImGuiTreeNodeFlags_Framed | Im
 
 # ImGuiViewportFlags_
 # Flags stored in ImGuiViewport::Flags, giving indications to the platform backends.
-ImGuiViewportFlags_None = 0              # 0
-ImGuiViewportFlags_IsPlatformWindow = 1  # 1 << 0 # Represent a Platform Window
-ImGuiViewportFlags_IsPlatformMonitor = 2 # 1 << 1 # Represent a Platform Monitor (unused yet)
-ImGuiViewportFlags_OwnedByApp = 4        # 1 << 2 # Platform Window: Is created/managed by the user application? (rather than our backend)
+ImGuiViewportFlags_None = 0                   # 0
+ImGuiViewportFlags_IsPlatformWindow = 1       # 1 << 0 # Represent a Platform Window
+ImGuiViewportFlags_IsPlatformMonitor = 2      # 1 << 1 # Represent a Platform Monitor (unused yet)
+ImGuiViewportFlags_OwnedByApp = 4             # 1 << 2 # Platform Window: Is created/managed by the user application? (rather than our backend)
+ImGuiViewportFlags_NoDecoration = 8           # 1 << 3 # Platform Window: Disable platform decorations: title bar, borders, etc. (generally set all windows, but if ImGuiConfigFlags_ViewportsDecoration is set we only set this on popups/tooltips)
+ImGuiViewportFlags_NoTaskBarIcon = 16         # 1 << 4 # Platform Window: Disable platform task bar icon (generally set on popups/tooltips, or all windows if ImGuiConfigFlags_ViewportsNoTaskBarIcon is set)
+ImGuiViewportFlags_NoFocusOnAppearing = 32    # 1 << 5 # Platform Window: Don't take focus when created.
+ImGuiViewportFlags_NoFocusOnClick = 64        # 1 << 6 # Platform Window: Don't take focus when clicked on.
+ImGuiViewportFlags_NoInputs = 128             # 1 << 7 # Platform Window: Make mouse pass through so we can drag this window while peaking behind it.
+ImGuiViewportFlags_NoRendererClear = 256      # 1 << 8 # Platform Window: Renderer doesn't need to clear the framebuffer ahead (because we will fill it entirely).
+ImGuiViewportFlags_NoAutoMerge = 512          # 1 << 9 # Platform Window: Avoid merging this window into another host window. This can only be set via ImGuiWindowClass viewport flags override (because we need to now ahead if we are going to create a viewport in the first place!).
+ImGuiViewportFlags_TopMost = 1024             # 1 << 10 # Platform Window: Display on top (for tooltips only).
+ImGuiViewportFlags_CanHostOtherWindows = 2048 # 1 << 11 # Viewport can host multiple imgui windows (secondary viewports are associated to a single window). // FIXME: In practice there's still probably code making the assumption that this is always and only on the MainViewport. Will fix once we add support for "no main viewport".
+ImGuiViewportFlags_IsMinimized = 4096         # 1 << 12 # Platform Window: Window is minimized, can skip render. When minimized we tend to avoid using the viewport pos/size for clipping window or testing if they are contained in the viewport.
+ImGuiViewportFlags_IsFocused = 8192           # 1 << 13 # Platform Window: Window is focused (last call to Platform_GetWindowFocus() returned true)
 
 # ImGuiWindowFlags_
 # Flags for ImGui::Begin()
@@ -947,9 +999,10 @@ ImGuiWindowFlags_NoFocusOnAppearing = 4096         # 1 << 12 # Disable taking fo
 ImGuiWindowFlags_NoBringToFrontOnFocus = 8192      # 1 << 13 # Disable bringing window to front when taking focus (e.g. clicking on it or programmatically giving it focus)
 ImGuiWindowFlags_AlwaysVerticalScrollbar = 16384   # 1 << 14 # Always show vertical scrollbar (even if ContentSize.y < Size.y)
 ImGuiWindowFlags_AlwaysHorizontalScrollbar = 32768 # 1<< 15 # Always show horizontal scrollbar (even if ContentSize.x < Size.x)
-ImGuiWindowFlags_NoNavInputs = 65536               # 1 << 16 # No gamepad/keyboard navigation within the window
-ImGuiWindowFlags_NoNavFocus = 131072               # 1 << 17 # No focusing toward this window with gamepad/keyboard navigation (e.g. skipped by CTRL+TAB)
+ImGuiWindowFlags_NoNavInputs = 65536               # 1 << 16 # No keyboard/gamepad navigation within the window
+ImGuiWindowFlags_NoNavFocus = 131072               # 1 << 17 # No focusing toward this window with keyboard/gamepad navigation (e.g. skipped by CTRL+TAB)
 ImGuiWindowFlags_UnsavedDocument = 262144          # 1 << 18 # Display a dot next to the title. When used in a tab/docking context, tab is selected when clicking the X + closure is not assumed (will wait for user to stop submitting the tab). Otherwise closure is assumed when pressing the X, so if you keep submitting the tab may reappear at end of tab bar.
+ImGuiWindowFlags_NoDocking = 524288                # 1 << 19 # Disable docking of this window
 ImGuiWindowFlags_NoNav = 196608                    # ImGuiWindowFlags_NoNavInputs | ImGuiWindowFlags_NoNavFocus
 ImGuiWindowFlags_NoDecoration = 43                 # ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoCollapse
 ImGuiWindowFlags_NoInputs = 197120                 # ImGuiWindowFlags_NoMouseInputs | ImGuiWindowFlags_NoNavInputs | ImGuiWindowFlags_NoNavFocus
@@ -958,6 +1011,7 @@ ImGuiWindowFlags_Tooltip = 33554432                # 1 << 25 # Don't use! For in
 ImGuiWindowFlags_Popup = 67108864                  # 1 << 26 # Don't use! For internal use by BeginPopup()
 ImGuiWindowFlags_Modal = 134217728                 # 1 << 27 # Don't use! For internal use by BeginPopupModal()
 ImGuiWindowFlags_ChildMenu = 268435456             # 1 << 28 # Don't use! For internal use by BeginMenu()
+ImGuiWindowFlags_DockNodeHost = 536870912          # 1 << 29 # Don't use! For internal use by Begin()/NewFrame()
 
 
 class ImVec2 < FFI::Struct
@@ -1040,12 +1094,14 @@ end
 class ImDrawCmd < FFI::Struct
   layout(
     :ClipRect, ImVec4.by_value,
-    :TextureId, :pointer,
+    :TextureId, :uint64,
     :VtxOffset, :uint,
     :IdxOffset, :uint,
     :ElemCount, :uint,
     :UserCallback, :pointer,
-    :UserCallbackData, :pointer
+    :UserCallbackData, :pointer,
+    :UserCallbackDataSize, :int,
+    :UserCallbackDataOffset, :int
   )
 
   def GetTexID()
@@ -1066,7 +1122,7 @@ end
 class ImDrawCmdHeader < FFI::Struct
   layout(
     :ClipRect, ImVec4.by_value,
-    :TextureId, :pointer,
+    :TextureId, :uint64,
     :VtxOffset, :uint
   )
 end
@@ -1078,7 +1134,7 @@ end
 # access the current window draw list and draw custom primitives.
 # You can interleave normal ImGui:: calls and adding primitives to the current draw list.
 # In single viewport mode, top-left is == GetMainViewport()->Pos (generally 0,0), bottom-right is == GetMainViewport()->Pos+Size (generally io.DisplaySize).
-# You are totally free to apply whatever transformation matrix to want to the data (depending on the use of the transformation you may want to apply it to ClipRect as well!)
+# You are totally free to apply whatever transformation matrix you want to the data (depending on the use of the transformation you may want to apply it to ClipRect as well!)
 # Important: Primitives are always added to the list and not culled (culling is done at higher-level by ImGui:: functions), if you use this API a lot consider coarse culling your drawn objects.
 class ImDrawList < FFI::Struct
   layout(
@@ -1095,6 +1151,7 @@ class ImDrawList < FFI::Struct
     :_Splitter, ImDrawListSplitter.by_value,
     :_ClipRectStack, ImVector.by_value,
     :_TextureIdStack, ImVector.by_value,
+    :_CallbacksDataBuf, ImVector.by_value,
     :_FringeScale, :float,
     :_OwnerName, :pointer
   )
@@ -1107,8 +1164,8 @@ class ImDrawList < FFI::Struct
     ImGui::ImDrawList_AddBezierQuadratic(self, p1, p2, p3, col, thickness, num_segments)
   end
 
-  def AddCallback(callback, callback_data)
-    ImGui::ImDrawList_AddCallback(self, callback, callback_data)
+  def AddCallback(callback, userdata, userdata_size = 0)
+    ImGui::ImDrawList_AddCallback(self, callback, userdata, userdata_size)
   end
 
   def AddCircle(center, radius, col, num_segments = 0, thickness = 1.0)
@@ -1405,7 +1462,7 @@ end
 class ImFontAtlas < FFI::Struct
   layout(
     :Flags, :int,
-    :TexID, :pointer,
+    :TexID, :uint64,
     :TexDesiredWidth, :int,
     :TexGlyphPadding, :int,
     :Locked, :bool,
@@ -1565,47 +1622,6 @@ class ImGuiKeyData < FFI::Struct
   )
 end
 
-# - Currently represents the Platform Window created by the application which is hosting our Dear ImGui windows.
-# - With multi-viewport enabled, we extend this concept to have multiple active viewports.
-# - In the future we will extend this concept further to also represent Platform Monitor and support a "no main platform window" operation mode.
-# - About Main Area vs Work Area:
-#   - Main Area = entire viewport.
-#   - Work Area = entire viewport minus sections used by main menu bars (for platform windows), or by task bar (for platform monitor).
-#   - Windows are generally trying to stay within the Work Area of their host viewport.
-class ImGuiViewport < FFI::Struct
-  layout(
-    :ID, :uint,
-    :Flags, :int,
-    :Pos, ImVec2.by_value,
-    :Size, ImVec2.by_value,
-    :WorkPos, ImVec2.by_value,
-    :WorkSize, ImVec2.by_value,
-    :PlatformHandle, :pointer,
-    :PlatformHandleRaw, :pointer
-  )
-
-  def GetCenter()
-    pOut = ImVec2.new
-    ImGui::ImGuiViewport_GetCenter(pOut, self)
-    return pOut
-  end
-
-  def GetWorkCenter()
-    pOut = ImVec2.new
-    ImGui::ImGuiViewport_GetWorkCenter(pOut, self)
-    return pOut
-  end
-
-  def self.create()
-    return ImGuiViewport.new(ImGui::ImGuiViewport_ImGuiViewport())
-  end
-
-  def destroy()
-    ImGui::ImGuiViewport_destroy(self)
-  end
-
-end
-
 # Helper: Key->Value storage
 # Typically you don't have to worry about this since a storage is held within each Window.
 # We use it to e.g. store collapse state for a tree (Int 0/1)
@@ -1681,6 +1697,58 @@ class ImGuiStorage < FFI::Struct
 
 end
 
+class ImDrawData < FFI::Struct
+end
+# - Currently represents the Platform Window created by the application which is hosting our Dear ImGui windows.
+# - With multi-viewport enabled, we extend this concept to have multiple active viewports.
+# - In the future we will extend this concept further to also represent Platform Monitor and support a "no main platform window" operation mode.
+# - About Main Area vs Work Area:
+#   - Main Area = entire viewport.
+#   - Work Area = entire viewport minus sections used by main menu bars (for platform windows), or by task bar (for platform monitor).
+#   - Windows are generally trying to stay within the Work Area of their host viewport.
+class ImGuiViewport < FFI::Struct
+  layout(
+    :ID, :uint,
+    :Flags, :int,
+    :Pos, ImVec2.by_value,
+    :Size, ImVec2.by_value,
+    :WorkPos, ImVec2.by_value,
+    :WorkSize, ImVec2.by_value,
+    :DpiScale, :float,
+    :ParentViewportId, :uint,
+    :DrawData, ImDrawData.ptr,
+    :RendererUserData, :pointer,
+    :PlatformUserData, :pointer,
+    :PlatformHandle, :pointer,
+    :PlatformHandleRaw, :pointer,
+    :PlatformWindowCreated, :bool,
+    :PlatformRequestMove, :bool,
+    :PlatformRequestResize, :bool,
+    :PlatformRequestClose, :bool
+  )
+
+  def GetCenter()
+    pOut = ImVec2.new
+    ImGui::ImGuiViewport_GetCenter(pOut, self)
+    return pOut
+  end
+
+  def GetWorkCenter()
+    pOut = ImVec2.new
+    ImGui::ImGuiViewport_GetWorkCenter(pOut, self)
+    return pOut
+  end
+
+  def self.create()
+    return ImGuiViewport.new(ImGui::ImGuiViewport_ImGuiViewport())
+  end
+
+  def destroy()
+    ImGui::ImGuiViewport_destroy(self)
+  end
+
+end
+
 # Helper: ImColor() implicitly converts colors to either ImU32 (packed 4x1 byte) or ImVec4 (4x1 float)
 # Prefer using IM_COL32() macros if you want a guaranteed compile-time ImU32 for usage with ImDrawList API.
 # **Avoid storing ImColor! Store either u32 of ImVec4. This is not a full-featured color class. MAY OBSOLETE.
@@ -1746,9 +1814,9 @@ class ImFont < FFI::Struct
     :ContainerAtlas, ImFontAtlas.ptr,
     :ConfigData, :pointer,
     :ConfigDataCount, :short,
-    :FallbackChar, :ushort,
-    :EllipsisChar, :ushort,
     :EllipsisCharCount, :short,
+    :EllipsisChar, :ushort,
+    :FallbackChar, :ushort,
     :EllipsisWidth, :float,
     :EllipsisCharStep, :float,
     :DirtyLookupTables, :bool,
@@ -1838,11 +1906,12 @@ end
 # See ImFontAtlas::AddCustomRectXXX functions.
 class ImFontAtlasCustomRect < FFI::Struct
   layout(
-    :Width, :ushort,
-    :Height, :ushort,
     :X, :ushort,
     :Y, :ushort,
+    :Width, :ushort,
+    :Height, :ushort,
     :GlyphID, :uint,
+    :GlyphColored, :uint,
     :GlyphAdvanceX, :float,
     :GlyphOffset, ImVec2.by_value,
     :Font, ImFont.ptr
@@ -1975,22 +2044,43 @@ class ImGuiIO < FFI::Struct
     :FontAllowUserScaling, :bool,
     :FontDefault, ImFont.ptr,
     :DisplayFramebufferScale, ImVec2.by_value,
+    :ConfigNavSwapGamepadButtons, :bool,
+    :ConfigNavMoveSetMousePos, :bool,
+    :ConfigNavCaptureKeyboard, :bool,
+    :ConfigNavEscapeClearFocusItem, :bool,
+    :ConfigNavEscapeClearFocusWindow, :bool,
+    :ConfigNavCursorVisibleAuto, :bool,
+    :ConfigNavCursorVisibleAlways, :bool,
+    :ConfigDockingNoSplit, :bool,
+    :ConfigDockingWithShift, :bool,
+    :ConfigDockingAlwaysTabBar, :bool,
+    :ConfigDockingTransparentPayload, :bool,
+    :ConfigViewportsNoAutoMerge, :bool,
+    :ConfigViewportsNoTaskBarIcon, :bool,
+    :ConfigViewportsNoDecoration, :bool,
+    :ConfigViewportsNoDefaultParent, :bool,
     :MouseDrawCursor, :bool,
     :ConfigMacOSXBehaviors, :bool,
-    :ConfigNavSwapGamepadButtons, :bool,
     :ConfigInputTrickleEventQueue, :bool,
     :ConfigInputTextCursorBlink, :bool,
     :ConfigInputTextEnterKeepActive, :bool,
     :ConfigDragClickToInputText, :bool,
     :ConfigWindowsResizeFromEdges, :bool,
     :ConfigWindowsMoveFromTitleBarOnly, :bool,
+    :ConfigWindowsCopyContentsWithCtrlC, :bool,
+    :ConfigScrollbarScrollByPage, :bool,
     :ConfigMemoryCompactTimer, :float,
     :MouseDoubleClickTime, :float,
     :MouseDoubleClickMaxDist, :float,
     :MouseDragThreshold, :float,
     :KeyRepeatDelay, :float,
     :KeyRepeatRate, :float,
+    :ConfigErrorRecovery, :bool,
+    :ConfigErrorRecoveryEnableAssert, :bool,
+    :ConfigErrorRecoveryEnableDebugLog, :bool,
+    :ConfigErrorRecoveryEnableTooltip, :bool,
     :ConfigDebugIsDebuggerPresent, :bool,
+    :ConfigDebugHighlightIdConflicts, :bool,
     :ConfigDebugBeginReturnValueOnce, :bool,
     :ConfigDebugBeginReturnValueLoop, :bool,
     :ConfigDebugIgnoreFocusLoss, :bool,
@@ -2019,6 +2109,7 @@ class ImGuiIO < FFI::Struct
     :MouseWheel, :float,
     :MouseWheelH, :float,
     :MouseSource, :int,
+    :MouseHoveredViewport, :uint,
     :KeyCtrl, :bool,
     :KeyShift, :bool,
     :KeyAlt, :bool,
@@ -2040,12 +2131,11 @@ class ImGuiIO < FFI::Struct
     :MouseCtrlLeftAsRightClick, :bool,
     :MouseDownDuration, [:float, 5],
     :MouseDownDurationPrev, [:float, 5],
+    :MouseDragMaxDistanceAbs, [ImVec2.by_value, 5],
     :MouseDragMaxDistanceSqr, [:float, 5],
     :PenPressure, :float,
     :AppFocusLost, :bool,
     :AppAcceptingEvents, :bool,
-    :BackendUsingLegacyKeyArrays, :char,
-    :BackendUsingLegacyNavInputArray, :bool,
     :InputQueueSurrogate, :ushort,
     :InputQueueCharacters, ImVector.by_value
   )
@@ -2086,6 +2176,10 @@ class ImGuiIO < FFI::Struct
     ImGui::ImGuiIO_AddMouseSourceEvent(self, source)
   end
 
+  def AddMouseViewportEvent(id)
+    ImGui::ImGuiIO_AddMouseViewportEvent(self, id)
+  end
+
   def AddMouseWheelEvent(wheel_x, wheel_y)
     ImGui::ImGuiIO_AddMouseWheelEvent(self, wheel_x, wheel_y)
   end
@@ -2315,6 +2409,28 @@ class ImGuiPlatformImeData < FFI::Struct
 
 end
 
+# (Optional) This is required when enabling multi-viewport. Represent the bounds of each connected monitor/display and their DPI.
+# We use this information for multiple DPI support + clamping the position of popups and tooltips so they don't straddle multiple monitors.
+class ImGuiPlatformMonitor < FFI::Struct
+  layout(
+    :MainPos, ImVec2.by_value,
+    :MainSize, ImVec2.by_value,
+    :WorkPos, ImVec2.by_value,
+    :WorkSize, ImVec2.by_value,
+    :DpiScale, :float,
+    :PlatformHandle, :pointer
+  )
+
+  def self.create()
+    return ImGuiPlatformMonitor.new(ImGui::ImGuiPlatformMonitor_ImGuiPlatformMonitor())
+  end
+
+  def destroy()
+    ImGui::ImGuiPlatformMonitor_destroy(self)
+  end
+
+end
+
 # Optional helper to store multi-selection state + apply multi-selection requests.
 # - Used by our demos and provided as a convenience to easily implement basic multi-selection.
 # - Iterate selection with 'void* it = NULL; ImGuiID id; while (selection.GetNextSelectedItem(&it, &id)) { ... }'
@@ -2466,13 +2582,14 @@ class ImGuiStyle < FFI::Struct
     :SeparatorTextPadding, ImVec2.by_value,
     :DisplayWindowPadding, ImVec2.by_value,
     :DisplaySafeAreaPadding, ImVec2.by_value,
+    :DockingSeparatorSize, :float,
     :MouseCursorScale, :float,
     :AntiAliasedLines, :bool,
     :AntiAliasedLinesUseTex, :bool,
     :AntiAliasedFill, :bool,
     :CurveTessellationTol, :float,
     :CircleTessellationMaxError, :float,
-    :Colors, [ImVec4.by_value, 56],
+    :Colors, [ImVec4.by_value, 58],
     :HoverStationaryDelay, :float,
     :HoverDelayShort, :float,
     :HoverDelayNormal, :float,
@@ -2549,8 +2666,8 @@ class ImGuiTextBuffer < FFI::Struct
     ImGui::ImGuiTextBuffer_append(self, str, str_end)
   end
 
-  def appendf(fmt, *varargs)
-    ImGui::ImGuiTextBuffer_appendf(self, fmt, *varargs)
+  def appendf(buffer, fmt, *varargs)
+    ImGui::ImGuiTextBuffer_appendf(buffer, fmt, *varargs)
   end
 
   def begin()
@@ -2653,6 +2770,36 @@ class ImGuiTextRange < FFI::Struct
 
 end
 
+# [ALPHA] Rarely used / very advanced uses only. Use with SetNextWindowClass() and DockSpace() functions.
+# Important: the content of this class is still highly WIP and likely to change and be refactored
+# before we stabilize Docking features. Please be mindful if using this.
+# Provide hints:
+# - To the platform backend via altered viewport flags (enable/disable OS decoration, OS task bar icons, etc.)
+# - To the platform backend for OS level parent/child relationships of viewport.
+# - To the docking system for various options and filtering.
+class ImGuiWindowClass < FFI::Struct
+  layout(
+    :ClassId, :uint,
+    :ParentViewportId, :uint,
+    :FocusRouteParentWindowId, :uint,
+    :ViewportFlagsOverrideSet, :int,
+    :ViewportFlagsOverrideClear, :int,
+    :TabItemFlagsOverrideSet, :int,
+    :DockNodeFlagsOverrideSet, :int,
+    :DockingAlwaysTabBar, :bool,
+    :DockingAllowUnclassed, :bool
+  )
+
+  def self.create()
+    return ImGuiWindowClass.new(ImGui::ImGuiWindowClass_ImGuiWindowClass())
+  end
+
+  def destroy()
+    ImGui::ImGuiWindowClass_destroy(self)
+  end
+
+end
+
 # [Internal] Key+Value for ImGuiStorage
 class ImGuiStoragePair < FFI::Struct
   layout(
@@ -2722,12 +2869,12 @@ module ImGui
   end
 
   def self.import_symbols(output_error = false)
-    callback :ImDrawCallback, [ImDrawList, ImDrawCmd], :void
-    callback :ImGuiInputTextCallback, [ImGuiInputTextCallbackData], :int
-    callback :ImGuiSizeCallback, [ImGuiSizeCallbackData], :void
+    callback :ImDrawCallback, [ImDrawList, ImDrawCmd], :void 
+    callback :ImGuiInputTextCallback, [ImGuiInputTextCallbackData], :int 
+    callback :ImGuiSizeCallback, [ImGuiSizeCallbackData], :void 
 
     entries = [
-      [:ImDrawCmd_GetTexID, [:pointer], :pointer],
+      [:ImDrawCmd_GetTexID, [:pointer], :uint64],
       [:ImDrawCmd_ImDrawCmd, [], :pointer],
       [:ImDrawCmd_destroy, [:pointer], :void],
       [:ImDrawData_AddDrawList, [:pointer, :pointer], :void],
@@ -2745,7 +2892,7 @@ module ImGui
       [:ImDrawListSplitter_destroy, [:pointer], :void],
       [:ImDrawList_AddBezierCubic, [:pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint, :float, :int], :void],
       [:ImDrawList_AddBezierQuadratic, [:pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint, :float, :int], :void],
-      [:ImDrawList_AddCallback, [:pointer, :ImDrawCallback, :pointer], :void],
+      [:ImDrawList_AddCallback, [:pointer, :ImDrawCallback, :pointer, :size_t], :void],
       [:ImDrawList_AddCircle, [:pointer, ImVec2.by_value, :float, :uint, :int, :float], :void],
       [:ImDrawList_AddCircleFilled, [:pointer, ImVec2.by_value, :float, :uint, :int], :void],
       [:ImDrawList_AddConcavePolyFilled, [:pointer, :pointer, :int, :uint], :void],
@@ -2753,9 +2900,9 @@ module ImGui
       [:ImDrawList_AddDrawCmd, [:pointer], :void],
       [:ImDrawList_AddEllipse, [:pointer, ImVec2.by_value, ImVec2.by_value, :uint, :float, :int, :float], :void],
       [:ImDrawList_AddEllipseFilled, [:pointer, ImVec2.by_value, ImVec2.by_value, :uint, :float, :int], :void],
-      [:ImDrawList_AddImage, [:pointer, :pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint], :void],
-      [:ImDrawList_AddImageQuad, [:pointer, :pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint], :void],
-      [:ImDrawList_AddImageRounded, [:pointer, :pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint, :float, :int], :void],
+      [:ImDrawList_AddImage, [:pointer, :uint64, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint], :void],
+      [:ImDrawList_AddImageQuad, [:pointer, :uint64, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint], :void],
+      [:ImDrawList_AddImageRounded, [:pointer, :uint64, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, :uint, :float, :int], :void],
       [:ImDrawList_AddLine, [:pointer, ImVec2.by_value, ImVec2.by_value, :uint, :float], :void],
       [:ImDrawList_AddNgon, [:pointer, ImVec2.by_value, :float, :uint, :int, :float], :void],
       [:ImDrawList_AddNgonFilled, [:pointer, ImVec2.by_value, :float, :uint, :int], :void],
@@ -2800,7 +2947,7 @@ module ImGui
       [:ImDrawList_PrimWriteVtx, [:pointer, ImVec2.by_value, ImVec2.by_value, :uint], :void],
       [:ImDrawList_PushClipRect, [:pointer, ImVec2.by_value, ImVec2.by_value, :bool], :void],
       [:ImDrawList_PushClipRectFullScreen, [:pointer], :void],
-      [:ImDrawList_PushTextureID, [:pointer, :pointer], :void],
+      [:ImDrawList_PushTextureID, [:pointer, :uint64], :void],
       [:ImDrawList__CalcCircleAutoSegmentCount, [:pointer, :float], :int],
       [:ImDrawList__ClearFreeMemory, [:pointer], :void],
       [:ImDrawList__OnChangedClipRect, [:pointer], :void],
@@ -2810,7 +2957,7 @@ module ImGui
       [:ImDrawList__PathArcToN, [:pointer, ImVec2.by_value, :float, :float, :float, :int], :void],
       [:ImDrawList__PopUnusedDrawCmd, [:pointer], :void],
       [:ImDrawList__ResetForNewFrame, [:pointer], :void],
-      [:ImDrawList__SetTextureID, [:pointer, :pointer], :void],
+      [:ImDrawList__SetTextureID, [:pointer, :uint64], :void],
       [:ImDrawList__TryMergeDrawCmds, [:pointer], :void],
       [:ImDrawList_destroy, [:pointer], :void],
       [:ImFontAtlasCustomRect_ImFontAtlasCustomRect, [], :pointer],
@@ -2845,7 +2992,7 @@ module ImGui
       [:ImFontAtlas_GetTexDataAsRGBA32, [:pointer, :pointer, :pointer, :pointer, :pointer], :void],
       [:ImFontAtlas_ImFontAtlas, [], :pointer],
       [:ImFontAtlas_IsBuilt, [:pointer], :bool],
-      [:ImFontAtlas_SetTexID, [:pointer, :pointer], :void],
+      [:ImFontAtlas_SetTexID, [:pointer, :uint64], :void],
       [:ImFontAtlas_destroy, [:pointer], :void],
       [:ImFontConfig_ImFontConfig, [], :pointer],
       [:ImFontConfig_destroy, [:pointer], :void],
@@ -2876,6 +3023,8 @@ module ImGui
       [:ImFont_RenderText, [:pointer, :pointer, :float, ImVec2.by_value, :uint, ImVec4.by_value, :pointer, :pointer, :float, :bool], :void],
       [:ImFont_SetGlyphVisible, [:pointer, :ushort, :bool], :void],
       [:ImFont_destroy, [:pointer], :void],
+      [:ImGuiFreeType_GetBuilderForFreeType, [], :pointer],
+      [:ImGuiFreeType_SetAllocatorFunctions, [:pointer, :pointer, :pointer], :void],
       [:ImGuiIO_AddFocusEvent, [:pointer, :bool], :void],
       [:ImGuiIO_AddInputCharacter, [:pointer, :uint], :void],
       [:ImGuiIO_AddInputCharacterUTF16, [:pointer, :ushort], :void],
@@ -2885,6 +3034,7 @@ module ImGui
       [:ImGuiIO_AddMouseButtonEvent, [:pointer, :int, :bool], :void],
       [:ImGuiIO_AddMousePosEvent, [:pointer, :float, :float], :void],
       [:ImGuiIO_AddMouseSourceEvent, [:pointer, :int], :void],
+      [:ImGuiIO_AddMouseViewportEvent, [:pointer, :uint], :void],
       [:ImGuiIO_AddMouseWheelEvent, [:pointer, :float, :float], :void],
       [:ImGuiIO_ClearEventsQueue, [:pointer], :void],
       [:ImGuiIO_ClearInputKeys, [:pointer], :void],
@@ -2920,6 +3070,8 @@ module ImGui
       [:ImGuiPlatformIO_destroy, [:pointer], :void],
       [:ImGuiPlatformImeData_ImGuiPlatformImeData, [], :pointer],
       [:ImGuiPlatformImeData_destroy, [:pointer], :void],
+      [:ImGuiPlatformMonitor_ImGuiPlatformMonitor, [], :pointer],
+      [:ImGuiPlatformMonitor_destroy, [:pointer], :void],
       [:ImGuiSelectionBasicStorage_ApplyRequests, [:pointer, :pointer], :void],
       [:ImGuiSelectionBasicStorage_Clear, [:pointer], :void],
       [:ImGuiSelectionBasicStorage_Contains, [:pointer, :uint], :bool],
@@ -2985,6 +3137,8 @@ module ImGui
       [:ImGuiViewport_GetWorkCenter, [:pointer, :pointer], :void],
       [:ImGuiViewport_ImGuiViewport, [], :pointer],
       [:ImGuiViewport_destroy, [:pointer], :void],
+      [:ImGuiWindowClass_ImGuiWindowClass, [], :pointer],
+      [:ImGuiWindowClass_destroy, [:pointer], :void],
       [:igAcceptDragDropPayload, [:pointer, :int], :pointer],
       [:igAlignTextToFramePadding, [], :void],
       [:igArrowButton, [:pointer, :int], :bool],
@@ -3042,6 +3196,9 @@ module ImGui
       [:igDebugStartItemPicker, [], :void],
       [:igDebugTextEncoding, [:pointer], :void],
       [:igDestroyContext, [:pointer], :void],
+      [:igDestroyPlatformWindows, [], :void],
+      [:igDockSpace, [:uint, ImVec2.by_value, :int, :pointer], :uint],
+      [:igDockSpaceOverViewport, [:uint, :pointer, :int, :pointer], :uint],
       [:igDragFloat, [:pointer, :pointer, :float, :float, :float, :pointer, :int], :bool],
       [:igDragFloat2, [:pointer, :pointer, :float, :float, :float, :pointer, :int], :bool],
       [:igDragFloat3, [:pointer, :pointer, :float, :float, :float, :pointer, :int], :bool],
@@ -3073,8 +3230,10 @@ module ImGui
       [:igEndTabItem, [], :void],
       [:igEndTable, [], :void],
       [:igEndTooltip, [], :void],
+      [:igFindViewportByID, [:uint], :pointer],
+      [:igFindViewportByPlatformHandle, [:pointer], :pointer],
       [:igGetAllocatorFunctions, [:pointer, :pointer, :pointer], :void],
-      [:igGetBackgroundDrawList, [], :pointer],
+      [:igGetBackgroundDrawList, [:pointer], :pointer],
       [:igGetClipboardText, [], :pointer],
       [:igGetColorU32_Col, [:int, :float], :uint],
       [:igGetColorU32_Vec4, [ImVec4.by_value], :uint],
@@ -3096,7 +3255,7 @@ module ImGui
       [:igGetFont, [], :pointer],
       [:igGetFontSize, [], :float],
       [:igGetFontTexUvWhitePixel, [:pointer], :void],
-      [:igGetForegroundDrawList, [], :pointer],
+      [:igGetForegroundDrawList, [:pointer], :pointer],
       [:igGetFrameCount, [], :int],
       [:igGetFrameHeight, [], :float],
       [:igGetFrameHeightWithSpacing, [], :float],
@@ -3131,13 +3290,16 @@ module ImGui
       [:igGetTime, [], :double],
       [:igGetTreeNodeToLabelSpacing, [], :float],
       [:igGetVersion, [], :pointer],
+      [:igGetWindowDockID, [], :uint],
+      [:igGetWindowDpiScale, [], :float],
       [:igGetWindowDrawList, [], :pointer],
       [:igGetWindowHeight, [], :float],
       [:igGetWindowPos, [:pointer], :void],
       [:igGetWindowSize, [:pointer], :void],
+      [:igGetWindowViewport, [], :pointer],
       [:igGetWindowWidth, [], :float],
-      [:igImage, [:pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec4.by_value, ImVec4.by_value], :void],
-      [:igImageButton, [:pointer, :pointer, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec4.by_value, ImVec4.by_value], :bool],
+      [:igImage, [:uint64, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec4.by_value, ImVec4.by_value], :void],
+      [:igImageButton, [:pointer, :uint64, ImVec2.by_value, ImVec2.by_value, ImVec2.by_value, ImVec4.by_value, ImVec4.by_value], :bool],
       [:igIndent, [:float], :void],
       [:igInputDouble, [:pointer, :pointer, :double, :double, :pointer, :int], :bool],
       [:igInputFloat, [:pointer, :pointer, :float, :float, :pointer, :int], :bool],
@@ -3185,6 +3347,7 @@ module ImGui
       [:igIsRectVisible_Vec2, [ImVec2.by_value, ImVec2.by_value], :bool],
       [:igIsWindowAppearing, [], :bool],
       [:igIsWindowCollapsed, [], :bool],
+      [:igIsWindowDocked, [], :bool],
       [:igIsWindowFocused, [:int], :bool],
       [:igIsWindowHovered, [:int], :bool],
       [:igLabelText, [:pointer, :pointer, :varargs], :void],
@@ -3239,6 +3402,7 @@ module ImGui
       [:igRadioButton_Bool, [:pointer, :bool], :bool],
       [:igRadioButton_IntPtr, [:pointer, :pointer, :int], :bool],
       [:igRender, [], :void],
+      [:igRenderPlatformWindowsDefault, [:pointer, :pointer], :void],
       [:igResetMouseDragDelta, [:int], :void],
       [:igSameLine, [:float, :float], :void],
       [:igSaveIniSettingsToDisk, [:pointer], :void],
@@ -3263,6 +3427,7 @@ module ImGui
       [:igSetItemTooltip, [:pointer, :varargs], :void],
       [:igSetKeyboardFocusHere, [:int], :void],
       [:igSetMouseCursor, [:int], :void],
+      [:igSetNavCursorVisible, [:bool], :void],
       [:igSetNextFrameWantCaptureKeyboard, [:bool], :void],
       [:igSetNextFrameWantCaptureMouse, [:bool], :void],
       [:igSetNextItemAllowOverlap, [], :void],
@@ -3272,13 +3437,16 @@ module ImGui
       [:igSetNextItemStorageID, [:uint], :void],
       [:igSetNextItemWidth, [:float], :void],
       [:igSetNextWindowBgAlpha, [:float], :void],
+      [:igSetNextWindowClass, [:pointer], :void],
       [:igSetNextWindowCollapsed, [:bool, :int], :void],
       [:igSetNextWindowContentSize, [ImVec2.by_value], :void],
+      [:igSetNextWindowDockID, [:uint, :int], :void],
       [:igSetNextWindowFocus, [], :void],
       [:igSetNextWindowPos, [ImVec2.by_value, :int, ImVec2.by_value], :void],
       [:igSetNextWindowScroll, [ImVec2.by_value], :void],
       [:igSetNextWindowSize, [ImVec2.by_value, :int], :void],
       [:igSetNextWindowSizeConstraints, [ImVec2.by_value, ImVec2.by_value, :ImGuiSizeCallback, :pointer], :void],
+      [:igSetNextWindowViewport, [:uint], :void],
       [:igSetScrollFromPosX, [:float, :float], :void],
       [:igSetScrollFromPosY, [:float, :float], :void],
       [:igSetScrollHereX, [:float], :void],
@@ -3358,6 +3526,7 @@ module ImGui
       [:igTreePush_Str, [:pointer], :void],
       [:igTreePush_Ptr, [:pointer], :void],
       [:igUnindent, [:float], :void],
+      [:igUpdatePlatformWindows, [], :void],
       [:igVSliderFloat, [:pointer, ImVec2.by_value, :pointer, :float, :float, :pointer, :int], :bool],
       [:igVSliderInt, [:pointer, ImVec2.by_value, :pointer, :int, :int, :pointer, :int], :bool],
       [:igVSliderScalar, [:pointer, ImVec2.by_value, :int, :pointer, :pointer, :pointer, :pointer, :int], :bool],
@@ -3445,7 +3614,7 @@ module ImGui
   # - Disable all user interactions and dim items visuals (applying style.DisabledAlpha over current colors)
   # - Those can be nested but it cannot be used to enable an already disabled section (a single BeginDisabled(true) in the stack is enough to keep everything disabled)
   # - Tooltips windows by exception are opted out of disabling.
-  # - BeginDisabled(false) essentially does nothing useful but is provided to facilitate use of boolean expressions. If you can avoid calling BeginDisabled(False)/EndDisabled() best to avoid it.
+  # - BeginDisabled(false)/EndDisabled() essentially does nothing but is provided to facilitate use of boolean expressions (as a micro-optimization: if you have tens of thousands of BeginDisabled(false)/EndDisabled() pairs, you might want to reformulate your code to avoid making those calls)
   def self.BeginDisabled(disabled = true)
     igBeginDisabled(disabled)
   end
@@ -3487,6 +3656,7 @@ module ImGui
   #
   # Widgets: List Boxes
   # - This is essentially a thin wrapper to using BeginChild/EndChild with the ImGuiChildFlags_FrameStyle flag for stylistic changes + displaying a label.
+  # - If you don't need a label you can probably simply use BeginChild() with the ImGuiChildFlags_FrameStyle flag for the same result.
   # - You can submit contents and manage your selection state however you want it, by creating e.g. Selectable() or any other items.
   # - The simplified/old ListBox() api are helpers over BeginListBox()/EndListBox() which are kept available for convenience purpose. This is analoguous to how Combos are created.
   # - Choose frame width:   size.x > 0.0f: custom  /  size.x < 0.0f or -FLT_MIN: right-align   /  size.x = 0.0f (default): use current ItemWidth
@@ -3840,6 +4010,37 @@ module ImGui
     igDestroyContext(ctx)
   end
 
+  # ret: void
+  def self.DestroyPlatformWindows()  # call DestroyWindow platform functions for all viewports. call from backend Shutdown() if you need to close platform windows before imgui shutdown. otherwise will be called by DestroyContext().
+    igDestroyPlatformWindows()
+  end
+
+  # arg: dockspace_id(ImGuiID), size(ImVec2), flags(ImGuiDockNodeFlags), window_class(const ImGuiWindowClass*)
+  # ret: uint
+  #
+  # Docking
+  # [BETA API] Enable with io.ConfigFlags |= ImGuiConfigFlags_DockingEnable.
+  # Note: You can use most Docking facilities without calling any API. You DO NOT need to call DockSpace() to use Docking!
+  # - Drag from window title bar or their tab to dock/undock. Hold SHIFT to disable docking.
+  # - Drag from window menu button (upper-left button) to undock an entire node (all windows).
+  # - When io.ConfigDockingWithShift == true, you instead need to hold SHIFT to enable docking.
+  # About dockspaces:
+  # - Use DockSpaceOverViewport() to create a window covering the screen or a specific viewport + a dockspace inside it.
+  #   This is often used with ImGuiDockNodeFlags_PassthruCentralNode to make it transparent.
+  # - Use DockSpace() to create an explicit dock node _within_ an existing window. See Docking demo for details.
+  # - Important: Dockspaces need to be submitted _before_ any window they can host. Submit it early in your frame!
+  # - Important: Dockspaces need to be kept alive if hidden, otherwise windows docked into it will be undocked.
+  #   e.g. if you have multiple tabs with a dockspace inside each tab: submit the non-visible dockspaces with ImGuiDockNodeFlags_KeepAliveOnly.
+  def self.DockSpace(dockspace_id, size = ImVec2.create(0,0), flags = 0, window_class = nil)  # Implied size = ImVec2(0, 0), flags = 0, window_class = NULL
+    igDockSpace(dockspace_id, size, flags, window_class)
+  end
+
+  # arg: dockspace_id(ImGuiID), viewport(const ImGuiViewport*), flags(ImGuiDockNodeFlags), window_class(const ImGuiWindowClass*)
+  # ret: uint
+  def self.DockSpaceOverViewport(dockspace_id = 0, viewport = nil, flags = 0, window_class = nil)  # Implied dockspace_id = 0, viewport = NULL, flags = 0, window_class = NULL
+    igDockSpaceOverViewport(dockspace_id, viewport, flags, window_class)
+  end
+
   # arg: label(const char*), v(float*), v_speed(float), v_min(float), v_max(float), format(const char*), flags(ImGuiSliderFlags)
   # ret: bool
   #
@@ -3849,7 +4050,7 @@ module ImGui
   #   the array syntax is just a way to document the number of elements that are expected to be accessible. You can pass address of your first element out of a contiguous set, e.g. &myvector.x
   # - Adjust format string to decorate the value with a prefix, a suffix, or adapt the editing and display precision e.g. "%.3f" -> 1.234; "%5.2f secs" -> 01.23 secs; "Biscuit: %.0f" -> Biscuit: 1; etc.
   # - Format string may also be set to NULL or use the default format ("%f" or "%d").
-  # - Speed are per-pixel of mouse movement (v_speed=0.2f: mouse needs to move by 5 pixels to increase value by 1). For gamepad/keyboard navigation, minimum speed is Max(v_speed, minimum_step_at_given_precision).
+  # - Speed are per-pixel of mouse movement (v_speed=0.2f: mouse needs to move by 5 pixels to increase value by 1). For keyboard/gamepad navigation, minimum speed is Max(v_speed, minimum_step_at_given_precision).
   # - Use v_min < v_max to clamp edits to given limits. Note that CTRL+Click manual input can override those limits if ImGuiSliderFlags_AlwaysClamp is not used.
   # - Use v_max = FLT_MAX / INT_MAX etc to avoid clamping to a maximum, same with v_min = -FLT_MAX / INT_MIN to avoid clamping to a minimum.
   # - We use the same sets of flags for DragXXX() and SliderXXX() functions as the features are the same and it makes it easier to swap them.
@@ -4021,17 +4222,30 @@ module ImGui
     igEndTooltip()
   end
 
+  # arg: id(ImGuiID)
+  # ret: pointer
+  def self.FindViewportByID(id)  # this is a helper for backends.
+    igFindViewportByID(id)
+  end
+
+  # arg: platform_handle(void*)
+  # ret: pointer
+  def self.FindViewportByPlatformHandle(platform_handle)  # this is a helper for backends. the type platform_handle is decided by the backend (e.g. HWND, MyWindow*, GLFWwindow* etc.)
+    igFindViewportByPlatformHandle(platform_handle)
+  end
+
   # arg: p_alloc_func(ImGuiMemAllocFunc*), p_free_func(ImGuiMemFreeFunc*), p_user_data(void**)
   # ret: void
   def self.GetAllocatorFunctions(p_alloc_func, p_free_func, p_user_data)
     igGetAllocatorFunctions(p_alloc_func, p_free_func, p_user_data)
   end
 
+  # arg: viewport(ImGuiViewport*)
   # ret: pointer
   #
   # Background/Foreground Draw Lists
-  def self.GetBackgroundDrawList()  # Implied viewport = NULL
-    igGetBackgroundDrawList()
+  def self.GetBackgroundDrawList(viewport = nil)  # Implied viewport = NULL
+    igGetBackgroundDrawList(viewport)
   end
 
   # ret: pointer
@@ -4171,9 +4385,10 @@ module ImGui
     return pOut
   end
 
+  # arg: viewport(ImGuiViewport*)
   # ret: pointer
-  def self.GetForegroundDrawList()  # Implied viewport = NULL
-    igGetForegroundDrawList()
+  def self.GetForegroundDrawList(viewport = nil)  # Implied viewport = NULL
+    igGetForegroundDrawList(viewport)
   end
 
   # ret: int
@@ -4379,6 +4594,16 @@ module ImGui
     igGetVersion()
   end
 
+  # ret: uint
+  def self.GetWindowDockID()
+    igGetWindowDockID()
+  end
+
+  # ret: float
+  def self.GetWindowDpiScale()  # get DPI scale currently associated to the current window's viewport.
+    igGetWindowDpiScale()
+  end
+
   # ret: pointer
   def self.GetWindowDrawList()  # get draw list associated to the current window, to append your own drawing primitives
     igGetWindowDrawList()
@@ -4403,6 +4628,11 @@ module ImGui
     return pOut
   end
 
+  # ret: pointer
+  def self.GetWindowViewport()  # get viewport currently associated to the current window.
+    igGetWindowViewport()
+  end
+
   # ret: float
   def self.GetWindowWidth()  # get current window width (IT IS UNLIKELY YOU EVER NEED TO USE THIS). Shortcut for GetWindowSize().x.
     igGetWindowWidth()
@@ -4415,6 +4645,7 @@ module ImGui
   # - Read about ImTextureID here: https://github.com/ocornut/imgui/wiki/Image-Loading-and-Displaying-Examples
   # - 'uv0' and 'uv1' are texture coordinates. Read about them from the same link above.
   # - Note that Image() may add +2.0f to provided size if a border is visible, ImageButton() adds style.FramePadding*2.0f to provided size.
+  # - ImageButton() draws a background based on regular Button() color + optionally an inner background if specified.
   def self.Image(user_texture_id, image_size, uv0 = ImVec2.create(0,0), uv1 = ImVec2.create(1,1), tint_col = ImVec4.create(1,1,1,1), border_col = ImVec4.create(0,0,0,0))  # Implied uv0 = ImVec2(0, 0), uv1 = ImVec2(1, 1), tint_col = ImVec4(1, 1, 1, 1), border_col = ImVec4(0, 0, 0, 0)
     igImage(user_texture_id, image_size, uv0, uv1, tint_col, border_col)
   end
@@ -4617,9 +4848,8 @@ module ImGui
   #
   # Inputs Utilities: Keyboard/Mouse/Gamepad
   # - the ImGuiKey enum contains all possible keyboard, mouse and gamepad inputs (e.g. ImGuiKey_A, ImGuiKey_MouseLeft, ImGuiKey_GamepadDpadUp...).
-  # - before v1.87, we used ImGuiKey to carry native/user indices as defined by each backends. About use of those legacy ImGuiKey values:
-  #  - without IMGUI_DISABLE_OBSOLETE_KEYIO (legacy support): you can still use your legacy native/user indices (< 512) according to how your backend/engine stored them in io.KeysDown[], but need to cast them to ImGuiKey.
-  #  - with    IMGUI_DISABLE_OBSOLETE_KEYIO (this is the way forward): any use of ImGuiKey will assert with key < 512. GetKeyIndex() is pass-through and therefore deprecated (gone if IMGUI_DISABLE_OBSOLETE_KEYIO is defined).
+  # - (legacy: before v1.87, we used ImGuiKey to carry native/user indices as defined by each backends. This was obsoleted in 1.87 (2022-02) and completely removed in 1.91.5 (2024-11). See https://github.com/ocornut/imgui/issues/4921)
+  # - (legacy: any use of ImGuiKey will assert when key < 512 to detect passing legacy native/user indices)
   def self.IsKeyDown(key)  # is key being held.
     igIsKeyDown(key)
   end
@@ -4651,7 +4881,7 @@ module ImGui
   # arg: button(ImGuiMouseButton)
   # ret: bool
   #
-  # Inputs Utilities: Mouse specific
+  # Inputs Utilities: Mouse
   # - To refer to a mouse button, you may use named enums in your code e.g. ImGuiMouseButton_Left, ImGuiMouseButton_Right.
   # - You can also use regular integer: it is forever guaranteed that 0=Left, 1=Right, 2=Middle.
   # - Dragging operations are only reported after mouse has moved a certain distance away from the initial clicking position (see 'lock_threshold' and 'io.MouseDraggingThreshold')
@@ -4719,6 +4949,11 @@ module ImGui
     igIsWindowCollapsed()
   end
 
+  # ret: bool
+  def self.IsWindowDocked()  # is current window docked into another window?
+    igIsWindowDocked()
+  end
+
   # arg: flags(ImGuiFocusedFlags)
   # ret: bool
   def self.IsWindowFocused(flags = 0)  # is current window focused? or its root/child, depending on flags. see flags for options.
@@ -5046,6 +5281,12 @@ module ImGui
     igRender()
   end
 
+  # arg: platform_render_arg(void*), renderer_render_arg(void*)
+  # ret: void
+  def self.RenderPlatformWindowsDefault(platform_render_arg = nil, renderer_render_arg = nil)  # Implied platform_render_arg = NULL, renderer_render_arg = NULL
+    igRenderPlatformWindowsDefault(platform_render_arg, renderer_render_arg)
+  end
+
   # arg: button(ImGuiMouseButton)
   # ret: void
   def self.ResetMouseDragDelta(button = 0)  # Implied button = 0
@@ -5169,8 +5410,7 @@ module ImGui
   # ret: void
   #
   # Focus, Activation
-  # - Prefer using "SetItemDefaultFocus()" over "if (IsWindowAppearing()) SetScrollHereY()" when applicable to signify "this is the default item"
-  def self.SetItemDefaultFocus()  # make last item the default focused item of a window.
+  def self.SetItemDefaultFocus()  # make last item the default focused item of of a newly appearing window.
     igSetItemDefaultFocus()
   end
 
@@ -5205,6 +5445,14 @@ module ImGui
     igSetMouseCursor(cursor_type)
   end
 
+  # arg: visible(bool)
+  # ret: void
+  #
+  # Keyboard/Gamepad Navigation
+  def self.SetNavCursorVisible(visible)  # alter visibility of keyboard/gamepad cursor. by default: show when using an arrow key, hide when clicking with mouse.
+    igSetNavCursorVisible(visible)
+  end
+
   # arg: want_capture_keyboard(bool)
   # ret: void
   def self.SetNextFrameWantCaptureKeyboard(want_capture_keyboard)  # Override io.WantCaptureKeyboard flag next frame (said flag is left for your application to handle, typically when true it instructs your app to ignore inputs). e.g. force capture keyboard when your widget is being hovered. This is equivalent to setting "io.WantCaptureKeyboard = want_capture_keyboard"; after the next NewFrame() call.
@@ -5260,6 +5508,12 @@ module ImGui
     igSetNextWindowBgAlpha(alpha)
   end
 
+  # arg: window_class(const ImGuiWindowClass*)
+  # ret: void
+  def self.SetNextWindowClass(window_class)  # set next window class (control docking compatibility + provide hints to platform backend via custom viewport flags and platform parent/child relationship)
+    igSetNextWindowClass(window_class)
+  end
+
   # arg: collapsed(bool), cond(ImGuiCond)
   # ret: void
   def self.SetNextWindowCollapsed(collapsed, cond = 0)  # set next window collapsed state. call before Begin()
@@ -5272,6 +5526,12 @@ module ImGui
     igSetNextWindowContentSize(size)
   end
 
+  # arg: dock_id(ImGuiID), cond(ImGuiCond)
+  # ret: void
+  def self.SetNextWindowDockID(dock_id, cond = 0)  # set next window dock id
+    igSetNextWindowDockID(dock_id, cond)
+  end
+
   # ret: void
   def self.SetNextWindowFocus()  # set next window to be focused / top-most. call before Begin()
     igSetNextWindowFocus()
@@ -5304,6 +5564,12 @@ module ImGui
     igSetNextWindowSizeConstraints(size_min, size_max, custom_callback, custom_callback_data)
   end
 
+  # arg: viewport_id(ImGuiID)
+  # ret: void
+  def self.SetNextWindowViewport(viewport_id)  # set next window viewport
+    igSetNextWindowViewport(viewport_id)
+  end
+
   # arg: local_x(float), center_x_ratio(float)
   # ret: void
   def self.SetScrollFromPosX(local_x, center_x_ratio = 0.5)  # adjust scrolling amount to make given position visible. Generally GetCursorStartPos() + offset to compute a valid position.
@@ -5811,6 +6077,15 @@ module ImGui
     igUnindent(indent_w)
   end
 
+  # ret: void
+  #
+  # (Optional) Platform/OS interface for multi-viewport support
+  # Read comments around the ImGuiPlatformIO structure for more details.
+  # Note: You may use GetWindowViewport() to get the current viewport of the current window.
+  def self.UpdatePlatformWindows()  # call in main loop. will call CreateWindow/ResizeWindow/etc. platform functions for each secondary viewport, and DestroyWindow for each inactive viewport.
+    igUpdatePlatformWindows()
+  end
+
   # arg: label(const char*), size(ImVec2), v(float*), v_min(float), v_max(float), format(const char*), flags(ImGuiSliderFlags)
   # ret: bool
   def self.VSliderFloat(label, size, v, v_min, v_max, format = "%.3f", flags = 0)  # Implied format = "%.3f", flags = 0