stl-thumb 安装和配置指南

stl-thumb 安装和配置指南

stl-thumb Thumbnail generator for STL files 项目地址: https://gitcode.com/gh_mirrors/st/stl-thumb

1. 项目基础介绍和主要编程语言

stl-thumb 是一个快速、轻量级的 STL 文件缩略图生成器。它能够在 Linux 和 Windows 的文件管理器中显示 STL 文件的预览图。该项目主要使用 Rust 编程语言编写，并利用 OpenGL 进行图形渲染。

2. 项目使用的关键技术和框架

• Rust: 项目的主要编程语言，提供了高性能和内存安全的特性。
• OpenGL: 用于图形渲染，确保缩略图生成的高效性和质量。
• Cargo: Rust 的包管理工具，用于项目的构建和管理。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• Windows: 64 位 Windows 7 或更高版本。
• Linux: 支持 Gnome 和大多数其他类似的桌面环境。如果使用 KDE 桌面环境，还需要安装 stl-thumb-kde 包。

安装步骤

Windows 安装

1. 下载安装程序:

   • 访问 stl-thumb GitHub 发布页面。
   • 下载最新版本的 .exe 安装程序。

2. 运行安装程序:

   • 双击下载的 .exe 文件，按照提示完成安装。

3. 刷新缩略图缓存:

   • 安装程序会尝试刷新 Windows 的缩略图缓存，但有时可能不成功。如果缩略图未更新，请使用 Disk Cleanup 工具手动清除缩略图缓存。

Linux 安装

Arch Linux

1. 安装 AUR 包:
   • 使用 AUR 助手（如 yay）安装 stl-thumb 包。

   yay -S stl-thumb
   

Debian / Ubuntu

1. 下载 .deb 包:

   • 访问 stl-thumb GitHub 发布页面。
   • 下载适用于您平台的 .deb 包（通常为 amd64）。

2. 安装 .deb 包:

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

openSUSE

1. 添加用户仓库:

   sudo zypper ar -f obs://home:jubalh:stl stl
   sudo zypper ref
   sudo zypper install stl-thumb
   

配置文件管理器

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

构建和运行

如果您想从源代码构建 stl-thumb，请按照以下步骤操作：

1. 克隆仓库:

   git clone https://github.com/unlimitedbacon/stl-thumb.git
   cd stl-thumb
   

2. 构建项目:

   cargo build --release
   

3. 运行:

   ./target/release/stl-thumb <STL_FILE> [IMG_FILE]
   

通过以上步骤，您应该能够成功安装和配置 stl-thumb，并在文件管理器中查看 STL 文件的缩略图。

stl-thumb Thumbnail generator for STL files 项目地址: https://gitcode.com/gh_mirrors/st/stl-thumb