RTD(1)

✨ rtd — real-time image display application 💖

okay bestie, welcome to rtd(1), a User Commands girly, and she is literally the moment. 🫶

✨ NAME ✨

rtd — real-time image display application. that's it, that's the vibe. 👑

🌸 SYNOPSIS 🌸

rtd options filename

🦋 DESCRIPTION 🦋

so the rtd application is what you use to display FITS images in real-time. no cap. and here's the lore: it's based on "rtdimage", which is a Tk image extension for displaying FITS images. iconic lineage, honestly. 💅

🎀 OPTIONS 🎀

bestie there are SO many flags, grab a snack, we're going through all of them. every. single. one. 💖

• -file name — "name" tells her which FITS format file to load and display.
• -subsample bool — if bool is true, subsampling is used when shrinking the image, i.e.: if the image is shrunk by 1/3, only every third pixel is displayed. otherwise, the maximum value is taken from the group of pixels.
• -sampmethod n — (experimental, she's in her testing era 🙈) if option 'subsample' is false, the following methods can be used for displaying a shrunk image (i.e. an image with a scale factor < 1):
  • 0 — max value of all pixels in a NxN box (default)
  • 1 — min value of all pixels in a NxN box
  • 2 — mean value of all pixels in a NxN box
  • 3 — median value of all pixels in a NxN box
  • 4 — max value of pixels on a diagonal cross in a NxN box
  • 5 — min value of pixels on a diagonal cross in a NxN box
  • 6 — mean value of pixels on a diagonal cross in a NxN box
  • 7 — median value of pixels on a diagonal cross in a NxN box
  • 8 — median value of pixels in a chess-board like box
  • 9 — median value of a 3x3 box
• -usexshm bool — if bool is true (default, so she's on by default bestie), attempt to use X shared memory for the image display, if available. this improves performance considerably, but it's only available when working on the system console. so like, console-only girly. 💀
• -usexsync bool — if true, try to use X synchronisation.
• -verbose bool — if bool is true, diagnostic messages are printed out to show what's going on internally (for debugging use). she's telling you everything. no secrets. 🗣️
• -default_cmap — this option sets the default colormap file to use when starting up. only the root of the filename should be specified for this option, for example: "ramp" for a grey level colormap. for a list of available colormap files, see the colormaps directory in the rtd release. ✨
• -min_colors n — specify the min and max number of colors to allocate before using a private colormap.
• -max_colors n — specify the min and max number of colors to allocate before using a private colormap.
• -default_itt — this option is similar to -default_cmap, except it sets the default ITT (intensity transfer table) file to use at startup. ITT files are also stored in the colormaps directory.
• -xscale xs — set the default scaling factors (default: 1).
• -yscale ys — set the default scaling factors (default: 1).
• -camera name — set the camera name for real-time image events: default: taken from the RTD_CAMERA environment variable, if set, otherwise set to RTDSIMULATOR, for simulation test mode.
• -zoom_factor number — set the scale factor for the zoom window (default 5 x the original image).
• -colorramp_height h — set the height of the colorramp subwindow (default: 20).
• -with_zoom_window bool — if bool is true (default), add a zoom window. 🔍
• -with_pan_window bool — if bool is true (default), add a panning window.
• -dozoom bool — if true, turn on zoom window.
• -disp_image_icon bool — if true, display a copy (view) of the image as an icon.
• -drag_scroll bool — if true, set bindings to scroll with the middle mouse button.
• -scrollbars bool — if true, display scrollbars to scroll the image.
• -port port — default port for remote connections (0 means system chooses a port).
• -debug bool — debugging flag: enables real-time simulation with testProg (below).
• -testprog path — for testing: name of test program used to generate real-time updates (tRtd).
• -interval n — for testing: interval between updates in ms.
• -with_perftest bool — if true, display performance tester utility in menu bar. 📊
• -with_warp bool — option to warp the mouse pointer. ✨

🍓 FILES 🍓

• $RTD_LIBRARY/../demos/rtd.tcl

💜 SEE ALSO 💜

rtdServer(1), RtdClient(1), RtdCubeDisplay(1), skycat(1)

and that's the whole page bestie, you ate it up fr fr. this one's brought to you by RTS, dated March 2009 — yes she's a vintage icon and she still serves 💅✨ periodt. go display some FITS images, you've got this 🫶🎀