5.2 Trace view

The main window in Graphics Analyzer shows a table of function calls made by your application as it is running. Use this information to examine what your application requested from the graphics system and what the system returned.

Each call has:

  • The time at which it was made.
  • The time at which it finished.
  • The duration of the call in microseconds.

    Important:

    This duration is the time that is spent in the driver for the function call. It is not how much time the GPU spends doing the work that the function call requests.
  • The list of arguments sent to the call.

    Note:

    This list is truncated to save space. For a complete list of the arguments, see 5.5 Function Call view.
  • The value, if any, returned by the underlying system when the function was called.
  • The error code returned by the underlying system when the function was called.
  • The process ID (PID) of the process the function call was made from.
  • The thread ID (TID) of the thread the function call was made from.
  • Any bookmark notes you have added to the function call. See 5.2.1 Add a bookmark to a function call.

Note:

Some columns in this table might initially be hidden. To enable or disable columns, click .

Each call executed in a different EGL context is highlighted using a different color.

The Trace Outline shows a frame-oriented view of the trace. A call to eglSwapBuffers() delimits each frame. Draw calls in a frame are grouped by the framebuffer that is bound at the time they were called. Selecting an item in the overview highlights the corresponding item in the main trace.

You can open documentation for an API call, if available, in a browser by menu-clicking on the call and selecting Open Documentation.

It is possible to select two function calls from the trace using Ctrl+click on Windows or Linux hosts, or Command+click on OS X hosts. Menu-clicking on one of the two selected functions displays a popup menu showing various options including the ability to generate a state difference report, see 4.6 Comparing state between function calls. Alternatively, select two draw calls from the Outline view and use the popup menu to compare the two draw calls instead.

Searching

To find a particular function call, or set of calls, Graphics Analyzer includes a search feature. You can open the search dialog by pressing Ctrl+F with the Trace view selected, or by selecting Edit > Find API call… from the main menu. Type your search string in the search box and Graphics Analyzer highlights matching calls in the trace. Click and to jump between the search results.

To close the search and hide the results, click or press Esc.

By default, the search only looks at the function call name. If you want to search the function call parameters as well, select the Include parameters option. With this option selected, Graphics Analyzer searches the functions exactly as they appear in the Function Call column of this view.

See 5.21 Filtering and searching in Graphics Analyzer for more information.

This section contains the following subsection:
Non-Confidential - RELPDF file icon PDF version101545__00_en
Copyright © 2020–2022, 2024 Arm Limited or its affiliates. All rights reserved.