Wasm4fun

Rust库，用于WASM-4幻想控制台

主页： https://wasm4fun.neocities.org/

仓库： https://gitlab.com/claudiomattera/wasm4fun/

此仓库包含一组库/工具箱，用于在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的卡带大小限制，这可能会迫使使用较小的游戏资源，如精灵，或者避免使用一些复杂的库。

另一方面，虽然动态分配在其他环境中带来了许多优势，但在Rust的WASM-4上并不那么必要。存在许多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://opensource.org/licenses/Apache-2.0)
• MIT许可证 (LICENSE-MIT.txt 或 https://opensource.org/licenses/MIT)

任选其一。