newsAdvanced Gtk+ Sequencer - News: AgsSoundContainer and AgsSoundResource interfaces

Latest News
GSequencer version 3.10.5 released posted by jkraehemann, Sun 29 Aug 2021 07:41:14 AM UTC - 0 replies
implement VST3 C API Wrapper posted by jkraehemann, Tue 10 Aug 2021 12:53:03 PM UTC - 0 replies
refactored utility functions posted by jkraehemann, Tue 03 Aug 2021 06:26:38 AM UTC - 0 replies
GSequencer version 3.9.1 released posted by jkraehemann, Wed 30 Jun 2021 06:07:07 AM UTC - 0 replies
preparation for migration to Gtk4 posted by jkraehemann, Thu 18 Feb 2021 10:38:40 AM UTC - 0 replies
[Submit News]
[103 news in archive]

AgsSoundContainer and AgsSoundResource interfaces

Item posted by Joël Krähemann <jkraehemann> on Mon 07 May 2018 03:48:09 PM UTC.

AgsSoundContainer and AgsSoundResource superseeds AgsPlayable. The changes were just applied to:

  • AgsSndfile - implementing AgsSoundResource
  • AgsIpatch - implementing AgsSoundContainer

The API was extended and refactored. Thought it is not yet final the basics are there, yet. One thing missing is implementing following methods:

GList* (*get_resource_all)(AgsSoundContainer *sound_container);
GList* (*get_resource_by_name)(AgsSoundContainer *sound_container,
                               gchar *resource_name);
GList* (*get_resource_by_index)(AgsSoundContainer *sound_container,
                                guint resource_index);
GList* (*get_resource_current)(AgsSoundContainer *sound_container);

AgsIpatchSample implementing AgsSoundResource

The new object AgsIpatchSample was introduced to implement missing functionality. AgsSoundContainer shall return objects implementing AgsSoundResource.

So it works like following to obtain all samples:

  GList *sound_resource;

  sound_resource = ags_sound_container_get_resource_all(AGS_SOUND_CONTAINER(ipatch));

AgsSndfile implementing AgsSoundResource

Since WAV, FLAC, AIFF or OGG files is a sound resource, the object implements AgsSoundResource. The object has been refactored, yet.

To make the API straight-forward - analogously to AgsSoundcard interface - the AgsSoundResource provides following functions:

gboolean ags_sndfile_info(AgsSoundResource *sound_resource,
                          guint *frame_count,
                          guint *loop_start, guint *loop_end);
void ags_sndfile_set_presets(AgsSoundResource *sound_resource,
                             guint channels,
                             guint samplerate,
                             guint buffer_size,
                             guint format);
void ags_sndfile_get_presets(AgsSoundResource *sound_resource,
                             guint *channels,
                             guint *samplerate,
                             guint *buffer_size,
                             guint *format);

Special about it is you read one single audio channel, others get cached in the buffer to reduce disk overhead:

/* read sample data */
guint ags_sound_resource_read(AgsSoundResource *sound_resource,
                              void *dbuffer,
                              guint audio_channel,
                              guint frame_count, guint format);

/* write sample data */
void ags_sound_resource_write(AgsSoundResource *sound_resource,
                              void *sbuffer,
                              guint audio_channel,
                              guint frame_count, guint format);

So the buffer size of AgsSoundResource should be the frame count you request of AgsSoundResource.

by Joël

No messages in AgsSoundContainer and AgsSoundResource interfaces


Back to the top

Powered by Savane 3.7