DisplayChannel 单色彩通道提取与色彩分量检视节点

节点核心功能 (What is it?)

DisplayChannel 节点通过从输入图像中提取特定色彩通道（红色 Red、绿色 Green、蓝色 Blue 或 Alpha），生成对应的单通道灰阶可视化图像。该节点在底层逻辑上与 DisplayMask 类似，但它开箱默认提取红色通道（Red）而非透明度通道，专门面向图像色彩结构分析、色度分量隔离与基于色彩信息的选区提取。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

提取并分析红、绿、蓝特定颜色通道在画面中的明暗能量分布；
检视各个基色通道在最终合成画面中的贡献占比；
基于色彩分量亮度生成用于局部校色或分色印刷的专用灰度遮罩；
排查三原色通道在过曝或欠曝情况下的阶调截断问题；
专注进行红色分量分析（因其为默认预设）。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在工作流画布中添加 DisplayChannel 节点。
将图像数据源接入 input_image 输入插槽。
从 channel 下拉菜单中选择目标颜色通道（默认已选为 "red"）。
在 output 引脚处提取提取生成的单通道灰度图像工件。

参数输入插槽 (Parameters)

input_image：待提取通道分量的源图像资产。
channel：待提取的通道（默认为 "red"，可选 "red"、"green"、"blue"、"alpha"）。

输出引脚 (Outputs)

output：由所选色彩通道的像素光强映射生成的标准 8 位灰阶图像工件（ImageArtifact）。

典型工作流示例 (Example)

分析暖色调摄影图中的红色高频信息：

使用 LoadImage 导入一张包含夕阳或人像肤色的暖调照片。
将其接入 DisplayChannel 节点的 input_image 参数。
节点开箱默认即刻提取出红色通道的灰度图。
将 output 接入 DisplayImage，可清晰观察到肤色与高光区域呈现纯白，而冷色天空呈现暗黑。
可将该通道作为蒙版引至后续的锐化算子中，专门针对肤色区域执行柔化处理。

通道选项详解 (Channel Options)

red（默认）：提取红色分量，用于隔离肤色、火焰、夕阳与暖色元素；
green：提取绿色分量，用于分析植物叶绿素与自然植被的结构明度；
blue：提取蓝色分量，通常在数码相机传感器中噪点最多，适合用于颗粒感分析与天空隔离；
alpha：提取透明度通道。

与 DisplayMask 节点的核心差异 (Difference from DisplayMask)

两者的核心底层逻辑高度一致，关键区别在于默认提取的通道侧重点不同：

DisplayChannel：默认选择 "red" 通道，设计初衷是加速色彩分析与调色选区流转；
DisplayMask：默认选择 "alpha" 通道，设计初衷是加速抠图去背与透明度遮罩提取。

关键技术特性 (Important Notes)

通道单通道灰阶映射：高数值呈现亮白，低数值呈现深黑。
色彩模式全兼容：全面兼容 RGB、RGBA、单通道灰度（L）及带透明度的灰度（LA）格式。
RGB 图层 Alpha 回退机制：若输入不带透明度的普通 RGB 图像而手动选择了 "alpha"，节点会自动安全回退至红色通道。
无损 PNG 编码导出：保障通道灰阶在传输过程中零失真。

常见问题与排查 (Common Issues)

图像全黑或全白：表明被测画面在当前选定颜色通道上的光强接近 0 或接近饱和 255。
未见数据输出：核验上游输入图像节点是否已正常执行。