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.8.6.27  v_exit_cur                                               TOS

 Name:         »Exit alpha mode« - Switch text mode off for screen or 
               metafile.

 Opcode:       5 (Escape 2)

 Syntax:       void v_exit_cur ( int16_t handle );

 Description:  The call v_exit_cur switches off the alpha mode on the 
               workstation with the ID handle (screen or metafile) if 
               the alpha and graphic modes are different.

               The alpha mode is the normal text mode without any 
               graphics, such as used by the desktop for depicting 
               files and folders in windows set to 'Display > As Text' 
               for instance.

               Note: The function also clears the graphics screen and 
               restores the mouse pointer (to completely restore the 
               screen, you should call form_dial( FMD_FINISH sx, sy, 
               sw, sh ) where sx, sy, sw, sh are the coordinates of 
               the screen); with a metafile a corresponding entry is 
               made in the file.

 Return value: The function does not return a result.

 Availability: Supported by all screen drivers.

 Group:        Text functions

 See Also:     Binding   v_enter_cur