Load3D 三维模型载入与 GLTF 快照渲染节点
节点核心功能 (What is it?)
Load3D 节点是 Griptape Nodes 中用于将三维模型资产引入工作流的基础构件。它专门支持工业标准的 GLTF / GLB 格式，允许创作者从本地磁盘或网络 URL 加载三维模型资产，在画布中进行交互式视口渲染预览，并支持将特定视角的渲染快照提取为二维图像工件供下游管线消费。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 从本地文件系统导入 GLTF / GLB 三维网格与材质模型；
- 将 3D 资产句柄传递给工作流中的其他空间计算或几何处理节点；
- 在工作流画布中内嵌交互式 WebGL 3D 视口，旋转与缩放观察模型；
- 从 3D 模型的特定观察视角抓取渲染屏幕快照（Screenshot），作为下游图像处理或视觉 AI 的输入底图。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 Load3D 节点。
- 通过文件浏览器选择本地 GLTF 文件，或在
gltf参数中输入模型的绝对路径 / 网络 URL，亦可接入上游生成节点的输出引脚。 - 模型加载就绪后可在节点视口中旋转观察。
- 点击界面上的快照保存按钮，即可从
image引脚引出当前视角的渲染图片。
参数输入插槽 (Parameters)
- gltf：待载入的 GLTF 文件路径、网络 URL，或来自上游节点的 3D 工件输出。
输出引脚 (Outputs)
- gltf：加载完成的标准化 GLTF 3D 模型工件（可供下游 3D 算子直接调用）。
- image：三维模型的当前视角二维渲染快照图像工件（在模型加载并触发保存快照后生效）。
关键技术特性 (Important Notes)
- 本地文件浏览集成：点击文件图标可直接从本地磁盘选取
.gltf或.glb文件。 - 快照联动渲染机制：一旦 3D 模型在前端 WebGL 视口中渲染就绪，创作者调整好最佳光影与观察角度后，点击“保存快照”（Save Snapshot）即可瞬间光栅化为无损图片输出。
- 输出条件约束：
image输出插槽只有在用户主动触发了快照保存操作后才会生成具体的图像数据流。
常见问题与排查 (Common Issues)
- 模型未展示 (No Model Showing)：确认提供的 GLTF 文件路径合法有效，且模型网格没有损坏。
- 文件格式不受支持：确保文件符合标准 GLTF 2.0 规范（包含配套的贴图与 bin 缓冲区，或单文件打包的
.glb格式）。 - 图像引脚为空：
image引脚依赖主动触发快照，请确保在前端面板中点击了保存快照操作。