f3d-app/f3d

项目介绍

F3D 是一个桌面 3D 查看器，同时提供底层的 libf3d 渲染库。它面向数字内容与科学数据集，支持 glTF、USD、STL、STEP、PLY、OBJ、FBX、Alembic 等格式，可播放动画、生成缩略图，支持快捷键、拖放以及从文件管理器直接打开。渲染方面提供实时物理渲染和光线追踪等选项。

项目刻意保持为查看器：目标包括尽可能多的格式、命令行与配置文件控制、非交互式使用和多种渲染风格；不计划提供带菜单和按钮的传统鼠标界面、数据处理工具或导出功能。libf3d 提供 C++17 API，并有 C、Python、Java 和 JavaScript 绑定，便于把网格渲染嵌入其他程序。

快速使用

从下载页面安装对应平台的发行包，安装后终端中应能直接调用 f3d 命令。

传入文件路径即可打开：

f3d /path/to/file.ext

如果希望把渲染结果保存为图片，而不是仅在窗口中查看，追加输出参数：

f3d /path/to/file.ext --output=/path/to/img.png

这条流程不需要自行编译，准备好已安装的程序和受支持的模型文件即可。也可以在项目的在线查看器中直接打开文件；更多命令与配置用法见快速入门指南。

使用约束

F3D 不提供带菜单和按钮的常规鼠标界面，也不提供数据处理和导出功能；缩略图、图片输出等能力需要通过命令行参数和配置文件来使用。具体格式和渲染特性取决于随包集成的依赖（如 VTK、OCCT、Assimp、OpenUSD、OpenVDB、OSPRay 等），不同构建对某些文件或效果的支持可能不一致。

代码以 BSD-3-Clause 许可分发，第三方组件列在第三方许可中。若要在程序中嵌入渲染能力，应参考 libf3d 概览，而不是把桌面应用本身当作 API。

HotRepo 点评

在 HotRepo 记录的 2026-11-14 C++ 日榜中，F3D 位列第 3，当时有 5,040 个 Star 和 475 个 Fork，单日新增 6 个 Star。这只是单日快照，只能说明当天它在 C++ 榜单上位置靠前，不足以判断持续增长趋势。该仓库在 HN 上也有多次发布讨论，包括 v2.3.0 和加入 FreeCAD .FCStd 支持的 4.0.0 版本（HN 讨论）。2024 年 v2.3.0 的讨论中，有评论者反馈同一 glb 文件在此版本中不可见，但在 Blender 中显示正常（评论），说明格式渲染可能因构建和文件而异；现有讨论中没有看到后续结论。

许可证

项目以 3-Clause BSD 许可发布，集成的第三方源码均使用宽松许可证。