Ejoy2D 项目教程

1. 项目目录结构及介绍

Ejoy2D 是一个用于移动游戏的 2D 图形引擎。以下是项目的目录结构及其介绍：

ejoy2d/
├── doc/
│   ├── apicn.md          # API 文档（中文）
│   └── README.md         # 文档说明
├── examples/
│   ├── asset/            # 示例资源文件
│   └── ex01.lua          # 示例脚本
├── ios/
│   └── example/          # iOS 示例项目
├── lib/
│   ├── particle/         # 粒子系统相关代码
│   └── texture/          # 纹理处理相关代码
├── lua/
│   └── ejoy2d/           # Lua 模块代码
├── mac/
│   └── example/          # macOS 示例项目
├── mingw/
│   └── makefile          # MinGW 编译配置
├── msvc/
│   └── make.bat          # MSVC 编译配置
├── posix/
│   └── makefile          # POSIX 系统编译配置
├── .gitignore            # Git 忽略文件配置
├── LICENSE               # 项目许可证
├── Makefile              # 主 Makefile
└── README.md             # 项目说明

目录介绍

• doc/: 包含项目的文档文件，如 API 文档和 README 文件。
• examples/: 包含示例代码和资源文件，用于展示如何使用 Ejoy2D。
• ios/ 和 mac/: 分别包含 iOS 和 macOS 平台的示例项目。
• lib/: 包含引擎的核心库代码，如粒子系统和纹理处理。
• lua/: 包含 Lua 模块代码，用于与 C 代码交互。
• mingw/ 和 msvc/: 分别包含 MinGW 和 MSVC 的编译配置文件。
• posix/: 包含 POSIX 系统的编译配置文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证。
• Makefile: 主 Makefile，用于编译项目。
• README.md: 项目说明文件。

2. 项目的启动文件介绍

Ejoy2D 的启动文件主要是 examples/ex01.lua，这是一个简单的示例脚本，展示了如何使用 Ejoy2D 绘制基本的图形。

启动文件内容

-- examples/ex01.lua
require "ejoy2d"

local function update()
    -- 更新逻辑
end

local function drawframe()
    -- 绘制逻辑
end

local function touch()
    -- 触摸事件处理
end

ejoy2d.start(update, drawframe, touch)

启动流程

1. 加载 Ejoy2D 模块: 使用 require "ejoy2d" 加载 Ejoy2D 模块。
2. 定义更新函数: update 函数用于处理游戏的更新逻辑。
3. 定义绘制函数: drawframe 函数用于处理游戏的绘制逻辑。
4. 定义触摸事件处理函数: touch 函数用于处理触摸事件。
5. 启动 Ejoy2D: 使用 ejoy2d.start 启动 Ejoy2D，传入更新、绘制和触摸事件处理函数。

3. 项目的配置文件介绍

Ejoy2D 的配置文件主要是 Makefile 和 msvc/make.bat，分别用于 POSIX 系统和 Windows 系统的编译配置。

Makefile

Makefile 是用于 POSIX 系统的编译配置文件，定义了编译规则和依赖关系。

# Makefile
CC = gcc
CFLAGS = -Wall -O2
LDFLAGS = -lglew -llua5.2

all: ej2d

ej2d: main.o
    $(CC) $(CFLAGS) -o ej2d main.o $(LDFLAGS)

main.o: main.c
    $(CC) $(CFLAGS) -c main.c

clean:
    rm -f ej2d main.o

MSVC 编译配置

msvc/make.bat 是用于 MSVC 的编译配置文件，定义了 Windows 系统下的编译规则。

:: msvc/make.bat
cl /EHsc /O2 main.c /link /out:ej2d.exe glew.lib lua52.lib

配置说明

• 编译器: 使用 gcc 或 cl 作为编译器。
• 编译选项: 使用 -Wall -O2 或 /EHsc /O2 作为编译选项，启用警告和优化。
• 链接库: 链接 glew 和 lua5.2 库。
• 目标文件: 生成 ej2d 可执行文件。

通过这些配置文件，开发者可以在不同的平台上编译和运行 Ejoy2D 项目。