This commit is contained in:
Robert Jelic
2025-02-09 19:28:51 +01:00
parent 011bad0ed3
commit edb3ee8361
2 changed files with 22 additions and 26 deletions

View File

@@ -1,11 +1,8 @@
project = 'Basalt 2' project = 'Basalt 2'
title = 'Basalt Documentation' title = 'Basalt Documentation'
description = 'A UI Framework for ComputerCraft' description = 'A UI Framework for ComputerCraft'
file = 'src' -- Einzelner String statt Table file = 'src'
dir = 'out' -- Ausgabeverzeichnis dir = 'out'
format = 'markdown' format = 'markdown'
ext = '.md' -- Explizite Dateierweiterung
all = true all = true
not_luadoc = true style = true
style = true
template = true

View File

@@ -55,15 +55,15 @@ function basalt.createFrame()
end end
--- Returns the element manager instance --- Returns the element manager instance
--- @return table ElementManager The element manager -- @return table ElementManager The element manager
--- @usage local manager = basalt.getElementManager() -- @usage local manager = basalt.getElementManager()
function basalt.getElementManager() function basalt.getElementManager()
return elementManager return elementManager
end end
--- Gets or creates the main frame --- Gets or creates the main frame
--- @return BaseFrame table The main frame instance -- @return BaseFrame table The main frame instance
--- @usage local frame = basalt.getMainFrame() -- @usage local frame = basalt.getMainFrame()
function basalt.getMainFrame() function basalt.getMainFrame()
if(mainFrame == nil)then if(mainFrame == nil)then
mainFrame = basalt.createFrame() mainFrame = basalt.createFrame()
@@ -72,32 +72,31 @@ function basalt.getMainFrame()
end end
--- Sets the active frame --- Sets the active frame
--- @param frame table The frame to set as active -- @param frame table The frame to set as active
--- @usage basalt.setActiveFrame(myFrame) -- @usage basalt.setActiveFrame(myFrame)
function basalt.setActiveFrame(frame) function basalt.setActiveFrame(frame)
mainFrame = frame mainFrame = frame
end end
--- Schedules a function to be updated --- Schedules a function to be updated
--- @function scheduleUpdate -- @param func function The function to schedule
--- @param func function The function to schedule -- @return number Id The schedule ID
--- @return number Id The schedule ID -- @usage local id = basalt.scheduleUpdate(myFunction)
--- @usage local id = basalt.scheduleUpdate(myFunction)
function basalt.scheduleUpdate(func) function basalt.scheduleUpdate(func)
table.insert(basalt._schedule, func) table.insert(basalt._schedule, func)
return #basalt._schedule return #basalt._schedule
end end
--- Removes a scheduled update --- Removes a scheduled update
--- @function removeSchedule -- @function removeSchedule
--- @param id number The schedule ID to remove -- @param id number The schedule ID to remove
--- @usage basalt.removeSchedule(scheduleId) -- @usage basalt.removeSchedule(scheduleId)
function basalt.removeSchedule(id) function basalt.removeSchedule(id)
basalt._schedule[id] = nil basalt._schedule[id] = nil
end end
--- Internal event handler --- Internal event handler
--- @local -- @local
local function updateEvent(event, ...) local function updateEvent(event, ...)
if(event=="terminate")then basalt.stop() end if(event=="terminate")then basalt.stop() end
@@ -121,7 +120,7 @@ local function updateEvent(event, ...)
end end
--- Internal render function --- Internal render function
--- @local -- @local
local function renderFrames() local function renderFrames()
if(mainFrame)then if(mainFrame)then
mainFrame:render() mainFrame:render()
@@ -129,7 +128,7 @@ local function renderFrames()
end end
--- Updates all scheduled functions --- Updates all scheduled functions
--- @usage basalt.update() -- @usage basalt.update()
function basalt.update() function basalt.update()
for k,v in pairs(basalt._schedule) do for k,v in pairs(basalt._schedule) do
if type(v)=="function" then if type(v)=="function" then
@@ -139,7 +138,7 @@ function basalt.update()
end end
--- Stops the Basalt runtime --- Stops the Basalt runtime
--- @usage basalt.stop() -- @usage basalt.stop()
function basalt.stop() function basalt.stop()
term.clear() term.clear()
term.setCursorPos(1,1) term.setCursorPos(1,1)
@@ -147,9 +146,9 @@ function basalt.stop()
end end
--- Starts the Basalt runtime --- Starts the Basalt runtime
--- @param isActive boolean Whether to start active (default: true) -- @param isActive boolean Whether to start active (default: true)
--- @usage basalt.run() -- @usage basalt.run()
--- @usage basalt.run(false) -- @usage basalt.run(false)
function basalt.run(isActive) function basalt.run(isActive)
updaterActive = isActive updaterActive = isActive
if(isActive==nil)then updaterActive = true end if(isActive==nil)then updaterActive = true end