docking: runs end to end (dock/undock by drag, builder, ini round trip), test scripts

2026-10-08 05:43:00 -05:00
parent fee9a84902
commit 2381a232ee
17 changed files with 492 additions and 107 deletions
@@ -0,0 +1,47 @@
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+local G = require(ReplicatedStorage:WaitForChild("ImGui"))
+local ImGui, ImVec2 = G.ImGui, G.ImVec2
+ImGui.CreateContext()
+local io = ImGui.GetIO()
+io.ConfigFlags = bit32.bor(io.ConfigFlags, G.ImGuiConfigFlags.DockingEnable)
+G.ImGui_ImplRoblox.Init()
+local frame = 0
+local dockspace_id
+local winA, winB, winC
+RunService.Stepped:Connect(function()
+    frame += 1
+    G.ImGui_ImplRoblox.NewFrame()
+    ImGui.NewFrame()
+    dockspace_id = ImGui.DockSpaceOverViewport(0, nil, 0)
+    if frame == 2 then
+        ImGui.DockBuilderRemoveNode(dockspace_id)
+        ImGui.DockBuilderAddNode(dockspace_id, bit32.bor(G.ImGuiDockNodeFlags.DockSpace))
+        ImGui.DockBuilderSetNodeSize(dockspace_id, ImGui.GetMainViewport().Size)
+        local left, right = ImGui.DockBuilderSplitNode(dockspace_id, G.ImGuiDir.Left, 0.3)
+        ImGui.DockBuilderDockWindow("A", left)
+        ImGui.DockBuilderDockWindow("B", right)
+        ImGui.DockBuilderDockWindow("C", right)
+        ImGui.DockBuilderFinish(dockspace_id)
+        print("split", left, right)
+    end
+    for _, n in ipairs({"A", "B", "C"}) do
+        if ImGui.Begin(n) then ImGui.Text("window " .. n) end
+        ImGui.End()
+    end
+    if frame == 30 then
+        local g = ImGui.GetCurrentContext()
+        local a, b, c = ImGui.FindWindowByName("A"), ImGui.FindWindowByName("B"), ImGui.FindWindowByName("C")
+        print("A node", a.DockNode and a.DockNode.ID, "B node", b.DockNode and b.DockNode.ID, "C node", c.DockNode and c.DockNode.ID)
+        assert(a.DockNode ~= nil and b.DockNode ~= nil, "windows must be docked")
+        assert(a.DockNode ~= b.DockNode, "A and B in different nodes")
+        assert(b.DockNode == c.DockNode, "B and C share a node")
+        assert(b.DockNode.TabBar ~= nil and b.DockNode.TabBar.Tabs.Size == 2, "B/C tab bar with 2 tabs")
+        local ini = ImGui.SaveIniSettingsToMemory()
+        print(ini)
+        assert(ini:find("%[Docking%]%[Data%]"), "docking ini section")
+        print("DOCK OK")
+    end
+    ImGui.Render()
+    G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
+end)
@@ -0,0 +1,69 @@
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+local G = require(ReplicatedStorage:WaitForChild("ImGui"))
+local ImGui, ImVec2 = G.ImGui, G.ImVec2
+ImGui.CreateContext()
+local io = ImGui.GetIO()
+io.ConfigFlags = bit32.bor(io.ConfigFlags, G.ImGuiConfigFlags.DockingEnable)
+G.ImGui_ImplRoblox.Init()
+local frame = 0
+-- script: {frame, x, y, down}
+local function lerp(a, b, t) return a + (b - a) * t end
+local function script(f)
+    if f >= 50 then
+        -- tab of B inside the docked node: press on the tab, drag far downward to undock
+        if f < 52 then return 150, 108, false end
+        if f == 52 then return 150, 108, true end
+        if f <= 66 then local t = (f - 52) / 14 return lerp(150, 700, t), lerp(108, 600, t), true end
+        if f <= 70 then return 700, 600, true end
+        return 700, 600, false
+    end
+    if f < 6 then return 600, 108, false end
+    if f == 6 then return 600, 108, true end
+    if f <= 20 then local t = (f - 6) / 14 return lerp(600, 250, t), lerp(108, 190, t), true end
+    if f <= 26 then return 250, 190, true end
+    if f == 27 then return 250, 190, false end
+    return 250, 190, false
+end
+local last_down = false
+RunService.Stepped:Connect(function()
+    frame += 1
+    G.ImGui_ImplRoblox.NewFrame()
+    local x, y, down = script(frame)
+    io:AddMousePosEvent(x, y)
+    if down ~= last_down then io:AddMouseButtonEvent(0, down); last_down = down end
+    ImGui.NewFrame()
+    ImGui.SetNextWindowPos(ImVec2(100, 100), G.ImGuiCond.FirstUseEver)
+    ImGui.SetNextWindowSize(ImVec2(300, 200), G.ImGuiCond.FirstUseEver)
+    if ImGui.Begin("A") then ImGui.Text("window A") end
+    ImGui.End()
+    ImGui.SetNextWindowPos(ImVec2(500, 100), G.ImGuiCond.FirstUseEver)
+    ImGui.SetNextWindowSize(ImVec2(300, 200), G.ImGuiCond.FirstUseEver)
+    if ImGui.Begin("B") then ImGui.Text("window B") end
+    ImGui.End()
+    if frame == 28 or frame == 40 then
+        local a, b = ImGui.FindWindowByName("A"), ImGui.FindWindowByName("B")
+        local g = ImGui.GetCurrentContext()
+        print("frame", frame, "movingwindow", g.MovingWindow and g.MovingWindow.Name, "dragdrop", g.DragDropActive, "A.node", a.DockNode and a.DockNode.ID, "B.node", b.DockNode and b.DockNode.ID, "B.pos", b.Pos.x, b.Pos.y)
+    end
+    if frame == 45 then
+        local a, b = ImGui.FindWindowByName("A"), ImGui.FindWindowByName("B")
+        assert(a.DockNode ~= nil and a.DockNode == b.DockNode, "B must be docked into A's node")
+        assert(a.DockNode.Windows.Size == 2, "node has 2 windows")
+        print("DRAG DOCK OK")
+    end
+    if frame >= 60 and frame <= 90 and frame % 3 == 0 then local g = ImGui.GetCurrentContext(); local b = ImGui.FindWindowByName("B"); local tb = b.DockNode and b.DockNode.TabBar; print("f", frame, "Bnode", b.DockNode and b.DockNode.ID, "Bpos", b.Pos.x, b.Pos.y, "active", g.ActiveId, "hovered", g.HoveredId, "hovwin", g.HoveredWindow and g.HoveredWindow.Name, "tabid", b.TabId, "moving", g.MovingWindow and g.MovingWindow.Name, "dd", g.DragDropActive, "mouse", g.IO.MousePos.x, g.IO.MousePos.y, "down", g.IO.MouseDown[0], "drag", ImGui.IsMouseDragging(0)) end
+    if frame == 52 then
+        local b = ImGui.FindWindowByName("B")
+        local tb = b.DockNode.TabBar
+        for i = 1, tb.Tabs.Size do local t = tb.Tabs.Data[i]; print("tab", i, ImGui.TabBarGetTabName(tb, t), "offset", t.Offset, "width", t.Width, "bar", tb.BarRect.Min.x, tb.BarRect.Min.y, tb.BarRect.Max.x, tb.BarRect.Max.y) end
+    end
+    if frame == 90 then
+        local a, b = ImGui.FindWindowByName("A"), ImGui.FindWindowByName("B")
+        print("final", "A.node", a.DockNode and a.DockNode.ID, "B.node", b.DockNode and b.DockNode.ID, "B.pos", b.Pos.x, b.Pos.y)
+        assert(b.DockNode == nil or b.DockNode ~= a.DockNode, "B must be undocked from A")
+        print("UNDOCK OK")
+    end
+    ImGui.Render()
+    G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
+end)
@@ -0,0 +1,80 @@
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+local G = require(ReplicatedStorage:WaitForChild("ImGui"))
+local ImGui, ImVec2 = G.ImGui, G.ImVec2
+ImGui.CreateContext()
+local io = ImGui.GetIO()
+io.ConfigFlags = bit32.bor(io.ConfigFlags, G.ImGuiConfigFlags.DockingEnable)
+G.ImGui_ImplRoblox.Init()
+local frame = 0
+local seed = 7
+local function rnd(n) seed = (seed * 1103515245 + 12345) % 2147483648; return seed % n end
+local names = {"A", "B", "C", "D", "E"}
+local drag -- {fx,fy,tx,ty,start}
+local last_down = false
+local docks, undocks = 0, 0
+local function check_tree()
+    local g = ImGui.GetCurrentContext()
+    for id, node in pairs(g.DockContext.Nodes) do
+        assert(node.ID == id)
+        if node.ParentNode then
+            assert(node.ParentNode.ChildNodes[0] == node or node.ParentNode.ChildNodes[1] == node, "parent link")
+        end
+        for _, w in node.Windows:iter() do assert(w.DockNode == node or w.DockNode == nil, "window->node link") end
+        if node:IsSplitNode() then assert(node.ChildNodes[1] ~= nil and node.Windows.Size == 0, "split node has two children and no windows") end
+    end
+    for _, n in ipairs(names) do
+        local w = ImGui.FindWindowByName(n)
+        if w and w.DockNode then assert(w.DockNode.Windows:find_index(w) ~= nil, "node contains window") end
+    end
+end
+RunService.Stepped:Connect(function()
+    frame += 1
+    G.ImGui_ImplRoblox.NewFrame()
+    -- scripted drag
+    local x, y, down = (drag and drag.x or 5), (drag and drag.y or 5), false
+    if not drag and frame % 45 == 0 then
+        local w = ImGui.FindWindowByName(names[rnd(#names) + 1])
+        if w and w.Active then
+            local sx, sy
+            if w.DockNode and w.DockNode.TabBar and w.DockNode.TabBar.Tabs.Size > 0 and rnd(2) == 0 then
+                local tb = w.DockNode.TabBar; local t = tb.Tabs.Data[rnd(tb.Tabs.Size) + 1]
+                sx, sy = tb.BarRect.Min.x + t.Offset + 4, tb.BarRect.Min.y + 8
+            else sx, sy = w.Pos.x + 40, w.Pos.y + 8 end
+            local mode = rnd(3)
+            local tx, ty
+            if mode == 0 then local o = ImGui.FindWindowByName(names[rnd(#names) + 1]); tx, ty = o.Pos.x + o.Size.x * (0.1 + rnd(80) / 100), o.Pos.y + o.Size.y * (0.1 + rnd(80) / 100)
+            else tx, ty = 50 + rnd(1800), 50 + rnd(980) end
+            drag = { sx = sx, sy = sy, tx = tx, ty = ty, start = frame, x = sx, y = sy }
+            x, y = sx, sy
+        end
+    end
+    if drag then
+        local f = frame - drag.start
+        local t = math.min(f / 14, 1)
+        drag.x = drag.sx + (drag.tx - drag.sx) * t; drag.y = drag.sy + (drag.ty - drag.sy) * t
+        x, y = drag.x, drag.y
+        down = f >= 1 and f <= 24
+        if f > 26 then drag = nil end
+    end
+    io:AddMousePosEvent(x, y)
+    if down ~= last_down then io:AddMouseButtonEvent(0, down); last_down = down end
+    ImGui.NewFrame()
+    ImGui.DockSpaceOverViewport(0, nil, G.ImGuiDockNodeFlags.PassthruCentralNode)
+    for i, n in ipairs(names) do
+        ImGui.SetNextWindowPos(ImVec2(60 + i * 90, 60 + i * 50), G.ImGuiCond.FirstUseEver)
+        ImGui.SetNextWindowSize(ImVec2(260, 180), G.ImGuiCond.FirstUseEver)
+        if ImGui.Begin(n) then ImGui.Text("window " .. n) end
+        ImGui.End()
+    end
+    ImGui.Render()
+    G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
+    if frame % 50 == 0 then check_tree() end
+    if frame % 1000 == 0 then
+        local nodes, docked = 0, 0
+        for _ in pairs(ImGui.GetCurrentContext().DockContext.Nodes) do nodes += 1 end
+        for _, n in ipairs(names) do local w = ImGui.FindWindowByName(n); if w and w.DockNode then docked += 1 end end
+        print("frame", frame, "nodes", nodes, "docked windows", docked)
+        local ini = ImGui.SaveIniSettingsToMemory()
+    end
+end)
@@ -0,0 +1,61 @@
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+local G = require(ReplicatedStorage:WaitForChild("ImGui"))
+local ImGui, ImVec2 = G.ImGui, G.ImVec2
+local function setup()
+    ImGui.CreateContext()
+    local io = ImGui.GetIO()
+    io.ConfigFlags = bit32.bor(io.ConfigFlags, G.ImGuiConfigFlags.DockingEnable)
+    G.ImGui_ImplRoblox.Init()
+end
+setup()
+local frame, phase, ini, base = 0, 1, nil, 0
+local function windows()
+    for _, n in ipairs({"A", "B", "C"}) do
+        if ImGui.Begin(n) then ImGui.Text("window " .. n) end
+        ImGui.End()
+    end
+end
+RunService.Stepped:Connect(function()
+    frame += 1
+    G.ImGui_ImplRoblox.NewFrame()
+    ImGui.NewFrame()
+    local id = ImGui.DockSpaceOverViewport(0, nil, 0)
+    local f = frame - base
+    if phase == 1 then
+        if f == 2 then
+            ImGui.DockBuilderRemoveNode(id)
+            ImGui.DockBuilderAddNode(id, G.ImGuiDockNodeFlags.DockSpace)
+            ImGui.DockBuilderSetNodeSize(id, ImGui.GetMainViewport().Size)
+            local l, r = ImGui.DockBuilderSplitNode(id, G.ImGuiDir.Left, 0.25)
+            local rt, rb = ImGui.DockBuilderSplitNode(r, G.ImGuiDir.Up, 0.6)
+            ImGui.DockBuilderDockWindow("A", l); ImGui.DockBuilderDockWindow("B", rt); ImGui.DockBuilderDockWindow("C", rb)
+            ImGui.DockBuilderFinish(id)
+        end
+        windows()
+        if f == 20 then
+            ini = ImGui.SaveIniSettingsToMemory()
+            print(ini:match("%[Docking%].*"))
+        end
+    else
+        windows()
+        if f == 20 then
+            local a, b, c = ImGui.FindWindowByName("A"), ImGui.FindWindowByName("B"), ImGui.FindWindowByName("C")
+            print("reloaded nodes", a.DockNode and a.DockNode.ID, b.DockNode and b.DockNode.ID, c.DockNode and c.DockNode.ID, "sizes", a.Size.x, b.Size.x, b.Size.y, c.Size.y)
+            assert(a.DockNode and b.DockNode and c.DockNode, "all docked after reload")
+            assert(a.DockNode ~= b.DockNode and b.DockNode ~= c.DockNode, "3 distinct nodes")
+            local ini2 = ImGui.SaveIniSettingsToMemory()
+            assert(ini2:match("%[Docking%].*") == ini:match("%[Docking%].*"), "docking ini identical after round trip")
+            print("INI ROUNDTRIP OK")
+        end
+    end
+    ImGui.Render()
+    G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
+    if phase == 1 and f == 20 then
+        G.ImGui_ImplRoblox.Shutdown()
+        ImGui.DestroyContext()
+        setup()
+        ImGui.LoadIniSettingsFromMemory(ini)
+        phase, base = 2, frame
+    end
+end)
@@ -0,0 +1,41 @@
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+local G = require(ReplicatedStorage:WaitForChild("ImGui"))
+local ImGui, ImVec2 = G.ImGui, G.ImVec2
+ImGui.CreateContext()
+G.ImGui_ImplRoblox.Init()
+local frame = 0
+local logged = nil
+RunService.Stepped:Connect(function()
+    frame += 1
+    G.ImGui_ImplRoblox.NewFrame()
+    ImGui.NewFrame()
+    ImGui.SetNextWindowPos(ImVec2(20, 20), G.ImGuiCond.Always)
+    ImGui.SetNextWindowSize(ImVec2(400, 300), G.ImGuiCond.Always)
+    ImGui.Begin("Popups")
+    if frame == 3 then ImGui.OpenPopup("Delete?") end
+    if frame == 5 then ImGui.LogToClipboard() end
+    ImGui.Text("Some text to log")
+    if frame == 5 then ImGui.LogFinish(); logged = ImGui.GetClipboardText() end
+    ImGui.BeginChild("child", ImVec2(0, 100), G.ImGuiChildFlags.Borders)
+    for i = 1, 20 do ImGui.Text("child line " .. i) end
+    ImGui.EndChild()
+    if ImGui.BeginPopupContextWindow() then ImGui.Text("ctx"); ImGui.EndPopup() end
+    if ImGui.BeginPopupModal("Delete?", nil, G.ImGuiWindowFlags.AlwaysAutoResize) then
+        ImGui.Text("All those beautiful files will be deleted.\nThis operation cannot be undone!")
+        ImGui.Separator()
+        if ImGui.Button("OK", ImVec2(120, 0)) then ImGui.CloseCurrentPopup() end
+        ImGui.EndPopup()
+    end
+    ImGui.End()
+    ImGui.Render()
+    G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
+    if frame == 6 then
+        print("LOG:", logged)
+        local ini = ImGui.SaveIniSettingsToMemory()
+        print("INI:", ini)
+        ImGui.LoadIniSettingsFromMemory(ini)
+        assert(ImGui.SaveIniSettingsToMemory() == ini, "ini round trip")
+        print("INI round trip ok")
+    end
+end)
@@ -0,0 +1,30 @@
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+local G = require(ReplicatedStorage:WaitForChild("ImGui"))
+local ImGui, ImVec2 = G.ImGui, G.ImVec2
+ImGui.CreateContext()
+G.ImGui_ImplRoblox.Init()
+local opened = {true, true, true, true, true, true, true, true}
+local frame = 0
+RunService.Stepped:Connect(function()
+    frame += 1
+    G.ImGui_ImplRoblox.NewFrame()
+    ImGui.NewFrame()
+    ImGui.SetNextWindowPos(ImVec2(0, 0), G.ImGuiCond.Always)
+    ImGui.SetNextWindowSize(ImVec2(300, 300), G.ImGuiCond.Always)
+    ImGui.Begin("Tabs")
+    local flags = bit32.bor(G.ImGuiTabBarFlags.Reorderable, G.ImGuiTabBarFlags.TabListPopupButton, G.ImGuiTabBarFlags.FittingPolicyScroll, G.ImGuiTabBarFlags.AutoSelectNewTabs)
+    if ImGui.BeginTabBar("bar", flags) then
+        if ImGui.TabItemButton("+", G.ImGuiTabItemFlags.Trailing) then end
+        for i = 1, #opened do
+            local vis
+            vis, opened[i] = ImGui.BeginTabItem("Tab number " .. i, opened[i], (i == 3) and G.ImGuiTabItemFlags.UnsavedDocument or 0)
+            if vis then ImGui.Text("Contents of tab " .. i); ImGui.EndTabItem() end
+        end
+        ImGui.EndTabBar()
+    end
+    if frame == 50 then local tb = ImGui.GetCurrentContext().TabBars:GetByIndex(0); print("tabs", tb.Tabs.Size, "selected", tb.SelectedTabId ~= 0, "scrollbtn", tb.ScrollButtonEnabled) end
+    ImGui.End()
+    ImGui.Render()
+    G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
+end)