> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MoGePanoramaInference - ComfyUI Built-in Node Documentation

> 此节点对等距柱状全景图（equirectangular panorama）执行深度估计。

此节点对等距柱状全景图（equirectangular panorama）执行深度估计。它将全景图拆分为 12 个透视视图，对每个视图运行 MoGe 深度估计模型，再将各视图的结果合并回一张覆盖完整全景的深度图。每个视图预测的法线和度量尺度会被忽略，因为各视图的尺度在重叠接缝处无法对齐。

## 输入

| Parameter          | Description                                              | Data Type   | Required | Range      |
| ------------------ | -------------------------------------------------------- | ----------- | -------- | ---------- |
| `moge_model`       | 用于推理的 MoGe 模型。                                           | MOGE\_MODEL | 是        |            |
| `image`            | 等距柱状全景图（任意宽高比）。此节点仅接受单张图像；传入一批图像会引发错误。仅使用前 3 个颜色通道（RGB）。 | IMAGE       | 是        |            |
| `resolution_level` | 每个视图的细节程度（0 = 最快，9 = 最详细）（默认：9）。                         | INT         | 是        | 0 到 9      |
| `split_resolution` | 每个透视拆分的分辨率（默认：512）。                                      | INT         | 是        | 256 到 1024 |
| `merge_resolution` | 合并后的等距柱状距离图的长边分辨率（默认：1920）。                              | INT         | 是        | 256 到 8192 |
| `batch_size`       | 每个推理批次的视图数量（共 12 个拆分）（默认：4）。                             | INT         | 是        | 1 到 12     |

**注意：**

* 输入必须是单张图像。如果 `image` 的批次中包含多张图像，此节点会引发错误。
* `merge_resolution` 被视为最大长边尺寸。如果全景图小于该值，则合并后的图会按照全景图的原始尺寸生成，而不会被放大。合并结果在返回前会被缩放回全景图的原始分辨率。

## 输出

| Output Name     | Description                                                              | Data Type      |
| --------------- | ------------------------------------------------------------------------ | -------------- |
| `moge_geometry` | 包含估计几何信息的字典：`points`（3D 点云）、`depth`（深度图）、`mask`（有效区域掩码）以及 `image`（输入图像）。 | MOGE\_GEOMETRY |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MoGePanoramaInference/zh.md)

***

**Source fingerprint (SHA-256):** `d35b6d42a5bb17c184bc56fe3867d3a183017084dc81649c0663a9fba2362770`
