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-File12.1.11.7  controlSwitch                                           TOS

Here Atari routines can hook themselves in with the XBRA procedure. 
They are then called in Atari-mode (supervisor-mode) when one of the 
specified events occurs. This is required, for instance, when an Atari 
program wants to make use of certain Macintosh routines. For example, 
a program using the sound routines of the Mac can be told in this way 
when MagiC Mac has been terminated to close the sound channels and to 
release the occupied memory.

The following values are passed in d0.W and on the stack (and must 
also remain there):

 Value  Description

 0      Hide
        Mouse and keyboard control for MagiC are suspended, because a 
        Mac dialog is opened, for instance; in that case there should 
        be no output to the screen either (e.g. for interrupt 
        routines) as otherwise these could overwrite the Macintosh 
        dialog
 1      Show
        The opposite of Hide

Note: The routine has to be called in Atari supervisor-mode, the USP 
is undefined.

See also: The MagiC Mac cookie   Cookie and XBRA list