☰
F3D 3D 查看器:10 分钟装好,50+ 格式模型秒开、导出、批量出图
2026/10/19 1:30:30 网站建设 项目流程

F3D 3D 查看器:10 分钟装好,50+ 格式模型秒开、导出、批量出图

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

F3D 是一款轻量级 3D 文件查看器,支持 glTF、STL、STEP、FBX、点云等 50 余种格式,打开文件即可旋转缩放查看,加一个--output参数就能把当前视角渲染成 PNG 图片。

谁适合用:需要频繁查看 3D 模型的游戏、建模、测绘和科研人员。不适合:需要编辑几何、装配建模的用户,请继续用 CAD/DCC 软件,F3D 只读不改。

📦 三种安装路径,5 分钟装好并打开第一个模型

包管理器安装(推荐):

# Windows winget install f3d # macOS brew install f3d # Debian / Ubuntu sudo apt install f3d

源码编译(需要 CMake、C++20 编译器,推荐 VTK 9.7):

git clone https://gitcode.com/GitHub_Trending/f3/f3d cd f3d cmake -B build -DCMAKE_BUILD_TYPE=Release cmake --build build --config Release

二进制包(免安装):到 F3D 官方发布页下载对应平台的安装包,解压后把可执行文件放进PATH即可。安装完成后执行f3d --version,能看到版本号就说明装好了。

🎯 打开文件、调整视图、导出结果:核心三步

第一步,打开文件,把模型路径作为第一个参数传入:

# 最小命令:打开单个模型 f3d model.glb # 进阶:一次性打开整个资源目录 f3d assets/ --recursive-dir-add --multi-file-mode=all

窗口内左键拖拽旋转、滚轮缩放、中键平移,按F1打开快捷键速查表。

第二步,调整视图。网格和坐标轴帮你判断比例与朝向:

# 最小命令:加网格和坐标轴 f3d model.stl --grid --axis # 进阶:显示法线箭头,检查模型面是否朝内 f3d model.stl --grid --axis --normal-glyphs

第三步,输出结果。加--output后不弹窗口,直接渲染成图片:

# 最小命令:导出 1024x1024 的 PNG f3d model.glb --output=preview.png --resolution=1024,1024 # 进阶:动画模型直接导出 MP4 f3d character.glb --output-video=anim.mp4

只想确认文件能否加载、不关心画面时,可以用f3d model.step --no-render --verbose跳过渲染直接退出,并用f3d --list-readers查看当前构建支持哪些格式。

🕘 早会前 10 分钟:检查一批模型能否正常打开

拿到外部发来的模型,先确认格式和朝向没问题,再产出几张截图发群里。

# 检查法线朝向:箭头朝外才是正确的 f3d check.stl --grid --axis --normal-glyphs # 一次性打开整个目录,用上下方向键切换文件 f3d *.stl --multi-file-mode=all --grid # 导出固定机位的检查图,标注方位 f3d check.stl --grid --axis --camera-azimuth-angle=30 \ --camera-elevation-angle=25 --output=check.png \ --resolution=1600,900

动画模型可以用W键切换动画、空格播放,确认动作是否完整。

🌙 下班前批量出预览图:一条循环搞定整个目录

mkdir -p previews for f in assets/*.{glb,fbx,obj,stl}; do f3d "$f" --output="previews/$(basename "${f%.*}").png" \ --resolution=512,512 --background-color=0.9,0.9,0.9 done

对需要演示动画的 FBX,把循环里的参数换成--output-video="previews/$(basename "${f%.*}").mp4"即可。F3D 还支持从标准输入流式读取,管道场景下用-作为文件名,必要时加--force-reader指定解析器。

⚙️ 写一个配置文件,按格式自动套用不同显示参数

常用参数不用每次敲,写进 JSON 配置文件即可。配置文件是 JSON 数组,第一个块对所有文件生效,后续块用match正则按文件名覆盖,详见 配置文件文档:

[ { "options": { "background-color": "0.2,0.2,0.2", "grid": true, "axis": true } }, { "match": ".*(step|stp)$", "options": { "edges": true } }, { "match": ".*(gltf|glb)$", "options": { "raytracing": true, "denoise": true } } ]

把文件保存为标准配置目录下的config.json,之后所有 F3D 会话自动生效。命令行参数优先级更高,需要临时覆盖时直接用--option=value传入。

🔧 排错速查:常见现象与对应参数

现象尝试的参数预期效果
模型表面显示反了、像被挖空--blending=ddp开启透明混合,半透明材质正确显示
.ply的 3D 高斯点云打开后像一团灰雾--point-sprites=gaussian --point-sprites-size=1 --coloring-mode=direct按高斯 splatting 预设正确渲染
STEP 文件不跟随--color变色--color=Blue --coloring-mode=material关闭标量着色,颜色选项生效
超大文件加载慢,生成缩略图时只想限制大小--max-size=256超过 256 MiB 的文件直接跳过

更多限制与已知问题见 limitations 文档。

下一步行动

F3D 把"打开一个 3D 文件到导出图片"压缩到一分钟以内,剩下的只是把参数用顺手。

  • 执行f3d --help,通读一遍选项列表
  • 用 配置文件 保存你每天的默认显示设置
  • 按 命令行选项文档 为你的目录写一条批量出图循环

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询