排除应用程序性能问题¶

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 应用程序中的性能瓶颈。例如，您可以使用它通过将渲染分布在多个帧上来找出如何提高应用程序的性能。请参阅在多个帧之间分配渲染。
- API 显示 Kanzi 使用的渲染 API，例如 OpenGL ES 或 Vulkan。它还显示显卡标识符和驱动程序版本。
- Frames Per Second 显示每秒渲染的帧数。
- Animation Duration (μs) 以微秒为单位显示执行应用程序中最近一帧的所有动画所需的时间及平均、最高和最低耗时。
- Draw Count 显示执行了多少个单独的绘图调用。
  
  Draw Count 图中的最高值显示最近 500 帧期间的最高批处理数，最低值是最后一帧中的批处理数。
- Triangle Count 显示一帧中绘制的单独三角形的估计总数。
- Pipeline Count 显示最后一帧中绑定新渲染管线的次数。请参阅减少着色器切换。
- Pass Count 显示最后一帧中使用了多少个渲染通道。请参阅渲染最佳实践。
- Memory Upload 显示最后一帧使用了多少字节的滚动暂存内存以及缓冲区总大小。暂存内存包含 Uniform 数据以及用于更新顶点缓冲区或纹理等 GPU 资源的临时存储。在某些平台上，每种类型的数据使用各自独立的缓冲区。
- Dispatch Count 显示最后一帧中使用了多少次计算调度。
- Kanzi Graphics Objects 显示已创建的 Kanzi Graphics 对象的摘要。括号中是最后一帧中创建和删除的对象数量。
- 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 函数获取当前帧率值。
要获取渲染一帧所需的时间，使用 MainLoopScheduler 计时接口 MainLoopScheduler::getLastFrameDuration。