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.17.53  mix                                                       TOS

 Name:         »mix« - Mixes 2, 4, 6 or 8 stereo channels

 Opcode:       500, 100

 Syntax:       int32_t xbios ( 500, 100, int16_t channels, int32_t 
               startadr, int32_t len, int32_t zieladr, int32_t voltab 
               );

 Description:  Mixes 2, 4, 6 or 8 stereo channels (= 4, 8, 12 or 16 
               tracks) to one stereo channel

                channels    Number of tracks (4, 8, 12 or 16)
                startradr   Start address of tracks to be mixed
                len         Length of a stereo track
                zieladr     Start address for the mixed stereo track
                voltab      Pointer to track volume value table
                            int8_t VOL-STEREOTRACK1
                            int8_t VOL-STEREOTRACK2 etc.
                            ...
                            int8_t VOL-STEREOTRACK8


               The tracks to be mixed lie in memory as stereo tracks 
               following each other. The volume value table contains 
               the sound volume for the individual channels in the 
               region 0-200:
                 0 = Mute
                50 = Half volume
               100 = Original volume
               200 = Double volume


 Return value: 0 - No error

 Availability: This function is only available when the driver of the 
               StarTrack sound card has been launched.

 Group:        Sound routines

 See also:     Binding