dx-doc 1:4.4.4-7 / usr / share / doc / dx / help / dxall932

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rscalar 
Scalar #!N #!N Category #!N #!N  #!Lcatint,dxall757 h Interactor  #!EL  #!N #!N Function #!N 
#!N Generates successive scalar values over a specified range. #!N #!N 
Syntax #!N #!N Available only through the user interface. #!N #!N 
Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Default 
TAB Description #!EF #!N TAB data TAB object TAB no default 
TAB object from which interactor #!N TAB - TAB - TAB 
- TAB attributes can be derived #!N TAB refresh TAB flag 
TAB 0 TAB reset the interactor #!N TAB min TAB scalar 
TAB minimum data value TAB minimum output value #!N TAB max 
TAB scalar TAB maximum data value TAB maximum output value #!N 
TAB delta TAB scalar TAB input dependent TAB increment between successive 
#!N TAB - TAB - TAB - TAB scalar outputs #!N 
TAB method TAB string TAB input dependent TAB defines interpretation of 
delta #!N TAB - TAB - TAB - TAB input #!N 
TAB decimals TAB integer TAB input dependent TAB number of decimal 
places to be #!N TAB - TAB - TAB - TAB 
displayed in output values #!N TAB label TAB string TAB "Scalar" 
TAB global name applied to interactor #!N TAB - TAB - 
TAB - TAB stand-ins #!N TAB - TAB - TAB - 
TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name 
TAB Type TAB Description #!EF #!N TAB output TAB scalar TAB 
interactor output #!N TAB - TAB - TAB #!EF #!N #!N 
Functional Details #!N #!N This interactor allows the user to interactively 
change a scalar value. The range of values over which the 
module acts is governed by its attributes (e.g., minimum, maximum, and 
delta), which in turn are either (1) specified by the parameter 
values in its  #!F-adobe-times-bold-r-normal--18*   Set Attributes... #!EF dialog box or (2) 
determined from input to the module (e.g., a data field). In 
the second case, the interactor is said to be "data driven." 
#!N #!N If the interactor is not data-driven, its attributes are 
taken from its  #!F-adobe-times-bold-r-normal--18*   Set Attributes... #!EF dialog box (accessed from 
the  #!F-adobe-times-bold-r-normal--18*   Edit #!EF pull-down menu in the Control Panel). #!N 
#!N Because the module is interactive, the user can change the 
current controlling value directly in Scalar's control panel. Note: The module's 
control panel is invoked by double-clicking on its icon in the 
VPE window. Its configuration dialog box is accessed from the  #!F-adobe-times-bold-r-normal--18*   
Edit #!EF pull-down menu in the same window. #!N #!I0 #!N 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   data #!EF #!EF #!I50 #!N is 
the object (usually a data field) from which the interactor can 
derive any or all of the minimum, maximum, and delta attributes 
when their corresponding input tab is up. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   
 #!F-adobe-times-bold-r-normal--18*   refresh #!EF #!EF #!I50 #!N resets the interactor so that 
the output is computed from the current input. If  #!F-adobe-times-bold-r-normal--18*   refresh 
#!EF = 0 (the default), the output is recomputed only if 
the current output does not lie within the range of the 
current  #!F-adobe-times-bold-r-normal--18*   data #!EF . The default for the output of 
the interactor is the midpoint of  #!F-adobe-times-bold-r-normal--18*   min #!EF and  #!F-adobe-times-bold-r-normal--18*   
max #!EF . #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   min #!EF and 
 #!F-adobe-times-bold-r-normal--18*   max #!EF #!EF #!I50 #!N specify the minimum and maximum 
values of the interactor's scalar output. If set, these values override 
those implied by  #!F-adobe-times-bold-r-normal--18*   data #!EF . #!N #!N If neither 
 #!F-adobe-times-bold-r-normal--18*   min #!EF nor  #!F-adobe-times-bold-r-normal--18*   data #!EF is specified, the interactor 
uses the minimum set in the  #!F-adobe-times-bold-r-normal--18*   Set Attributes... #!EF dialog 
box. #!N #!N If neither  #!F-adobe-times-bold-r-normal--18*   max #!EF nor  #!F-adobe-times-bold-r-normal--18*   data 
#!EF is specified, the interactor uses the maximum set in the 
 #!F-adobe-times-bold-r-normal--18*   Set Attributes... #!EF dialog box. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
delta #!EF #!EF #!I50 #!N specifies a scalar value as a 
factor for calculating the increment between successive outputs over the specified 
range. The actual value depends on the interpretation specified by  #!F-adobe-times-bold-r-normal--18*   
method #!EF (see below). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   method #!EF 
#!EF #!I50 #!N specifies the interpretation of  #!F-adobe-times-bold-r-normal--18*   delta #!EF : 
#!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N #!I30 #!N o "rounded": the 
increment (  #!F-adobe-times-bold-r-normal--18*   max #!EF -  #!F-adobe-times-bold-r-normal--18*   min #!EF ) * 
 #!F-adobe-times-bold-r-normal--18*   delta #!EF is rounded to a "nice" number. The spacing 
between successive values will approximate the interval specified by  #!F-adobe-times-bold-r-normal--18*   delta 
#!EF . (For example, the default value of 0.01 specifies an 
interval of 1/100 of the specified range.) #!N #!I30 #!N o 
"relative": the interpretation is the same as for "rounded," but the 
increment is  #!F-adobe-times-medium-i-normal--18*   not #!EF rounded. #!N #!I30 #!N o "absolute": 
 #!F-adobe-times-bold-r-normal--18*   delta #!EF is the absolute value of the interval. (If 
 #!F-adobe-times-bold-r-normal--18*   delta #!EF has not been specified, its default is 1.) 
#!N #!N The default value for  #!F-adobe-times-bold-r-normal--18*   method #!EF depends on 
other input. The default is: #!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N 
#!I30 #!N - "rounded" if  #!F-adobe-times-bold-r-normal--18*   data #!EF is specified  #!F-adobe-times-medium-i-normal--18*   
or #!EF if both  #!F-adobe-times-bold-r-normal--18*   min #!EF and  #!F-adobe-times-bold-r-normal--18*   max #!EF 
are specified. #!N #!I30 #!N - "absolute" in all other cases. 
#!N #!I0 #!N #!EF #!N #!N #!I0 #!N #!EF #!N #!N 
#!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   decimals #!EF #!EF #!I50 #!N specifies the 
number of decimal places displayed in the interactor. If neither  #!F-adobe-times-bold-r-normal--18*   
data #!EF nor  #!F-adobe-times-bold-r-normal--18*   delta #!EF is specified, the interactor uses 
the value in its own  #!F-adobe-times-bold-r-normal--18*   Set Attributes... #!EF dialog box. 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   label #!EF #!EF #!I50 #!N is 
the global label of all instances of the corresponding interactor stand-in. 
An interactor instance's local label (set from the Control Panel) overrides 
a global label. By default, the global label is set by 
the user interface. #!I0 #!N #!N #!N #!N Example Visual Programs 
#!N #!N Many example visual programs use the Scalar interactor. DataDrivenInteractors.net 
uses a data-driven scalar interactor. #!N #!N See Also #!N #!N 
 #!Linteger,dxall878 h Integer  #!EL  ,  #!Lintegel,dxall879 h IntegerList  #!EL  ,  #!Lscalarl,dxall933 h ScalarList  #!EL  ,  #!Lvector,dxall977 h Vector  #!EL  ,  #!Lvectorl,dxall978 h VectorList  #!EL  #!N #!N 
#!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Lscalarl,dxall933 h ScalarList  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N