FreeSound()

Syntax

FreeSound(#Sound)

Hält den zuvor mit LoadSound() oder CatchSound() geladenen Sound an und entfernt ihn aus dem Speicher. Sobald ein Sound freigegeben wurde, kann er nicht mehr abgespielt werden.

Parameter

#Sound

Der freizugebende Sound. Wenn #PB_All angegeben wird, dann werden alle verbleibenden Sounds freigegeben.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Alle verbliebenen Sounds werden automatisch freigegeben, wenn das Programm endet.

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)
      
      MessageRequester("Info", "zum Stoppen.")
      
      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

Unterstützte OS

Alle