Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

saveregions - Constructor

	Package	display
	Module	widgets
	Tool	saveregions

Construct a saveregions widget

Synopsis
saveregions(parent, table, regions, changenames, globalsave, widgetset)

Arguments

parent		Parent of the widget
		Allowed:	Widget
		Default:	F
table		The table of interest
		Allowed:	Table tool, image tool or string
		Default:	''
regions		The regions to save, or the region names
		Allowed:	Record of regions or vector of strings
changenames		Entry boxes to enable region name changes are provided
		Allowed:	T or F
		Default:	T
globalsave		The regions are saved from global name space or a record
		Allowed:	T or F
		Default:	F
widgetset		The widget server to use
		Allowed:	widgetserver tool
		Default:	dws

Returns
saveregions tool or fail

Description

This is the constructor. If parent=F, then the widget will make its own parent frame. The Table can be specified in many ways; 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 Image tool. If the Table does not exists, a be one will be created. It will have no useful structure beyond that needed to store the regions.

The regions are either provided in a record (globalsave=F or should exist in global name space, whereupon you just provide their names.

If changenames=T, when you select regions, entry boxes which enable you to change the names of the regions on save are provided.

Example

- include 'saveregions.g'   
- r1 := drm.box([10,10],[20,30]);
- r2 := drm.quarter();
- sr1 := saveregions(table='hcn', regions="r1 r2", globalsave=T, changenames=F);
- r := [=];
- r[1] := r1;
- r[2] := r2;
- sr2 := saveregions(table='hcn', regions=r, globalsave=F);

In this example, two widgets are contructed with a Table called `hcn'. The first shows how to save from global name space. The second saves from a record.