Port debug tools (item picker, flash style color, debug locate, DebugDraw*, keyboard preview, debug break, DrawCmd mesh view), context hooks, SetContextName, AddInputCharactersUTF8, sanity checks, window resize ids, Register/UnregisterUserTexture, SetPixelDensity, TestShortcutRouting, DemoMarker; InputTextState selection API (fixes undo crash, callbacks get 0-based positions), ShortcutsForCancel (Esc/right-click reverts drags/sliders), ImParseFormatSanitizeForPrinting, ImDrawList CloneOutput/PrimQuadUV/AddImageQuad, ImDrawData DeIndexAllBuffers/ScaleClipRects, internal helpers (ImBitVector, ImGuiPackedDate, inline ImGui getters...); t_debugtools, t_helpers
This commit is contained in:
4DBug
@@ -0,0 +1,79 @@
|
||||
-- Debug tools + misc imgui.cpp ports: item picker, DebugFlashStyleColor, DebugLocateItem, context hooks, AddInputCharactersUTF8, ImBezierCubicClosestPoint
|
||||
local G = require(game:GetService("ReplicatedStorage"):WaitForChild("ImGui"))
|
||||
local ImGui, ImVec2 = G.ImGui, G.ImVec2
|
||||
local ctx = ImGui.CreateContext(); G.ImGui_ImplRoblox.Init()
|
||||
local io = ImGui.GetIO()
|
||||
local failed = {}
|
||||
local function check(ok, msg) if not ok then table.insert(failed, msg); print("FAIL " .. msg) end end
|
||||
|
||||
-- ImBezierCubicClosestPoint: straight-line cubic (0,0)-(30,0)-(60,0)-(90,0): closest point to (45,10) is (45,0)
|
||||
local p1, p2, p3, p4 = ImVec2(0, 0), ImVec2(30, 0), ImVec2(60, 0), ImVec2(90, 0)
|
||||
local cp = G.ImBezierCubicClosestPoint(p1, p2, p3, p4, ImVec2(45, 10), 20)
|
||||
check(math.abs(cp.x - 45) < 1e-3 and math.abs(cp.y) < 1e-6, ("ImBezierCubicClosestPoint %g,%g"):format(cp.x, cp.y))
|
||||
-- Curved: result must lie on the curve (distance to a dense sampling of the curve ~0) and beat the endpoints
|
||||
local q1, q2, q3, q4 = ImVec2(0, 0), ImVec2(0, 100), ImVec2(100, 100), ImVec2(100, 0)
|
||||
local target = ImVec2(50, 120)
|
||||
for _, r in { G.ImBezierCubicClosestPoint(q1, q2, q3, q4, target, 64), G.ImBezierCubicClosestPointCasteljau(q1, q2, q3, q4, target, 0.25) } do
|
||||
check(math.abs(r.x - 50) < 0.5 and math.abs(r.y - 75) < 0.5, ("closest point on curve %g,%g (expected ~50,75)"):format(r.x, r.y))
|
||||
end
|
||||
|
||||
-- AddInputCharactersUTF8 queues one Text event per codepoint
|
||||
io:AddInputCharactersUTF8("a\u{e9}\u{20ac}\u{1F600}")
|
||||
local chars = {}
|
||||
for _, e in ctx.InputEventsQueue.Data do if e.Type == G.ImGuiInputEventType.Text then table.insert(chars, e.Text.Char) end end
|
||||
-- (this build has IM_UNICODE_CODEPOINT_MAX = 0xFFFF like upstream's default ImWchar16: U+1F600 becomes IM_UNICODE_CODEPOINT_INVALID)
|
||||
check(#chars == 4 and chars[1] == 0x61 and chars[2] == 0xE9 and chars[3] == 0x20AC and chars[4] == ((G.IM_UNICODE_CODEPOINT_MAX >= 0x1F600) and 0x1F600 or 0xFFFD), "AddInputCharactersUTF8 " .. table.concat(chars, ","))
|
||||
|
||||
-- Context hooks
|
||||
local log = {}
|
||||
local function hook(t, name)
|
||||
local h = G.ImGuiContextHook(); h.Type = t; h.Callback = function(c, hk) table.insert(log, name) end
|
||||
return ImGui.AddContextHook(ctx, h)
|
||||
end
|
||||
local T = G.ImGuiContextHookType
|
||||
hook(T.NewFramePre, "nfpre"); hook(T.NewFramePost, "nfpost"); hook(T.RenderPre, "rpre"); local rpost = hook(T.RenderPost, "rpost")
|
||||
|
||||
-- Style color flash
|
||||
local col = ImGui.GetStyle().Colors[G.ImGuiCol.Button]
|
||||
local orig = { col.x, col.y, col.z, col.w }
|
||||
|
||||
local f, rect, picked, broke, button_id = 0, nil, nil, 0, 0
|
||||
ctx.DebugBreakCallback = function() broke += 1 end
|
||||
game:GetService("RunService").Stepped:Connect(function()
|
||||
f += 1
|
||||
G.ImGui_ImplRoblox.NewFrame()
|
||||
if rect and f == 5 then io:AddMousePosEvent((rect[1].x + rect[2].x) / 2, (rect[1].y + rect[2].y) / 2) end
|
||||
if f == 6 then ImGui.DebugStartItemPicker() end
|
||||
if f == 8 then io:AddMouseButtonEvent(0, true) elseif f == 9 then io:AddMouseButtonEvent(0, false) end
|
||||
ImGui.NewFrame()
|
||||
if f == 1 then check(table.concat(log, " ") == "nfpre nfpost", "hooks after NewFrame: " .. table.concat(log, " ")) end
|
||||
if f == 8 then picked = ctx.DebugItemPickerBreakId end
|
||||
if f == 3 then ImGui.DebugFlashStyleColor(G.ImGuiCol.Button) end
|
||||
ImGui.SetNextWindowPos(ImVec2(10, 10), G.ImGuiCond.Always)
|
||||
ImGui.Begin("DebugTools")
|
||||
ImGui.Button("Target")
|
||||
if f == 2 then local a, b = ImGui.GetItemRectMin(), ImGui.GetItemRectMax(); rect = { ImVec2(a.x, a.y), ImVec2(b.x, b.y) } end
|
||||
local target_id = ctx.LastItemData.ID
|
||||
button_id = target_id
|
||||
if f == 12 then ImGui.DebugLocateItem(target_id) end
|
||||
if f == 13 then check(ctx.DebugLocateId == 0, "DebugLocateItem resolved by ItemAdd()") end
|
||||
ImGui.DebugDrawItemRect(); ImGui.DebugDrawCursorPos(); ImGui.DebugDrawLineExtents()
|
||||
ImGui.DebugTextUnformattedWithLocateItem(("id 0x%08X here"):format(target_id))
|
||||
ImGui.End()
|
||||
ImGui.SetNextWindowPos(ImVec2(400, 10), G.ImGuiCond.Always); ImGui.ShowMetricsWindow()
|
||||
ImGui.SetNextWindowPos(ImVec2(400, 300), G.ImGuiCond.Always); ImGui.ShowDebugLogWindow()
|
||||
if f == 4 then
|
||||
local c = ImGui.GetStyle().Colors[G.ImGuiCol.Button]
|
||||
check(c.w == 1.0 and ctx.DebugFlashStyleColorIdx == G.ImGuiCol.Button, "flash active")
|
||||
end
|
||||
ImGui.Render(); G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
|
||||
if f == 1 then check(table.concat(log, " ") == "nfpre nfpost rpre rpost", "hooks after Render: " .. table.concat(log, " ")); ImGui.RemoveContextHook(ctx, rpost) end
|
||||
if f == 2 then check(table.concat(log, " ") == "nfpre nfpost rpre rpost nfpre nfpost rpre", "RemoveContextHook: " .. table.concat(log, " ")) end
|
||||
if f == 60 then
|
||||
local c = ImGui.GetStyle().Colors[G.ImGuiCol.Button]
|
||||
check(c.x == orig[1] and c.y == orig[2] and c.z == orig[3] and c.w == orig[4] and ctx.DebugFlashStyleColorIdx == nil, "flash restored color exactly")
|
||||
check(picked ~= nil and picked ~= 0 and picked == button_id, ("item picker set DebugItemPickerBreakId (%s vs %s)"):format(tostring(picked), tostring(button_id)))
|
||||
check(not ctx.DebugItemPickerActive and broke >= 1, ("item picker break hook called (%d)"):format(broke))
|
||||
if #failed == 0 then print("DEBUGTOOLS OK") end
|
||||
end
|
||||
end)
|
||||
@@ -0,0 +1,142 @@
|
||||
-- Small upstream helpers: ImGuiInputTextState selection API + ReloadUserBuf*, ImGuiInputTextCallbackData:SetSelection, ImDrawList AddImageQuad/PrimQuadUV/
|
||||
-- CloneOutput, ImDrawData DeIndexAllBuffers/ScaleClipRects, ImBitVector/ImBitArray*, ImGuiPackedDate, ImParseFormatSanitizeForPrinting, drag cancel (ShortcutsForCancel)
|
||||
local G = require(game:GetService("ReplicatedStorage"):WaitForChild("ImGui"))
|
||||
local ImGui, ImVec2 = G.ImGui, G.ImVec2
|
||||
ImGui.CreateContext(); G.ImGui_ImplRoblox.Init()
|
||||
local io = ImGui.GetIO()
|
||||
local failed = {}
|
||||
local function check(ok, msg) if not ok then table.insert(failed, msg); print("FAIL " .. msg) end end
|
||||
|
||||
-- Pure helpers
|
||||
check(G.ImParseFormatSanitizeForPrinting("%.3f%%", nil, 32) == "%.3f", "sanitize %.3f%%")
|
||||
check(G.ImParseFormatSanitizeForPrinting("%'_5.2f units", nil, 32) == "%5.2f", "sanitize stb flags: " .. G.ImParseFormatSanitizeForPrinting("%'_5.2f units", nil, 32))
|
||||
local d = G.ImGuiPackedDate(20260315)
|
||||
check(d:IsValid() and d:Unpack() == 20260315, "PackedDate round trip " .. d:Unpack())
|
||||
d:SubtractMonths(3)
|
||||
check(d:Unpack() == 20251215, "PackedDate SubtractMonths " .. d:Unpack())
|
||||
check(not G.ImGuiPackedDate():IsValid() and G.ImGuiPackedDate():Unpack() == 0, "PackedDate empty")
|
||||
local bv = G.ImBitVector()
|
||||
bv:Create(70)
|
||||
check(bv.Storage.Size == 3, "ImBitVector size")
|
||||
bv:SetBit(1); bv:SetBit(70); bv:SetBit(33)
|
||||
check(bv:TestBit(1) and bv:TestBit(70) and bv:TestBit(33) and not bv:TestBit(2) and not bv:TestBit(69), "ImBitVector SetBit/TestBit")
|
||||
bv:ClearBit(33)
|
||||
check(not bv:TestBit(33) and bv:TestBit(70), "ImBitVector ClearBit")
|
||||
local arr = {}
|
||||
G.ImBitArrayClearAllBits(arr, 96)
|
||||
G.ImBitArraySetBitRange(arr, 3, 70) -- [3..70)
|
||||
local ok_range = true
|
||||
for n = 1, 96 do if G.ImBitArrayTestBit(arr, n) ~= (n >= 3 and n < 70) then ok_range = false end end
|
||||
check(ok_range, "ImBitArraySetBitRange")
|
||||
check(G.ImBitArrayGetStorageSizeInBytes(70) == 12, "ImBitArrayGetStorageSizeInBytes")
|
||||
check(G.ImModPositive(-1, 5) == 4 and G.ImRoundSigned64(-1.5) == -2 and G.ImCharIsXdigitA(string.byte("F")), "math helpers")
|
||||
|
||||
local buf = ImGui.NewTextBuffer("hello world", 64)
|
||||
local cbuf = ImGui.NewTextBuffer("abcdef", 64)
|
||||
local cb_calls = 0
|
||||
local function cb(data)
|
||||
cb_calls += 1
|
||||
if cb_calls == 1 then data:SetSelection(1, 3) end
|
||||
return 0
|
||||
end
|
||||
local df, rect_df = 10.0, nil
|
||||
local f = 0
|
||||
local function center(r) return (r[1].x + r[2].x) / 2, (r[1].y + r[2].y) / 2 end
|
||||
|
||||
local function vtx(dl, i) -- 1-based vertex
|
||||
local b, o = dl.VtxBuffer.Buf, (i - 1) * G.VTX_STRIDE
|
||||
return buffer.readf64(b, o), buffer.readf64(b, o + 8), buffer.readf64(b, o + 16), buffer.readf64(b, o + 24), buffer.readu32(b, o + 32)
|
||||
end
|
||||
|
||||
game:GetService("RunService").Stepped:Connect(function()
|
||||
f += 1
|
||||
G.ImGui_ImplRoblox.NewFrame()
|
||||
-- drag + Escape cancels and reverts (ShortcutsForCancel)
|
||||
if f == 20 then io:AddMousePosEvent(center(rect_df)) end
|
||||
if f == 21 then io:AddMouseButtonEvent(0, true) end
|
||||
if f == 22 then local x, y = center(rect_df); io:AddMousePosEvent(x + 40, y) end
|
||||
if f == 24 then io:AddKeyEvent(G.ImGuiKey.Escape, true) end
|
||||
if f == 25 then io:AddKeyEvent(G.ImGuiKey.Escape, false) end
|
||||
if f == 26 then io:AddMouseButtonEvent(0, false) end
|
||||
ImGui.NewFrame()
|
||||
ImGui.SetNextWindowPos(ImVec2(10, 10)); ImGui.SetNextWindowSize(ImVec2(400, 300))
|
||||
ImGui.Begin("H")
|
||||
if f == 2 then ImGui.SetKeyboardFocusHere() end
|
||||
ImGui.InputText("##t", buf, 64)
|
||||
local id = ImGui.GetItemID()
|
||||
local st = ImGui.GetInputTextState(id)
|
||||
if f == 5 then
|
||||
check(st ~= nil, "InputText active")
|
||||
if st then
|
||||
st:SetSelection(3, 6)
|
||||
check(st:GetSelectionStart() == 3 and st:GetSelectionEnd() == 6 and st:GetCursorPos() == 6 and st:HasSelection(), "SetSelection/Get*")
|
||||
st:ClearSelection()
|
||||
check(st:GetSelectionStart() == 6 and st:GetSelectionEnd() == 6 and not st:HasSelection(), "ClearSelection")
|
||||
check(st:GetPreferredOffsetX() == -1, "GetPreferredOffsetX")
|
||||
-- modify the user buffer externally then reload
|
||||
local s = "bye"; for i = 1, #s do buf[i] = string.byte(s, i) end; buf[#s + 1] = 0
|
||||
st:ReloadUserBufAndSelectAll()
|
||||
end
|
||||
end
|
||||
if f == 7 and st then
|
||||
check(G.ImGui._ByteArrayToString(st:GetText(), 1, st.TextLen + 1) == "bye", "ReloadUserBufAndSelectAll text")
|
||||
check(st:GetSelectionStart() == 1 and st:GetSelectionEnd() == 4, ("ReloadUserBufAndSelectAll sel %d..%d"):format(st:GetSelectionStart(), st:GetSelectionEnd()))
|
||||
st:SetSelection(2, 3); st:ReloadUserBufAndKeepSelection()
|
||||
end
|
||||
if f == 9 and st then
|
||||
check(st:GetSelectionStart() == 2 and st:GetSelectionEnd() == 3, "ReloadUserBufAndKeepSelection")
|
||||
st:ReloadUserBufAndMoveToEnd()
|
||||
end
|
||||
if f == 11 and st then
|
||||
check(st:GetCursorPos() == 4 and not st:HasSelection(), "ReloadUserBufAndMoveToEnd " .. st:GetCursorPos())
|
||||
end
|
||||
-- callback SetSelection (0-based callback positions -> 1-based stb)
|
||||
if f == 12 then ImGui.SetKeyboardFocusHere() end
|
||||
ImGui.InputText("##c", cbuf, 64, G.ImGuiInputTextFlags.CallbackAlways, cb)
|
||||
if f == 15 then
|
||||
local cst = ImGui.GetInputTextState(ImGui.GetItemID())
|
||||
check(cst ~= nil and cb_calls > 0 and cst:GetSelectionStart() == 2 and cst:GetSelectionEnd() == 4, "callback SetSelection " .. (cst and (cst:GetSelectionStart() .. ".." .. cst:GetSelectionEnd()) or "nil"))
|
||||
end
|
||||
df = ImGui.DragFloat("##df", df, 1.0)
|
||||
local a, b = ImGui.GetItemRectMin(), ImGui.GetItemRectMax(); rect_df = { ImVec2(a.x, a.y), ImVec2(b.x, b.y) }
|
||||
if f == 23 then check(df ~= 10.0, "drag changed value " .. df) end
|
||||
if f == 25 then check(df == 10.0 and ImGui.GetActiveID() == 0, "Escape reverts drag " .. df) end
|
||||
|
||||
if f == 30 then
|
||||
local dl = ImGui.GetWindowDrawList()
|
||||
local v0, i0 = dl.VtxBuffer.Size, dl.IdxBuffer.Size
|
||||
local tex = G.ImTextureRef(1234)
|
||||
dl:AddImageQuad(tex, ImVec2(10, 10), ImVec2(50, 12), ImVec2(48, 60), ImVec2(8, 58), ImVec2(0, 0), ImVec2(1, 0), ImVec2(1, 1), ImVec2(0, 1), 0xFF00FF00)
|
||||
check(dl.VtxBuffer.Size == v0 + 4 and dl.IdxBuffer.Size == i0 + 6, "AddImageQuad counts")
|
||||
local x, y, u, v, col = vtx(dl, v0 + 3)
|
||||
check(x == 48 and y == 60 and u == 1 and v == 1 and col == 0xFF00FF00, ("PrimQuadUV vertex %s %s %s %s %x"):format(x, y, u, v, col))
|
||||
local idx = dl.IdxBuffer.Data
|
||||
check(idx[i0 + 1] == v0 + 1 and idx[i0 + 5] == v0 + 3 and idx[i0 + 6] == v0 + 4, "PrimQuadUV indices")
|
||||
local cmin, cmax = dl:GetClipRectMin(), dl:GetClipRectMax()
|
||||
check(cmax.x > cmin.x and cmax.y > cmin.y, "GetClipRectMin/Max")
|
||||
|
||||
local clone = dl:CloneOutput()
|
||||
check(clone.VtxBuffer.Size == dl.VtxBuffer.Size and clone.IdxBuffer.Size == dl.IdxBuffer.Size and clone.CmdBuffer.Size == dl.CmdBuffer.Size
|
||||
and clone.VtxBuffer.Buf ~= dl.VtxBuffer.Buf and clone.CmdBuffer.Data[1] ~= dl.CmdBuffer.Data[1], "CloneOutput copies buffers")
|
||||
local cx = vtx(clone, v0 + 3)
|
||||
check(cx == 48, "CloneOutput vertex data")
|
||||
|
||||
local dd = G.ImDrawData()
|
||||
dd.CmdLists:push_back(clone)
|
||||
local n_idx = clone.IdxBuffer.Size
|
||||
local ex, ey = vtx(clone, clone.IdxBuffer.Data[n_idx])
|
||||
dd:DeIndexAllBuffers()
|
||||
check(clone.IdxBuffer.Size == 0 and clone.VtxBuffer.Size == n_idx and dd.TotalVtxCount == n_idx and dd.TotalIdxCount == 0, "DeIndexAllBuffers counts")
|
||||
local lx, ly = vtx(clone, n_idx)
|
||||
check(lx == ex and ly == ey, "DeIndexAllBuffers vertex data")
|
||||
|
||||
local cr = clone.CmdBuffer.Data[1].ClipRect
|
||||
local x1, y1, z1, w1 = cr.x, cr.y, cr.z, cr.w
|
||||
dd:ScaleClipRects(ImVec2(2, 3))
|
||||
local cr2 = clone.CmdBuffer.Data[1].ClipRect
|
||||
check(cr2.x == x1 * 2 and cr2.y == y1 * 3 and cr2.z == z1 * 2 and cr2.w == w1 * 3 and dl.CmdBuffer.Data[1].ClipRect.z == z1, "ScaleClipRects")
|
||||
end
|
||||
ImGui.End()
|
||||
ImGui.Render(); G.ImGui_ImplRoblox.RenderDrawData(ImGui.GetDrawData())
|
||||
if f == 32 and #failed == 0 then print("HELPERS OK") end
|
||||
end)
|
||||
Reference in New Issue
Block a user