Lib.rs

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

PolyMesh文件格式（pmf）是一个包含结构化目录树JSON文件的gzip文件。树的每一层都包含一个描述目录的描述文件 polymeta.json。最低层目录都包含描述3D网格的 mesh.json 文件，这些文件使用一组基本多边形来描述3D网格。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 可视化工具。受皮克斯的 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