> ## 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.

# Canny - ComfyUI Built-in Node Documentation

> Complete documentation for the Canny node in ComfyUI. Learn its inputs, outputs, parameters and usage.

从照片中提取所有边缘线条，就像用笔勾勒照片一样，绘制出物体的轮廓和细节边界。

## 工作原理

想象你是一位艺术家，需要用笔勾勒一张照片。Canny 节点就像一个智能助手，帮助你决定在哪里画线（边缘），在哪里不画。

这个过程类似于筛选工作：

* **高阈值**是“必须画线的标准”：只有非常明显、清晰的轮廓线才会被绘制，例如人物的面部轮廓和建筑框架
* **低阈值**是“绝对不画线的标准”：过于微弱的边缘会被忽略，以避免绘制噪点和无意义的线条
* **中间区域**：介于两个标准之间的边缘，如果与“必须画线”相连，则会一起绘制；如果是孤立的，则不会绘制

最终输出是一张黑白图像，白色部分为检测到的边缘线条，黑色部分为没有边缘的区域。

## 输入

| 参数名   | 功能说明                            | 数据类型  | 输入类型 | 默认值 | 范围        |
| ----- | ------------------------------- | ----- | ---- | --- | --------- |
| `图像`  | 需要进行边缘提取的原始照片                   | IMAGE | 输入   | -   | -         |
| `低阈值` | 低阈值，决定忽略多弱的边缘。值越低保留更多细节，但可能产生噪点 | FLOAT | 控件   | 0.4 | 0.01-0.99 |
| `高阈值` | 高阈值，决定保留多强的边缘。值越高只保留最明显的轮廓线     | FLOAT | 控件   | 0.8 | 0.01-0.99 |

## 输出

| 输出名  | 说明                            | 数据类型  |
| ---- | ----------------------------- | ----- |
| `图像` | 黑白边缘图像，白色线条为检测到的边缘，黑色区域为无边缘部分 | IMAGE |

## 参数对比

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Canny/input.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=b52726f24f334b769b6742dc0af3b7d4" alt="原始图像" width="716" height="716" data-path="images/built-in-nodes/Canny/input.webp" />

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Canny/compare.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=77aaab6e6c62c1d3cdfa11d0fa4deb2d" alt="参数对比" width="1039" height="1331" data-path="images/built-in-nodes/Canny/compare.webp" />

**常见问题：**

* 边缘断裂：尝试降低高阈值
* 噪点过多：提高低阈值
* 缺少重要细节：降低低阈值
* 边缘过于粗糙：检查输入图像质量和分辨率

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