ENVIView

This is a reference to a view object. For details on creating and retrieving this reference, see ENVI::CreateView and ENVI::GetView.

Example

The following code snippet creates two views.

; Launch the application

e = ENVI()

; Open ENVIRaster

file = FILEPATH('qb_boulder_msi', ROOT_DIR=e.ROOT_DIR, $

  SUBDIRECTORY = ['data'])

raster = e.OpenRaster(file)

view1 = e.GetView()

layer1 = view1.CreateLayer(raster)

; Create the second view

view2 = e.CreateView()

; Create the ENVIRasterLayer

layer2 = view2.CreateLayer(raster, /CIR)

Syntax

Result = ENVIView([, Properties=value])

Methods

Properties

Properties marked as (Init) can be set during the initial creation of the object. Properties marked as (Get) can be retrieved. Properties marked as (Set) can be set after initial creation.

BACKGROUND_COLOR (Get, Set)

Set this property to a string or RGB vector that specifies the background color of the view. If this property is not set, then it will use a default color of white.

See the description of the ENVIROI COLOR property for the valid values that you can use.

COORDINATE_SYSTEM (Get, Set)

A fully qualified coordinate system string associated with the view. If no coordinate system exists, then an empty string is returned. Note that this property cannot be set on an empty view.

DIMENSIONS (Get)

A 2-element array containing the x, y size (in pixels) of the view.

EVENT_HANDLER (Set)

Set this property to the name of a custom event handler class.

GEOLINK (Get)

An array of the geographically linked views (including itself). If the view is not part of the geographic link, the property value is !NULL.

KEYBOARD_HANDLER (Set)

Set this property to the name of a custom keyboard event handler.

LOCATION (Get)

A 2-element array containing the x, y location (in pixels) of the view, relative to the origin, which is in the lower-left corner.

MOUSE_DOWN_HANDLER (Set)

Set this property to the name of a custom mouse-down event handler.

MOUSE_MOTION_HANDLER (Set)

Set this property to the name of a custom mouse-motion event handler.

MOUSE_UP_HANDLER (Set)

Set this property to the name of a custom mouse-up event handler.

MOUSE_WHEEL_HANDLER (Set)

Set this property to the name of a custom mouse-wheel event handler.

MAP_SCALE (Get)

The proportion of screen size to real-world size (1:X). The default value is 1:1.

NAME (Get, Set)

Specify a string value with the name of the view.

PIXELLINK (Get)

An array of the pixel-linked views (including itself). If the view is not part of the pixel link, the property value is !NULL.

ROTATION_ANGLE (Get, Set)

Returns the current rotation angle (in degrees) of the view.

SELECTION_CHANGE_HANDLER (Set)

Set this property to the name of a selection-change event handler.

SHOW_OVERVIEW

Set this property to 1 to display the overview window, and to 0 to hide it. The default value is 0.

SHOW_SNAIL_TRAIL

Set this property to 1 to display the snail trail in the overview window, and to 0 to hide it. The default value is 1.

This property is independent of the SHOW_OVERVIEW property. For example, if SHOW_OVERVIEW is set to 0, SHOW_SNAIL_TRAIL can be set to 1, but the snail trail will not be visible until the overview is displayed.

SPATIALREF (Get)

This property retrieves a reference to the ENVIPseudoRasterSpatialRef, ENVIRPCRasterSpatialRef, or ENVIStandardRasterSpatialRef object.

ZOOMLINK (Get)

An array of the zoom-linked views (including itself). If the view is not part of the zoom link, the property value is !NULL.

Version History

ENVI 5	Introduced
ENVI 5.0.1	Added COORDINATE_SYSTEM property
ENVI 5.1	Added the following properties: EVENT_HANDLER, KEYBOARD_HANDLER, MOUSE_DOWN_HANDLER, MOUSE_MOTION_HANDLER, MOUSE_UP_HANDLER, MOUSE_WHEEL_HANDLER, SELECTION_CHANGE_HANDLER, SPATIALREF Added the following methods: ConvertFileToWindow, ConvertWindowToFile, and HitTest
ENVI 5.2	Added ChipToVideo method
ENVI 5.3	Added Chip and ChipToFile methods
ENVI 5.5.3	Added BACKGROUND_COLOR property
ENVI 6.1	Added the DIMENSIONS and LOCATION properties

API Version

4.3