favSetRoi

AVVIEWER Subroutine: Sets the position number of the first and last elements in the Region of Interest (ROI) of the specified array dimension.

Module: USE AVVIEWER

Syntax

favSetRoi (hv, dim, roilb, roiub, status)

hv

A handle that references an instance of Array Viewer created by favStartViewer.

dim

An input argument of type INTEGER(2). It specifies the array dimension that the following two arguments will be applied to. The dimension must be in the range 0 to rank, where rank is the rank of the currently loaded array.

roilb

An input argument of type INTEGER(4). It specifies the lower array index to be included in the ROI. The array index must be in the range lbound to ubound, where lbound and ubound are the lower bound and upper bound of dimension dim.

roiub

An input argument of type INTEGER(4). It specifies the upper array index to be included in the ROI. The array index must be in the range lbound to ubound, where lbound and ubound are the lower bound and upper bound of dimension dim.

status

An output argument of type INTEGER(4). It returns a status code for the success of this call. The value 0 indicates success.

Remarks

This subroutine can be used to select and view a subregion of the current array. You must call the favUpdate subroutine before the new ROI is mapped to the graph.

See Also

favUpdate