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

  If InitSound()           ; Initialisieren des Sound-Systems
    UseOGGSoundDecoder()   ; Verwenden von Ogg-Dateien
    
    ; Lädt einen Sound aus einer Datei
    If 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
    EndIf
  Else
    Debug "Warnung! Die Sound-Umgebung konnte nicht initialisiert werden. Daher können keine Sound-Befehle verwendet werden..."
  EndIf

Siehe auch

GetSoundFrequency()

Unterstützte OS

Windows