;+
; NAME:
;	qView_GetInfo
; PURPOSE:
;	Get information about current selected image area
; CATEGORY:
;	Widget qView
; CALLING SEQUENCE:
	FUNCTION qView_GetInfo, state, 	$
		dim		= dim	, $
		offset	= offset, $
		subdim	= subdim, $
		box		= box	, $
		zval	= zval	, $
		zhilo	= zhilo	, $
		zback	= zback	, $
		fixz	= fixz	, $
		zlog	= zlog	, $
		zoom	= zoom	, $
		smei	= smei	, $
		center	= center, $
		p_axis	= p_axis, $
		p_box	= p_box	, $
		prorate	= prorate,$
		cosine	= cosine, $
		qimage_cw_state = qimage_cw_state
; INPUTS:
;	state			array[1]; type: structure
;						qView state structure
; OPTIONAL OUTPUT PARAMETERS:
;	dim		= dim		array[2]; type: integer
;							dimensions of the full images (as stored in image file)
;	offset	= offset	array[2]; type: integer
;							pixel coordinates of the lower left corner of the image cube
;							currently loaded in memory
;	subdim	= subdim	array[2]; type: integer
;							dimensions of the images in the current image cube
;	box		= box		array[2,2]; type: integer
;							square area of pixels in the image, expressed as pixel coordinates
;							in the full images (i.e. including 'offset');
;							box[0:1,*] is the lower left corner; box[0:1,*] the upper right
;							corner. Box is fully contained in the images in the current
;							image cube.
;	zval	= zval		array[4]; type: float
;							min, max, average and standard deviation for the 'box' area
;	zhilo	= zhilo		array[2]; type: float
;							min and max used to limit the range of pixel values if 'fixz' is set.
;	zback	= zback
;
;	fixz	= fixz		scalar; type: byte
;							if set then 'zhilo' is used to limit the range of pixel values
;							displayed in images and cross sections.
;	zlog	= zlog		scalar; type: byte
;							if set then pixel values are displayed on a logarithmic scale
;	zoom	= zoom		scalar; type: integer
;							zoom factor used in displaying a 'wall' view or and animation.
;
;	smei	= smei
;	center	= center
;	p_axis	= p_axis
;	p_box	= p_box
;	prorate	= prorate
; INCLUDE:
	@compile_opt.pro			; On error, return to caller
; PROCEDURE:
;	The image area is selected using the qImage widget. This widget sends events
;	to qView, where they are processed by qView_SetBox. They are stored in a structure
;	which is maintained as user value of the state.wid_info widget.
;	This procedure returns the information stored in that info structure.
;
;	The info structure is defined in qImage_SendStructure
; STATE INFO USED:
;	widget_control, state.wid_info, get_uvalue=info, /no_copy
; STATE INFO MODIFIED:
;	widget_control, state.wid_info, set_uvalue=info, /no_copy
; MODIFICATION HISTORY:
;	FEB-2000, Paul Hick (UCSD/CASS)
;	FEB-2001, Paul Hick (UCSD/CASS; pphick@ucsd.edu)
;		Added p_axis keyword to extract optical axis
;-

widget_control, state.wid_info, get_uvalue=info, /no_copy

set = n_elements(info) NE 0

IF set THEN BEGIN
	dim		= info.dim
	offset	= info.offset
	subdim	= info.subdim

	qimage_cw_state = info.qimage_cw_state

	box		= info.box
	zval	= info.zval
	zhilo	= info.zhilo
	zback	= info.zback
	fixz	= info.fixz
	zlog	= info.zlog
	zoom	= info.zoom

	smei	= info.smei
	center	= info.center
	p_axis	= info.p_axis
	p_box	= info.p_box
	prorate	= info.prorate

	if widget_info(info.qimage_cw_state.wid_cos, /valid) then	$
		widget_control, info.qimage_cw_state.wid_cos, get_value=cosine

	widget_control, state.wid_info, set_uvalue=info, /no_copy

ENDIF

RETURN, set  &  END