Skip to content

Latest commit

 

History

History
73 lines (50 loc) · 3.99 KB

usage.md

File metadata and controls

73 lines (50 loc) · 3.99 KB
hide
navigation

Using GITS

This page aims to provide a general overview of how to use gits. For an in-depth look please see the comprehensive documentation section.

GITS Binaries

GITS consists of three parts:

  • Recorder: Libraries used to intercept (and record) API calls into a stream
  • Player: Executable to playback a stream
  • Plugins, Utilities and Tools: Miscalaneus binaries for specialized use cases

You can find all the binaries in the output folders of GITS. After completing the build & install process you will have multiple folders in the installation directory (default location: <gits-root-folder>\<build-folder>\<install-folder>).

The Recorder is split into multiple folders depending on the API you wish to record:

API Windows Unix
:material-microsoft: DirectX12 FilesToCopyDirectX ---
:simple-intel: LevelZero FilesToCopyL0 LevelZero
:simple-opengl: OpenGL FilesToCopyOGL OpenGL
:simple-opengl: OpenGL ES FilesToCopyES OpenGL
:simple-opengl: OpenCL FilesToCopyOCL OpenCL
:simple-vulkan: Vulkan FilesToCopyVulkan Vulkan
:simple-vulkan: Vulkan Layer VulkanLayer VulkanLayer

Record

To record the API-calls from an application you first need to identify the correct folder for your endeavor by choosen the right API and OS and use it in the recording process.

  • On Windows, this is typically done by copying a DLL into the app directory.
  • On Linux, by manipulating loader environment variables.
  • When recording Vulkan, it is also possible to use GITS as a Vulkan layer instead. This method works on both OSs.

Once the files are in place you simply start the application normally while GITS initiates the recording. For information on how to adjust parameters of the recording please see the configuration section.

Playback

To playback a binary stream you can use the commandline to run gitsPlayer with the arguments as needed.

gitsPlayer BasicSample_7016_24_06_13_16_57_00.297

Use player's --help option to see basic usage info, or --hh all to list all available options.

Here are some of the most commonly used arguments:

Argument Windows
--help Basic usage info
--hh all List all available options
--stats Show stream statistics
--captureFrames Dump rendered frames to disk
--captureFrames 23,420-450:10 Dump rendered frames #23, #420, #430, #440, #450 to disk
--captureDraws Dump rendered draw calls to disk

For information on how to adjust parameters of the playback please see the configuration section.

Configuration

Aside from various binaries there's also the pre-configured gits_config.yml inside the folder containing all default values. This file is used by both gitsRecorder as well as gitsPlayer and exposes all the dials and knobs the respective application offers. As YAML files are hierarchically structured finding the values/settings you need to customize should not be too dificult.

✍️ TODO
Talk about the most important settings

Further Information

You can find further information about the configuration file in the documentation section.