< Previous PageNext Page >

Descriptive Names

Each descriptive name describes what the parameter represents and lists its symbolic name.

2D Command Data

The number of bytes sent using 2D graphics contexts. command2DBytes

2D Context Switches

The total number of context switches to a 2D context on the GPU. context2DSwitchCount

2D Contexts

The total number of 2D contexts in use on the GPU. context2DCount

AGP Data Mapped

The number of bytes that are mapped into the AGP Graphics Address Remapping Table (GART) or equivalent hardware. gartMapInBytes

AGP Data Unmapped

The number of bytes that are unmapped from the AGP Graphics Address Remapping Table (GART) (or equivalent hardware). gartMapOutBytes

Buffer Swaps

The total number of buffer swaps (or blits) that the GPU perform. bufferSwapCount

CPU Texture Page-off Wait (non-DMA)

The amount of time, in nanoseconds, that the CPU waits for the GPU to finish activity. This is the that the CPU could use to modify a texture prior to paging the texture. This metric applies only if the texture must be paged using the CPU and not using direct memory access (DMA). texturePageOffWaitTime

CPU Texture Page-on Wait

The amount of time, in nanoseconds, that the CPU waits for a texture upload command to be completed by the GPU. This is the that the CPU could use for updating and reloading a texture. Typically, there is very little, if any time, spent waiting here. texturePageInWaitTime

CPU Texture Upload Wait (2D context only)

The amount of time, in nanoseconds, that the CPU waits for a texture upload to complete before the buffer can be modified. This particular metric tracks usage only by 2D contexts, and is somewhat obsolete. textureWaitTime

CPU Wait for 2D Operations to Finish

The amount of time, in nanoseconds, that the CPU waits for all 2D commands issued on a single context to complete. finish2DWaitTime

CPU Wait for 2D Swap to Complete

The amount of time, in nanoseconds, that the CPU waits for a previously issued 2D buffer swap to complete. swapComplete2DWaitTime

CPU Wait for DVD Operations to Finish

The amount of time, in nanoseconds, that the CPU waits for all DVD commands issued on a single context to complete. finishDVDWaitTime

CPU Wait for DVD Swap to Complete

The amount of time, in nanoseconds, that the CPU waits for a previously issued DVD buffer swap to complete. swapCompleteDVDWaitTime

CPU Wait for Free 2D Command Buffer

The amount of time, in nanoseconds, that the CPU waits for a 2D command buffer to become available. freeCommandBuffer2DWaitTime

CPU Wait for Free OpenGL Command Buffer

The amount of time, in nanoseconds, that the CPU waits for an OpenGL command buffer to become available. freeCommandBufferGLWaitTime

CPU Wait for Free OpenGL Data Buffer

The amount of time, in nanoseconds, that the CPU waits for an OpenGL data buffer to become available. freeDataBufferGLWaitTime

CPU Wait for Free 2D Context Switch Buffer

The amount of time, in nanoseconds, that the CPU waits for a 2D context-switching buffer to become available. freeContextBuffer2DWaitTime

CPU Wait for Free OpenGL Context Switch Buffer

The amount of time, in nanoseconds, that the CPU waits for an OpenGL context-switching buffer to become available. freeContextBufferGLWaitTime

CPU Wait for Free DVD Context Switch Buffer

The amount of time, in nanoseconds, that the CPU waits for a DVD context-switching buffer to become available. freeContextBufferDVDWaitTime

CPU Wait for GPU

The amount of time, in nanoseconds, that the CPU stalled while waiting on the GPU for any reason. hardwareWaitTime

CPU Wait for Mapped AGP Buffer Removal

The amount of time, in nanoseconds, the CPU waits for the GPU to finish an operation on a buffer that needs to be removed from the Graphics Address Remapping Table (GART). removeFromGARTWaitTime

CPU Wait for OpenGL Swap to Complete

The amount of time, in nanoseconds, that the CPU waits for a previously issued OpenGL buffer swap to complete. swapCompleteGLWaitTime

CPU Wait for Operations to Finish

The amount of time, in nanoseconds, that the CPU waits for all GPU operations to complete and then to be idle. Generally, only the window server waits for this state. finishAll2DWaitTime

CPU Wait for OpenGL Operations to Finish

