
stable-diffusion-webui-depthmap-script
一键生成高分辨率深度图,让SD图像更有空间感。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1856
技术标签
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 已安装并可正常运行 AUTOMATIC1111 的 Stable Diffusion WebUI
- Python 环境(随 WebUI 一并安装)
- 建议有 GPU;显存不足时可用 CPU 计算深度图
安装与启动步骤
-
1准备 SD WebUI
本扩展是 AUTOMATIC1111 Stable Diffusion WebUI 的插件,需先装好 WebUI 并确认能正常启动。
-
2安装扩展
把仓库克隆到 WebUI 的 extensions 目录下即可(README 的安装章节为空,未给出具体安装命令)。
git clone https://github.com/thygate/stable-diffusion-webui-depthmap-script.git -
3重启 WebUI
重新启动 WebUI,让扩展被自动加载,之后界面会多出 DepthMap 脚本与 Depth 标签页。
-
4选择 DepthMap
在 txt2img 或 img2img 的 script 选择框里选 DepthMap;处理已有图片则去 Depth 标签页。
-
5生成深度图
在 Model 下拉框选模型(res101、midas 系列、ZoeDepth 系列),可开启 Boost、Match input size 后生成。
-
6查看与保存
勾选 Show DepthMap 才能在网页里看到结果;Save DepthMap 会始终把深度图保存到输出目录。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
Maximum wholesize for boost | 否 | 对应 BoostingMonocularDepth 的 r_max,直接决定 Boost 时可能占用的最大显存 | 1600 |
如何确认成功
启动 WebUI 后,txt2img 的 script 下拉框中出现 DepthMap,或顶部出现 Depth 标签页,即加载成功。
常见问题
Q:开启 Boost 时显存不足怎么办?
A:在 WebUI 设置页调低 Maximum wholesize for boost,或把 Compute on 改为 CPU。默认值已从论文的 3000 降到 1600 以便 8GB 显存可用。
Q:生成后界面看不到深度图?
A:需要勾选 Show DepthMap 才会在页面显示;批量 img2img 时同样要勾选该选项。
Q:为什么生成特别慢?
A:Boost 使用多分辨率合并,计算时间显著增加但效果更好,配 res101 模型效果最佳;生成 3D inpainted 网格则可能从几分钟到一小时。
Q:深度图保存成什么格式?
A:保存为 PNG 时是 16 位单通道;保存成其他格式一律是 8 位三通道 RGB。文件名默认带 _depth 后缀。
注意事项
- 所有立体图(stereo / anaglyph)生成都在 CPU 上完成,速度受 CPU 影响。
- Generate 3D inpainted mesh 只在 Depth 标签页可用,生成的 ply 网格和演示视频保存在 extras 目录,视频只能由该扩展生成的网格渲染。
- 仓库 README 的 Install instructions 章节为空,以上安装方式为通用做法,具体以官方 wiki 为准。
核心亮点
- 深度图分辨率远高于SD WebUI默认输出,细节更丰富。
- 集成多种深度估计模型,用户可根据场景灵活选择。
- 与ControlNet无缝衔接,可提升图像生成的结构一致性。
不足之处
- 依赖特定模型权重,首次使用需额外下载,增加部署成本。
- 文档和社区支持相对有限,高级用法需自行摸索。
适用场景
- 为SD生成图像添加精确深度信息,用于3D建模或立体显示。
- 配合ControlNet进行结构引导的图像生成,如室内设计、建筑可视化。
- 用于图像编辑中的前景背景分离或景深效果增强。
替代项目
Stable Diffusion WebUI ControlNet、MiDaS、ZoeDepth
同类项目推荐
samila
开源
输入数学函数,一键生成独特艺术图案
A Generative Art Generator
sd.cpp.gui.wx
开源
用 C++ 原生界面,轻松跑通 Stable Diffusion 出图
Stable Diffusion GUI written in C++
ComfyUI-CharacterCardStudio
开源
一键出角色三视图,自动切片拼成角色卡
ComfyUI custom node: one-click character reference sheet (character card) generation···
cyclegan-qp
开源
用二次势能约束,让艺术风格迁移更保真
Official PyTorch implementation of "Artist Style Transfer Via Quadratic Potential"
stable-diffusion-xl-demo
开源
一键启动SDXL图形界面,支持多GPU和精炼器,快速出图
A gradio web UI demo for Stable Diffusion XL 1.0, with refiner and MultiGPU support
DemoFusion
开源
用低显存生成高分辨率图像,细节更丰富
Let us democratise high-resolution generation! (CVPR 2024)
animatediff-cli
开源
命令行一键生成 Stable Diffusion 动画,无需写代码。
a CLI utility/library for AnimateDiff stable diffusion generation
SDEdit
开源
涂鸦秒变高清图,用随机微分方程实现可控图像编辑
PyTorch implementation for SDEdit: Image Synthesis and Editing with Stochastic Diffe···
lightcraft
开源
纯Rust写的非破坏RAW修图,原图永不改
LightCraft: An open-source non-destructive photo editor written by scratch in pure R···