Versione attuale delle 16:28, 4 gen 2022

Va precisato che ormai la Libreria SDL è obsoleta: al suo posto va utilizzata la Libreria SDL2.

La libreria SDL è un API multi-piattaforma contenente funzioni per la gestione multimediale dell'audio e del video.

Per poter eseguire file Midi, è necessario utilizzare la libreria SDL_mixer che viene utilizzata con la libreria SDL. Essa, più in generale, permette ai programmatori di usare più campioni con la musica, e di semplificare la gestione del caricamento, della riproduzione di campioni e della musica da diversi tipi di formati di file.
Per l'ascolto dei file Midi, si potrà anche impostare il file banco di suoni .sf2 nell'apposita funzione Mix_SetSoundFonts().

Per utilizzare in Gambas le risorse della libreria libSDL_mixer, bisognerà richiamare la libreria: libSDL_mixer-1.2.so.0.12.0

Mostriamo di seguito un semplice codice per eseguire un file Midi in un'applicazione a riga di comando:

Private Const AUDIO_S16SYS As Integer = 32784
Private Const STEREO As Integer = 2


Library "libSDL_mixer-1.2:0.12.0"

' int Mix_SetSoundFonts(const char *paths)
' Set SoundFonts paths to use by supported MIDI backends.
Private Extern Mix_SetSoundFonts(paths As String) As Integer

' int Mix_OpenAudio(Int frequency, Uint16 Format, Int channels, Int chunksize)
' Open the mixer with a certain audio format.
Private Extern Mix_OpenAudio(frequency As Integer, formatSh As Short, channels As Byte, chunksize As Integer) As Integer

' Mix_Music *Mix_LoadMUS(const char *file)
' Load a wave file or a music.
Private Extern Mix_LoadMUS(file As String) As Pointer

' int Mix_PlayMusic(Mix_Music *music, int loops)
' Play an audio chunk on a specific channel.
Private Extern Mix_PlayMusic(music As Pointer, loops As Integer) As Integer

' Int Mix_PlayingMusic()
' Check the status of a specific channel.
Private Extern Mix_PlayingMusic() As Integer

' void Mix_FreeChunk(Mix_Chunk *chunk)
' Free an audio chunk previously loaded.
Private Extern Mix_FreeChunk(chunk As Pointer)

' char * Mix_GetError()
' For reporting errors.
Private Extern Mix_GetError() As String

' void Mix_CloseAudio(void)
' Close the mixer, halting all playing audio.
Private Extern Mix_CloseAudio()


Public Sub Main()

 Dim err As Integer
 Dim audio_rate As Integer = 44100   ' Imposta la frequenza che verrà usata da "SDL_mixer"
 Dim audio_buffers As Short = 4096   ' Determina la quantità di blocchi di memoria utilizzati per incamerare ed eseguire l'audio
 Dim music As Pointer
 Dim tm As Date

' Volendo, è possibile anche impostare il banco di suoni per l'esecuzione del Midi:
 Mix_SetSoundFonts("/percorso/del/file/soundbank.sf2")
  
' Inizializza la libreria "SDL_mixer" con specifiche impoostazioni audio:
 err = Mix_OpenAudio(audio_rate, AUDIO_S16SYS, STEREO, audio_buffers)
 If err <> 0 Then Error.Raise("Impossibile inizializzare l'audio: " & Mix_GetError())
 
' Carica il file Midi:
 music = Mix_LoadMUS("/percorso/del/file.mid")
 If music == 0 Then Error.Raise("Impossibile caricare il file Midi: " & Mix_GetError())

' Esegue il file Midi. Se il secondo argomento è posto a 0 il file sarà eseguito soltanto una volta.
' Se è posto a -1 il file sarà eseguito all'infinito:
 err = Mix_PlayMusic(music, 0)
 If err < 0 Then Error.Raise("Impossibile eseguire il file Midi: " & Mix_GetError())

 tm = Now
 
' Effettua un ciclo per consentire l'esecuzione del file Midi e ne usce solo al termine dell'esecuzione:
 Repeat 
   Write "\r" & Str(Time(0, 0, 0, DateDiff(tm, Now, gb.Millisecond)))
   Wait 0.01
 Until Mix_PlayingMusic() == 0
 
' Libera la memoria precedentemente allocata per l'esecuzione sonora:
   Mix_FreeChunk(music)
' Chiude l'interfaccia audio SDL_mixer:
   Mix_CloseAudio()
 
End

Riferimenti

• Il sito dell'API di SDL.
• http://www.libsdl.org/projects/SDL_mixer/
• il sito di www.webkinesia.com