The amount of time, in nanoseconds, that the CPU waits for all OpenGL commands issued on a single context to complete. This is essentially the time spent in glFinish. finishGLWaitTime

CPU Wait in User Code

The amount of time, in nanoseconds, that the CPU waits while the client (user-level) OpenGL driver waits for a hardware time stamp to arrive (usually for making texture modifications or waiting for a fence to complete). clientGLWaitTime

CPU Wait to perform Surface Read

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU may read from a surface. surfaceReadLockIdleWaitTime

CPU Wait to perform Surface Resize

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU may change the dimensions of a surface. surfaceSetShapeIdleWaitTime

CPU Wait to perform Surface Write

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU may write to a surface. surfaceWriteLockIdleWaitTime

CPU Wait to perform VRAM Surface Page-off

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU can page a surface out of VRAM. surfaceCopyOutWaitTime

CPU Wait to perform VRAM Surface Page-on

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU can page a surface in to VRAM. surfaceCopyInWaitTime

CPU Wait to Submit Commands

The amount of time, in nanoseconds, that the CPU waits before being able to submit a new batch of commands to the GPU. hardwareSubmitWaitTime

Current AGP Memory

The total size, in bytes, of the AGP Graphics Address Remapping Table (GART). gartSizeBytes

Current Free AGP Memory

The total number of free bytes in the AGP Graphics Address Remapping Table (GART). gartFreeBytes

Current Mapped AGP Memory

The total number of bytes mapped into AGP Graphics Address Remapping Table (GART). gartUsedBytes

Current Free Video Memory

The total number of bytes of free VRAM. This parameter is vendor specific and not available for all drivers. vramFreeBytes

Current Largest Free Video Memory Block

The largest free contiguous chunk of VRAM, in bytes. This parameter is vendor specific and not available for all drivers. vramLargestFree

Current Video Memory in Use

The total number of bytes of VRAM in use. This parameter is vendor specific and not available for all drivers. vramUsedBytes

DVD Command Data

The number of bytes sent using DVD contexts. commandDVDBytes

DVD Context Switches

The total number of context switches to a DVD context on the GPU. contextDVDSwitchCount

DVD Contexts

The total number of DVD contexts in use on the GPU. contextDVDCount

Extra OpenGL Data

The number of bytes used for extra OpenGL command traffic (usually vertex data). Not used by all drivers in all modes. dataGLBytes

Last GPU Submission Time

The last submitted time stamp to the GPU, as an absolute time value. submitStamp

Last Read GPU time

The last time stamp read back from the GPU, as an absolute time value. lastReadStamp

OpenGL Command Data

The number of bytes sent using OpenGL contexts. commandGLBytes

OpenGL Contexts

The total number of OpenGL contexts in use on the GPU. contextGLCountcontextGLCount

OpenGL Data Buffers

The total number of extra OpenGL data buffers allocated. dataBufferCount

OpenGL Context Switches

The total number of context switches to an OpenGL context on the GPU. contextGLSwitchCount

Surface Page Off Data (Non-AGP)

The number of bytes transferred due to surface page-off operations. surfacePageOffBytes

Surface Page On Data (Non-AGP)

The number of bytes transferred due to surface page-on operations. surfacePageInBytes

Surfaces

The total number of surfaces allocated by the GPU. surfaceCount

Swap Data

The number of bytes sent by swap commands. swapBytes

Target Minimum Mapped AGP Memory

The minimum amount of data, in bytes, that a driver tries to keep mapped into AGP Graphics Address Remapping Table (GART). gartCacheBytes

Texture Page Off Data (Non-AGP)

The number of bytes transferred for texture page-off operations. Under most conditions, textures are not paged off but are simply thrown away since a backup exists in system memory. Texture page-off traffic usually happens when VRAM pressure forces a page-off of a texture that only has valid data in VRAM, such as a texture created using the function glCopyTexImage, or modified using the functiona glCopyTexSubImage or glTexSubImage. texturePageOutBytes

Texture Page On Data (Non-AGP)

The number of bytes transferred for texture page-ins. Textures mapped using AGP will not show up here. texturePageInBytes

Textures

The total number of kernel textures allocated by the GPU. textureCount

Total Command Data

The number of bytes sent using all graphics contexts (2D, OpenGL, DVD). commandBytes



< Previous PageNext Page >


© 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-12-04)