----- file created by makedoc on: Tue May 29 14:43:55 2012
----- Documentation for /sware/exp/xop-2.3/extensions/shadowvui/src/vui/shadow_setifcpar.pro -----

 NAME:
	SHADOW_SETIFCPAR
 PURPOSE:
	Scripting SHADOWVUI RUNS
 CATEGORY:
	SHADOW's utilities.
 CALLING SEQUENCE:
	shadow_setIfcPar,variable,new_value
 INPUTS:
	variable: The name of the variable (as named in start.xx files)
	to be changed
	new_value: The new value of the variable (new_value can also be
       a named variable to retrieve the current value, when the GET 
	keyword is set)
 KEYWORD PARAMETERS:
	PARENT = The widget Id of the SHADOWVui window where the value
		will be changed. If undefined, it takes the current
		ShadowVui window.
	SOURCE  = Set to the source type when VARIABLE affects the source.
		Use Sorce=0 (geometrical), 1 (BM), 2 (Wiggler) 3 Undulator.
	TRACE = Set to the oe index (e.g., trace=0 for oe1, etc)
	INDEX = When VARIABLE is an array, use this keyword to select 
		the index of VARIABLE to be changed. If VARIABLE is an
		array and INDEX is not set, then INDEX=0 is assumed.
	GET = Set this kwyword to retrieve in new_value (named variable) the
               current status of VARIABLE
	
 OUTPUTS:
	Changes the corresponding VARIABLE in ShadowVui window

 COMMON BLOCKS:
	COMMON shadow_ifc,parent1
	(to allow working without defining PARENT)

 EXAMPLE: 
       ; starts ShadowVUI
	shadow,parent=p1  
       ; loads a ws
	shadow_loadws,p1,file='beamEvol.ws',/norun 
       ; change number of rays
	shadow_setIfcPar,parent=p1,'npoint',6000,source=0 
       ; change asymm angle for oe2
	shadow_setIfcPar,parent=p1,'a_bragg',12,trace=1 
	; run shadow
	shadow_run,p1,/source,/trace

 MODOFICATION HISTORY:
	M. Sanchez del Rio
       2007/10/09 srio@esrf.eu adds doc and fixes a small bug. 
       2009/03/05 srio@esrf.eu adds GET keyword.


