ktx2ktx2(1)

📦 version 4.4.2, in nixos 26.05, nixpkgs unstable

💖 ktx2ktx2 — the KTX glow-up page 💅

okay so bestie, welcome to ktx2ktx2(1) from the KTX Tools Reference — the little tool that takes your dusty old KTX files and gives them a whole new main character era ✨

🌸 NAME 🌸

ktx2ktx2 — literally just "create a KTX 2 file from a KTX file." that's the whole vibe. no cap.

🎀 SYNOPSIS 🎀

ktx2ktx2 [options] [infile ...]

🦋 DESCRIPTION 🦋

so ktx2ktx2 creates Khronos texture format version 2 files (KTX2) out of Khronos texture format version 1 files. glow-up complete, honestly iconic 🔥

it reads each named infile. the output files get the same name as the input, except the extension is changed to .ktx2. slay.

when infile is not specified, it reads a single file from stdin and writes the output to standard out. lowkey elegant.

🫶 heads up bestie: if unrecognized metadata with keys beginning "KTX" or "ktx" is found in the input file, it gets dropped, and a warning is written to standard error. not me dropping your metadata but also telling you about it 💀

the following options are available:

✨ OPTIONS ✨

  • -b, --rewritebado — rewrite bad orientation metadata. some in-the-wild KTX files have orientation metadata with the key "KTXOrientation" instead of KTXorientaion. this option rewrites such bad metadata instead of dropping it. so it's giving "fix it, don't trash it" 🎀
  • -o outfile, --output=outfile — name the output file outfile. if outfile is 'stdout', the output gets written to stdout. and if there's more than 1 input file, the command prints its usage message and exits. one outfile, one input, that's the rule 💅
  • -f, --force — if the destination file already exists, remove it and create a new file, without prompting for confirmation regardless of its permissions. ruthless. obsessed. 🔥
  • -h, --help — print this usage message and exit. your little guide when you're lost 🧚
  • -v, --version — print the version number of this program and exit. periodt.

⭐ EXIT STATUS ⭐

ktx2ktx2 exits 0 on success, 1 on command line errors and 2 on functional errors. know the numbers, bestie 🌈

👑 HISTORY 👑

version 4.0

  • initial version. everybody starts somewhere 💜

💖 AUTHOR 💖

Mark Callow, github.com/MarkCallow — the icon behind it all 🙌

and that's the whole page, bestie! this one's from Version 0.0.0, dated Tue Jan 1 1980 00:00:00 — yeah, that timestamp is literally a vibe of its own 😭💀 go forth and convert those textures fr fr 🦋💅

📦 where this page comes from