The Performance Analysis Tool user interface is fully customizable and enables you to display information such as framebuffer contents and performance data, in graphical and tabular formats.
Figure 3.1 shows an example of the Performance Analysis Tool user interface using a data file created by an OpenGL ES Emulator. This window shows the result of importing data files and selecting values to be displayed in different panes.
The Performance Analysis Tool user interface contains the following information:
The title bar contains the name of the Performance Analysis Tool project currently displayed, which in this example is
Buttons. Table 3.1 shows the Performance Analysis Tool buttons.
Table 3.1. Performance Analysis Tool buttons Button Use this button to... Create a new project. Open an existing project. Save a project. Import a performance data file. Connect to target Add a framebuffer pane. Add a graph. Add a table. Add an Info pane.
The Performance Counters pane contains a list of available performance variables. The list includes:
Mali200 Performance, Mali200 Bandwidth, and Mali200 Counters are intermediate headers for groups of Mali200 performance variables
MaliGP2 Performance, MaliGP2 Bandwidth, and MaliGP2 Counters are intermediate headers for groups of MaliGP2 performance variables
frame time and frames per second are the names of performance variables that have values that can be displayed.
OpenGL ES API counters
EGL API timing counter.
The Frequency pane displays the frequency (MHz) of the Mali system bus clock, this can be an assumed or simulated frequency.
The Player pane enables you to control the playback of performance data files when you are using offline mode, or to start and stop the application when using online mode. The player controls operate much like the controls of consumer electronics players, such as CD players. The number of the current frame in the performance data file is shown prominently.
When using online mode, you can also use the player to control how your application runs. For example, you can use the pause button to pause the application.
The Framebuffer pane shows the current frame.
The Info display pane shows information about the application being analyzed. You can display information about counters by dragging and dropping performance counters from the Performance counters pane.
The remaining panes display performance data in graphical or tabular form, depending on the data you add to the Performance Analysis Tool window. When you play the performance data file, or start your application, if using online mode, you can see how the performance of the application changes over time.
You can add table or graph panes to the Performance Analysis Tool main window. You can then select individual performance counters from the Performance Counters pane, and drag them to a particular table or graph, to display their values. This flexibility enables you to group related performance counters together. For example, you can create a table to display GLES counters and another one to display EGL counters.
Figure 3.1 shows:
OpenGL ES profiling pane containing graph and performance table
EGL timing information.
After creating a particular set of tables and graphs, and associated performance data, you can save the settings that define the project, as a
.patproject file. You can then use the
.patfile to reload saved projects.
The Hardware counters are only available when the Performance Analysis Tool is connected to a Mali GPU or when a performance data file has been previously dumped by a Performance Analysis Tool connected to a Mali GPU with instrumented drivers.
See Chapter 4 Performance Analysis Tool Data Displays for more information about the Performance Analysis Tool features.