dx-doc 1:4.4.4-9 / usr / share / doc / dx / help / dxall958

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rsupstat 
SuperviseState #!N #!N Category #!N #!N  #!Lcatwin,dxall764 h Windows  #!EL  #!N #!N Function #!N 
#!N Manages the object and/or camera associated with an image window 
created using SuperviseWindow. #!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N 
 #!F-adobe-times-bold-r-normal--18*   object, camera, where, events #!EF = SuperviseState(  #!F-adobe-times-bold-r-normal--18*   where,defaultCamera, resetCamera, 
#!N object, resetObject, size, #!N events, mode, args #!EF ); #!EF 
#!N #!N #!EC #!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 where 
TAB string TAB (none) TAB the window for which objects and 
#!N TAB - TAB - TAB - TAB cameras are to 
be manipulated #!N TAB defaultCamera TAB camera TAB (none) TAB initial 
or default camera #!N TAB resetCamera TAB flag TAB 0 TAB 
whether to reset camera to the #!N TAB - TAB - 
TAB - TAB default #!N TAB object TAB object TAB (none) 
TAB initial or default object #!N TAB resetObject TAB flag TAB 
0 TAB whether to reset object to the #!N TAB - 
TAB - TAB - TAB default #!N TAB size TAB vector 
or integer list TAB (none) TAB size #!N TAB events TAB 
object TAB (none) TAB mouse or keyboard events from #!N TAB 
- TAB - TAB - TAB SuperviseWindow #!N TAB mode TAB 
integer TAB (none) TAB specifies the mode, or which #!N TAB 
- TAB - TAB - TAB UserInteractor to enable #!N TAB 
args TAB object TAB (none) TAB interactor arguments #!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 
object TAB object TAB current object #!N TAB camera TAB camera 
TAB current camera #!N TAB where TAB string TAB input where 
#!N TAB events TAB string TAB unhandled events #!N TAB - 
TAB - TAB #!EF #!N #!N Functional Details #!N #!N Briefly, 
this module allows a user to specify the particular action that 
should be taken on mouse or keyboard events in a window 
created using SuperviseWindow. The SuperviseState module is expected to be used 
together with SuperviseWindow and Display to create and display a window. 
These modules are used as an alternative to the Image tool. 
See  #!Lsupwind,dxall961 h SuperviseWindow  #!EL  for a more complete discussion of the use of 
the Supervise modules and the benefits one gets with respect to 
the simple use of the Image tool. #!N #!N Actions are 
specified using user-supplied routines called UserInteractors. A single UserInteractor is the 
set of actions which take place for any mouse or keyboard 
event for a given  #!F-adobe-times-bold-r-normal--18*   mode #!EF . For example, a 
single  #!F-adobe-times-bold-r-normal--18*   mode #!EF may define different behaviors for left, middle, 
and right mouse actions. An arbitrary number of different modes can 
be defined, providing a limitless number of different user interactions with 
the image. Note that this implies that different actions (for example 
zoom and translate) can be implemented either as different modes using 
the same mouse button, as the same mode with different mouse 
buttons, or of course, different modes and different buttons. #!N #!I0 
#!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   where #!EF #!EF #!I50 #!N 
the window for which objects and cameras are to be manipulated. 
This input should be supplied by the  #!F-adobe-times-bold-r-normal--18*   where #!EF output 
of SuperviseWindow. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   defaultCamera #!EF #!EF #!I50 
#!N is the initial or default camera. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   
 #!F-adobe-times-bold-r-normal--18*   resetCamera #!EF #!EF #!I50 #!N indicates whether to reset camera 
to the default #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   object #!EF #!EF 
#!I50 #!N is the initial or default object #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   resetObject #!EF #!EF #!I50 #!N indicates whether to reset 
object to the default #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   size #!EF 
#!EF #!I50 #!N is the current size of the image, and 
should be supplied by the  #!F-adobe-times-bold-r-normal--18*   size #!EF output of SuperviseWindow 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   events #!EF #!EF #!I50 #!N mouse 
or keyboard events. Should be supplied by the  #!F-adobe-times-bold-r-normal--18*   events #!EF 
output of SuperviseWindow #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   mode #!EF #!EF 
#!I50 #!N specifies the mode, (which UserInteractor to enable). The set 
of user-defined UserInteractors is created as a table of callbacks. The 
 #!F-adobe-times-bold-r-normal--18*   mode #!EF value specifies which entry in that table is 
to be called. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   args #!EF #!EF 
#!I50 #!N interactor arguments as required by a UserInteractor. #!I0 #!N 
#!N #!N #!N The following are output parameters: #!N #!I0 #!N 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   object #!EF #!EF #!I50 #!N current 
object; should be passed to the  #!F-adobe-times-bold-r-normal--18*   object #!EF input of 
Display. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   camera #!EF #!EF #!I50 #!N 
current camera; should be passed to the  #!F-adobe-times-bold-r-normal--18*   camera #!EF input 
of Display #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   where #!EF #!EF #!I50 
#!N Window where parameter; should be passed to the  #!F-adobe-times-bold-r-normal--18*   where 
#!EF input of Display. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   events #!EF 
#!EF #!I50 #!N are unhandled events, that is any mouse or 
keyboard events that have been masked off within the routine InitMode, 
described in UserInteractors. #!I0 #!N #!N #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next 
Topic #!EF #!N #!N  #!Lall958,dxall959 h UserInteractors  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N