ComfyPilotComfyPilot
文档 / 节点说明 / 3D 预览(高级)

3D 预览(高级)

此节点在 UI 中显示 3D 模型预览,而无需将文件保存到 ComfyUI 输出目录。

节点说明 Preview3DAdvanced 更新于 2026-11-12

查看官方原文

3D 预览(高级) - ComfyUI Built-in Node Documentation

此节点在 UI 中显示 3D 模型预览,而无需将文件保存到 ComfyUI 输出目录。

此节点在 UI 中显示 3D 模型预览,而无需将文件保存到 ComfyUI 输出目录。它将模型保存到临时文件,并传递模型数据、模型信息、相机信息和预览尺寸,以供下游进一步处理。

输入

参数说明数据类型是否必需范围
model_3d来自上游 3D 节点的 3D 模型文件。FILE3D是GLB、GLTF、FBX、OBJ、STL、USDZ 或任何支持的 3D 格式
3D 模型信息每个模型在场景中的放置:位置、旋转和缩放(Y 轴向上世界空间)。可选。高级选项。LOAD3DMODELINFO否-
viewport_state包含相机和模型信息的当前视口状态。LOAD3D是-
相机信息视口相机信息:位置、注视目标、缩放和类型。可选。高级选项。LOAD3DCAMERA否-
宽度视口的渲染宽度(像素)。默认值:1024。INT是1到4096
高度视口的渲染高度(像素)。默认值:1024。INT是1到4096

注意:当 camera_info 或 model_3d_info 未连接时,其值会尽可能从 viewport_state 中获取。如果 viewport_state 不包含相机信息,则 camera_info 为 None。如果 viewport_state 没有模型信息,则 model_3d_info 默认为空列表。如果 viewport_state 不是字典,则将其视为空。

输出

输出名称说明数据类型
模型文件来自上游 3D 节点的 3D 模型文件(glb/obj/stl 等),保持不变地传递。FILE3D
相机信息每个模型在场景中的放置:位置、旋转和缩放(Y 轴向上世界空间)。使用输入值,或回退到 viewport_state 中存储的值。LOAD3DMODELINFO
3D 模型信息视口相机信息:位置、注视目标、缩放和类型。使用输入值,或回退到 viewport_state 中存储的值。LOAD3DCAMERA
宽度视口的渲染宽度(像素)。INT
高度视口的渲染高度(像素)。INT
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑

Source fingerprint (SHA-256): f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480