Widget Functions

local widgetId = createWidget(config)

local mapWidget = createWidget({
  type = "canvas",
  title = "Map Widget",
  x = 100,
  y = 100,
  width = 400,
  height = 300
})
 
-- Widget is automatically active after creation
-- Draw in init() when canvas is ready
function init()
  drawRect(0, 0, 400, 300, "#1a1a1a")
  drawText("Map View", 10, 20, "#ffffff")
end

destroyWidget(widgetId)

-- Manually destroy a widget (rarely needed - cleanup is automatic)
destroyWidget(mapWidget)

showWidget(widgetId)

-- Toggle widget visibility
showWidget(statsWidget)

hideWidget(widgetId)

-- Hide widget when not needed
hideWidget(statsWidget)

moveWidget(widgetId, x, y)

-- Move widget to top-left corner
moveWidget(statsWidget, 10, 10)

resizeWidget(widgetId, width, height)

-- Make widget larger
resizeWidget(mapWidget, 600, 400)

setWidgetZOrder(widgetId, zIndex)

-- Bring widget to front
setWidgetZOrder(popupWidget, 2000)
 
-- Send widget to back
setWidgetZOrder(backgroundWidget, 500)

local value = getWidgetProperty(widgetId, property)

local visible = getWidgetProperty(statsWidget, "visible")
local width = getWidgetProperty(statsWidget, "width")

setWidgetProperty(widgetId, property, value)

setWidgetProperty(statsWidget, "title", "Player Stats")
setWidgetProperty(statsWidget, "visible", true)

local value = widgetInfo(widgetId, infoType)

-- Get current dimensions
local width = widgetInfo(mapWidget, 3)
local height = widgetInfo(mapWidget, 4)
 
-- Check visibility
local isVisible = widgetInfo(mapWidget, 7)
 
-- Get mouse position within widget
local mouseX = widgetInfo(mapWidget, 11)
local mouseY = widgetInfo(mapWidget, 12)
 
-- Check if widget has been resized from original
local origWidth = widgetInfo(mapWidget, 5)
local currWidth = widgetInfo(mapWidget, 3)
if currWidth ~= origWidth then
  print("Widget has been resized")
end

setActiveWidget(widgetId)
-- or
setActiveWidget(widgetInstance)

-- First widget is automatically active after creation
local widget1 = createWidget({ type = "canvas", x = 10, y = 10, width = 200, height = 200 })
drawRect(0, 0, 200, 200, "#ff0000")  -- Draws on widget1
 
-- Create second widget (now widget2 is active)
local widget2 = createWidget({ type = "canvas", x = 220, y = 10, width = 200, height = 200 })
drawRect(0, 0, 200, 200, "#00ff00")  -- Draws on widget2
 
-- Switch back to widget1
setActiveWidget(widget1)
drawCircle(100, 100, 50, "#0000ff")  -- Draws on widget1

local widget = getActiveWidget()

registerWidgetEvent(widgetId, eventType, callback)

-- Handle mouse clicks
registerWidgetEvent(mapWidget, "click", function(data)
  print("Clicked at: " .. data.x .. ", " .. data.y)
  print("Button: " .. data.button) -- 1=left, 2=middle, 3=right
 
  -- Draw a marker at click position
  drawCircle(data.x, data.y, 5, "#ff0000")
end)
 
-- Handle mouse movement
registerWidgetEvent(mapWidget, "mousemove", function(data)
  -- data.x and data.y are relative to the widget
  updateCrosshair(data.x, data.y)
end)
 
-- Handle resize
registerWidgetEvent(mapWidget, "resize", function(data)
  print("New size: " .. data.width .. "x" .. data.height)
  redrawMap()
end)
 
-- Handle keyboard
registerWidgetEvent(mapWidget, "keydown", function(data)
  if data.key == "ArrowUp" then
    scrollMap(0, -10)
  elseif data.key == "ArrowDown" then
    scrollMap(0, 10)
  end
end)

unregisterWidgetEvent(widgetId, eventType, callback?)

-- Remove specific callback
unregisterWidgetEvent(mapWidget, "click", myClickHandler)
 
-- Remove all click handlers
unregisterWidgetEvent(mapWidget, "click")

textWidgetAddLine(widgetId, text, color?)

local logWidget = createWidget({
  type = "enhanced-text",
  title = "Combat Log",
  x = 10, y = 10,
  width = 300, height = 200
})
 
textWidgetAddLine(logWidget, "Combat started!", "#ff0000")
textWidgetAddLine(logWidget, "You hit the goblin for 15 damage.", "#00ff00")
textWidgetAddLine(logWidget, "The goblin misses you.", "#cccccc")

textWidgetAddButton(widgetId, buttonId, text, callback)

textWidgetAddButton(logWidget, "clear_btn", "Clear Log", function()
  textWidgetClear(logWidget)
end)
 
textWidgetAddButton(logWidget, "attack_btn", "Attack!", function()
  send("attack goblin")
end)

textWidgetClear(widgetId)

textWidgetClear(logWidget)

textWidgetSetSelectable(widgetId, selectable)

-- Allow users to copy text from the widget
textWidgetSetSelectable(logWidget, true)

textWidgetSetTransparent(widgetId, transparent)

-- Make widget overlay without blocking view
textWidgetSetTransparent(logWidget, true)

-- Multi-widget example
print("Loading...")
 
-- Create map canvas
local mapWidget = createWidget({
  type = "canvas",
  title = "World Map",
  x = 100,
  y = 100,
  width = 400,
  height = 300
})
 
-- Create stats text widget
local statsWidget = createWidget({
  type = "enhanced-text",
  title = "Character Stats",
  x = 510,
  y = 100,
  width = 200,
  height = 300
})
 
-- Map drawing function
local function drawMap()
  setActiveWidget(mapWidget)  -- Required: multiple widgets exist
  clear("#0a0a1a")
  drawText("World Map", 10, 20, "#ffffff")
end
 
-- Stats update function
local function updateStats()
  textWidgetClear(statsWidget)
  textWidgetAddLine(statsWidget, "=== Character ===", "#ffff00")
  textWidgetAddLine(statsWidget, "HP: 100/100", "#00ff00")
  textWidgetAddLine(statsWidget, "MP: 50/50", "#0066ff")
end
 
-- Handle map clicks
registerWidgetEvent(mapWidget, "click", function(data)
  setActiveWidget(mapWidget)
  drawCircle(data.x, data.y, 3, "#ffff00")
end)
 
-- Handle map resize
registerWidgetEvent(mapWidget, "resize", function(data)
  drawMap()
end)
 
-- Initial draw
function init()
  drawMap()
  updateStats()
end
 
print("Loaded!")