F3D：把「查看 3D 文件」压到一条命令的轻量 3D 查看器

F3D：把「查看 3D 文件」压到一条命令的轻量 3D 查看器

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

F3D 是一个在终端里用一条命令打开 3D 文件的命令行 3D 查看器，面向需要快速检查模型、批量渲染或把 3D 显示能力接进自己工具的工程师与科研人员。它支持 50 余种格式，同一套 C++17 核心对外提供 Python、C、Java、JavaScript 四组绑定。

命令行 3D 查看器：不启动软件先看模型

在文件管理器里双击一个.stl，通常要先等建模软件加载界面、读入几何，再手动调整视角。终端里执行f3d model.stl，窗口直接出图，窗口角落显示当前文件名。左键拖拽绕焦点旋转，Enter一键把相机复位到初始位置——没有菜单栏，没有工程文件，交互逻辑和常见 3D 软件一致。按F1弹出快捷键速查表，关掉后继续操作。

跑通第一条命令

装预编译包最短：从官方下载页取对应平台安装包；需要最新特性或自定义插件时走源码构建（构建细节见构建文档）：

git clone https://gitcode.com/GitHub_Trending/f3/f3d && cd f3d && mkdir build && cd build && cmake .. && cmake --build . -j$(nproc) f3d --list-readers # 列出本次构建实际可用的读取器 f3d --help f3d model.glb --output=result.png # 不弹窗，直接输出静帧

--list-readers的输出因构建配置而异，它是确认格式支持列表的第一手依据。--output指定 PNG 后 F3D 不进交互窗口，这条参数是后文批量用法的基础。

F3D 直接干的 4 件事

检查模型几何→ 默认场景，灰色标准材质加默认光照，适合只关心模型本身；-e叠边线，G键铺开参考网格。

呈现标量场→--coloring-mode=scivis按数据阵列着色，--coloring-array=<name>指定阵列，-b带出色标条，科学数据（.vtu、.vtkhdf、点云等）按 colormap 读出。

播放文件自带动画→ 窗口内W循环切换动画、Space播放；命令行用--animation-indices=0,1指定编号，负值表示全部同时播放。

静帧与批量渲染→--output=out.png出静帧，--no-background输出透明背景，配合 shell 循环即可批量出图。

一条命令导出动画帧序列

触发条件：文件里含动画（.abc、.fbx、.gltf等，具体见格式支持）。核心命令：

f3d model.abc --output=frame_{frame:04}.png --frame-rate=30

输出是frame_0000.png、frame_0001.png一类的 PNG 序列，文件名里的{frame}是模板变量，:04控制零填充到 4 位。坑很具体：输出文件名里不写{frame}时只导出一张静帧，不会自动序列；--frame-rate在这里决定导出的帧数（默认 30），不是视频播放帧率，想只导前一段还要配--animation-time截断时长。若直接要视频文件，--output-video=video.h264一条参数替代整套流程。

作为依赖接入：import libf3d

核心入口是 C++17 的f3d::engine（入口类），Python 侧import f3d后走f3d.Engine.create(True)得到同款对象。最小调用链四步：创建 engine、scene.add加文件、window.render_to_image()取图、Image.save落盘，完整可运行示例见Python 示例。仓库分层：application/是 CLI 壳，library/是跨语言核心 libf3d，plugins/按格式划分读取器可插拔，vtkext/存渲染扩展。类设计细节见libf3d 概述。

工作流里频繁出现「打开一个 3D 文件看一眼」或批量出静帧的需求，F3D 值得装；只打算在编辑器里改模型，它替代不了建模软件。先装上，用一条--output命令出一帧试试。

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