NAME

 
 RtdImageCtrl - Widget combining an RtdImage with a control panel

NAMESPACE

 
 rtd

PARENT CLASS

 
 rtd::RtdImage

SYNOPSIS

 
 RtdImageCtrl <path> ?options?

DESCRIPTION

 
 RtdImageCtrl is an itcl widget combining the RtdImage itcl widget with
 a control panel, zoom and panning windows.

 RtdImageCtrl inherits all of the features described in RtdImage(n) and
 also adds the following user interface components:  Zoom window (see
 RtdImageZoomView(n)), Panning window (see RtdImagePan(n)), Colormap
 display widget (see RtdImageColorRamp(n)), Image Control panel (see
 RtdImagePanel(n)).

 Each of the added user interface components is defined in a separate
 [incr Tk] widget class. In addition, some methods from RtdImage are
 redefined in order to update the user interface display.

ITK COMPONENTS

 
 colorramp
        Color ramp widget (RtdImageColorRamp(n)).

 gridcheck
        Check button for optional WCS grid.

 gridf
        Frame at lower right for the grid checkbutton and size entry.

 gridsize
        LabelEntry for grid size.

 info
        Info panel, RtdImagePanel(n) object used to display image
        controls.

 pan
        Pan window (RtdImagePan(n) widget).

 panel
        The RTD control panel, may be put in a frame or optionally in a
        popup window.

 zoom
        Zoom window (RtdImageZoomView(n) widget).

 zoom
        Zoom window: this version is not really supported any more...

WIDGET OPTIONS

 
 -colorramp_height
        Height of the colorramp subwindow.

 -default_cmap
        Default cmap file.

 -default_itt
        Default ITT file.

 -dozoom
        Flag: if true, turn on zoom window.

 -feedback
        Command used to display feedback during startup.

 -float_panel
         Floating panel option (for small displays).

 -pan_height
        Height of panning window.

 -pan_width
        Width of panning window.

 -panel_layout
        Panel layout order: set to one of {saoimage reverse default} to
        change the layout ordering of the panel windows.  "saoimage" puts
        the info first, followed by pan and zoom, "reverse" reverses the
        default order, which is {zoom info pan}.

 -port
        Default port for remote connections (0 means system chooses a
        port).

 -use_zoom_view
        Flag: if true, make zoom window a view of the main image otherwise
        do a faster, but less accurate (by shrunken images) zoom from the
        xImage.

 -with_colorramp
        Flag: if true (default), show the color ramp window.

 -with_grid
        Option to include grid button (default to off, since it doesn't
        work well yet on some images).

 -with_pan_window
        Flag: if true (default) make a panning window.

 -with_warp
        Option to warp the mouse pointer.

 -with_zoom_window
        Flag: if true (default) make a zoom window .

 -xscale
        Default scaling factor (just for backwards compatibility with
        tcscam; don't use!).

 -zoom_factor
        Zooming factor.

 -zoom_height
        Height of zoom window.

 -zoom_view_propagate
        Flag: if true, changes in main image scale will propagate to the
        zoom window, otherwise controls are displayed so the user can
        manually change it (ZoomView only).

 -zoom_width
        Width of zoom window.

PUBLIC METHODS

 
 clear {}
        Clear the current image display and remove an windows that access
        it (extend parent class version).

 feedback {msg}
        This method is called at startup to give feedback while building
        the interface.

 hide_control_panel {variable}
        Toggle the visibility of the control panel (argument is the name
        of the checkbutton variable to use).

 inc_zoom {inc}
        Add the given increment to the current zoom factor and re-scale
        the image.

 open {{dir "."} {pattern "*.*fit*"}}
        Open and load a new FITS image file via file name dialog.

 scale {x y}
        This method is redefined here to update the scale display.  resize
        the image and the canvas graphics by the given integer factors (1
        is no scale, -2 = 50%, 2 = 200% etc...).

 set_bias {}
        Pop up a window to control bias subtraction.

 set_colors {}
        Pop up a window to edit the image colors.

 set_grid_size {size}
        Set the size of the grid (space between lines) in arc seconds of
        dec degrees.

 set_wcs_info {list}
        This command is called with a list of values from wcs_info_dialog
        above to set new world coordinates information for the current
        image.

 show_grid {variable}
        Toggle the visibility of the image ra,dec grid (argument is the
        name of the checkbutton variable to use).

 update_color_window {}
        Update the settings in the color popup to reflect those of the
        image.

 update_colors {}
        This method is called when the colormap has been changed to update
        the display.

 view_fits_header {}
        View the FITS header in a text window.

 wcs_info_dialog {}
        Pop up a dialog to display/edit the basic world coordinate
        parameters.

PROTECTED METHODS

 
 init {}
        This method is called from the base class (TopLevelWidget) after
        all the options have been evaluated.

 make_colorramp {}
        Add a generated image to display the colors in the colormap.

 make_control_panel {}
        Make the control panel for operating on the image.

 make_grid_item {}
        Create an item in the panel to control the ra,dec grid size.

 make_pan_window {panel}
        Make the pan window.

 make_panel_info {panel}
        Make the panel info subwindow.

 make_panel_subwindows {panel}
        Add the panel subwindows.

 make_zoom_window {panel}
        Make the zoom window in the panel.

 new_image_cmd {}
        This method is called by the image code whenever a new image is
        loaded.  (for real-time updates, see camera command).

PROTECTED VARIABLES

 
 cut_
        Cut values frame.

 grid_var_
        Name of trace var for grid.

 zoom_state_
        Saved zoom button state.

SEE ALSO

 
 RtdImage(n)

 


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