forked from LeenkxTeam/LNXSDK
68 lines
1.8 KiB
C
68 lines
1.8 KiB
C
#pragma once
|
|
|
|
#include <kinc/global.h>
|
|
|
|
#include <kinc/audio2/audio.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
/*! \file sound.h
|
|
\brief Sounds are pre-decoded on load and therefore primarily useful for playing sound-effects.
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct kinc_a1_sound {
|
|
uint8_t channel_count;
|
|
uint8_t bits_per_sample;
|
|
uint32_t samples_per_second;
|
|
int16_t *left;
|
|
int16_t *right;
|
|
int size;
|
|
float sample_rate_pos;
|
|
float volume;
|
|
bool in_use;
|
|
} kinc_a1_sound_t;
|
|
|
|
typedef enum { KINC_A1_AUDIOFORMAT_WAV, KINC_A1_AUDIOFORMAT_OGG } kinc_a1_audioformat_t;
|
|
|
|
/// <summary>
|
|
/// Create a sound from a wav or ogg file.
|
|
/// </summary>
|
|
/// <param name="filename">Path to a wav or ogg file</param>
|
|
/// <returns>The newly created sound</returns>
|
|
KINC_FUNC kinc_a1_sound_t *kinc_a1_sound_create(const char *filename);
|
|
|
|
/// <summary>
|
|
/// Create a sound from a buffer.
|
|
/// </summary>
|
|
/// <param name="filename">Path to a wav file</param>
|
|
/// <returns>The newly created sound</returns>
|
|
KINC_FUNC kinc_a1_sound_t *kinc_a1_sound_create_from_buffer(uint8_t *audio_data, const uint32_t size, kinc_a1_audioformat_t format);
|
|
|
|
/// <summary>
|
|
/// Destroy a sound.
|
|
/// </summary>
|
|
/// <param name="sound">The sound to destroy.</param>
|
|
KINC_FUNC void kinc_a1_sound_destroy(kinc_a1_sound_t *sound);
|
|
|
|
/// <summary>
|
|
/// Gets the current volume-multiplicator that's used when playing the sound.
|
|
/// </summary>
|
|
/// <param name="sound">The sound to query</param>
|
|
/// <returns>The volume-multiplicator</returns>
|
|
KINC_FUNC float kinc_a1_sound_volume(kinc_a1_sound_t *sound);
|
|
|
|
/// <summary>
|
|
/// Sets the volume-multiplicator that's used when playing the sound.
|
|
/// </summary>
|
|
/// <param name="sound">The sound to modify</param>
|
|
/// <param name="value">The volume-multiplicator to set</param>
|
|
KINC_FUNC void kinc_a1_sound_set_volume(kinc_a1_sound_t *sound, float value);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|