1个不稳定版本
0.1.0 | 2022年1月8日 |
---|
#2078 in 游戏开发
在 wasm4fun 中使用
23KB
164 行
Wasm4fun
Rust库,用于WASM-4幻想控制台
主页: https://wasm4fun.neocities.org/
仓库: https://gitlab.com/claudiomattera/wasm4fun/
此仓库包含一系列库/crates,用于在Rust语言中为WASM-4幻想控制台开发游戏。
WASM-4幻想控制台的硬件如下:
-
显示:使用可自定义的4色调色板的160×160屏幕。
这意味着在任何时候屏幕上只能有4种不同的颜色,但游戏可以在任何时候切换到另一组颜色。
-
内存:64 KiB。
-
卡带大小:64 KiB。
整个游戏不能超过卡带大小。这限制了游戏资源(如图形精灵)的数量和复杂性,以及游戏逻辑的复杂性(复杂的实现导致二进制文件更大)。
-
磁盘存储:1 KiB。
游戏可以读写最多1 KiB的数据,例如保存进度或高分。
WASM-4引擎公开了一组小型原语和内存映射,并期望游戏公开两个回调函数。这种方法可以轻松支持多种编程语言,但缺点是编程接口相对底层且简单。这些库的目的是封装WASM-4原语,并公开一个更丰富、更符合习惯和更安全的API。
架构
此库分为几个独立的crate,每个crate实现特定的功能。例如,wasm4fun-input
实现用于读取控制台输入的函数和数据类型,无论是鼠标还是游戏手柄,而wasm4fun-storage
实现用于从存储系统保存或加载数据的函数。
一些crate依赖于其他crate。例如,导出裸WASM-4接口的wasm4fun-core
在大多数crate中使用,以及导出debug!()
宏将格式化文本写入输出控制台的wasm4fun-log
。
顶级wasm4fun
crate重新导出所有子crate,但可以忽略它并显式依赖于某些子crate,以便精简依赖树。
设计选择
这些库不使用任何动态分配,因此也不使用Rust标准库的任何部分。从技术角度来说,它们不使用std::
模块中的任何内容,而只使用core::
。
动态分配使开发变得容易,但在WASM-4上有一个主要缺点:它导致游戏盒尺寸显著增大,因为游戏盒必须包含分配器本身。由于64 KiB的游戏盒尺寸限制,这可能会迫使使用较小的游戏资源,如精灵,或者避免一些复杂的库。
另一方面,尽管动态分配在其它环境中带来了许多优势,但在WASM-4上的Rust中并不那么必要。许多crate都存在,用于在堆栈上实现数据结构和算法。例如,tinyvec crate提供了由堆栈中的数组支持的“动态”向量。
最后,避免动态分配与WASM-4的总体极简主义哲学相吻合。
其理念是通过去除多余的部分并专注于本质,可以更容易地开始和完成游戏开发。
文档和示例
文档可在https://docs.rs/wasm4fun/上找到。
在目录examples
中提供了几个示例。它们可以通过命令cargo make run-example EXAMPLE_NAME
运行(WASM-4的可执行文件w4
必须在路径中)。
许可证
版权所有 Claudio Mattera 2022
您可以在署名下自由复制、修改和分发此应用程序,条件是遵守以下任一条款:
- Apache License,版本2.0(
LICENSE-Apache-2.0.txt
或https://open-source.org.cn/licenses/Apache-2.0) - MIT许可证(
LICENSE-MIT.txt
或https://open-source.org.cn/licenses/MIT)
任选其一。