std.audio.mpg123
mpg123 ist eine leistungsstarke Open-Source-Bibliothek zur Dekodierung von MP3-Audiodaten. Die Unit ermöglicht das stream-basierte Lesen und Dekodieren von MP3-Dateien inklusive automatischer Format-Erkennung (Samplerate, Kanäle, Encoding). Der dekodierte PCM-Datenstrom kann direkt an ALSA oder einen anderen Audio-Ausgabepfad weitergeleitet werden.
Typische Einsatzbereiche sind Mediaplayer, Audiostreaming, Transkodierung, Sprachverarbeitung und alle Anwendungen, die MP3-Audiodaten dekodiert lesen müssen.
Konstanten
| Name | Typ | Wert | Sichtbarkeit |
MPG123_OK | int64 | 0 | pub |
MPG123_ERROR | int64 | -1 | pub |
MPG123_NEED_MORE | int64 | -2 | pub |
MPG123_DONE | int64 | -12 | pub |
MPG123_NEW_FORMAT | int64 | -3 | pub |
MPG123_ACCURATE | int64 | 256 | pub |
MPG123_GAPLESS | int64 | 512 | pub |
MPG123_SEEK_BUFFER | int64 | 1024 | pub |
MPG123_ENC_SIGNED_16 | int64 | 4 | pub |
Externe Funktionen
| Signatur | Beschreibung |
mpg123_init(): int64 | Initialisiert mpg123-Bibliothek global |
mpg123_exit() | Gibt globale mpg123-Ressourcen frei |
mpg123_new(decoder: int64, err: int64): int64 | Erstellt neuen Decoder-Handle |
mpg123_delete(handle: int64) | Löscht Decoder-Handle und Ressourcen |
mpg123_open(handle: int64, path: pchar): int64 | Öffnet MP3-Datei am Handle |
mpg123_close(handle: int64) | Schließt geöffnete MP3-Datei |
mpg123_fmt(handle: int64, rate: int64, channels: int64, encoding: int64): int64 | Setzt erlaubtes Ausgabeformat |
mpg123_open_fixed(handle: int64, path: pchar, channels: int64, encoding: int64): int64 | Öffnet Datei mit festem Format |
mpg123_getformat(handle: int64, rate: int64, channels: int64, encoding: int64): int64 | Liest aktuelles Dekodierformat aus |
mpg123_strerror(handle: int64): pchar | Gibt Fehlermeldungstext des Handles |
mpg123_read(handle: int64, buffer: int64, bufSize: int64, done: int64): int64 | Dekodiert MP3-Daten in Puffer |
mpg123_decode_frame(handle: int64, num_ptr: int64, audio_ptr: int64, bytes_ptr: int64): int64 | Dekodiert einzelnen MP3-Frame |
Funktionen
| Signatur | Sichtbarkeit | Beschreibung |
MP3Init(): int64 | pub | Initialisiert mpg123 und erstellt Handle |
MP3OpenFile(handle: int64, path: pchar): int64 | pub | Öffnet MP3-Datei mit festem Format |
MP3Read(handle: int64, buffer: int64, bufSize: int64, donePtr: int64): int64 | pub | Liest dekodierte PCM-Daten in Puffer |
MP3GetFormat(handle: int64): int64 | pub | Gibt Samplerate des Streams zurück |
MP3Close(handle: int64) | pub | Schließt Handle und gibt Ressourcen frei |
