Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.7.33  vsm_valuator                                               TOS

 Name:         »Input valuator, Sample mode« - Obtain value changes of 
               input devices in SAMPLE mode.

 Opcode:       29

 Syntax:       void vsm_valuator ( int16_t handle, int16_t val_in, 
               int16_t *val_out, int16_t *term, int16_t *status );

 Description:  The call vsm_valuator retrieves value changes from the 
               'valuator' device in SAMPLE mode. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                val_in     Initial value
                val_out    Final value
                term       ASCII-code of pressed key
                status     Evaluation:
                            0 =     No change
                            1 =     Value changed
                            2 =     Key pressed

               Values between 1 and 100 are returned if a correspon- 
               ding event has occurred; otherwise no value is 
               returned.

               Note: The function is not supported by all device 
               drivers (also not in the ROM). The input functions of 
               the VDI work only on the physical workstation, which is 
               normally used by the AES.

 Return value: The function does not return a result.

 Availability: The function is not guaranteeed to be available with 
               any driver and its use should therefore be restricted.

 Group:        Input functions

 See Also:     Binding   vrq_valuator   vsin_mode