# 高清放大

Upscale 用 ONNX 模型把 Image Empty 的 RGB 放大 4 倍，不创建网格。它支持单图、Movie 和 Image Sequence，并以 Lanczos 独立放大源 Alpha 后重新合并。

## 使用

1. 在 AnyImage 扩展偏好设置中选择 **Default Upscale Model**。
2. 按需要设置 Environment 区的 **Maximum AI Input Size**；默认 `2048 px`，最高 `8192 px`。
3. 选中 Image Empty，在右键 **AnyImage** 菜单中点击 **Upscale**。

菜单项只显示本次操作预计生成的 4× 尺寸。当前图片长边必须小于全局上限；达到上限后 Upscale 会置灰，因此默认设置下单次结果长边小于 `8192 px`。完成后，当前 Empty 会直接使用放大结果；原 Image 没有其他引用时沿用原名并移除旧数据，存在其他引用时则为当前 Empty 保留独立结果。

## 模型选择

- **Real-ESRGAN General WDN x4v3**：默认模型，速度快，细节处理较保守。
- **SAFMN Real x4**：速度与细节较均衡。
- **Real-ESRGAN x4plus**：生成的细节更明显。

后两项可在扩展偏好设置中按需下载。

AnyImage 不追踪高清结果的原图引用，Upscale 始终处理当前 Image。只要当前长边仍小于全局上限，就可以再次放大；达到上限后不能继续执行。

把高清结果继续转换为 Depth Plane 时，颜色材质和分析都以当前 Image 为来源，分析输入仍遵守全局上限；Cutout 同样只缩放裁切后的分析输入，不会把限制后的临时图用作 Color。

如果显存或内存不足，请降低 **Maximum AI Input Size**，或改用 CPU。

分块推理、Alpha 合并与输入限制见 [Upscale 实现原理](../internals/operators/upscale.md)。