STL 文件预览工具 stl-thumb 使用指南
stl-thumb 是一个基于 Rust 和 OpenGL 开发的快速轻量级 STL 文件缩略图生成器，能够直接在文件管理器中显示 3D 模型预览。
为什么选择 stl-thumb？
stl-thumb 解决了 STL 文件的可视化预览问题。通过这个工具，你可以：
- 在文件管理器中直接查看 STL 文件缩略图
- 享受极速渲染体验，基于高性能 Rust 语言
- 支持多种图片格式输出（PNG、JPEG、GIF 等）
- 自定义材质颜色和背景设置
- 兼容 Windows 和 Linux 系统
安装指南
Windows 用户
stl-thumb 支持 64 位 Windows 7 及以上系统。下载最新的安装程序.exe 文件并运行即可。
小贴士：如果缩略图没有立即更新，可以使用系统自带的磁盘清理工具清除缩略图缓存。
Linux 用户
stl-thumb 与 Gnome 及大多数类似的桌面环境兼容。如果你使用 KDE 桌面环境，还需要额外安装 stl-thumb-kde 包。
确保文件管理器设置为生成大于 1MB 文件的预览。大多数文件管理器在偏好设置的预览选项卡中都有这个设置。
Arch Linux
AUR 中提供了 stl-thumb 包。手动安装或使用你喜欢的 AUR 助手：
yay -S stl-thumb
Debian/Ubuntu
下载适合你平台的.deb 包（通常是 amd64）并安装：
sudo apt install ./stl-thumb_0.5.0_amd64.deb
命令行使用技巧
stl-thumb 提供了丰富的命令行选项，让你完全掌控渲染效果：
stl-thumb <STL 文件> [图片文件]
常用参数详解
| 参数 | 功能描述 |
|---|---|
-s, --size <尺寸> | 指定图片宽度，始终为正方形 |
-f, --format <格式> | 图片格式：PNG、JPEG、GIF、ICO、BMP |
-m, --material <环境光> <漫反射> <镜面反射> | 使用 Phong 反射模型自定义材质颜色 |
-b, --background <颜色> | 设置背景颜色（含透明度） |
-a, --antialiasing [none, fxaa] | 抗锯齿方法，默认为 FXAA |
高级功能探索
材质自定义
使用 -m 参数可以完全控制模型的视觉效果：
stl-thumb model.stl -m ff0000 00ff00 0000ff
抗锯齿优化
stl-thumb 内置了 FXAA 抗锯齿技术，在保证质量的同时保持高性能。
项目结构解析
深入了解 stl-thumb 的项目结构有助于更好地使用和定制：
