Lib.rs

PolyMesh是我作为一个实验设计的自定义3D对象描述文件格式。PolyMesh文件格式和工具集专门为3D渲染应用设计。

PolyMesh文件格式（pmf）是一个包含结构化目录树JSON文件的gzip文件。树的每一级都包含一个描述目录的描述文件 polymeta.json。最低级别的目录都包含描述使用基本多边形集合的3D网格的 mesh.json 文件。PolyMesh文件的每一级都应被视为一个独立的3D网格。高级网格可以包含低级网格，以构建更复杂的网格。

所有网格都是相对定位的。这意味着最低级别的网格都应该以 [0,0,0] 为中心，以便高级网格可以包含它们并根据需要变换它们。PolyMesh文件可以使用 pmfpack 和 pmfextract 工具进行打包和解包。当PolyMesh解包时，可以在较低级别重新打包，这就是为什么保持所有网格相对定位很重要的原因。描述咖啡馆场景的PolyMesh也可以重新打包，仅描述主场景中的咖啡杯。

一个示例3D对象在 example_meshes/default_cube

工具集

此仓库提供了一些用于处理PolyMesh的命令行工具

• pmfpack
  • 可以将未压缩的目录（如 default_cube 示例）打包成一个单一的 .pmf 文件
• pmfextract
  • 可以将 .pmf 文件解包到未压缩的目录中
• pmftree
  • 提供类似 tree 命令样式的任何 .pmf 文件的可视化
• pmfview
  • 任何 .pmf 文件的完整 3D 可视化工具。灵感来自 Pixar 的 usdview。基于 raylib 构建
• vox2pmf
  • 可以将文件从 .vox 格式转换为 PolyMesh 的工具
• pmfcube
  • 一个调试工具，将在 [0,0,0] 的位置生成一个大小为 1 单位的彩色立方体

库

libpolymesh 可以作为一个独立的 Rust 库使用，目前正在开发中。

关于坐标的说明

该项目实际上不应该关心使用哪种坐标系，但我使用的是“Y-up，右手定则”来编程。

构建

此单一代码库有一些系统依赖项

# Install GUI libraries
sudo apt install libasound2-dev mesa-common-dev libx11-dev libxrandr-dev libxi-dev xorg-dev libgl1-mesa-dev libglu1-mesa-dev

# Install the workspace wrangling tools
cargo install cargo-token
cargo install cargo-unleash --version 1.0.0-alpha.11