audio.h

Go to the documentation of this file.

#ifndef BJ_AUDIO_H
#define BJ_AUDIO_H
 
#include <banjo/error.h>
#include <banjo/api.h>
#include <stdint.h>

typedef struct bj_audio_device_t bj_audio_device;

typedef enum bj_audio_format_t {
    BJ_AUDIO_FORMAT_UNKNOWN = 0x0000,  
    BJ_AUDIO_FORMAT_INT16   = 0x8010,  
    BJ_AUDIO_FORMAT_F32     = 0x8120,  
} bj_audio_format;

#define BJ_AUDIO_FORMAT_WIDTH(x)         ((x) & (0xFFu))

#define BJ_AUDIO_FORMAT_FLOAT(x)         ((x) & (1u<<8))

#define BJ_AUDIO_FORMAT_INT(x)           (!((x) & (1u<<8)))

#define BJ_AUDIO_FORMAT_BIG_ENDIAN(x)    ((x) & (1u<<12))

#define BJ_AUDIO_FORMAT_SIGNED(x)        ((x) & (1u<<15))

typedef struct bj_audio_properties_t {
    bj_audio_format format;      
    int16_t         amplitude;   
    unsigned int    channels;    
    unsigned int    sample_rate; 
} bj_audio_properties;

typedef void (*bj_audio_callback_t)(
    void*                     buffer,
    unsigned                  frames,
    const bj_audio_properties* audio,
    void*                     user_data,
    uint64_t                  base_sample_index
);

BANJO_EXPORT bj_audio_device* bj_open_audio_device(
    const bj_audio_properties* p_properties,
    bj_audio_callback_t        p_callback,
    void*                      p_callback_user_data,
    bj_error**                 p_error
);

BANJO_EXPORT void bj_close_audio_device(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_play_audio_device(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_pause_audio_device(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_reset_audio_device(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_stop_audio_device(
    bj_audio_device* p_device
);

BANJO_EXPORT bj_bool bj_audio_playing(
    const bj_audio_device* p_device
);

typedef struct bj_audio_play_note_data_t {
    enum {
        BJ_AUDIO_PLAY_SINE,      
        BJ_AUDIO_PLAY_SQUARE,    
        BJ_AUDIO_PLAY_TRIANGLE,  
        BJ_AUDIO_PLAY_SAWTOOTH,  
    } function;                  
    double frequency;            
    double phase;                
} bj_audio_play_note_data;

BANJO_EXPORT void bj_play_audio_note(
    void*                      buffer,
    unsigned                   frames,
    const bj_audio_properties* audio,
    void*                      user_data,
    uint64_t                   base_sample_index
);

typedef struct bj_audio_layer_t {
    void (*end)(struct bj_audio_layer_t* self, bj_error** p_error);

    void (*close_device)(struct bj_audio_layer_t* self, bj_audio_device* device);

    bj_audio_device* (*open_device)(
        struct bj_audio_layer_t* self,
        const bj_audio_properties* p_properties,
        bj_audio_callback_t callback,
        void* user_data,
        bj_error** p_error
    );

    struct bj_audio_layer_data_t* data;
} bj_audio_layer;

typedef struct {
    const char* name;                          
    bj_audio_layer* (*create)(bj_error**);     
} bj_audio_layer_create_info;
 
#endif /* BJ_AUDIO_H */