Editor - Visualization

-- The visualization window is registered on editor init:
-- editor.registerWindow(toolWindowName, im.ImVec2(500,600))

-- Material debug mode switching:
-- materialDebugSetFlag(renderDebugFlags.FlagsDebugTriangleSize)
-- enableMaterialDebug(true)

-- Legend overlay renders at 80% viewport height, centered:
-- im.SetNextWindowPos(vec2(vp.Size.x * 0.5, vp.Size.y * 0.8), im.Cond_Always, vec2(0.5, 0.5))
-- Gradient bars drawn via TextureDrawPrimitive with jet/grayscale palettes

-- Jet colormap for triangle size / mip visualization:
-- function _jetRGB(t)
--   local r = max(0, min(1, 4*t - 2))
--   local g = max(0, min(1, 2 - abs(4*t - 2)))
--   local b = max(0, min(1, 2 - 4*t))
--   return r, g, b
-- end

-- Visualization type registration:
-- editor.registerVisualizationType({
--   type = editor.varTypes.LuaVar,
--   name = "GFXDevice.renderWireframe",
--   displayName = "Wireframe Mode"
-- })

-- Custom visualization types with setter/getter:
-- editor.registerVisualizationType({
--   type = editor.varTypes.Custom,
--   name = "$AL_LightColorVisualizeVar",
--   displayName = "Advanced Lighting: Light Color Viz",
--   setter = function(on) setConsoleVariable(varName, on and "1" or "0") end,
--   getter = function() return getConsoleVariable(varName) == "1" end
-- })

-- Preferences stored under gizmos.visualization:
-- visTypes (table), visible (table), selectable (table)
-- visualizationDrawDistance (int, default 250, range 50-2000)
-- saveVisualizationSettings (bool, default true)
-- showMaterialDebugLegend (bool, default true)

-- Reset to defaults via preference registry
-- Filter search supports multi-token case-insensitive matching