ags_audio_buffer_util: Advanced Gtk+ Sequencer Audio Reference Manual

ags_audio_buffer_util

Functions

#define	AGS_AUDIO_BUFFER_S8()
#define	AGS_AUDIO_BUFFER_S16()
#define	AGS_AUDIO_BUFFER_S24()
#define	AGS_AUDIO_BUFFER_S32()
#define	AGS_AUDIO_BUFFER_S64()
#define	AGS_AUDIO_BUFFER_FLOAT()
#define	AGS_AUDIO_BUFFER_DOUBLE()
guint	ags_audio_buffer_util_format_from_soundcard ()
guint	ags_audio_buffer_util_get_copy_mode ()
void	ags_audio_buffer_util_clear_float ()
void	ags_audio_buffer_util_clear_double ()
void	ags_audio_buffer_util_clear_buffer ()
gdouble	ags_audio_buffer_util_envelope_s8 ()
gdouble	ags_audio_buffer_util_envelope_s16 ()
gdouble	ags_audio_buffer_util_envelope_s24 ()
gdouble	ags_audio_buffer_util_envelope_s32 ()
gdouble	ags_audio_buffer_util_envelope_s64 ()
gdouble	ags_audio_buffer_util_envelope_float ()
gdouble	ags_audio_buffer_util_envelope_double ()
gdouble	ags_audio_buffer_util_envelope ()
void	ags_audio_buffer_util_volume_s8 ()
void	ags_audio_buffer_util_volume_s16 ()
void	ags_audio_buffer_util_volume_s24 ()
void	ags_audio_buffer_util_volume_s32 ()
void	ags_audio_buffer_util_volume_s64 ()
void	ags_audio_buffer_util_volume_float ()
void	ags_audio_buffer_util_volume_double ()
void	ags_audio_buffer_util_volume ()
signed char *	ags_audio_buffer_util_resample_s8 ()
signed short *	ags_audio_buffer_util_resample_s16 ()
signed long *	ags_audio_buffer_util_resample_s24 ()
signed long *	ags_audio_buffer_util_resample_s32 ()
signed long long *	ags_audio_buffer_util_resample_s64 ()
float *	ags_audio_buffer_util_resample_float ()
double *	ags_audio_buffer_util_resample_double ()
void *	ags_audio_buffer_util_resample ()
void	ags_audio_buffer_util_copy_s8_to_s8 ()
void	ags_audio_buffer_util_copy_s8_to_s16 ()
void	ags_audio_buffer_util_copy_s8_to_s24 ()
void	ags_audio_buffer_util_copy_s8_to_s32 ()
void	ags_audio_buffer_util_copy_s8_to_s64 ()
void	ags_audio_buffer_util_copy_s8_to_float ()
void	ags_audio_buffer_util_copy_s8_to_double ()
void	ags_audio_buffer_util_copy_s16_to_s8 ()
void	ags_audio_buffer_util_copy_s16_to_s16 ()
void	ags_audio_buffer_util_copy_s16_to_s24 ()
void	ags_audio_buffer_util_copy_s16_to_s32 ()
void	ags_audio_buffer_util_copy_s16_to_s64 ()
void	ags_audio_buffer_util_copy_s16_to_float ()
void	ags_audio_buffer_util_copy_s16_to_double ()
void	ags_audio_buffer_util_copy_s24_to_s8 ()
void	ags_audio_buffer_util_copy_s24_to_s16 ()
void	ags_audio_buffer_util_copy_s24_to_s24 ()
void	ags_audio_buffer_util_copy_s24_to_s32 ()
void	ags_audio_buffer_util_copy_s24_to_s64 ()
void	ags_audio_buffer_util_copy_s24_to_float ()
void	ags_audio_buffer_util_copy_s24_to_double ()
void	ags_audio_buffer_util_copy_s32_to_s8 ()
void	ags_audio_buffer_util_copy_s32_to_s16 ()
void	ags_audio_buffer_util_copy_s32_to_s24 ()
void	ags_audio_buffer_util_copy_s32_to_s32 ()
void	ags_audio_buffer_util_copy_s32_to_s64 ()
void	ags_audio_buffer_util_copy_s32_to_float ()
void	ags_audio_buffer_util_copy_s32_to_double ()
void	ags_audio_buffer_util_copy_s64_to_s8 ()
void	ags_audio_buffer_util_copy_s64_to_s16 ()
void	ags_audio_buffer_util_copy_s64_to_s24 ()
void	ags_audio_buffer_util_copy_s64_to_s32 ()
void	ags_audio_buffer_util_copy_s64_to_s64 ()
void	ags_audio_buffer_util_copy_s64_to_float ()
void	ags_audio_buffer_util_copy_s64_to_double ()
void	ags_audio_buffer_util_copy_float_to_s8 ()
void	ags_audio_buffer_util_copy_float_to_s16 ()
void	ags_audio_buffer_util_copy_float_to_s24 ()
void	ags_audio_buffer_util_copy_float_to_s32 ()
void	ags_audio_buffer_util_copy_float_to_s64 ()
void	ags_audio_buffer_util_copy_float_to_float ()
void	ags_audio_buffer_util_copy_float_to_double ()
void	ags_audio_buffer_util_copy_double_to_s8 ()
void	ags_audio_buffer_util_copy_double_to_s16 ()
void	ags_audio_buffer_util_copy_double_to_s24 ()
void	ags_audio_buffer_util_copy_double_to_s32 ()
void	ags_audio_buffer_util_copy_double_to_s64 ()
void	ags_audio_buffer_util_copy_double_to_float ()
void	ags_audio_buffer_util_copy_double_to_double ()
void	ags_audio_buffer_util_copy_buffer_to_buffer ()

