Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File4.17.109  WavePlay                                                 TOS

 Name:         »WavePlay« - Abspielen eines Samples

 Xbiosnummer:  165

 Deklaration:  int32_t WavePlay( int16_t flags, int32_t rate, int32_t 
               sptr, int32_t slen );

 Beschreibung: Die XBIOS-Routine WavePlay startet das abspielen eines 
               Samples.

               flags ist ein Bitvektor für die Beschreibung des 
               Samples bzw. auszuführenden Funktion:

               Bit 0 gesetzt: Sample ist Mono.
               Bit 1 gesetzt: Sample ist 16Bit.

               Ist Bit 5 im '_SND' Cookie gesetzt.

               Bit 4 gesetzt: Sample ist, wenn 16Bit, Intelformat.
               Bit 5 gesetzt: Sample ist ohne Vorzeichen.
               Bit 6 gesetzt: Sampleformat ist so wie es von 
               MilanBlaster aufgenommen wurde.

               Bit 8 gesetzt: siehe Beschreibung im Atari Compendium 
               Band I, XBIOS 4.110-4.112. Wird vom MilanBlaster-XBios 
               nicht unterstützt.

               rate ist die Samplefrequenz in Hz.

               sptr ist die Startadresse des Samples. (kann bei 
               MilanBlaster auch im TT-Ram liegen)

               slen ist die länge des Samples in Byte.

 Ergebnis:     Im Erfolgsfall liefert die Funktion den Wert 0, die 
               Wiedergabe wurde dann gestartet und kann durch 
               buffoper(0) jederzeit unterbrochen werden. Das Ende des 
               Samples wurde erreicht wenn buffoper(-1) Bit 0 gelöscht 
               ist.

 Verfügbar:    Die Funktion ist verfügbar wenn Bit 5 im '_SND' Cookie 
               gesetzt oder der 'SAM\0' Cookie vorhanden ist.

 Gruppe:       Soundroutinen

 Querverweis:  Binding