排除应用程序性能问题¶

Kanzi 提供了不同的方法来测量应用程序的性能，并显示各种性能参数。使用这些方法和参数来提高应用程序的性能。

在 Kanzi Studio 中查看应用程序性能¶

../../_images/select-performance-hud.png

要在 Kanzi Studio 中分析应用程序的性能和内部结构，在 Preview 中单击 analyze-off 以进入 Analyze 模式，右键单击分析开启，然后选择：

Performance HUD 显示了您的 Kanzi 应用程序在最近 500 帧中的整体性能指标，包括：
- Frame Duration (ms) 显示渲染最后一帧所用的时间（以毫秒为单位），以及平均、最高和最低时间。
  
  Frame Duration (ms) 图中的顶部值显示了渲染最后 500 帧中最长的一帧所用的时间，底部值显示了平均渲染一帧所用的时间。
  
  使用此信息来识别您的 Kanzi 应用程序中的性能瓶颈。例如，您可以使用它通过将渲染分布在多个帧上来找出如何提高应用程序的性能。请参阅在多个帧之间分配渲染。
- Frames Per Second 显示每秒渲染的帧数。
- Animation Duration (μs) 以微秒为单位显示执行应用程序中最近一帧的所有动画所需的时间及平均、最高和最低耗时。
- Batch Count 显示了执行了多少个单独的绘制调用（glDrawElements 和 glDrawArrays）。
  
  您可以通过调用 Renderer::getBatchCount 使用 Kanzi Engine API 访问批处理计数。
  
  Batch Count 图中的顶部值显示了在最近 500 帧中批次的最高数量，底部值显示了最后一帧中的批次数量。
- Triangle Count 显示在一帧中总共绘制了多少个独立的三角形。
  
  您可以通过调用 Renderer::getTriangleCount 在 Kanzi Engine API 中访问三角形计数。
- Texture Switches 显示了新纹理绑定到 GPU 的次数。
  
  您可以通过调用 Renderer::getTextureSwitchCount 在 Kanzi Engine API 中访问纹理切换计数。
- FBO Switches 显示绑定到 GPU 的帧缓冲对象的数量。请参阅渲染最佳实践。
  
  您可以通过调用 Renderer::getFramebufferSwitchCount 在 Kanzi Engine API 中访问缓冲区切换计数。
- Shader 显示了为新应用的批次绑定新着色器的次数以及为上一帧发送的单个着色器统一变量的数量。请参阅减少着色器切换。
  
  您可以通过调用 Renderer::getShaderSwitchCount 在 Kanzi Engine API 中访问着色器切换计数。
  
  您可以通过调用 Renderer::getUniformSendCount 来访问在 Kanzi Engine API 中发送的 uniforms。
- Buffer Switches 显示了绑定到 GPU 的顶点、索引和统一缓冲区对象的数量。
  
  您可以通过调用 Renderer::getBufferSwitchCount 在 Kanzi Engine API 中访问缓冲区切换计数。
- Buffer and Texture Data Updates 显示了新的顶点缓冲区或纹理数据上传到 GPU 的次数。如果同一个缓冲区被用于写入和读取操作，这些繁重的操作可能会导致 GPU 执行延迟。理想值是 0。
  
  例如，当文本字形缓存需要频繁更新时，该值可能会增加。在这种情况下，要减少字形缓存更新，请降低 Text Block 节点中 Font Size 属性的值。
  
  您可以通过调用 Renderer::getHeavyweightCallCount 在 Kanzi Engine API 中访问此内容。
- View Camera 显示用于在您的应用程序中显示场景的 Camera 节点的名称。
- Resource Memory Use 显示您的 Kanzi 应用程序使用的本地 GPU 内存 (VRAM) 和非本地 GPU 内存 (RAM) 的估计量。
  
  Performance HUD 在 Kanzi Studio Preview 中显示的值与您在目标设备上运行 Kanzi 应用程序时的值不同，因为 Kanzi Studio 会加载并在内存中保留应用程序中的所有资源。
- Timers 显示 MainLoopScheduler 中已注册的计时器处理程序的数量。计时器处理程序过多可能会降低应用程序的性能。请参阅添加计时器。
  
  您可以通过调用 MainLoopScheduler::getTimersCount 在 Kanzi Engine API 中访问计时器订阅的数量。
- Recurring Tasks 显示添加到主循环调度器各阶段的任务总数。Kanzi Engine 默认会添加一些任务。请参阅添加重复任务。
  
  您可以通过调用 MainLoopScheduler::getTasksTotalCount 在 Kanzi Engine API 中访问重复任务的数量。
- Animations 显示了您的 Kanzi 应用程序中活动动画和所有动画的数量。
  
  您可以在 Kanzi Engine API 中访问动画的数量：
  - 要获取活动动画的数量，使用 TimelineClock::getActiveTimelinePlaybackCount。
  - 要获取所有动画的数量，请使用 TimelineClock::getTimelinePlaybackCount。
Framebuffer objects 用半透明的黄色移动条纹标记节点，这些节点被渲染到纹理中并导致帧缓冲对象切换。
Transparency 用半透明的蓝色移动条纹标记透明节点。请参阅配置节点以实现高效渲染。
Overdraw 可视化表示 Kanzi 多次渲染到同一像素的区域。较浅的绿色表示较高的过度绘制量。

请参阅使用 Sorting Filter 防止过度绘制。。

查看整体性能¶

要查看您的 Kanzi 应用程序的整体性能：

在 Kanzi Studio Preview 中，点击，并在上下文菜单中启用 Performance HUD。
在 application.cfg 中，启用完整 Performance HUD 的显示：
```
PerformanceInfoLevel = 2
```
请参阅 PerformanceInfoLevel。
在 Application::onConfigure 函数中启用应用程序代码中 Performance HUD 的显示。
```
configuration.performanceInfoLevel = ApplicationProperties::PerformanceInfoLevelFull;
```
请参阅 PerformanceInfoLevel。

在 application.hpp 中，通过调用 Application::getPerformanceInfoLevel 和 Application::setPerformanceInfoLevel 函数启用 Performance HUD 的显示：

ApplicationProperties::PerformanceInfoLevel getPerformanceInfoLevel() const
{
    return m_applicationProperties.performanceInfoLevel;
}
void setPerformanceInfoLevel(ApplicationProperties::PerformanceInfoLevel level)
{
    m_applicationProperties.performanceInfoLevel = level;
}

要将帧率值写入日志文件，您可以通过在 application.hpp 中调用 Application::getFramesPerSecond 函数，从 Kanzi Engine 中检索当前帧率值。您可以通过调用 Application::getEngine 从应用程序中检索 Kanzi Engine。
要获取渲染一帧所需的时间，使用 MainLoopScheduler 计时接口 MainLoopScheduler::getLastFrameDuration。