audio.h

Go to the documentation of this file.

#pragma once
 
#include <banjo/error.h>
#include <banjo/api.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_audio_device_play(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_audio_device_pause(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_audio_device_reset(
    bj_audio_device* p_device
);

BANJO_EXPORT void bj_audio_device_stop(
    bj_audio_device* p_device
);

BANJO_EXPORT bj_bool bj_audio_device_is_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_audio_play_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;