F3D:一条命令快速预览任意 3D 模型的开源查看器
【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d
F3D 是一款开源、极简的3D 查看器(3D viewer),支持 glTF、FBX、STEP、STL、VTK 等数十种格式。它用一条命令行命令即可快速预览 3D 模型、播放动画、批量输出图片,适合需要频繁查看 CAD、游戏资产和科学数据的新手与开发者。
🚀 安装后第一步做什么
从官方下载页安装后,终端里会出现f3d命令。打开任意模型:
f3d /path/to/model.gltf窗口会立即显示模型,左键拖拽旋转、滚轮缩放,按F1调出快捷键表。想直接出图而不弹窗,加--output:
f3d /path/to/model.stl --output=render.png核心能力拆解
用 PBR 与 HDR 环境光照还原真实材质
F3D 内置实时PBR(基于物理的渲染)与 HDR 环境光照,默认就自带一个白色摄影棚 HDRI,无需额外设置即可看到金属、粗糙度等物理属性。打开文件后按F开关环境光、按J循环天空盒模式,或直接拖入.hdr/.exr文件作为环境。
预览 3D Gaussian Splatting 高斯泼溅场景
F3D 支持.ply、.splat、.spz三种高斯泼溅格式,用f3d scene.splat直接打开就能看到重建的 3D 场景,并支持球谐函数(SH)渲染。查看扫描重建结果、检查数据质量都很直接。
用 colormap 对科学数据快速着色
在scivis模式下,F3D 能直接对数据集的数组做伪彩着色:按S在材质/科学/直接三种着色模式间切换,按Y切换要着色的数组。适合快速检查 VTK、HDF5、NetCDF 等数据里的场变量分布。
真实场景怎么用
游戏与影视:不进引擎检查 glTF / FBX 资产
在引擎里打开资产往往很慢。用f3d asset.glb秒开,按W切换动画、Space播放、E显示边线,即可核对模型、法线贴图和动画,无需启动编辑器。
工业与 CAD:随手打开 STEP / FCStd 图纸
为看一眼装配而启动重型 CAD 并不划算。f3d part.step通过 occt 插件解析 BREP,按Enter复位视角,快速核对装配与干涉关系。
批量与自动化:脚本化出图
需要对一批模型统一出图时,循环调用--output即可;用--output=frame_{frame}.png还能把动画按帧导出成图片序列,方便做缩略图或截图。
进阶效率技巧
- 管道流式读取:
cat model.vtu | f3d -从 stdin 读取,适合脚本处理。 - 透明背景导出:
f3d m.stl --output=o.png --no-background生成可叠加的透明图。 - 按格式设默认:JSON 配置文件用
match规则,例如仅对.*glb开启 raytracing。 - 保存与恢复状态:
--save-statefile/--load-statefile存下相机、选项和窗口大小。 - 自动重载:加
--watch,文件在磁盘上一有改动就自动刷新,边改边看。
生态与扩展
除命令行工具外,F3D 提供 libf3d 库及 C、C++、Python、Java、JavaScript 绑定;格式解析采用插件系统(occt、assimp、usd、pdal 等),可用--load-plugins按需加载。
文档索引
- 快速入门 — 运行、交互、播放动画的最短路径
- 支持的格式 — 全部格式与对应插件对照
- 命令行选项 — 所有参数、管道与模板变量
- 配置文件 — 按文件格式设置默认渲染
- libf3d 概览 — 库接口与语言绑定说明
【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考