#!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
Generated by dwww version 1.15 on Sat Jun 22 12:45:46 CEST 2024.