Lib.rs

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

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

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

一个示例3D对象在 example_meshes/default_cube 中提供。

工具集

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

• pmfpack
  • 可以将未压缩的目录（如 default_cube 示例）打包成一个单独的 .pmf 文件。
• pmfextract
  • 可以将 .pmf 文件解包到未压缩的目录。
• pmftree
  • 提供了一个类似 tree 命令的样式的任何 .pmf 文件的可视化。
• pmfview
  • 任何 .pmf 文件的完整 3D 可视化工具。受皮克斯的 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