F3D 3D 查看器实用指南从秒开模型到批量生成预览图【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3dF3D 是一款开源、快速且极简的 3D 查看器把 glTF、STL、STEP 这类文件丢进终端几秒内就能渲染出窗口。它最核心的价值是「一切皆可脚本化」——单模型检查、批量出图、动画录制、CI 流水线全部靠命令行驱动不需要依赖图形界面。无论是游戏资产、机械零件还是科学数据一个轻量 3D 查看器很容易变成天天用的工具。快速上手官方提供三个平台的发布包装完终端里就能直接用f3d命令用包管理器的话macOS 上brew install f3d、Windows 上winget install f3d都能一步到位。需要自己编译时从源码仓库拉取再走标准 CMake 流程即可git clone https://gitcode.com/GitHub_Trending/f3/f3d装好后跑通第一条命令只需一行f3d /path/to/model.glb f3d /path/to/model.glb --outputpreview.png第二条命令把渲染结果存成图片这是后面所有自动化玩法的基础。窗口打开后按F1弹出按键速查表G切换网格Space播放动画。完整的交互和快捷键见 快速入门文档。F3D 打开的不只是模型图片文件本身也是受支持的格式纹理可以直接开起来检查仓库自带的棋盘格纹理f3d resources/checkerboard.png即可打开查看 核心工作流交付前检查单个模型打印或交付前看一眼法向、比例和朝向网格和坐标轴是最直观的两把尺子f3d model.stl --grid --axis f3d model.stl --outputpreview.png --resolution1024,1024 --grid--grid铺出参考网格判断比例--axis显示坐标轴判断朝向--resolution用逗号分隔宽、高出图分辨率和窗口是同一个参数。批量生成模型预览图给资产目录出一批缩略图一个 for 循环就够了for f in assets/*.glb; do f3d $f --outputthumbs/$(basename ${f%.glb}).png --resolution512,512 done有个容易踩的坑--output只在文件首次加载时生效所以必须一个文件一次f3d进程不能指望在交互窗口里切文件后自动续存。播放与录制动画带动画的文件glTF、FBX、Alembic 等可以直接出视频-1表示把所有动画一次放完f3d animated.glb --animation-indices-1 --output-videoanim.mp4交互模式下习惯用W键切换动画条目、Space播放选到合适的片段再用上面的命令离线录制画质比屏幕抓取干净得多。 进阶能力HDRI 环境光照默认渲染偏平挂一个 HDRI 环境后反射和背景立刻有真实感。F3D 内置了默认环境也可以指定自己的.hdr文件f3d car.glb --hdri-filecustom.hdr f3d car.glb --hdri-ambient--hdri-ambient表示只用环境光、不显示天空盒适合需要干净背景的产品预览。下面就是内置默认 HDRI 的预览图内置默认 HDRI 环境贴图的预览按格式定制的 JSON 配置文件不想每次手敲参数就把默认值写进配置文件。F3D 的配置是一个 JSON 块数组每块可以带match规则按文件名匹配出不同的默认值命令行参数始终覆盖配置[ { options: { background-color: 0.1,0.1,0.1, edges: true } }, { match: .*gl(tf|b), options: { hdri-skybox: enabled } } ]f3d model.glb --configmy_f3d.json反过来如果某条配置必须压过命令行在选项名前加!即可。格式与插件的完整对应关系见 支持的文件格式。融入日常把它接进 CI每次提交自动生成预览图再验证一下管道输入。下面两条命令分别演示「出图到文件」和「stdin 读、stdout 写」的管道形态f3d scene.glb --outputci/preview.png --resolution1920,1080 f3d - --force-readerSTL --output- model.stl ci/from_pipe.png第二条命令里文件名用-表示从标准输入读模型--force-reader指定用哪个 reader 解析图片写回 stdout 就能接display、ffmpeg或任何下游工具。录视频也一样--output-video- | ffmpeg -f h264 -i - out.mp4即可合成。速查参考参数作用--outputfile.png渲染存图仅首次加载生效--resolutionw,h设置窗口与出图分辨率--output-videofile.mp4录制动画视频-走 stdout--grid/--axis/--edges切换网格、坐标轴、边线显示--hdri-file.hdr/--hdri-ambientHDRI 环境贴图 / 仅用环境光不显示天空盒--animation-indicesn选择播放的动画-1播放全部--configfile.json加载 JSON 配置文件--list-readers列出当前构建可用的 reader--force-readerreader强制指定 reader管道输入时必需-D/--define向 reader 传参如-DSTEP.linear_deflection0.05下一步可以做的事打开一个手头模型按F1过一遍按键速查表跑一次f3d --list-readers确认当前构建带了哪些插件和格式写一个两块的 JSON 配置固定住默认背景色和边线显示。【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考