InitSound()

Syntax

Ergebnis = InitSound([AnzMaxKanäle])

Initialisiert die Sound-Programmumgebung. Diese Funktion muss immer vor allen anderen Soundbefehlen aufgerufen und ihr Ergebnis überprüft werden. Wenn die Initialisierung der Sound-Umgebung fehlschlägt, ist es absolut notwendig, alle weiteren Aufrufe von Soundbefehlen zu deaktivieren.

Parameter

AnzMaxKanäle (optional)

Legt die maximale Anzahl von Kanälen fest, die gleichzeitig zum Abspielen von Sounds verwendet werden sollen. Der Wert kann zwischen 1 und 254 liegen (der Standardwert, wenn dieser Parameter nicht angegeben wird, ist 64).

Rückgabewert

Ein Wert ungleich Null, wenn die Sound-Umgebung korrekt eingerichtet wurde, andernfalls Null (z.B. wenn keine Soundkarte verfügbar ist).

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")
      PlaySound(0, #PB_Sound_Loop) ; Abspielen des Sounds in einer Schleife starten
      
      MessageRequester("Info", "Ok zum Stoppen.")
      
      FreeSound(0) ; Der Sound wird freigegeben
    EndIf
    End
  Else
    Debug "Warnung! Die Sound-Umgebung konnte nicht initialisiert werden. Daher können keine Sound-Befehle verwendet werden..."
  EndIf

Unterstützte OS

Alle