JetBrains Rider 2025.2 Help

帧查看器工具

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

帧查看器工具界面

在帧查看器中加载 RenderDoc 快照后,您可以调试绘制调用,并通过集成直观的 UI 浏览渲染事件的聚焦视图,探索像素和顶点数据。

限制

帧查看器当前存在以下限制:

  • 仅支持 Windows。

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

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

启用 Frame Viewer 插件

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

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

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

帧查看器概览

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

  • 事件树 :显示包含 ID、阶段(如 Lighting、后处理)以及调试状态指示器的渲染事件。 可使用筛选器聚焦于自定义着色器(基于名称)或在筛选视图之间切换。

  • 纹理预览 :以可视化方式呈现渲染目标(如 SceneView RT),包含像素坐标和颜色值。 您可以将鼠标悬停在纹理上,以原始分辨率选择特定像素。

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

在帧查看器中打开快照

  1. 在 Rider 中打开 Unity 项目。

  2. 如果尚未保存,请在 RenderDoc 中保存快照。

  3. 点击 Rider 窗口右侧边栏中的帧查看器图标。

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

如需打开其他快照,请点击工具栏上的 打开快照 打开快照 ,或先关闭当前快照,再点击 打开快照 按钮。

JetBrains Rider:关闭 RenderDoc 快照

调试场景

帧查看器支持两种主要调试工作流:像素调试和顶点调试。

像素调试

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

调试像素

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

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

  3. 点击预览中的像素以选择用于调试的像素。

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

顶点调试

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

调试顶点

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

  2. 打开 顶点 选项卡,并确认目标顶点。

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

调试窗口同步

通过帧查看器调试着色器时, 调试窗口 显示当前调试会话中的着色器变量。 它与 事件树 同步,突出显示开始调试的特定事件。

最后修改日期: 2025年 9月 26日