OpenGL ES Driver Instrument
The OpenGL ES Driver instrument captures information about OpenGL ES statistics. It can record information from a single process only.
The OpenGL ES Driver instrument is associated with the following tasks:
“Measuring OpenGL Activity with the OpenGL ES Analysis Trace Template” in Instruments User Guide
“Finding Bottlenecks with the OpenGL ES Driver Trace Template” in Instruments User Guide
Platforms | iOS X |
Locations | OpenGL ES Analysis template OpenGL ES Driver template Library pane (only appears when an iOS device is connected) |
Displayed Information
The OpenGL Driver instrument displays the recorded information in the track pane and the Detail pane.
Track Pane
The track pane displays the following information shown in Table 39-1, based on the instrument’s configuration.
Display name | Definition |
|---|---|
CommandBufferRenderCount | The number of render actions sent to the command buffer. |
CommandBufferSubmitCount | The number of submit actions sent to the command buffer. |
CommandBufferTransferCount | The number of transfers processed by the command buffer. |
commandGLBytesPerSample | The number of GL bytes used during the sample time. |
contextGLCount | The number of OpenGL contexts that are currently being used. |
Device Utilization % | The percentage of the device that is being utilized. |
finishGLWaitTime | The amount of time, in nanoseconds, that the CPU waits for all OpenGL commands issued on a single context to complete. |
gartMapOutBytesPerSample | The number of bytes that are unmapped from the AGP graphics address remapping table during the sample period. |
gartSizeBytes | The total size, in bytes, of the AGP graphics address remapping table. |
gartUsedBytes | The total number of bytes mapped into the AGP graphics address remapping table. |
hardwareWaitTime | The amount of time, in nanoseconds, that the CPU stalled while waiting on the GPU for any reason. |
recoveryCount | The total number of recovery actions performed. |
Rendered Utilization % | The percentage of the render that is being used. |
SplitSceneCount | The number of split scenes being displayed. |
textureCount | The number of textures being displayed. |
TiledSceneBytes | The number of bytes being used by the tiler. |
Tiler Utilization % | The percentage of the tiler that is being used. |
CoreAnimationFramesPerSecond | The number frames rendered per second. |
Detail Pane
The Detail pane displays information in the Table based on the instrument’s configuration. Each statistic selected will be a column in the Table.
Figure 39-1 shows the OpenGL ES Driver instrument recording information from an app.
Configuration Options
You can configure how information is displayed in the track pane through the configuration dialog. Click the inspector icon to bring up the configuration dialog. Customize the following display options.
Target: Choose a target for this instrument. Available only if you choose Instrument Specific from the Target pop-up menu in the toolbar.
Track Display: Controls how information is displayed in the track pane, grouped by style, type, and zoom.
Style: How information is presented.
Line Graph: All points of information are connected by a line.
Filled Line Graph: All points of information are connect by a line. The area under the line is filled by the statistic’s designated color.
Point Graph: Information is represented by the statistic’s designated shape.
Block Graph: Information is presented as a horizontal line until the information changes. The area under the line is filled by the statistic’s designated color.
Type: How multiple parameters in one track are displayed.
Stacked: Each statistic has its own graph.
Overlay: All information is contained in one graph.
Zoom: The height of the data collection graph.
Statistics to Observe: Select a statistic to see it graphed in the track pane. Click the shape or the color well to change how a statistic is represented. Click Configure to see the back configuration page.
Select statistics to list: Select the statistics to be displayed on the front of the configuration page.
© 2013 Apple Inc. All Rights Reserved. (Last updated: 2013-04-23)