---@meta

--- 基础函数
---@param str string 日志内容
function log(str)
end

--- 删除图像
---@param img Image 图像指针
function delete(img)
end

--- 转换为字符串
---@param pos Position2 位置
---@return string 字符串表示
function to_string(pos)
end

--- 字符串操作
String = {}

--- 移除路径
---@param str string 路径字符串
---@return string 移除路径后的字符串
function String.ErasePath(str)
end

--- 获取文件名（不含扩展名）
---@param str string 路径字符串
---@return string 文件名
function String.GetFileStem(str)
end

--- 转换为Position2
---@param str string 字符串
---@return Position2 位置
function String.toPosition2(str)
end

--- 替换扩展名
---@param str string 路径字符串
---@param ext string 新扩展名
---@return string 替换后的字符串
function String.ReplaceExtension(str, ext)
end

--- 移除文件名
---@param str string 路径字符串
---@return string 移除文件名后的路径
function String.EraseFilename(str)
end

--- 图像处理
Img = {}

--- 支持的格式正则
Img.REGEX_FORMAT = "".(jpg|jpeg|png|tag|bmp|gif|hdr|pic)$""

--- 调整图像大小
---@overload fun(img: Image, scale: number): Image
---@overload fun(img: Image, size: Size): Image
---@param img Image 图像
---@param scale number 缩放比例
---@return Image 调整后的图像
function Img.Resize(img, scale)
end

--- 设置透明色为0
---@overload fun(img: Image)
---@overload fun(img: Image, a: number, col_new: number)
---@param img Image 图像
function Img.SetAlphaZero(img)
end

--- 创建图像
---@overload fun(path: string): Image
---@overload fun(size: Size, col: Color): Image
---@param path string 图像路径
---@return Image 图像
function Img.Create(path)
end

--- 保存图像
---@param img Image 图像
---@param path string 保存路径
---@return boolean 是否成功
function Img.Save(img, path)
end

--- 图像类
---@class Image
Image = {}

--- 窗口参数
---@class ParamWindow
---@field title string 窗口标题
ParamWindow = {}

--- 系统类
---@class System
System = {}

--- 设置运行函数
---@param func function 运行函数
function System:SetFuncRun(func)
end

--- 启动系统
---@param param ParamWindow 窗口参数
function System:Start(param)
end

--- 全局系统实例
g_system = nil --[[@type System]]

--- 文件操作
g_file = {}

--- 复制模式
g_file.CopyMode = {
    NONE = 0,
    OVERRIDE = 1,
    SKIP = 2
}

--- 获取路径下所有文件
---@overload fun(path: string, include: table, recursive: boolean): table
---@overload fun(path: string, include: table): table
---@overload fun(path: string): table
---@param path string 路径
---@return table 文件列表
function g_file.GetPathFileAll(path)
end

--- 获取绝对路径
---@param path string 路径
---@return string 绝对路径
function g_file.GetAbsolute(path)
end

--- 获取相对路径
---@param path string 路径
---@return string 相对路径
function g_file.GetRelative(path)
end

--- 创建文件夹
---@param path string 路径
---@return boolean 是否成功
function g_file.CreateFolder(path)
end

--- 删除内容
---@param path string 路径
---@return boolean 是否成功
function g_file.DeleteContent(path)
end

--- 重命名
---@param old_path string 旧路径
---@param new_path string 新路径
---@return boolean 是否成功
function g_file.Rename(old_path, new_path)
end

--- 复制
---@param src string 源路径
---@param dst string 目标路径
---@param mode number 复制模式
---@return boolean 是否成功
function g_file.Copy(src, dst, mode)
end

--- 获取文件路径
---@param path string 路径
---@return string 文件路径
function g_file.GetFilePath(path)
end

--- 获取文件名
---@param path string 路径
---@return string 文件名
function g_file.GetFileName(path)
end

--- 读取文件内容
---@param path string 路径
---@return string 文件内容
function g_file.GetString(path)
end

--- 保存字符串到文件
---@param path string 路径
---@param str string 内容
---@return boolean 是否成功
function g_file.SaveString(path, str)
end

--- 图形类
---@class Graphics
Graphics = {}

--- 绘制2D矩形
---@param p0 Position2 左上角坐标
---@param p1 Position2 右下角坐标
function Graphics:Rectangle2D(p0, p1)
end

--- 全局图形实例
g_gfx = nil --[[@type Graphics]]

--- UI面板
---@class UIPanel
UIPanel = {}

--- 添加文本
---@param text UIText 文本
function UIPanel:Add(text)
end

--- UI文本
---@class UIText
UIText = {}

--- 设置字符串
---@param str string 字符串
function UIText:SetString(str)
end

--- 设置语言
---@param lang string 语言
function UIText:SetLang(lang)
end

--- UI管理器
---@class UIManager
UIManager = {}

--- 创建面板
---@return UIPanel 面板
function UIManager:CreatePanel()
end

--- 创建文本
---@return UIText 文本
function UIManager:CreateText()
end

--- 创建默认文本
---@return UIText 文本
function UIManager:CreateTextDefault()
end

--- 全局UI管理器实例
g_ui = nil --[[@type UIManager]]

--- 执行系统命令
---@param cmd string 命令
---@return number 退出码
function system(cmd)
end

--- 辅助类型定义

---@class Position2
---@field x number X坐标
---@field y number Y坐标

---@class Size
---@field w number 宽度
---@field h number 高度

---@class Color
---@field r number 红色通道 (0-1)
---@field g number 绿色通道 (0-1)
---@field b number 蓝色通道 (0-1)
---@field a number 透明度 (0-1)