HDFTOR8(1)

📦 version 4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 HDFTOR8(1) 💖

okay bestie, welcome to the General Commands Manual era — this one's hdftor8, and she's a whole vibe ✨

🌸 NAME 🌸

hdftor8 — extract 8-Bit raster images and palettes from an HDF file 🎀

🦋 SYNOPSIS 🦋

hdftor8 hdf-file [-i] [-v] [-r raster-image-file] [-p pallette-file]

like. that's it. that's the whole invitation 💅

✨ DESCRIPTION ✨

so hdftor8 goes into an HDF file and extracts the raster images and/or the palettes out of it, then stores them in one file that holds the raster image data</> and another one that holds the palette data</>. two files, two destinies, iconic behavior honestly 🫶

now here's the part you actually need to clock, bestie — the way hdftor8 reads the names you give it for the raster image file and the palette file is very specific:

  • for each raster image file — the file name gets the extension .#.@.% slapped on it, where # is the raster image number from the HDF file, @ is the x-dimension of the raster image, and % is the y-dimension of the raster image 🌈
  • for each palette file — the file name gets the extension .#, where # is the palette number from the HDF format file 💜

and if you're like "bestie I don't feel like naming anything today"? totally valid. if you give no name for the raster image file, the default name img.#.@.% gets assigned, where #, @, and % mean exactly what they meant in the paragraph right above this one 👑 and the default name for a palette file is pal.# 🎀

💅 OPTIONS 💅

  • -i — run the program in interactive mode. it's giving conversation ✨
  • -v — run in verbose mode. it'll show you diagnostic messages during the session, so you're never left guessing what's happening 🔍
  • -r raster-image-file — specify the name of the raster image file 🖼️
  • -p pallette-file — specify the name of the palette file 🎨
yes, the option really is spelled pallette-file up there. we don't fix it, we respect it 💀

🌈 EXAMPLES 🌈

say you've got a file named denm.hdf that contains three 512 x 256 raster images and three palettes. to store these images and palettes in separate raster image and palette files, you'd run this hdftor8 command:

hdftor8 denm.hdf

and boom — six files appear, named:

  • img1.512.256
  • img2.512.256
  • img3.512.256
  • pal.1
  • pal.2
  • pal.3

six files. no cap. the naming scheme really said "let me introduce myself" 🌟

🧚 SEE ALSO 🧚

r8tohdf(1), hdf(5) — go read those too, they're part of the friend group 💖

and that's the whole page, bestie — this one's from the General Commands Manual, dated November 6, 1999, and it ate, fr fr. mwah 💅✨

📦 where this page comes from