CW_DEFROI

The CW_DEFROI function creates a compound widget that allows the user to define a region of interest within a widget draw window.

This routine is written in the IDL language. Its source code can be found in the file cw_defroi.pro in the lib subdirectory of the IDL distribution.

Syntax

Result = CW_DEFROI( Draw [, IMAGE_SIZE=vector] [, OFFSET=vector] [, /ORDER] [, /RESTORE] [, ZOOM=vector] )

Return Value

The is function returns an array of subscripts defining the region. If no region is defined, the scalar -1 is returned.

Arguments

Draw

The widget ID of draw window in which to draw the region. Note that the draw window must have both BUTTON and MOTION events enabled (see WIDGET_DRAW for more information).

Keywords

IMAGE_SIZE

The size of the underlying array, expressed as a two element vector: [columns, rows]. Default is the size of the draw window divided by the value of ZOOM.

OFFSET

The offset of lower left corner of image within the draw window. Default = [0,0].

ORDER

Set this keyword to return inverted subscripts, as if the array were output from top to bottom.

RESTORE

Set this keyword to restore the draw window to its previous appearance on exit. Otherwise, the regions remain on the drawable.

ZOOM

If the image array was expanded (using REBIN, for example) specify this two element vector containing the expansion factor in X and Y. Default = [1,1]. Both elements of ZOOM must be integers.

Widget Events Returned by the CW_DEFROI Widget

Examples

The following two procedures create a region-of-interest widget and its event handler. Create a file containing the program code using a text editor and compile using the .RUN command, or type .RUN at the IDL prompt and enter the lines interactively.

PRO test_event, ev 
 
; The common block holds variables that are shared between the 
; routine and its event handler: 
COMMON T, draw, dbutt, done, image 
 
; Define what happens when you click the "Draw ROI" button: 
IF ev.id EQ dbutt THEN BEGIN 
   ; The ROI definition will be stored in the variable Q: 
   Q = CW_DEFROI(draw) 
   IF (Q[0] NE -1) then BEGIN 
      ; Show the size of the ROI definition array: 
      HELP, Q 
      ; Duplicate the original image. 
      image2 = image 
 
      ; Set the points in the ROI array Q equal to a single 
      ; color value: 
      image2(Q)=!P.COLOR-1 
 
      ; Get the window ID of the draw widget: 
      WIDGET_CONTROL, draw, GET_VALUE=W 
 
      ; Set the draw widget as the current graphics window: 
      WSET, W 
 
      ; Load the image plus the ROI into the draw widget: 
      TV, image2 
   ENDIF 
ENDIF 
 
; Define what happens when you click the "Done" button: 
IF ev.id EQ done THEN WIDGET_CONTROL, ev.top, /DESTROY 
 
END

Next, create a draw widget that can call CW_DEFROI. Note that you must specify both button events and motion events when creating the draw widget, if it is to be used with CW_DEFROI.

PRO test 
COMMON T, draw, dbutt, done, image 
 
; Create a base to hold the draw widget and buttons: 
base = WIDGET_BASE(/COLUMN) 
 
; Create a draw widget that will return both button and  
; motion events: 
draw = WIDGET_DRAW(base, XSIZE=256, YSIZE=256, /BUTTON, /MOTION) 
dbutt = WIDGET_BUTTON(base, VALUE='Draw ROI') 
done = WIDGET_BUTTON(base, VALUE='Done') 
WIDGET_CONTROL, base, /REALIZE 
 
; Get the widget ID of the draw widget: 
WIDGET_CONTROL, draw, GET_VALUE=W 
 
; Set the draw widget as the current graphics window: 
WSET, W 
 
; Create an original image: 
image = BYTSCL(SIN(DIST(256))) 
 
; Display the image in the draw widget: 
TV, image 
 
; Start XMANAGER: 
XMANAGER, "test", base 
 
END