0.1.0	2022年1月8日

1787 在游戏开发

被 2 个库使用

MIT/Apache

9KB

Wasm4fun

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

此仓库包含一系列库/crate，用于在Rust语言中开发WASM-4幻想控制台的游戏。

WASM-4幻想控制台的硬件如下

显示屏：160×160屏幕，使用可定制的4色调色板。

这意味着在任何时候屏幕上只能有4种不同的颜色，但游戏可以随时切换到另一组颜色。
内存：64 KiB。
卡带大小：64 KiB。

整个游戏不能超过卡带大小。这限制了游戏资源（如图形精灵）的数量和复杂性，以及游戏逻辑的复杂性（复杂的实现会导致更大的二进制文件大小）。
磁盘存储：1 KiB。

游戏可以写入和读取多达1 KiB的数据，例如用于保存进度或高分。

WASM-4引擎公开了一组原始的内存映射，并期望游戏公开两个回调函数。这种方法可以轻松支持多种编程语言，但缺点是编程接口相对低级和简单。这些库的目的是封装WASM-4原始的，并公开一个更丰富、更符合习惯和更安全的API。

架构

此库分为几个独立的crate，每个crate实现特定的功能。例如，wasm4fun-input实现了读取控制台输入的函数和数据类型，无论是鼠标还是游戏手柄，而wasm4fun-storage实现了将数据保存到或从存储系统中加载的函数。

一些crate依赖于其他crate。例如，wasm4fun-core导出裸WASM-4接口，被大多数crate使用，同样wasm4fun-log导出一个debug!()宏，用于将格式化文本写入输出控制台。

顶级wasm4fun crate重新导出所有子crate，但也可以忽略它并显式地依赖某些子crate，以修剪依赖树。

这些库不使用任何动态分配，因此也不使用Rust标准库的任何部分。从技术角度来看，它们不使用std::模块中的任何内容，而只使用core::。

动态分配使开发变得更容易，但在WASM-4上有一个主要的缺点：它会导致卡带大小显著增加，因为卡带必须包含分配器本身。由于64 KiB的卡带大小限制，这可能会迫使使用较小的游戏资源，例如精灵，或者避免一些复杂的库。

另一方面，尽管动态分配在其它环境中带来了许多优势，但在Rust的WASM-4上并不那么必要。存在许多crate来实现堆栈上的数据结构和算法。例如，tinyvec crate提供了基于堆栈数组的“动态”向量。

最后，避免动态分配与WASM-4的通用极简主义哲学相吻合

其理念是通过去除多余内容并关注核心，更容易开始并完成游戏开发。

在目录examples中提供了几个示例。它们可以通过命令cargo make run-example EXAMPLE_NAME运行（WASM-4的可执行文件w4必须在路径中）。

您可以在署名的前提下自由复制、修改和分发此应用程序，根据以下条款之一

任选其一。