AgsAudioFile

AgsAudioFile — Audio file input/output

Stability Level

Stable, unless otherwise indicated

Functions

Types and Values

Includes

#include <ags/audio/file/ags_audio_file.h>

Description

AgsAudioFile is the base object to read/write audio data.

Functions

AGS_AUDIO_FILE_GET_OBJ_MUTEX()

#define AGS_AUDIO_FILE_GET_OBJ_MUTEX(obj) (&(((AgsAudioFile *) obj)->obj_mutex))

ags_audio_file_test_flags ()

gboolean
ags_audio_file_test_flags (AgsAudioFile *audio_file,
                           guint flags);

Test flags to be set on audio_file .

Parameters

audio_file

the AgsAudioFile

 

flags

the flags

 

Returns

TRUE if flags are set, else FALSE

Since: 3.0.0


ags_audio_file_set_flags ()

void
ags_audio_file_set_flags (AgsAudioFile *audio_file,
                          guint flags);

Enable a feature of audio_file .

Parameters

audio_file

the AgsAudioFile

 

flags

see AgsAudioFileFlags

 

Since: 3.0.0


ags_audio_file_unset_flags ()

void
ags_audio_file_unset_flags (AgsAudioFile *audio_file,
                            guint flags);

Disable a feature of audio_file .

Parameters

audio_file

the AgsAudioFile

 

flags

see AgsAudioFileFlags

 

Since: 3.0.0


ags_audio_file_check_suffix ()

gboolean
ags_audio_file_check_suffix (gchar *filename);

Check suffix.

Parameters

filename

the filename

 

Returns

TRUE if suffix supported, else FALSE

Since: 3.0.0


ags_audio_file_add_audio_signal ()

void
ags_audio_file_add_audio_signal (AgsAudioFile *audio_file,
                                 GObject *audio_signal);

Add audio_signal to audio_file .

Parameters

audio_file

the AgsAudioFile

 

audio_signal

the AgsAudioSignal

 

Since: 3.0.0


ags_audio_file_remove_audio_signal ()

void
ags_audio_file_remove_audio_signal (AgsAudioFile *audio_file,
                                    GObject *audio_signal);

Remove audio_signal from audio_file .

Parameters

audio_file

the AgsAudioFile

 

audio_signal

the AgsAudioSignal

 

Since: 3.0.0


ags_audio_file_add_wave ()

void
ags_audio_file_add_wave (AgsAudioFile *audio_file,
                         GObject *wave);

Add wave to audio_file .

Parameters

audio_file

the AgsAudioFile

 

wave

the AgsWave

 

Since: 3.0.0


ags_audio_file_remove_wave ()

void
ags_audio_file_remove_wave (AgsAudioFile *audio_file,
                            GObject *wave);

Remove wave from audio_file .

Parameters

audio_file

the AgsAudioFile

 

wave

the AgsWave

 

Since: 3.0.0


ags_audio_file_open ()

gboolean
ags_audio_file_open (AgsAudioFile *audio_file);

Open the AgsAudioFile in read mode.

Parameters

audio_file

the AgsAudioFile

 

Returns

TRUE on success, otherwise FALSE

Since: 3.0.0


ags_audio_file_open_from_data ()

gboolean
ags_audio_file_open_from_data (AgsAudioFile *audio_file,
                               gchar *data);

Open AgsAudioFile using virtual functions.

Parameters

audio_file

the AgsAudioFile

 

data

the audio data

 

Returns

TRUE on success, otherwise FALSE

Since: 3.0.0


ags_audio_file_rw_open ()

gboolean
ags_audio_file_rw_open (AgsAudioFile *audio_file,
                        gboolean create);

Open the AgsAudioFile in read/write mode.

Parameters

audio_file

the AgsAudioFile

 

create

create the file

 

Returns

TRUE on success, otherwise FALSE

Since: 3.0.0


ags_audio_file_close ()

void
ags_audio_file_close (AgsAudioFile *audio_file);

Close the AgsAudioFile.

Parameters

audio_file

the AgsAudioFile

 

Since: 3.0.0


ags_audio_file_read ()

void *
ags_audio_file_read (AgsAudioFile *audio_file,
                     guint audio_channel,
                     guint format,
                     GError **error);

Read audio buffer.

Parameters

audio_file

the AgsAudioFile

 

audio_channel

nth channel

 

format

the format

 

error

returned error

 

Since: 3.0.0


ags_audio_file_read_audio_signal ()

void
ags_audio_file_read_audio_signal (AgsAudioFile *audio_file);

Convert the AgsAudioFile to a GList of AgsAudioSignal.

Parameters

audio_file

the AgsAudioFile

 

Since: 3.0.0


ags_audio_file_read_wave ()

void
ags_audio_file_read_wave (AgsAudioFile *audio_file,
                          guint64 x_offset,
                          gdouble delay,
                          guint attack);

Convert the AgsAudioFile to a GList of buffers.

Parameters

audio_file

the AgsAudioFile

 

x_offset

the x offset

 

delay

the delay

 

attack

the attack

 

Since: 3.0.0


ags_audio_file_seek ()

void
ags_audio_file_seek (AgsAudioFile *audio_file,
                     guint frames,
                     gint whence);

Position the AgsAudioFile's internal data address.

Parameters

audio_file

the AgsAudioFile

 

frames

number of frames to seek

 

whence

SEEK_SET, SEEK_CUR, or SEEK_END

 

Since: 3.0.0


ags_audio_file_write ()

void
ags_audio_file_write (AgsAudioFile *audio_file,
                      void *buffer,
                      guint buffer_size,
                      guint format);

Write the buffer to AgsAudioFile.

Parameters

audio_file

the AgsAudioFile

 

buffer

the audio data

 

buffer_size

the count of frames to write

 

format

the format

 

Since: 3.0.0


ags_audio_file_flush ()

void
ags_audio_file_flush (AgsAudioFile *audio_file);

Flushes the AgsAudioFile's internal buffer.

Parameters

audio_file

the AgsAudioFile

 

Since: 3.0.0


ags_audio_file_new ()

AgsAudioFile *
ags_audio_file_new (gchar *filename,
                    GObject *soundcard,
                    gint audio_channel);

Create a new instance of AgsAudioFile.

Parameters

filename

the filename

 

soundcard

defaults of AgsSoundcard

 

audio_channel

the audio channel to read

 

Returns

the new AgsAudioFile.

Since: 3.0.0

Types and Values

enum AgsAudioFileFlags

Enum values to control the behavior or indicate internal state of AgsAudioFile by enable/disable as flags.

Members

AGS_AUDIO_FILE_ADDED_TO_REGISTRY

the audio file was added to registry, see AgsConnectable::add_to_registry()

 

AGS_AUDIO_FILE_CONNECTED

indicates the audio file was connected by calling AgsConnectable::connect()