This routine has been replaced with the SelectCoordinateSystem method to ENVIUI.

This function returns a compound widget that allows you to input and edit map coordinates and projections. An interactive ENVI Classic session is required to run this function.

Syntax


Result = WIDGET_MAP(Base [, AUTO_MANAGE={0 | 1}] [, DEFAULT_MAP=array] [, DEFAULT_PROJ=structure] [, /FLIP] [, /FRAME], UVALUE=value)

Arguments


Base

This is the ID of the base widget.

Keywords


AUTO_MANAGE (optional)

Use this keyword to specify how ENVI Classic auto-manages the widget with AUTO_WID_MNG. The keyword value specifies if the widget must have a defined value. Setting this keyword to a value of 1 requires that the widget has either a default value or a value that you enter. Setting this keyword to 0 does not require a value. Do not use this keyword for user-managed widgets.

DEFAULT_MAP (optional)

Use this keyword to set the default map location for the compound widget. DEFAULT_MAP is a two-element array of double precision-values, where DEFAULT[0] is the default x map location, and DEFAULT_MAP[1] is the default y map location.

DEFAULT_PROJ (optional)

Use this keyword to set the default map projection for the compound widget. DEFAULT_PROJ is a projection structure returned from ENVI_GET_PROJECTION or ENVI_PROJ_CREATE.

FLIP (optional)

Set this keyword to allow flipping between latitude/longitude and map coordinates.

FRAME (optional)

Set this keyword to place a frame around the widget base.

UVALUE

Use this keyword to assign a “user value” to the widget. This value may be of any data type and organization. The user value exists entirely for your convenience. For widgets managed by the ENVI Classic function AUTO_WID_MNG, UVALUE is a tag name in the returned anonymous structure. For user-managed widgets, you can set and use UVALUE however you wish. You must set UVALUE for all compound widgets.

Widget Event


When the widget is not auto-managed, widget events set event.result to a structure with three tags: map_x, map_y, and proj.

API Version


4.2