# 高清放大

Upscale 用 ONNX 模型把 Image Empty 的图片放大 4 倍，不创建网格。它支持单图、Movie 和 Image Sequence，并保留源 Alpha。

## 使用

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

输入长边超过全局上限时，会先保持宽高比缩小，再执行 4× 放大。因此默认设置下结果长边最多为 `8192 px`。完成后，当前 Empty 会改用名称以 `_upscale.png` 结尾的结果图片。

## 模型选择

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

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

对高清结果再次执行 Upscale 时，AnyImage 会从最初的原图重新生成并替换当前结果，不会连续放大已有高清图。

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

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

分块推理、Alpha 合并与原图引用见 [Upscale 实现原理](../internals/operators/upscale.md)。