DCM-GETFRAME(1)

💖 dcm-getframe — it's giving "print a frame from a DICOM PS3.10 file to standard output" ✨

okay bestie, so this one is a lil tool from the libdicom girlies, and honestly? it does exactly one thing and it ate. no notes.

---

✨ SYNOPSIS ✨

dcm-getframe [-v] file frame-number

that's it. that's the whole vibe. a file, a frame number, and optionally one single flag. iconic behavior honestly.

---

🌸 DESCRIPTION 🌸

so like. you have a DICOM PS3.10 file, right? and you want one specific frame out of it? not the whole thing, not a conversion, just… the frame. this is the girl for that job, no cap.

she prints that frame from the DICOM PS3.10 file straight to standard output. boom. done. 💅

---

🎀 OPTIONS 🎀

• -o OUTPUT-FILENAME — write the frame to OUTPUT-FILENAME instead of yelling it into the void of your terminal. by default the frame gets written to stdout, which is lowkey fine but sometimes you want a real file, yk? you decide.
• -h — display the help message (aka the usage summary) and dip. that's the whole thing. she said "here's how to use me" and then left.
• -V — display the version and exit. capital V bestie, that's the version one, not the verbosity one. do not mix them up, i am begging 🙈
• -v — increase logging verbosity to INFO. lowercase v. she gets chatty. she starts telling you things. not in a bad way. in an INFO way.

⚠️ fr fr note: -V and -v are different flags and the case matters. one is "who am I", one is "tell me more". iykyk.

---

💀 EXIT STATUS 💀

she tells you how it went, and she's honest about it:

• 0 — success 🎉 everything slayed, frame delivered, main character energy.
• 1 — a file could not be read 😭 the file said "not today" and honestly? we respect it but also rude.
• 2 — the arguments are invalid 🙈 you gave her something she can't work with. check your flags and your frame number bestie.

---

🦋 the sign-off 🦋

this whole thing is libdicom version 1.2.0, and she was born on 2023-09-30. vintage, honestly. a lil throwback. obsessed. 🫶✨🌈

stay hydrated, read your DICOM headers, and remember: one frame at a time. 💜🧚🍓