RTDCUBEDISPLAY(1)

💖 rtdCubeDisplay — the manual page, but make it cute 💖

okay so you found rtdCubeDisplay(1), it lives in the User Commands section of the manual, and bestie it is exactly what it sounds like: a lil baby program that shows off FITS cube images in real time. no cap. let's get into it 🫶

✨ NAME ✨

rtdCubeDisplay — a simple FITS cube display program 🌈

like, it's giving "I display FITS cubes and I do it simply." iconic behavior honestly.

🦋 SYNOPSIS 🦋

rtdCubeDisplay -f <filename> -c <cameraname> [-l] [-t msec] [-v]

so <filename> and <cameraname> are literally mandatory, and the rest are little optional sprinkles. read the flags section before you start mashing keys, okay? 💅

🌸 DESCRIPTION 🌸

okay so here's the vibe: rtdCubeDisplay displays FITS cube images for the real-time display. 🎀

the way that it works is — you specify a FITS cube file with the -f option, and you specify a camera name with the -c option, and then the images get extracted from the file and an image event gets sent to the rtdServer. that's the whole pipeline bestie, that's the plot. 🔥

BUT. and this is the important part. for the image to actually show up, some rtd widget application — for example rtd — has to register to the same camera name you specified up there. 👑

and for the rtd application specifically, that registering thing is done by setting the RTD_CAMERA environment variable. so if you're staring at a blank screen wondering why nothing's popping off... it's the camera name, it's always the camera name. 😭

💜 OPTIONS 💜

• -f <filename> — the FITS cube images. this is your actual data bestie, the whole reason we're here 🍓
• -c <cameraname> — the camera name, used to identify the real time source. this has to match the name your widget app registered with or it's giving silence ✨
• -l — loop indefinetly. yes that's the spelling from the man page, we don't gatekeep, we just report 🫶 (it means forever and ever and ever, no chill, no stopping)
• -t msec — the delay time between cube images, measured in msec. the default is 500 ms, so if you don't say anything, it takes a lil half-second breather between each one 💅
• -v — verbose mode. it tells you stuff. it yaps. we love a yapper 🙈

👀 SEE ALSO 👀

• rtd(1)
• rtdServer(1)
• rtcClient(1)

go read those too, they're the friend group, you can't just know one of them 💖

⭐ little reminder: -f and -c are not optional, they're the main characters. everything else is a supporting role.

and that's the whole page bestie!! this one came from the RTDCUBEDISPLAY source, dated March 2009, and it's the RTDCUBEDISPLAY(1) page. yes, 2009. a vintage. an antique. a classic. she's been serving real-time FITS cube realness since before some of us could walk and she's still slaying. 💀✨ mwah, go display something. 💖