#world #mapper #minetest #png #generate #node #voxel

bin+lib minetest-worldmapper

Minetest 世界映射器

9 个版本

0.3.4 2023年12月24日
0.3.3 2023年7月15日
0.3.2 2023年1月22日
0.2.4 2022年4月14日
0.2.2 2022年2月26日

#167图像

每月下载量 25

AGPL-3.0

40KB
439

minetest-worldmapper

Build Crates.io Dependency Status

Minetest 的多线程映射器,支持节点透明度。

它从上方生成世界的视图,每个体素渲染一个像素。

该项目目前仅在 Linux 上进行了测试。如果您有 Windows 并且它不起作用,请提交一个 错误报告。但如果您有其他操作系统并且它不起作用,也请提交错误报告。

示例图片

Zoomed map Example map

用法

首先,使用 cargo 编译项目

cargo build --release

命令行参数

然后,使用三个必需的参数调用可执行文件 target/release/minetest-worldmapper

选项 简称 描述
--world -w 要渲染的世界的目录。
--config -c 配置文件。格式应遵循 配置格式
--output -o 要渲染地图的图像文件。

日志记录

通过 RUST_LOG 环境变量,您可以选择日志级别 tracedebuginfowarnerror 之一。默认为 error

示例用法

minetest-worldmapper --world TestWorld/ --config config.example.toml --output map.png

带有日志记录的示例用法

RUST_LOG=debug minetest-worldmapper --world TestWorld/ --config config.example.toml --output map.png

配置文件

如果体素被渲染并且其颜色完全由基于 TOML 的配置文件决定,则该配置文件是该项目的一部分。一个 示例配置文件 是该项目的一部分。其主要目的是将体素内容映射到颜色。

配置选项 类型 描述
sufficient_alpha 整数 (可选,默认为 230) 在达到此不透明度值时停止通过透明节点确定像素的颜色。介于 0 和 255 之间。
background_color 字符串 十六进制颜色字符串;可以是 "rrggbb"(全不透明)或 "rrggbbaa"(具有 alpha 值的颜色)。如果给定像素的所有体素都已用尽并且仍有透明度,则用作后备颜色。
hillshading.启用 布尔型 (可选,默认为 true) 启用地形起伏可视化。
hillshading.min_alpha 整数 (可选,默认为 128) 在哪个alpha值下节点被认为是“地形”
node_colors 表格 将节点 itemstrings 映射到颜色字符串(其格式与 background_color 相同)。未在此列出的每个节点都视为空气。

最小配置示例

background_color = "888888"

[node_colors]
"default:water_source" = "00228888"

当前限制

  • 不支持LevelDB作为后端。
  • 仅支持地图块格式版本29(当前版本)。

使用Rust读取Minetest世界

minetestworld 是此渲染器的基石。

依赖项

~26–39MB
~473K SLoC