townengine/src/audio.h

#ifndef AUDIO_H
#define AUDIO_H

#include <stdbool.h>


typedef struct play_audio_args {
    /* default: false */
    bool repeat;
    /* crossfade between already playing audio on a given channel, if any */
    /* default: false */
    bool crossfade;
    /* range: 0.0f to 1.0f */
    /* default: 100.0f */
    float volume;
    /* range: -1.0 to 1.0f */
    /* default: 0.0f */
    float panning;
} t_play_audio_args;


/* plays audio file at specified channel or anywhere if NULL is passed */
/* path must contain valid file extension to infer which file format it is */
/* supported formats: .ogg, .xm */
/* preserves args that are already specified on the channel */
void play_audio(const char *path, const char *channel);

void play_audio_ex(const char *path, const char *channel, t_play_audio_args args);

/* could be used for modifying args */
/* warn: is only valid if no other calls to audio are made */
t_play_audio_args *get_audio_args(const char *channel);

t_play_audio_args get_default_audio_args(void);

#endif