NAME

       rtd - real-time image display application

SYNOPSIS

       rtd options filename

DESCRIPTION

       The rtd application is used to display FITS images in real-time.  The application is based
       on "rtdimage", a Tk image extension for displaying FITS images.

OPTIONS

       -file name
              "name" specifies a 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)
              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), attempt to use X shared memory for the image display, if
              available. This improves performance  considerably,  but  is  only  available  when
              working on the system console.

       -usexsync bool
              If true, try to use X synchronisation.

       -verbose bool
              If  bool  is  true,  diagnostic  messages  are printed out to show what is going on
              internally (for debugging use).

       -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

       -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

       -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)