F3D 在 Windows 上怎么用：3D 查看器安装、一行出图与资源管理器缩略图指南

F3D 在 Windows 上怎么用：3D 查看器安装、一行出图与资源管理器缩略图指南

【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d

拿重型三维软件打开一个 STL 看一眼，总觉得大材小用。F3D 是一款轻量级开源 3D 查看器：双击模型就能旋转缩放，命令行一行命令直接输出 PNG 图，装完还在资源管理器里附带模型缩略图。本文按 Windows 用户的实际使用路径写：先选安装形态，再讲怎么打开和把玩模型，然后是离线出图、资源管理器集成，最后是变卡变慢时的常用解法。

4 种安装方式，先选对形态再动手

安装方式主要影响两件事：文件关联和缩略图是否自动配好、卸载升级是否干净。四种渠道放在一起看：

选择逻辑简化后就是这张图：

新手直接走官方 .exe 最省心：向导保持默认一路下一步，文件关联和缩略图 Shell 扩展都会替你注册好。装完用一行命令验证，注意要跑控制台版才能打印版本：

f3d-console.exe --version

能输出版本号即成功。用 zip 的朋友把解压目录的bin加入 PATH，缩略图注册留到下文"让资源管理器长缩略图"一节处理。

打开模型有 3 条路，打开后这样把玩

入口有三个，看当时方便：

• 命令行：路径直接传给f3d；
• 双击：装好后常见 3D 格式都出现在"打开方式"里；
• 拖放：文件或文件夹丢进 F3D 窗口即可，丢.hdr/.exr会直接切换环境光照。

f3d C:\models\robot.glb

窗口一开，三个鼠标手势覆盖九成查看需求：左键拖动旋转、右键上下拖动或滚轮缩放、中键拖动平移。键盘上建议先记住这几个：

• Enter：重置相机，视角乱了第一时间按它；
• Space：播放/暂停动画，W在多段动画间循环切换；
• G：显示/隐藏地面网格；
• F12：截图，默认存到Pictures\F3D，文件名是模型名加序号；
• Esc：显示/隐藏控制台，报错信息一眼看到；
• F1：弹出完整快捷键表，忘了键位不用翻文档。

另外数字键1~9是相机预设视角（1 前视、7 顶视、9 等轴、5 切换正交投影），S/Y分别循环上色的模式和着色的数据数组。完整键位清单见 交互文档。键位混熟之后，下一步就是让 F3D 不开窗口干活——出图。

一条命令出静态图：--output 的三种玩法

加上--output，F3D 就不开窗口，直接渲进文件。注意PNG 是唯一支持的输出格式：

f3d C:\models\part.stl --output=renders\part.png

后面补一个--no-background就是透明背景，方便直接贴进报告或做合成。

整个目录一起出。同格式文件扎堆时一条 for 循环搞定，%~nf自动去掉扩展名，保证输出文件名和源文件一一对应：

for %f in (*.obj) do f3d "%f" --output="renders\%~nf.png"

先 cd 到模型目录再执行。这类固定参数如果长期要用，更好的做法是写进配置文件——F3D 每次启动都会读，Windows 上放在%APPDATA%\f3d\config.json，写法见 配置文件文档。

高清出图：光线追踪、采样数与分辨率

图片要拿去做正式交付时，盯住三个参数：

• --raytracing开启路径追踪（仅带 OSPRay 支持的构建可用，窗口内也能按R随时开关）；
• --raytracing-samples每像素采样数，默认5，调高画面更干净，代价是更慢；
• --resolution宽高用逗号分隔，默认1000,600。

f3d C:\models\scene.usd --raytracing --raytracing-samples=8 --resolution=3840,2160 --output=hd.png

环境光默认走内置 HDRI，效果大致如下：

想换环境用--hdri-file指定.hdr或.exr文件。图出完了，下面把 F3D 彻底安进文件管理器。

让资源管理器长出缩略图：注册与配置一次讲清

NSIS 安装已经注册好缩略图 Shell 扩展，开箱即用；zip 绿色版需要以管理员身份手动注册一次：

cd C:\path\to\f3d\bin\ regsvr32 F3DShellExtension.dll

将来想移除就加/u执行regsvr32 /u F3DShellExtension.dll。

文件关联装完即有，但各格式成熟度分三档：

• 完整场景格式：glTF/GLB、STL、OBJ、FBX、USD 这类，材质、灯光、相机信息齐全，体验最稳；
• CAD 格式：STEP、IGES、FCStd 等由occt插件提供，以着色面片展示；
• 依赖插件：Alembic 动画、LAS/PCD 点云等（pdal插件）功能各有边界。

完整清单见 支持的文件格式。

缩略图有独立配置，位于%APPDATA%\f3d\（thumbnail.json或thumbnail.d目录）。比如想跳过 256 MiB 以上的大文件（max-size单位 MiB，默认配置为 100）：

[ { "options": { "max-size": 256 } } ]

还有一个看似 bug 实为设计的行为：TIFF 有意不参与缩略图，避免和 2D 图片查看器抢活。

变卡变慢时，4 种场景对应 4 个解法

大 CAD 文件加载慢。STEP 这类格式的耗时主要在网格化，调大 deflection 让网格变粗即可明显提速（默认 0.1）：

f3d C:\cad\big.step -DSTEP.linear_deflection=0.5 --max-size=4096

--max-size（单位 MiB）直接拒绝加载超限文件，误开巨型文件时是道保险。

老机器帧率低。像素负载跟着分辨率走，先降分辨率，再关抗锯齿：

f3d C:\models\model.glb --resolution=1280,720 --anti-aliasing=none

虚拟机里没有 GPU。窗口根本起不来，上 Mesa 软渲染：下载 Mesa 的release-msvc版，把x64/opengl32.dll、libgallium_wgl.dll、x64/libglapi.dll拷到f3d.exe同目录，设置环境变量MESA_GL_VERSION_OVERRIDE=4.5再启动。细节在 桌面集成文档。

点云吃内存。LAS、PCD、SPLAT 体量大，用--max-size设上限，再加--no-cache关闭窗口几何与 HDRI 缓存，看完即关，不做常驻。

常见 6 个问题，逐条自查 🔧

• 弹出"Windows 已保护你的电脑"。F3D 尚未做微软签名，点更多信息 → 仍要运行即可。
• 注册缩略图后资源管理器打不开。Shell 扩展与 explorer 冲突，执行regsvr32 /u F3DShellExtension.dll卸载扩展恢复。
• f3d.exe --version没有任何输出。GUI 子系统不挂控制台，属正常现象，改用f3d-console.exe。
• 更新时报无法写入 F3DShellExtension.dll。旧 DLL 正被缩略图进程占用，等几分钟或重启后再更新。
• 部分文件没有缩略图。先查max-size是否拦了大文件、TIFF 等格式是否被有意排除；文件在 OneDrive 这类云同步目录里时，拷到本地再看一次。
• cmd 里中文文件名乱码。先切 UTF-8 代码页：chcp 65001。

更多场景查 限制与故障排查文档。

日常速查表

下一步建议：对照 命令行选项文档 挑出你高频使用的参数放进配置文件，F3D 就正式成为你查模型的标准工具。

【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d