SetSoundFrequency()

Syntax

SetSoundFrequency(#Sound, Frequenz [, Kanal])

Legt in Echtzeit die neue Frequenz für den Sound fest. Der neue Frequenz-Wert wird für den Sound gespeichert - deshalb ist es nicht nötig, diesen jedes Mal aufzurufen.

Parameter

#Sound	Der zu verwendende Sound.
Frequenz	Die für den Sound festzulegende neue Frenquenz (in Hz). Gültige Werte reichen von 1000 Hz bis 100000 Hz.
Kanal (optional)	Der zu verwendende Kanal. Dabei handelt es sich um den von den PlaySound() zurückgegebenen Wert, wenn das #PB_Sound_MultiChannel Flag verwendet wird. Wenn #PB_All angegeben wird, dann sind alle Kanäle des Sounds betroffen.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

 InitSound()           ; Initialisieren des Sound-Systems
 UseOGGSoundDecoder()  ; Verwenden von Ogg-Dateien

 ; Lädt einen Sound aus einer Datei
 LoadSound(0, #PB_Compiler_Home +"Examples\3D\Data\Siren.ogg")
 ; Der Sound wird abgespielt
 PlaySound(0, #PB_Sound_Loop, 20)
 
 MessageRequester("Info", "Die durchschnittliche Frequenz ist " + Str(GetSoundFrequency(0))+" Hz")
 PauseSound(0)
 
 SetSoundFrequency(0,16000)
 
 ResumeSound(0)
 
 MessageRequester("Info", "Die durchschnittliche Frequenz ist " + Str(GetSoundFrequency(0))+" Hz")
 
 FreeSound(0) ; Der Sound wird freigegeben
 End

Siehe auch

GetSoundFrequency()

Unterstützte OS

Windows