Home

Awesome

GAPID: Graphics API Debugger

GoDoc <img alt="Linux" src="kokoro/img/linux.png" width="20px" height="20px" hspace="2px"/> Linux Build Status <img alt="MacOS" src="kokoro/img/macos.png" width="20px" height="20px" hspace="2px"/> MacOS Build Status <img alt="Windows" src="kokoro/img/windows.png" width="20px" height="20px" hspace="2px"/> Windows Build Status

Maintenance Mode

GAPID is not currently under active development. Issues filed against this repo might not be answered.

For Android GPU debugging and profiling, please use AGI which is based on GAPID.

Downloads

Download the latest version of GAPID here.

Unstable developer releases are here.

Documentation

User documentation can be found at gapid.dev

The developer documentation contains some hints for GAPID developers. See also the README files under some source directories.

About

GAPID is a collection of tools that allows you to inspect, tweak and replay calls from an application to a graphics driver.

GAPID can trace any Android debuggable application, or if you have root access to the device any application can be traced. GAPID can also trace any desktop Vulkan application.

<table> <tr> <td> <a href="https://gapid.dev/images/screenshots/framebuffer.png"> <img src="https://gapid.dev/images/screenshots/framebuffer_thumb.jpg" alt="Screenshot 1"> </a> </td> <td> <a href="https://gapid.dev/images/screenshots/geometry.png"> <img src="https://gapid.dev/images/screenshots/geometry_thumb.jpg" alt="Screenshot 2"> </a> </td> </tr> <tr> <td> <a href="https://gapid.dev/images/screenshots/textures.png"> <img src="https://gapid.dev/images/screenshots/textures_thumb.jpg" alt="Screenshot 3"> </a> </td> <td> <a href="https://gapid.dev/images/screenshots/shaders.png"> <img src="https://gapid.dev/images/screenshots/shaders_thumb.jpg" alt="Screenshot 4"> </a> </td> </tr> </table>

Building

See Building GAPID.

Running the client

After building GAPID, you can run the client from <gapid-root>/bazel-bin/pkg/gapid.

Command-Line Interface

GAPID exposes most of its functionality via a CLI gapit. You can find auto-generated documentation here.

Project Structure

GAPID consists of the following sub-components:

gapii: Graphics API Interceptor

A layer that sits between the application / game and the GPU driver, recording all the calls and memory accesses.

gapis: Graphics API Server

A process that analyses capture streams reporting incorrect API usage, processes the data for replay on various target devices, and provides an RPC interface to the client.

gapir: Graphics API Replay daemon

A stack-based VM used to playback capture files, imitating the original application’s / game's calls to the GPU driver. Supports read-back of any buffer / framebuffer, and provides profiling functionality.

gapic: Graphics API Client

The frontend user interface application. Provides visual inspection of the capture data, memory, resources, and frame-buffer content.

gapil: Graphics API Language

A new domain specific language to describe a graphics API in its entirety. Combined with our template system to generate huge parts of the interceptor, server and replay systems.