Load81 项目技术文档

本文档将详细介绍 Load81 项目的安装、使用及 API 调用方法，帮助用户更好地理解和使用该项目。

1. 安装指南

1.1 环境要求

Load81 项目使用 ANSI C 编写，依赖于 SDL、SDL_gfx 和 SDL_image 库。确保您的系统中已安装以下依赖项：

• ANSI C 编译环境
• SDL
• SDL_gfx
• SDL_image

1.2 编译与安装

将项目源代码下载至本地，使用以下命令编译：

gcc -o load81 main.c -lSDL -lSDL_gfx -lSDL_image

编译成功后，会生成 load81 可执行文件。

2. 项目的使用说明

启动 Load81，运行示例脚本：

./load81 example.lua

在编辑模式和运行模式之间切换，可以按下 ESC 键。

查看 examples 文件夹中的示例代码，以了解如何编写 Load81 程序。

3. 项目 API 使用文档

3.1 绘图函数

以下为 Load81 项目提供的绘图函数：

• fill(r, g, b, alpha): 设置绘图颜色。
• background(r, g, b): 将整个背景涂成指定颜色。
• rect(x, y, width, height): 在坐标 (x, y) 处绘制矩形。
• ellipse(x, y, width, height): 在坐标 (x, y) 处绘制椭圆。
• line(x1, y1, x2, y2): 从坐标 (x1, y1) 到 (x2, y2) 绘制直线。
• text(x, y, string): 在坐标 (x, y) 处输出指定文本。
• triangle(x1, y1, x2, y2, x3, y3): 根据指定的顶点绘制三角形。
• getpixel(x, y): 获取指定像素的颜色值。
• sprite(file, x, y, [rotation], [antialiasing]): 在指定坐标绘制精灵图，可选设置旋转角度和抗锯齿。

3.2 控制函数

• setFPS(fps): 设置帧率。默认值为 30 帧/秒。

3.3 键盘事件

检查按键 'a' 是否被按下：

if keyboard.pressed['a'] then ...

使用 SDL 键盘符号名称。您可以使用以下 Lua 程序轻松找到给定键的名称：

function draw()
    for k, v in pairs(keyboard.pressed) do
        print(k)
    end
end

3.4 低级别键盘事件

通过访问 keyboard.state 和 keyboard.key 字段，可以捕获低级别 SDL 事件。

keyboard.state 可能的值为：

• "down": KEYDOWN 事件
• "up": KEYUP 事件
• "none": 无事件

当 state 值不等于 "none" 时，keyboard.key 会被设置为按下的键。

3.5 鼠标事件

使用 mouse.x 和 mouse.y 获取当前鼠标坐标。检查鼠标按钮是否被按下：

if mouse.pressed['1'] then ...

鼠标按钮命名为 '1', '2', '3', ... 依此类推。

4. 项目安装方式

请参考第 1 节“安装指南”中的编译与安装方法。

---

本文档详细介绍了 Load81 项目的安装、使用及 API 调用方法，希望能为您的项目开发提供帮助。