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)

RTS                                                March 2009                                             RTD(1)