JetBrains Rider 2026.1 Help

Frame Viewer 工具

Frame Viewer 通过允许您在 IDE 中直接检查和分析渲染快照,无需使用诸如 RenderDoc 等外部工具,从而简化了着色器调试。

Frame Viewer 工具界面

当在 Frame Viewer 中加载 RenderDoc 快照时,您可以通过集成且直观的 UI 在聚焦的渲染事件视图中导航,以调试绘制调用并探索像素和顶点数据。

限制

Frame Viewer 目前存在以下限制:

  • 仅适用于 Windows。

  • 仅支持顶点和片段阶段的着色器调试。

  • 该工具仅适用于 Unity 项目。

启用 Frame Viewer 插件

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

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

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

Frame Viewer 概述

Frame Viewer 提供一个聚焦且按类别组织的 UI,用于探索渲染事件及其相关资源与阶段。 关键组件包括:

  • 事件树 :显示带有 ID 、阶段(例如,光照、后期处理)以及调试状态指示器的渲染事件。 可使用筛选器聚焦自定义着色器(根据其名称),或在筛选后的视图之间切换。

  • 纹理预览 :提供渲染目标(例如 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 调试着色器时, 调试窗口 会显示当前调试会话的着色器变量。 它与 事件树 同步,并高亮显示开始调试的特定事件。

2026年 3月 31日