NAME

 
 SkyCat - image display application class with catalog extensions

NAMESPACE

 
 skycat

PARENT CLASS

 
 rtd::Rtd

SYNOPSIS

 
 SkyCat <path> ?options?

DESCRIPTION

 
 This class defines a top level window for the skycat application.  The
 easiest way to create an instance this class is via the "startSkyCat"
 proc. It sets up the environment, creates an instance of the class and
 then waits for the application to exit.

 The SkyCat widget supports the same options as the Rtd widget, its base
 class, and adds some of its own options.  The widget options are the
 same as the skycat command line options, since these are passed
 unchanged to the widget.

ITK COMPONENTS

 
 image
        SkyCatCtrl(n) widget (derived from RtdImageCtrl), for displaying
        image and control panel.

WIDGET OPTIONS

 
 -cat
        Flag: if true, display the data-servers menu (catalog features).

 -catalog
        Specify a catalog (may be a local file) to load on startup.

 -dhsdata
        Directory used to hold image files from OLAF/DHS.

 -dhshost
        For OLAF (On-Line Archive Facility): name of DHS host machine.

 -help_url
        Url to use for the help menu - link to skycat WWW page.

 -remote
        If another skycat application is running on this display, use it
        rather than this process (saves memory and colors in the
        colormap).

 -rtd
        Flag: if true, display the real-time menu (VLT features).

PUBLIC METHODS

 
 clone {}
        Make a new main window (redefined from parent class).

 feedback {msg}
        This method is redefined here to get feedback during startup.

PROTECTED METHODS

 
 add_go_menu {}
        Add a "Go" menu with shortcuts to view images previously viewed.

 add_graphics_save_menu_item {}
        Add a menu item to the Graphics menu for saving the line graphics
        in a FITS table in the image.

 add_help_menu {}
        Add a menubutton with help items.

 add_olaf_menu {}
        Add a menubutton with OLAF items.

 add_realtime_menu {}
        Add the Real-time menubutton and menu, if the -rtd option was
        given.

 add_view_hdu_menu_item {}
        Add a menu item to the View menu for selecting the current HDU.

 init {}
        Called after the options have been evaluated.

 load_toplevel_geometry {}
        Restore the position of the top level window from the previous
        session.

 make_init_window {}
        Display a window while the application is starting up.

 make_rtdimage {}
        Create the rtd image widget with catalog extensions (redefined
        from parent class to use class with catalog features added).

 resize {w h}
        Called when the main window is resized:  Check the geometry to
        make sure it fits on the screen.

 save_toplevel_geometry {}
        Save the position of the top level window so we can reload it the
        next time.

 select_region {x0 y0 x1 y1}
        This method is called when a region of the image has been selected
        (via -regioncommand option when creating image above).  The
        arguments are the bounding box of the region in canvas coords.
        pass it on to any catalog windows to select any catalog symbols in
        the region.

 setXdefaults {}
        Set default X resources for colors and fonts, and set some default
        key bindings. This method is called from the parent class and
        overridden here.  These are built-in defaults that the user can
        also override in the ~/.Xdefaults file.

 start_remote {}
        This method is called for the -remote option. If another skycat is
        running, use it to display the image and exit, otherwise do it in
        this process.  Try Tk send, and if that fails, fall back on the
        RTD socket interface.

PROTECTED VARIABLES

 
 percent_done_
        Used in startup dialog .

COMMON CLASS VARIABLES

 
 toplevel_geometry_
        Name of the file used to save the positions of the top level
        windows.

SEE ALSO

 
 Rtd(n)

 


- - - - - -
Last change: 07 May 99