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.17  Setscreen                                                  TOS

 Name:         »set screen« - Initializes the screen.

 Opcode:       5

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

 Description:  The XBIOS routine Setscreen serves to alter the screen 
               resolution and screen memory addresses. The following 
               apply:

                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 

               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.

               Under some circumstances there is an extended version 
               of this function (VsetScreen).

 Return value: The function does not return a result.

 Availability: All TOS versions.

 Group:        Screen functions

 See also:     Binding   Physbase   Logbase   Getrez