JetBrains Rider 2025.3 Help

Frame Viewer 工具

Frame Viewer 通过允许您在 IDE 中直接检查并分析渲染快照,无需借助 RenderDoc 等外部工具,从而简化了 Shader 调试。

Frame Viewer 工具接口

当在 Frame Viewer 中加载 RenderDoc 快照后,您可以通过集成且直观的 UI 视图来调试绘制调用并探索像素与顶点数据。

限制

Frame Viewer 当前有以下限制:

  • 仅支持 Windows 平台。

  • 仅支持顶点和片段阶段的 Shader 调试。

  • 此工具专为 Unity 项目提供。

启用 Frame Viewer 插件

此功能依赖于 Frame Viewer 插件,该插件随 JetBrains Rider 一起提供并默认启用。 如果相关功能不可用,请确保您未禁用该插件。 有关更多信息,请参见 启用插件设置

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Frame Viewer 插件,并选中插件名称旁的复选框。

Frame Viewer 概述

Frame Viewer 提供了聚焦且分类整理的 UI,用于探索渲染事件及其关联资源和阶段。 主要组件包括:

  • 事件树 :显示具有 ID、阶段(例如 Lighting、后期处理)和调试状态指示器的渲染事件。 提供筛选器,可按名称聚焦自定义 Shader 或在筛选视图之间切换。

  • 纹理预览 :以像素坐标和颜色值的形式提供渲染目标(例如 SceneView RT)的可视化表示。 您可以将鼠标悬停在纹理上,以全分辨率选择特定像素。

  • 顶点预览 :显示与所选渲染事件相关联的顶点数据,可用于在渲染管线中调试变换。

在 Frame Viewer 中打开快照

  1. 在 Rider 中打开您的 Unity 项目。

  2. 如果尚未保存快照,请从 RenderDoc 中保存一个快照。

  3. 点击 Rider 窗口右侧边栏中的 Frame Viewer 图标。

  4. 点击 打开快照 并选择快照文件( *.rdc ),开始检查渲染数据。

若要打开另一个快照,可点击工具栏中的 打开快照 打开快照 ,或关闭当前快照后点击 打开快照 按钮。

JetBrains Rider:关闭 RenderDoc 快照

调试场景

Frame Viewer 支持两种主要调试工作流:像素调试和顶点调试。

像素调试

像素调试允许您调试特定像素的渲染结果,检查其在整个渲染管线中的处理状态。

调试像素

  1. 从事件树中选择一个渲染事件。

  2. 纹理 选项卡中预览对应的纹理。

  3. 在预览中点击一个像素,以便选择进行调试。

  4. 在纹理面板中点击 调试 Pixel 调试 开始调试。

顶点调试

顶点调试允许您检查所选顶点在渲染管线中的变换过程。

调试顶点

  1. 从事件树中选择一个渲染事件。

  2. 打开 顶点 选项卡并识别目标顶点。

  3. 在顶点面板中点击 调试顶点 调试 以调试所选顶点。

调试窗口同步

通过 Frame Viewer 调试 Shader 时, 调试窗口 会显示当前调试会话的 Shader 变量。 该窗口与 事件树 同步,并高亮显示调试开始的具体事件。

最后修改日期: 2025年 12月 5日