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

# CameraAngle - ComfyUI Built-in Node Documentation

> 此节点选择围绕主体的相机角度，并将该选择转换为两项内容：可供 3D 节点渲染的 camerainfo 结构，以及可粘贴到提示词中的通俗英文镜头描述。

此节点选择围绕主体的相机角度，并将该选择转换为两项内容：可供 3D 节点渲染的 `camera_info` 结构，以及可粘贴到提示词中的通俗英文镜头描述。主体位于场景原点，下游 3D 节点会在此处将模型居中，因此你在这里选择的角度与预览一致。

可在生成前用它来为渲染取景，或为图像或视频模型描述视角，例如 `front view eye-level shot medium shot`。节点中的 3D 预览会显示生成的相机位置。

## 输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `horizontal_angle` | 围绕主体的方位角，单位为度：0 为正面，90 为右侧，180 为背面。（默认值：0） | INT | 是 | 0 到 360 |
| `vertical_angle` | 仰角，单位为度。负值表示从下往上看，正值表示从上往下看。（默认值：0） | INT | 是 | -30 到 60 |
| `zoom` | 对主体的镜头变焦：0 为广角镜头，10 为特写。该值也会传入 `camera_info.zoom`。（默认值：5.0） | FLOAT | 是 | 0.0 到 10.0 （步长：0.1） |
| `image` | 可选参考图像，显示在 3D 预览中主体立方体的正面。 | IMAGE | 否 | - |

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `camera_info` | 用于 3D 节点的相机信息：位置、注视目标、缩放因子、相机类型和视场角。相机保持固定的 35 度视场角，并放置在距目标 6 个单位处。 | LOAD3DCAMERA |
| `prompt` | 根据角度、仰角和距离生成的简短镜头描述，例如 `front view eye-level shot medium shot`。 | STRING |

## 镜头描述术语

`prompt` 输出会从下列每组中组合一个术语。数值会先被限制到控件范围内。

* 水平角度被划分为八个 45 度扇区：`front view`、`front-right quarter view`、`right side view`、`back-right quarter view`、`back view`、`back-left quarter view`、`left side view`、`front-left quarter view`。
* 垂直角度在低于 -15 度时变为 `low-angle shot`，低于 15 度时变为 `eye-level shot`，低于 45 度时变为 `elevated shot`，45 度及以上时变为 `high-angle shot`。
* 变焦在低于 2 时变为 `wide shot`，低于 6 时变为 `medium shot`，6 或以上时变为 `close-up`。

`camera_info.zoom` 因子会将控件值缩放映射到 1.0 至 1.875，因此 `zoom` 为 0 时得到 1.0，`zoom` 为 10 时得到 1.875。

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

***

**Source fingerprint (SHA-256):** `8ed2cd186bc6ca02dbc8da006b2e9156245ef691a2257f286f6e32ffa480fd5d`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.