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-File4.5.21  VSetscreen                                                 TOS

 Name:         »set screen« - initializes the screen.

 Opcode:       5

 Syntax:       void VSetscreen( void *laddr, void *paddr, int16_t rez, 
               int16_t mode );

 Description:  The XBIOS routine VsetScreen corresponds to the 
               Setscreen function with an additional parameter, and 
               serves for altering the current screen resolution and 
               screen memory addresses.

                Parameter  Meaning 
                laddr      Address of the logical screen memory 
                paddr      Address of the physical screen memory 
                rez        0 = ST Low 
                           1 = ST Medium 
                           2 = ST High 
                           3 = Resolution used, from mode 
                mode       modecode (see VsetMode) 

               A value of -1 here means that the corresponding address 
               or resolution will not be altered.

               Note: One should always check whether possible changes 
               were really performed successfully. During resolution 
               changes the VT52 emulator is automatically initialized.

               The additional parameter mode is only available if the 
               cookie '_VDO' has the value 0x00030000 or greater.

               For the TOS of the Milan there is an additional 
               function for Setscreen, entsprechendes gilt auch für 
               den ct60.

 Return value: The function does not return a result.

 Availability: The function is only available on computers of the 
               Falcon series.

 Group:        Screen functions

 See also:     Binding