#stl #3d #3d-printing #graphics #file-manager

bin+lib stl-thumb

为 STL 文件提供快速轻量级缩略图生成器

1 个不稳定版本

使用旧的 Rust 2015

0.5.0 2022年5月30日

#16#stl

MIT 许可证

54KB
1K SLoC

Rust 1K SLoC // 0.1% comments GLSL 121 SLoC // 0.1% comments

stl-thumb

Build Status Build Status

Stl-thumb 是 STL 文件的快速轻量级缩略图生成器。它可以在 Linux 和 Windows 的文件管理器中显示 STL 文件的预览。它使用 Rust 编写并使用 OpenGL。

Screenshot

安装

Windows

Stl-thumb 需要 64 位 Windows 7 或更高版本。下载最新版本的 安装程序 .exe 并运行。

安装程序会告诉 Windows 壳刷新缩略图缓存,但这似乎并不总是有效。如果图标没有更改,请尝试使用 磁盘清理 工具来清除缩略图缓存。

Linux

Stl-thumb 与 Gnome 和大多数类似桌面环境兼容。如果您使用的是 KDE 桌面环境,则还需要安装单独的 stl-thumb-kde 软件包。

请确保您的文件管理器设置为为大于 1 MB 的文件生成预览。大多数文件管理器在首选项中的预览选项卡下都有此设置。

Arch

AUR 中有可用的软件包。您可以选择手动安装或使用您最喜欢的 AUR 辅助工具安装。

$ yay -S stl-thumb

Debian / Ubuntu

下载适用于您的平台 (.deb) 的软件包(通常是 amd64),然后安装。软件包也适用于 armhf(树莓派)和 arm64(Pine64 和其他 SBC)。

$ sudo apt install ./stl-thumb_0.4.0_amd64.deb

构建

构建工具本身

$ cargo build

构建 .deb 软件包

$ cargo install cargo-deb #this is an additional dependency
$ cargo deb

命令行使用

$ stl-thumb <STL_FILE> [IMG_FILE]

选项

选项 描述
<STL_FILE> 您要创建图片的 STL 文件。使用 - 从 stdin 读取而不是文件。
<IMG_FILE> 将创建的缩略图图像文件。使用 - 将输出写入 stdout 而不是文件。
-s, --size <size> 指定图像的宽度。它总是正方形。
-f, --format <format> 图像文件的格式。如果未指定,将根据文件扩展名确定,如果没有扩展名,则默认为PNG。
-m, --material <环境> <漫反射> <镜面> 使用Phong反射模型渲染网格的颜色。需要3种颜色作为rgb十六进制值:环境、漫反射和镜面。默认为蓝色。
-b, --background <颜色> 具有透明度的背景颜色(rgba)。默认为ffffff00。
-a, --antialiasing [none, fxaa] 抗锯齿方法。默认为FXAA,速度快但可能引入伪影。
--recalc-normals 强制重新计算面法线。处理损坏的STL文件时使用。
-x 在窗口中显示图像而不是保存文件。
-h, --help 打印帮助信息。
-V, --version 打印版本信息。
-v[v][v] 增加消息详细程度。级别:错误、警告、信息、调试

依赖项

~21–33MB
~361K SLoC