Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

restoreregions - Tool

	Package	display
	Module	widgets

Postscript file available

Tk widget to restore image regions of interest from a table

include "restoreregions.g"

Constructors

restoreregions	Construct a restoreregions widget

Functions

done	Destroy ourselves
gui	Restart the GUI
refresh	Refresh the display
regions	Recover the selected regions from the Table into a record
settable	Set a (new) table

Description

This widget enables you to restore the image regions-of-interest (or more simply, regions - see Regionmanager) stored in an AIPS++ Table. You can restore the regions into a record, or into global name space (i.e. into Glish).

Figure 1.14: The restoreregions GUI

The widget displays, in listboxes, the regions stored in the Table. If you select specific regions, then the GUI expands to enable you to rename them during the restore. The `Restore' button restores only selected regions. The `Restore all' button restores all regions with no renaming option. If you select `Confirm', you will be prompted for confirmation if you attempt to overwrite a pre-existing Glish symbol. The `Dismiss' button dismisses the GUI. You can recover it with the gui function.

Under the `File' menu, you can either dismiss the GUI or destroy the widget (same as invoking function done).

You can change the Table you are accessing at any time by entering the new Table name in the appropriate entry box and entering a carriage return.

The Table can be specified in many ways (at construction and via the entry box in the GUI); a Table tool, an Image) tool, the name of a Table (a string) which might be an AIPS++ image, or the name of a Glish symbol which is either a Table or an Image tool.

This widget emits an event called restored (it has no value) when the regions have been restored. It also emits an event called dismissed (it has no value) when the dismiss button on the GUI is pressed.