SoundVolume()

Syntax

SoundVolume(#Sound, Lautstärke.f [, Kanal])

Ändert in Echtzeit die Lautstärke des Sounds.

Parameter

#Sound	Der zu verwendende Sound. Wenn #PB_All angegeben wird, dann sind alle Sounds (und alle Kanäle) betroffen.
Lautstärke.f	Die neue Lautstärke des Sounds. Gültige Werte reichen von 0 (keine Lautstärke) bis 100 (volle Lautstärke).
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 Sound-Lautstärke liegt bei 20%")
      
      SoundVolume(0, 80)
      MessageRequester("Info", "Die Sound-Lautstärke liegt bei 80%")
      
      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

LoadSound()

Unterstützte OS

Alle