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
40KB
439 行
minetest-worldmapper
Minetest 的多线程映射器,支持节点透明度。
它从上方生成世界的视图,每个体素渲染一个像素。
该项目目前仅在 Linux 上进行了测试。如果您有 Windows 并且它不起作用,请提交一个 错误报告。但如果您有其他操作系统并且它不起作用,也请提交错误报告。
示例图片
用法
首先,使用 cargo 编译项目
cargo build --release
命令行参数
然后,使用三个必需的参数调用可执行文件 target/release/minetest-worldmapper
选项 | 简称 | 描述 |
---|---|---|
--world | -w | 要渲染的世界的目录。 |
--config | -c | 配置文件。格式应遵循 配置格式。 |
--output | -o | 要渲染地图的图像文件。 |
日志记录
通过 RUST_LOG
环境变量,您可以选择日志级别 trace
、debug
、info
、warn
和 error
之一。默认为 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