资源转换管线

从 PNG 图片和 GBA 汇编数据到 WASM 模块中可直接使用的数据——资源转换管线是连接美术资源与运行时数据的关键桥梁。

涵盖内容

模块	说明
资源概念	INCGFX / INCBIN 宏处理、数据转换流程
练习	分析资源转换脚本、自定义资源处理
代码走读	逐函数解读 generate_wasm_assets.py 和 wasm_asm_data.py

核心概念

本项目使用两个 Python 脚本处理游戏资源：

1. generate_wasm_assets.py — 扫描 C 源代码中的 INCGFX 和 INCBIN 宏，收集所有需要嵌入的资源文件路径，生成资源清单
2. wasm_asm_data.py — 将 GBA 格式的汇编数据（地图、事件、脚本、战斗数据等）转换为 C 数组或 WASM 可链接的数据块

这两个脚本在编译前运行，确保所有游戏资源以正确的格式嵌入最终的 WASM 模块。

前置知识

知识点	说明
C 预处理器宏	了解 #include、INCBIN 等宏的展开过程
GBA 图形格式	了解 Tile、Palette、VRAM 等基本概念
WASM 编译管线	了解编译和链接过程
GBA 硬件模拟	了解 GBA 内存布局

学习路径

下一步：WASM 内存模型 — 了解转换后的资源数据在 WASM 内存中的布局和访问方式。