Go up one levelGo to Previous Go to Next

AstroImage(n)

NAME

 
 AstroImage - user interface class for accessing image servers

NAMESPACE

 
 cat

PARENT CLASS

 
 util::TopLevelWidget

SYNOPSIS

 
 AstroImage <path> ?options?

DESCRIPTION

 
 AstroImage is a user interface class for accessing image servers such
 as DSS (Digitized Sky Survey).


ITK COMPONENTS

 
 progress
        ProgressBar(n) widget, to display the progress of a query.

WIDGET OPTIONS

 
 -anchor
        Set the anchor for labels.

 -debug
        Flag: if true, run queries in foreground for better debugging.

 -image
         image handle (itcl class: SkyCat or derived).

 -imagesvr
        Default image server name .

 -labelfont
        Font to use for labels.

 -labelwidth
        Set the width for  displaying labels.

 -title
        Text for  label displayed at top.

 -tmpfile
        Temp image file to use.

 -valuefont
        Font to use for values.

 -valuewidth
        Set the width for  displaying labels.

 -wcsfont
        Font to use for ra,dec labels.

PUBLIC METHODS

 
 convert_coords {in_x in_y in_units out_units}
        Convert the given input coordinates in the given input units to
        the given output units and return a list {x y} with the new
        values.  The units may be one of {canvas image wcs deg "wcs
        $equinox", "deg $equinox"}.

 convert_dist {in_x in_y in_units out_units}
        Convert the given input distance in the given input units to the
        given output distance and return a list {x y} with the new
        values.  The units may be one of {canvas image wcs deg "wcs
        $equinox", "deg $equinox"}.

 feedback {}
        This method is called by the fileevent handler during the image
        transfer from the HTTP C++ class to give the user feedback about
        how much there is left to copy, etc...  Read a line from the
        feedback pipe, which should contain text to be displayed in the
        progress widget.

 fill_imagesvr_menu {m {serv_type "imagesvr"}}
        Fill up a menu of known data servers to choose from.  The
        serv_type argument should be one of: "catalog", "archive",
        "imagesvr".

 get_imagesvr_equinox {}
        Return the current equinox, or an empty string if the imagesvr
        does not support world coordinates. The user can change the
        equinox used to display coordinates by typing in a different value
        in the panel.

 get_name_servers {m}
        Add the name server catalogs to the given menu.

 getimage {args}
        Get the requested image from the image server based on the current
        options and display the resulting image (args are ignored here).

 getimage_from_args {ra dec name equinox width height {flag 1}}
        Get the requested image from the image server based on the given
        arguments for the world coord position or name and the given width
        and height if flag is 1, the entries are updated from the
        arguments.

 help {}
        If the catalog has a "help" URL, try to display it in netscape
        using the netscape remote interface.

 interrupt {}
        Interrupt the current request .

 quit {}
        Quit and close the window.

 select_area {}
        Ask the user to select an area to search interactively and insert
        the resulting radius and center pos in the catalog window.

 select_image_area {wcs_flag}
        Ask the user to select an area of the image by dragging out a
        region on the image return the resulting center pos, width and
        height as a list of {x y width height}, or {ra dec equinox width
        height} if wcs_flag is 1. An empty string is returned if there is
        no image or the user cancels the operation.

 select_imagesvr {name}
        Called when an imagesvr ($name) is selected from the menu.

 set_default_values {}
        Set the default values for the form entries:  set the default
        position (RA, DEC) to the image center, .

 set_imagesvr {name}
        Set (open) the current image server - called when user selects a
        name from the menu.

 set_namesvr {name}
        Set the name server to use to resolve object names.

 set_pos_width_height {list}
        Set the values for the position, width and height entries from the
        given list, which should be in the format {ra dec equinox width
        height} if we are using wcs, or {x y width height} for image pixel
        coords.

 set_state {state}
        Set/reset widget states while busy .

PROTECTED METHODS

 
 add_menubar {}
        Add the menu bar.

 init {}
        Called after options have been evaluated.

 layout_dialog {}
        Do the dialog window layout.

 make_short_help {}
        Add a short help window and set the help texts.

 request_done {status result}
        This method is called when the background request is done.  The
        arguments are the error status (0 is OK) and the result, which is
        a list of {filename center-pos copyright}.

 set_feedback {onoff}
        Open or close a pipe to get feedback during HTTP transfers.  (To
        save limited fds, we close the feedback pipe after each HTTP op).
        The arg should be "on" to turn feedback on, or "off" to turn it
        off.

 set_logfile {}
        Create the ~/.skycat dir if it does not already exists and keep a
        log file there.

PROTECTED VARIABLES

 
 canvas_
         canvas window containing main image.

 copyright_
        Copyright field.

 count_
        Count used for filename generation.

 dec_
        Dec field widget.

 equinox_
        Equinox field widget.

 height_
        Height field widget.

 image_
        Internal rtdimage widget for main image.

 initialized_
        Flag: set at end of constructor.

 logfile_
        Log file handle (used to log URLs).

 logfile_name_
        Log file handle (used to log URLs).

 name_
        Name field widget.

 namesvr_
        Name server to use to resolve object names.

 ra_
        Ra field widget.

 rfd_
        Pipe to read feedback during image transfer.

 setfrom_
        "set from image" field widget.

 state_
        Current state: normal, disabled (i.e.: waiting).

 wfd_
        Pipe to write feedback during image transfer.

 width_
        Width field widget.

COMMON CLASS VARIABLES

 
 instances_
        Array mapping catalog name to widget/class name.

 n_instances_
        Instance count.

SEE ALSO

 
 TopLevelWidget(n)

 


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

 


Go up one levelGo to Previous Go to Next

Please send questions or comments to abrighto@eso.org@eso.org.
Copyright © 1998 ESO - European Southern Observatory