F3D轻量3D预览全格式即开即看【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3dF3D 要解决的问题很具体任何一个 3D 文件几秒内看到它的 3D 预览。它由 F3D-APP Foundation 维护C 编写、基于 VTK 渲染文档列出的格式条目有 55 个从 glTF、STL 到 STEP、Alembic旁边还带一个可直接集成的渲染库 libf3d。当你手头有一份几百 MB 的 CAD 文件只想花 10 秒确认结构对不对的时候F3D 就是拿来干这个的。打开文件直接看模型。 5分钟跑通 F3D从安装到第一次打开模型最直接的路径是二进制发行包到 F3D 官网下载页选对应平台的包装完终端里直接有f3d命令。纯 Python 脚本场景也可以pip install f3d拿到 Python 绑定。源码编译是备选路径依赖 CMake ≥ 3.21、C20 编译器和已装好的 VTK ≥ 9.4.0仓库自带 CMake presetcmake --presetvcpkg可以直接用 vcpkg 拉依赖。克隆仓库后配置、编译就两步git clone https://gitcode.com/GitHub_Trending/f3/f3d cd f3d cmake -B build # 需要系统已安装 VTK 9.4.0 cmake --build build --parallel这一步只构建f3d可执行文件和 libf3d各格式插件是可选依赖没装 Assimp、OCCT 之类的库就只是少了对应格式支持不影响主程序。编译成功后第一次运行就一行f3d /path/to/model.stl跑对的标志很明确弹出一个 3D 窗口模型自动居中取景灰底没有菜单也没有按钮。用f3d --list-readers能确认当前构建带哪些读取器f3d --version看版本号。文件打开后按 F1 弹出 Cheatsheet全部热键都列在那张表里。 能力拆解四类高频任务预览任意模型文件F3D 的格式覆盖面从 VTK 系列、glTF、USD、FBX一直排到 LAS、PCD 这类激光点云。glTF、OBJ、FBX 这些full scene格式会保留文件里的灯光、相机和材质其余格式走默认场景灰色基色加 PBR 光照参数。一次传多个文件时按 ↑ / ↓ 键切换文件组F5 重载当前文件加--watch可以让文件在磁盘上被修改后自动重新加载。批量出图命令行一次渲染一批--output指定 PNG 路径后不弹窗口直接渲染到文件。文件名支持模板变量{model}是模型名{frame}是帧号配 for 循环就能一次出一批预览图f3d $f --outputthumbs/{model}.png --no-background。生成文件管理器缩略图时再加--max-size256大文件直接跳过。--output-video则把渲染过程写成视频文件。把 F3D 嵌进你的应用仓库里的 libf3d 是 C17 API另有 C、Python、Java、JavaScript 四套绑定格式全部以插件形式组织用--load-plugins按需加载。examples/libf3d/ 目录里每个语言都有可直接编译的示例最常用的是离屏渲染路径Engine.create(True)建引擎scene.add加模型window.render_to_image拿图像全程不弹窗。按自己的习惯配置命令行能控的选项几乎都能写进 JSON 配置文件match字段按文件名正则给不同格式分配不同默认值bindings字段把自定义按键绑到命令上。--list-bindings查看当前绑定--configxxx换一份配置。指标数值备注支持格式条目55glTF / USD / STEP / 点云等格式插件109 个插件 内置 native语言绑定5C / C / Python / Java / JavaScript渲染基线VTK ≥ 9.4.0推荐 9.7.0光线追踪可选编译交互热键50F1 打开 Cheatsheet 速查这是 F3D 内置的默认环境天空图PBR 光照用它计算环境光也可以换一张自己的命令是--hdri-file。⚙️ 工作流嵌入放进你的日常CI 里批量出缩略图。背景CI 产物页要给每个模型挂一张预览图。操作循环执行f3d $f --outputthumbs/{model}.png --no-background --rendering-backendosmesa。结果透明背景 PNG 直接上页面沙箱里没有 X 环境也能跑。Python 平台生成资产缩略图。背景数据平台要给每个资产出一张 512px 缩略图。操作参考官方示例 examples/libf3d/python/offscreen-thumbnail/ 里的 offscreen_thumbnail.py十几行配置关 UI、调光照、开 SSAA。结果render_to_image拿图落盘窗口从头到尾不出现。远程协作分享同一视角。背景你和同事各看各的角度讨论对不上。操作你这边f3d model.glb --save-statefileview.json把状态文件发过去对方f3d model.glb --load-statefileview.json打开。结果相机、选项、文件组完全一致。 F3D 配置项速查与高频坑最常调的五个选项格式统一为配置项 → 默认值 → 推荐值 → 理由--axis角落坐标轴三轴架→ 关 → 开 → 转模型时知道朝向--grid地面网格→ 关 → 开 → 给模型一个距离和位置参照--edges面边线→ 关 → 看 STL / CAD 时开 → 轮廓细节清晰--hdri-ambientHDRI 环境光→ 关 → 开 → 材质光照更真实--coloring-mode着色模式→ material → 看科学数据时改 scivis → 场量按数值着色Linux 上配置文件放在~/.config/f3d/config.json即${XDG_CONFIG_HOME}/f3d/config.json命令行选项永远覆盖配置文件。下面第一块对所有文件生效第二块只命中 STEP 文件第三块是自定义按键行尾 # 是讲解注释真实 JSON 文件里不含 #[ { options: { axis: true, grid: true, edges: true, hdri-ambient: true } }, # 全局默认 { match: .*\\.(step|stp)$, # 按文件名正则匹配 options: { coloring-mode: material } }, { bindings: { O: set_camera isometric, Any3: roll_camera -90 } } # 按键 → 命令 ]⚠️ 高频坑高斯泼溅 .ply 显示不对.ply 是通用格式F3D 不会默认按 3DGS 处理补上--point-sprites-size1 --point-spritesgaussian --coloring-modedirect -k或写进配置的 match 块。STEP 文件不认--colorOCCT 插件默认走标量着色追加--coloring-modematerial颜色才生效。无头环境跑不起来文件管理器生成缩略图的沙箱场景用--rendering-backendosmesa或 eglWindows 下命令行执行--version等无窗口命令不显示输出换f3d-console.exe。操作默认键说明旋转视图左键拖动绕焦点旋转相机平移视图中键拖动平行移动相机缩放滚轮 / 右键拖动加 Ctrl 缩放到光标处重置相机Enter回到初始视角截图F12CtrlF12 输出透明背景 适合谁下一步去哪适合需要快速核验 3D 模型结构、不想打开重型 DCC 软件的用户。适合要在脚本或 CI 里批量生成预览图的用户。适合想在产品里嵌入一个 3D 渲染组件的开发者。下一步doc/user/目录从 Quickstart 开始读选项、配置、交互都有专页集成 libf3d 看doc/libf3d/01-OVERVIEW.md构建细节看doc/dev/05-BUILD.md。生态侧VTK 是 F3D 的渲染底座格式读取能力基本都来自 VTK 的 IO 模块和上面那些插件。下次那个几百 MB 的 CAD 文件再出现在收件箱里你只需要一行f3d打开看一眼。【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考