Create a KTX 2 file from a KTX file.

SYNOPSIS

ktx2ktx2 [options] [infile ...]

DESCRIPTION

ktx2ktx2 creates Khronos texture format version 2 files (KTX2) from Khronos texture format version 1 files. ktx2ktx2 reads each named infile. Output files have the same name as the input but with the extension changed to .ktx2. When infile is not specified, a single file will be read from stdin and the output written to standard out.

If unrecognized metadata with keys beginning "KTX" or "ktx" is found in the input file, it is dropped and a warning is written to standard error.

The following options are available:

-b, --rewritebado

Rewrite bad orientation metadata. Some in-the-wild KTX files have orientation metadata with the key "KTXOrientation" instead of KTXorientaion. This option will rewrite such bad metadata instead of dropping it.

-o outfile, –output=outfile

Name the output file outfile. If outfile is 'stdout', output will be written to stdout. If there is more than 1 input file, the command prints its usage message and exits.

-f, --force

If the destination file already exists, remove it and create a new file, without prompting for confirmation regardless of its permissions.

-h, --help

Print this usage message and exit.

-v, --version

Print the version number of this program and exit.

EXIT STATUS

ktx2ktx2 exits 0 on success, 1 on command line errors and 2 on functional errors.

HISTORY

Version 4.0

• Initial version.

AUTHOR

Mark Callow, Edgewise Consulting www.edgewise-consulting.com