Types and Values

enum	AgsAudioBufferUtilFormat
enum	AgsAudioBufferUtilSamplerate
enum	AgsAudioBufferUtilCopyMode

Description

Functions

AGS_AUDIO_BUFFER_S8()

#define AGS_AUDIO_BUFFER_S8(ptr) ((signed char *)(ptr))

AGS_AUDIO_BUFFER_S16()

#define AGS_AUDIO_BUFFER_S16(ptr) ((signed short *)(ptr))

AGS_AUDIO_BUFFER_S24()

#define AGS_AUDIO_BUFFER_S24(ptr) ((signed long *)(ptr))

AGS_AUDIO_BUFFER_S32()

#define AGS_AUDIO_BUFFER_S32(ptr) ((signed long *)(ptr))

AGS_AUDIO_BUFFER_S64()

#define AGS_AUDIO_BUFFER_S64(ptr) ((signed long long *)(ptr))

AGS_AUDIO_BUFFER_FLOAT()

#define AGS_AUDIO_BUFFER_FLOAT(ptr) ((float *)(ptr))

AGS_AUDIO_BUFFER_DOUBLE()

#define AGS_AUDIO_BUFFER_DOUBLE(ptr) ((double *)(ptr))

ags_audio_buffer_util_format_from_soundcard ()

guint
ags_audio_buffer_util_format_from_soundcard
                               (guint soundcard_format);

Translate soundcard format to audio buffer util format.

Parameters

soundcard_format

the soundcard bit mode

Returns

the converted format

Since: 0.7.45

ags_audio_buffer_util_get_copy_mode ()

guint
ags_audio_buffer_util_get_copy_mode (guint destination_format,
                                     guint source_format);

Get copy mode for given destination and source format.

Parameters

destination_format	the destination buffer format
source_format	the source buffer format

Returns

the desired copy mode

Since: 0.7.45

ags_audio_buffer_util_clear_float ()

void
ags_audio_buffer_util_clear_float (float *buffer,
                                   guint channels,
                                   guint count);

Clears a buffer.

Parameters

buffer	the buffer to clear
channels	number of channels
count	count frames

Since: 0.7.65

ags_audio_buffer_util_clear_double ()

void
ags_audio_buffer_util_clear_double (double *buffer,
                                    guint channels,
                                    guint count);

Clears a buffer.

Parameters

buffer	the buffer to clear
channels	number of channels
count	count frames

Since: 0.7.65

ags_audio_buffer_util_clear_buffer ()

void
ags_audio_buffer_util_clear_buffer (void *buffer,
                                    guint channels,
                                    guint count,
                                    guint format);

Clears the audio data.

Parameters

buffer	the audio data
channels	the number of channels
count	number of frames
format	the format

Since: 0.7.81

ags_audio_buffer_util_envelope_s8 ()

