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>

struct bj_audio_device;

enum bj_audio_format {
    BJ_AUDIO_FORMAT_UNKNOWN = 0x0000,  
    BJ_AUDIO_FORMAT_INT16   = 0x8010,  
    BJ_AUDIO_FORMAT_F32     = 0x8120,  
};
#ifndef BJ_NO_TYPEDEF
typedef enum bj_audio_format bj_audio_format;
#endif

#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))

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

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

BANJO_EXPORT struct bj_audio_device* bj_open_audio_device(
    const struct bj_audio_properties* properties,
    bj_audio_callback_fn        callback,
    void*                      callback_user_data,
    struct bj_error**                 error
);

BANJO_EXPORT void bj_close_audio_device(
    struct bj_audio_device* device
);

BANJO_EXPORT void bj_play_audio_device(
    struct bj_audio_device* device
);

BANJO_EXPORT void bj_pause_audio_device(
    struct bj_audio_device* device
);

BANJO_EXPORT void bj_reset_audio_device(
    struct bj_audio_device* device
);

BANJO_EXPORT void bj_stop_audio_device(
    struct bj_audio_device* device
);

BANJO_EXPORT bj_bool bj_audio_playing(
    const struct bj_audio_device* device
);

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

BANJO_EXPORT void bj_play_audio_note(
    void*                      buffer,
    unsigned                   frames,
    const struct bj_audio_properties* audio,
    void*                      user_data,
    uint64_t                   base_sample_index
);
 
#endif /* BJ_AUDIO_H */