decoder.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
#pragma once
 
#include "audio_player/audio.h"
#include "audio_player/stream.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum {
    CODEC_UNKNOWN = 0,
    CODEC_WAV,
    CODEC_AIFF,
    CODEC_FLAC,
    CODEC_MP3,
    CODEC_VORBIS,
    CODEC_OPUS,
    CODEC_AAC,
    CODEC_ALAC,
    CODEC_WAVPACK,
    CODEC_APE,
    CODEC_DSF,
    CODEC_DFF,
    CODEC_COUNT
} codec_id_t;
 
const char *codec_name(codec_id_t id);   
bool codec_is_lossless(codec_id_t id);
 
codec_id_t codec_from_extension(const char *ext);
bool codec_is_audio_extension(const char *ext);
 
typedef struct {
    codec_id_t codec;
    audio_format_t fmt;        
    uint64_t total_frames;     
    uint32_t bitrate_kbps;     
    bool seekable;
} decoder_info_t;
 
typedef struct decoder decoder_t;
 
codec_id_t decoder_probe(core_stream_t *s, const char *path_hint);
 
decoder_t *decoder_open(core_stream_t *s, const char *path_hint, decoder_info_t *info, int *err);
 
int32_t decoder_read(decoder_t *d, int32_t *out, uint32_t max_frames);
 
int decoder_seek(decoder_t *d, uint64_t frame);
uint64_t decoder_tell(decoder_t *d);          
const decoder_info_t *decoder_info(const decoder_t *d);
void decoder_close(decoder_t *d);
 
// ---------------------------------------------------------------------------
// ---------------------------------------------------------------------------
typedef struct {
    codec_id_t id;
    bool (*probe)(const uint8_t *head, size_t head_len, const char *ext);
    void *(*open)(core_stream_t *s, decoder_info_t *info, int *err);
    int32_t (*read)(void *state, int32_t *out, uint32_t max_frames);
    int (*seek)(void *state, uint64_t frame);
    void (*close)(void *state);  
} decoder_backend_t;
 
#ifdef __cplusplus
}
#endif