F3D一条命令打开 54 种 3D 文件的命令行 3D 查看器【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3dF3D 是一款快速、极简的开源 3D 查看器Fast and minimalist 3D viewer。它能直接打开 glTF、FBX、STEP、STL、USD、VTK 等 50 多种文件播放文件内嵌动画把渲染结果导出为图片或视频并支持实时物理渲染与光线追踪。整个过程完全可以用命令行驱动也可以配合 JSON 配置文件。如果你经常需要检查 3D 模型、点云或科学数据但不想为看一眼就启动重量级 CAD 或 DCC 软件或者想在 CI 里把 3D 预览变成一条脚本命令F3D 就是为你准备的。上图是 F3D 自带的默认 HDRI 环境贴图。F3D 打开模型时默认就使用环境贴图光照所以不需要手动布光模型直接就有比较真实的明暗关系。你也可以用--hdri-file换成自己的.hdr或.exr环境图。三个 F3D 省时间的真实场景场景一收到 STEP 文件只想确认形状。完整 CAD 软件启动就要几分钟而f3d part.step一条命令直接出窗口。STEP、IGES 这类格式由 occt 插件基于 OpenCASCADE提供FBX、DAE 由 assimp 插件提供官方格式表目前列出了 54 种格式完整清单见支持格式列表。场景二上百个游戏资产要快速过一遍外观。在 Blender 里逐个打开不现实用 shell 循环配合--output直接批量出缩略图for f in assets/*.glb; do f3d $f --outputthumbs/$(basename $f).png --resolution512,512 done场景三无显示器的构建机器上要留下渲染产物。--output本身就不开交互窗口直接离屏渲染到 PNG配合--rendering-backendosmesa或egl可以强制无头渲染塞进 CI 流水线没有障碍。动画还能直接导出视频流f3d anim.glb --output-video- | ffmpeg -f h264 -i - anim.mp4F3D 3D 查看器的最短路径从安装到第一张截图安装只主推一种方式到 F3D 官方下载页拿对应平台的二进制包装完后f3d命令即出现在终端里。其余方式一句话带过从源码构建需要 CMake≥3.1、VTK≥9.4.0推荐 9.7.0和 C20 编译器各格式插件均为可选项详见构建指南。装好之后先验证一下你的构建实际带上了哪些 reader不同安装方式差异不小f3d --list-readers输出里能看到每个 reader 的名字如GLB、STEP、VTKXMLVTU后面--force-reader用的就是这些名字。然后打开你手边任意一个 3D 文件f3d /path/to/file.ext窗口出现模型居中、自动取景左键拖动旋转。再追加--outputpreview.pngF3D 就不再开窗口而是直接把当前视图渲染成一张 PNG这就是第一个可验证的结果。一次完整操作离屏渲染模型并导出图片以仓库自带的测试文件为例执行f3d testing/data/f3d.glb --outputpreview.png --resolution1280,720执行命令后看到什么终端没有打开任何窗口直接返回当前目录生成preview.png。--resolution接受宽,高两个值默认 1000,600离屏渲染不受窗口缓存影响尺寸完全由参数决定。如何解读结果与常用变体想要透明背景方便贴到文档或页面里加--no-background。想换观察角度批量出图--camera-azimuth-angle和--camera-elevation-angle分别绕水平轴和垂直轴转指定角度写个循环就能出一圈视图。想在截图里显示文件名或 FPS-n、-z。想检查数据而不是外观--coloring-modescivis切换标量着色-b显示色标条。如果这些设置要长期生效别往命令行里堆参数写进 JSON 配置文件即可。配置是一个 JSON 数组每个块可以带match规则按文件名匹配[ { match: .*glb, options: { edges: true, raytracing: true } } ]命令行参数永远优先于配置文件想反过来让配置强制生效在选项名前加!imperative option。文件名匹配默认是正则也支持match-type设为glob或exact。F3D 3D 查看器高频参数与快捷键速查参数 / 快捷键作用--outputpng离屏渲染到 PNG不开窗口--resolutionw,h窗口/输出分辨率默认 1000,600--no-background输出透明背景 PNG--force-readername强制指定 reader无视扩展名与文件内容--list-readers列出当前构建可用的 reader--animation-indices-1同时播放文件内全部动画左键拖动 / Shift左键旋转 / 平移相机右键拖动或滚轮缩放Enter重置相机G/E/X切换网格 / 边线 / 坐标轴显示S循环切换着色模式material/scivis/directW/Space循环动画 / 播放暂停动画F1打开快捷键 CheatsheetF12截图CtrlF12 为无装饰、透明底的最小截图记不全没关系窗口里按F1就能看到完整 Cheatsheet。排查三个高频问题1. STEP 文件加了--color却不变色。这是已知行为STEP 的默认配置使用标量着色会忽略--color。显式指定着色模式即可f3d part.step --colorBlue --coloring-modematerial2. 模型表面翻转、明暗错乱。多半是数据本身含半透明元素按P循环开启半透明混合或命令行加-pf3d part.glb -p3. macOS 报安装包已损坏或无效。二进制包未做代码签名清一下扩展属性再运行xattr -cr /Applications/F3D.app另外两个容易踩的Windows 终端下中文输出乱码时执行chcp 65001切到 UTF-8.ply格式的 3D Gaussian Splatting 打不开时需要显式加--point-spritesgaussian --point-sprites-size1 --coloring-modedirect因为 F3D 无法从扩展名判断一个.ply是不是 3DGS 数据。更多已知限制与排障项在仓库的doc/user/14-LIMITATIONS_AND_TROUBLESHOOTING.md。F3D 的定位很克制README 明确写出不打算提供菜单按钮式 UI、不做数据处理、不做格式导出它就负责把 3D 文件快、准、可脚本化地显示出来。想继续深入建议按顺序读三份文档命令行选项参考每个参数的取值与默认值、支持格式列表含各 reader 的动画与流式支持级别、配置文件文档match 规则与快捷键绑定。【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
