CatUI 开源项目教程

祝舟连

于 2024-09-03 10:01:15 发布

阅读量267

点赞数 4

本文链接：https://blog.csdn.net/gitblog_01011/article/details/141852999

版权

CatUI 开源项目教程

catuiA very light-weight GUI library for the Löve2D项目地址:https://gitcode.com/gh_mirrors/ca/catui

1. 项目的目录结构及介绍

CatUI 是一个轻量级的 GUI 库，适用于 Löve2D 游戏引擎。以下是项目的目录结构及其介绍：

catui/
├── control/         # 控件文件夹
├── doc/             # 文档文件夹
├── font/            # 字体文件夹
├── img/             # 图片文件夹
├── LICENSE          # 许可证文件
├── README.md        # 项目说明文件
├── catui-scm-1.rockspec  # LuaRocks 配置文件
├── conf.lua         # 项目配置文件
├── config.ld        # 配置文件
├── main.lua         # 主启动文件

目录结构介绍

control/: 包含自定义控件的文件夹。
doc/: 包含项目文档的文件夹。
font/: 包含字体文件的文件夹。
img/: 包含图片文件的文件夹。
LICENSE: 项目的许可证文件。
README.md: 项目的说明文件。
catui-scm-1.rockspec: LuaRocks 配置文件，用于包管理。
conf.lua: 项目的配置文件。
config.ld: 另一个配置文件。
main.lua: 项目的主启动文件。

2. 项目的启动文件介绍

项目的主启动文件是 main.lua。以下是 main.lua 的基本结构和功能介绍：

-- 引入 CatUI 库
require "catui"

-- 创建一个新的 UI 控件
local myBtn = UIControl:new()
myBtn:setPos(100, 100)
myBtn:setSize(100, 40)

-- 设置绘制事件
myBtn.events:on(UI_DRAW, function()
    local box = ...
    -- 绘制逻辑
end)

-- 主循环
function love.draw()
    myBtn:draw()
end

启动文件介绍

require "catui": 引入 CatUI 库。
UIControl:new(): 创建一个新的 UI 控件。
setPos(x, y): 设置控件的位置。
setSize(width, height): 设置控件的大小。
events:on(UI_DRAW, function() ...): 设置绘制事件的处理函数。
love.draw(): Löve2D 的主绘制循环，调用控件的绘制方法。

3. 项目的配置文件介绍

项目的配置文件包括 conf.lua 和 config.ld。以下是这两个配置文件的基本结构和功能介绍：

conf.lua

function love.conf(t)
    t.window.title = "CatUI Example"  -- 设置窗口标题
    t.window.width = 800             -- 设置窗口宽度
    t.window.height = 600            -- 设置窗口高度
    t.window.vsync = true            -- 启用垂直同步
end

config.ld

return {
    version = "1.0",                 -- 版本号
    author = "wilhantian",           -- 作者
    description = "A lightweight GUI library for Löve2D",  -- 描述
}