OPJ_JP3D_DECOMPRESS(1)

📦 version 2.4.0, in ubuntu jammy

💖 OPJ_JP3D_DECOMPRESS(1) 💖

okay bestie, welcome to the User Commands section of the manual, and specifically to OPJ_JP3D_DECOMPRESS(1) — the page that teaches you how to decompress jp3d files. yes literally un-squish them. let's go 🦋

✨ NAME ✨

opj_jp3d_decompress — decompress jp3d files. that's it, that's the whole job. iconic. 💅

✨ SYNOPSIS ✨

opj_jp3d_decompress [optional arguments] -i input.{jp3d, j3d} -o
output.{pgx, bin} -m characteristics.img

✨ OPTIONS ✨

🎀 Required Parameters (except with -h):

  • -i <compressed file> ( *.jp3d, *.j3d ) — the input bestie. Currently accepts J3D-files. how does it know which type it is? it peeks at the suffix. that's the whole vibe check. 🔍
  • -o <decompressed file> ( *.pgx, *.bin ) — the output. Currently accepts PGX-files and BIN-files. binary data is written to the file, not ascii (do not come for me). and if you hand it a PGX filename, get this: there will be as many output files as slices, with an indice starting from 0 appended to the output filename, right before the "pgx" extension. so many files. so many. 🫶
  • -m <characteristics file> ( *.img ) — Required only for BIN-files. ascii data of volume characteristics is written. yes ascii here, unlike that other one. it's giving range. 💜

🦋 Optional arguments

  • -h — display the help information. your bestie when you're lost. 🙈
  • -r <RFx,RFy,RFz> — set the number of highest resolution levels to be discarded on each dimension. the volume resolution is effectively divided by 2 to the power of the number of discarded levels. and the reduce factor is limited by the smallest total number of decomposition levels among tiles. math ate, honestly. ✨
  • -l <number of quality layers to decode> — set the maximum number of quality layers to decode. if there are fewer quality layers than the number you specified, then all the quality layers are decoded. no crumbs left behind. 🍓
  • -O original-file — this one is lowkey fancy. it offers the possibility to compute some quality results for the decompressed volume, like the PSNR value achieved or the global SSIM value. it needs the original file so it can compare it with the new one.
NOTE: only valid when the -r option is 0,0,0 (both original and decompressed volumes have same resolutions).
NOTE: if the original file is a .BIN file, the volume characteristics file shall be defined with the -m option. (i.e. -O original-BIN-file -m original-IMG-file)

so yes, both notes are non-negotiable. read them. 👑

  • -BE — define that the recovered volume data will be saved with big endian byte order. by default, little endian byte order is used. pick your endian, bestie. 🧚

✨ AUTHOR ✨

this manual page was written by Mathieu Malaterre <malat@debian.org> and Hugo Lefeuvre <hle@debian.org> for the Debian GNU/Linux system, but may be used by others. shoutout to them fr fr, absolute icons for writing the docs so we didn't have to. 💖

and that's the page!! opj_jp3d_decompress version 2.3.1, dated October 2019, living its best life under OPJ_JP3D_DECOMPRESS(1). go decompress something, you've got this. slay. 💅✨🌈

📦 where this page comes from