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:

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.

Table 39-1  Display information in the track pane (OpenGL ES Driver instrument)

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.

Figure 39-1  OpenGL ES Driver instrument

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.

Type: How multiple parameters in one track are displayed.

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.