96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# ComfyUI-DepthNormalizer
|
||
|
||
A ComfyUI custom node for normalizing depth maps to a specific range (0–230 by default).
|
||
|
||
## 简介
|
||
|
||
ComfyUI-DepthNormalizer 提供了一个自定义节点，用于将深度图按 0–255 灰阶域进行归一化和拉伸，使输出稳定在 0–230（可配置）。
|
||
|
||
**核心功能：**
|
||
- 在 8-bit 域（0-255）中手动设置最小/最大值进行重映射
|
||
- 支持将输出最大值映射到目标值（默认 230）
|
||
- 可选减去最小值，强制黑色为 0
|
||
- 自动处理 ComfyUI IMAGE 格式（0-1 float）与 8-bit 域的转换
|
||
|
||
## 安装方式
|
||
|
||
### 方式一：通过 ComfyUI Manager 安装（推荐）
|
||
|
||
1. 打开 ComfyUI，点击 **Manager** 按钮
|
||
2. 选择 **Install Custom Nodes**
|
||
3. 搜索 "DepthNormalizer" 或输入仓库地址
|
||
4. 点击安装并重启 ComfyUI
|
||
|
||
### 方式二：手动安装
|
||
|
||
```bash
|
||
# 进入 ComfyUI 的 custom_nodes 目录
|
||
cd /path/to/ComfyUI/custom_nodes
|
||
|
||
# 克隆仓库
|
||
git clone https://github.com/vito0131/ComfyUI-DepthNormalizer.git
|
||
|
||
# 重启 ComfyUI
|
||
```
|
||
|
||
## 节点说明
|
||
|
||
### Depth Range → 0–190 (Manual)
|
||
|
||
将深度图按指定的 8-bit 范围进行归一化，输出到目标范围。
|
||
|
||
#### 输入参数
|
||
|
||
| 参数名 | 类型 | 默认值 | 范围 | 说明 |
|
||
|--------|------|--------|------|------|
|
||
| `image` | IMAGE | - | - | 输入深度图（ComfyUI IMAGE 格式，0-1 float） |
|
||
| `min_8bit` | INT | 0 | 0-255 | 输入深度图在 8-bit 域的最小值 |
|
||
| `max_8bit` | INT | 255 | 0-255 | 输入深度图在 8-bit 域的最大值 |
|
||
| `target_max_8bit` | INT | 230 | 1-255 | 输出深度图在 8-bit 域的目标最大值 |
|
||
| `subtract_min` | BOOLEAN | True | - | 是否先减去最小值，使黑色强制为 0 |
|
||
| `clamp_to_target` | BOOLEAN | True | - | 是否将输出限制在目标范围内 |
|
||
|
||
#### 输出
|
||
|
||
| 输出名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| `image` | IMAGE | 归一化后的深度图（ComfyUI IMAGE 格式，0-1 float） |
|
||
|
||
#### 处理逻辑
|
||
|
||
1. 将输入从 0-1 float 转换为 0-255 域：`x255 = image * 255.0`
|
||
2. 根据 `subtract_min` 参数选择重映射方式：
|
||
- 如果为 True：`y255 = (x255 - min) * (target / (max - min))`
|
||
- 如果为 False：`y255 = x255 * (target / max)`
|
||
3. 根据 `clamp_to_target` 进行裁剪：
|
||
- 如果为 True：限制在 `[0, target]`
|
||
- 如果为 False：限制在 `[0, 255]`
|
||
4. 转换回 0-1 float：`output = y255 / 255.0`
|
||
|
||
## 使用示例
|
||
|
||
### 示例：将深度范围 1-117 拉伸到 0-230
|
||
|
||
假设你有一个深度图，其有效深度值在 8-bit 域的范围是 1 到 117，你希望将其拉伸到 0-230 范围：
|
||
|
||
| 参数 | 值 |
|
||
|------|-----|
|
||
| `min_8bit` | 1 |
|
||
| `max_8bit` | 117 |
|
||
| `target_max_8bit` | 230 |
|
||
| `subtract_min` | ✅ True |
|
||
| `clamp_to_target` | ✅ True |
|
||
|
||
**效果：**
|
||
- 输入值 1 将映射到 0
|
||
- 输入值 117 将映射到 230
|
||
- 中间值线性插值
|
||
|
||
## 分类
|
||
|
||
在 ComfyUI 节点树中位于：**Depth/Normalize**
|
||
|
||
## 许可证
|
||
|
||
MIT License
|