ShaderGraph节点解析(165):预览节点（Preview Node）详解

小李也疯狂

于 2025-07-10 09:57:06 发布

阅读量623

点赞数 7

CC 4.0 BY-SA版权

分类专栏： # ShaderGraph节点详解-UV篇文章标签： Unity ShaderGraph

本文链接：https://blog.csdn.net/qq_40882017/article/details/149225407

ShaderGraph节点详解-UV篇专栏收录该内容

13 篇文章

订阅专栏

场景：在多节点串联的计算中，检查某一步的输出是否正确

4.2 验证节点连接

场景：确认节点之间的连接是否正确，避免 “错连端口” 导致的数据异常

4.3 教学与演示

场景：在讲解 Shader Graph 逻辑时，通过预览节点分步展示数据变化

一、前言

在复杂的 Shader Graph 中，调试中间结果是提升开发效率的关键。Unity Shader Graph 中的预览节点（Preview Node）专为这一需求设计，它能在 Shader 编译和预览过程中，实时显示特定节点的输出值，且不会对输入数据做任何修改 —— 简单来说，它是一个 “透明的观察窗口”，帮助开发者在不干扰整体逻辑的前提下，检查中间计算结果是否符合预期。

无论是定位数据传递错误、验证节点连接是否正确，还是调试复杂的数学运算，预览节点都是不可或缺的辅助工具。本文将详细解析其功能、原理及使用技巧，助力开发者高效调试 Shader Graph。

二、节点基础

2.1 功能概述

预览节点（Preview Node）的核心功能是实时预览输入值，且不修改任何数据。它接收一个动态向量（Dynamic Vector）作为输入，直接将其传递到输出端口，整个过程中输入值保持不变。其唯一作用是在 Shader Graph 编辑器中显示输入数据的预览效果（如颜色、向量值、纹理坐标等），帮助开发者直观了解特定节点的输出状态。

2.2 端口详解

端口名称	方向	类型	描述
In	输入	Dynamic Vector	待预览的动态向量值，支持多种数据类型（如 float、float2、float3、float4 等）
Out	输出	Dynamic Vector	与输入值完全相同的输出，确保数据传递不受影响，可继续连接到后续节点

2.3 生成代码解析

预览节点的底层实现极其简单，仅负责将输入值直接传递到输出，不包含任何修改逻辑。示例代码如下：

hlsl

void Unity_Preview_float4(float4 In, out float4 Out)
{
    Out = In; // 直接传递输入值，无任何修改
}

代码中，In为输入的 float4 类型数据，Out直接赋值为In，清晰体现了 “透明传递” 的特性。
若输入为其他类型（如 float3、float2），生成的代码会自动适配对应的类型（如Unity_Preview_float3），逻辑保持一致。

三、工作原理

预览节点的工作原理可概括为 “数据透传 + 可视化预览”：

数据透传：输入值通过节点时，不经过任何运算或转换，直接从In端口传递到Out端口，确保整个 Shader 的逻辑流程不受干扰 —— 即使移除预览节点，Shader 的最终效果也完全相同。
可视化预览：在 Shader Graph 编辑器中，节点会根据输入值的类型，实时显示对应的预览效果：
- 若输入为颜色（float4），预览窗口会显示该颜色的色块；
- 若输入为向量（如 float2），会显示其数值（如(0.5, 0.8)）；
- 若输入为标量（float），则直接显示具体数值（如0.75）。