gdouble
ags_audio_buffer_util_envelope_s8 (signed char *buffer,
                                   guint channels,
                                   guint buffer_length,
                                   gdouble current_volume,
                                   gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope_s16 ()

gdouble
ags_audio_buffer_util_envelope_s16 (signed short *buffer,
                                    guint channels,
                                    guint buffer_length,
                                    gdouble current_volume,
                                    gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope_s24 ()

gdouble
ags_audio_buffer_util_envelope_s24 (signed long *buffer,
                                    guint channels,
                                    guint buffer_length,
                                    gdouble current_volume,
                                    gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope_s32 ()

gdouble
ags_audio_buffer_util_envelope_s32 (signed long *buffer,
                                    guint channels,
                                    guint buffer_length,
                                    gdouble current_volume,
                                    gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope_s64 ()

gdouble
ags_audio_buffer_util_envelope_s64 (signed long long *buffer,
                                    guint channels,
                                    guint buffer_length,
                                    gdouble current_volume,
                                    gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope_float ()

gdouble
ags_audio_buffer_util_envelope_float (float *buffer,
                                      guint channels,
                                      guint buffer_length,
                                      gdouble current_volume,
                                      gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope_double ()

gdouble
ags_audio_buffer_util_envelope_double (double *buffer,
                                       guint channels,
                                       guint buffer_length,
                                       gdouble current_volume,
                                       gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_envelope ()

gdouble
ags_audio_buffer_util_envelope (void *buffer,
                                guint channels,
                                guint format,
                                guint buffer_length,
                                gdouble current_volume,
                                gdouble ratio);

Envelope buffer at ratio .

Parameters

buffer	the audio buffer
channels	number of audio channels
format	the format to use
buffer_length	the buffer's length
current_volume	current volume
ratio	the amount to increment

Returns

the last volume used

Since: 0.7.111

ags_audio_buffer_util_volume_s8 ()

void
ags_audio_buffer_util_volume_s8 (signed char *buffer,
                                 guint channels,
                                 guint buffer_length,
                                 gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume_s16 ()

void
ags_audio_buffer_util_volume_s16 (signed short *buffer,
                                  guint channels,
                                  guint buffer_length,
                                  gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume_s24 ()

void
ags_audio_buffer_util_volume_s24 (signed long *buffer,
                                  guint channels,
                                  guint buffer_length,
                                  gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume_s32 ()

void
ags_audio_buffer_util_volume_s32 (signed long *buffer,
                                  guint channels,
                                  guint buffer_length,
                                  gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume_s64 ()

void
ags_audio_buffer_util_volume_s64 (signed long long *buffer,
                                  guint channels,
                                  guint buffer_length,
                                  gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume_float ()

void
ags_audio_buffer_util_volume_float (float *buffer,
                                    guint channels,
                                    guint buffer_length,
                                    gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume_double ()

void
ags_audio_buffer_util_volume_double (double *buffer,
                                     guint channels,
                                     guint buffer_length,
                                     gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_volume ()

void
ags_audio_buffer_util_volume (void *buffer,
                              guint channels,
                              guint format,
                              guint buffer_length,
                              gdouble volume);

Adjust volume of buffer.

Parameters

buffer	the audio buffer
channels	number of audio channels
format	the format to use
buffer_length	the buffer's length
volume	volume

Since: 0.7.111

ags_audio_buffer_util_resample_s8 ()

signed char *
ags_audio_buffer_util_resample_s8 (signed char *buffer,
                                   guint channels,
                                   guint samplerate,
                                   guint buffer_length,
                                   guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65

ags_audio_buffer_util_resample_s16 ()

signed short *
ags_audio_buffer_util_resample_s16 (signed short *buffer,
                                    guint channels,
                                    guint samplerate,
                                    guint buffer_length,
                                    guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65

ags_audio_buffer_util_resample_s24 ()

signed long *
ags_audio_buffer_util_resample_s24 (signed long *buffer,
                                    guint channels,
                                    guint samplerate,
                                    guint buffer_length,
                                    guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65

ags_audio_buffer_util_resample_s32 ()

signed long *
ags_audio_buffer_util_resample_s32 (signed long *buffer,
                                    guint channels,
                                    guint samplerate,
                                    guint buffer_length,
                                    guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65

ags_audio_buffer_util_resample_s64 ()

signed long long *
ags_audio_buffer_util_resample_s64 (signed long long *buffer,
                                    guint channels,
                                    guint samplerate,
                                    guint buffer_length,
                                    guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65

ags_audio_buffer_util_resample_float ()

float *
ags_audio_buffer_util_resample_float (float *buffer,
                                      guint channels,
                                      guint samplerate,
                                      guint buffer_length,
                                      guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65

ags_audio_buffer_util_resample_double ()

double *
ags_audio_buffer_util_resample_double (double *buffer,
                                       guint channels,
                                       guint samplerate,
                                       guint buffer_length,
                                       guint target_samplerate);

Resamples buffer from samplerate to target_samplerate .

Parameters

buffer	the audio buffer
channels	number of audio channels
samplerate	the current samplerate
buffer_length	the buffer's length
target_samplerate	the samplerate to use

Returns

the resampled audio buffer

Since: 0.7.65