NAME¶

SYNOPSIS¶

DESCRIPTION¶

Remapping is accomplished via canonicalization. Thus, modules can be compressed one at a time with no loss of quality relative to operating on many modules at once. The command line tool operates on multiple modules only in the trivial repetition sense, for ease of use. The remapper API only accepts a single module at a time.

spirv-remap is currently in an alpha state. Although there are no known remapping defects, it has only been exercised on one real world game shader workload.

OPTIONS¶

-? --help

shows help

-V --version

shows version

-v -vv ... --verbose [int]

sets verbosity. With no verbosity, the command is silent.

-i --input file1 [file2...]

files to process

-o --output DESTDIR

output directory

-s --strip-all --strip all

strips all debug info

--map (all|types|names|funcs)

canonicalizes type IDs / named data / function bodies

--dce (all|types|funcs)

removes dead types / functions

--opt (all|loadstore)

optimizes unneeded loads/stores

--do-everything

Synonym for --map all --dce all --opt all --strip all

RETURNS¶

a positive integer error on failure.

EXAMPLES¶

spirv-remap -v --map all --input *.spv --output /tmp/out_dir

Perform ID remapping on all shaders in "*.spv", writing new files with the same basenames to /tmp/out_dir.

spirv-remap-linux-64 -v --do-everything --input *.spv --output /tmp/out_dir

Perform all possible size reductions

Note that

ALSO SEE¶