Usage:¶

gfxrecon-replay

[-h | --help] [--version] [--gpu <index>] [--pause-frame <N>] [--paused] [--sync] [--screenshot-all] [--screenshots <N1(-N2),...>] [--screenshot-format <format>] [--screenshot-dir <dir>] [--screenshot-prefix <file-prefix>] [--sfa | --skip-failed-allocations] [--replace-shaders <dir>] [--opcd | --omit-pipeline-cache-data] [--wsi <platform>] [--surface-index <N>] [--remove-unsupported] [-m <mode> | --memory-translation <mode>] <file>

Required arguments:¶

<file>

Path to the capture file to replay.

Optional arguments:¶

-h

Print usage information and exit (same as --help).

--version

Print version information and exit.

--gpu <index>

Use the specified device for replay, where index is the zero-based index to the array of physical devices returned by vkEnumeratePhysicalDevices. Replay may fail if the specified device is not compatible with the original capture devices.

--pause-frame <N>

Pause after replaying frame number N.

--paused

Pause after replaying the first frame (same as --pause-frame 1).

--screenshot-all

Generate screenshots for all frames. When this option is specified, --screenshots is ignored.

--screenshots <N1[-N2][,...]>

Generate screenshots for the specified frames. Target frames are specified as a comma separated list of frame ranges. A frame range can be specified as a single value, to specify a single frame, or as two hyphenated values, to specify the first and last frames to process. Frame ranges should be specified in ascending order and cannot overlap. Note that frame numbering is 1-based (i.e. the first frame is frame 1). Example: 200,301-305 will generate six screenshots.

--screenshot-format <format>

Image file format to use for screenshot generation. Available formats are:

bmp

Bitmap file format. This is the default format.

--screenshot-dir <dir>

Directory to write screenshots. Default is the current working directory.

--screenshot-prefix <file-prefix>

Prefix to apply to the screenshot file name. Default is "screenshot", producing file names similar to "screenshot_frame8049.bmp".

--sfa

Skip vkAllocateMemory, vkAllocateCommandBuffers, and vkAllocateDescriptorSets calls that failed during capture (same as --skip-failed-allocations).

--replace-shaders <dir> Replace the shader code in each CreateShaderModule

with the contents of the file <dir>/sh<handle_id> if found, where <handle_id> is the handle id of the CreateShaderModule call. See gfxrecon-extract.

--opcd

Omit pipeline cache data from calls to vkCreatePipelineCache and skip calls to vkGetPipelineCacheData (same as --omit-pipeline-cache-data).

--wsi <platform>

Force replay to use the specified wsi platform. Available platforms are: auto,xlib,xcb,wayland

--surface-index <N>

Restrict rendering to the Nth surface object created. Used with captures that include multiple surfaces. Default is -1 (render to all surfaces).

--sync

Synchronize after each queue submission with vkQueueWaitIdle.

--remove-unsupported

Remove unsupported extensions and features from instance and device creation parameters.

-m <mode>

Enable memory translation for replay on GPUs with memory types that are not compatible with the capture GPU's memory types. Available modes are:

none

No memory translation is performed. This is the default behavior.

remap

Attempt to map capture memory types to compatible replay memory types, without altering memory allocation behavior.

realign

Adjust memory allocation sizes and resource binding offsets based on replay memory properties.

rebind

Change memory allocation behavior based on resource usage and replay memory properties. Resources may be bound to different allocations with different offsets. Uses VMA to manage allocations and suballocations.

GFXReconstruct Version 0.9.4-unknown (unknown-build-source) Vulkan Header Version 1.2.162