| Top |
| guint | audio-channel | Read / Write |
| gpointer | autamation-port | Read / Write |
| guint | buffer-size | Read / Write |
| gpointer | child | Read / Write |
| GType * | child-type | Read / Write |
| gchar * | effect | Read / Write |
| guint | effect-index | Read / Write |
| gchar * | filename | Read / Write |
| guint | format | Read / Write |
| GObject * | input-soundcard | Read / Write |
| gint | input-soundcard-channel | Read / Write |
| guint | line | Read / Write |
| GObject * | output-soundcard | Read / Write |
| gint | output-soundcard-channel | Read / Write |
| guint | pad | Read / Write |
| AgsRecall * | parent | Read / Write |
| gpointer | port | Read / Write |
| AgsRecallContainer * | recall-container | Read / Write |
| gpointer | recall-dependency | Read / Write |
| AgsRecallID * | recall-id | Read / Write |
| guint | samplerate | Read / Write |
| void | automate | Run Last |
| void | cancel | Run Last |
| void | check-rt-data | Run Last |
| void | child-added | Run Last |
| void | do-feedback | Run Last |
| void | done | Run Last |
| GObject* | duplicate | Run Last |
| void | feed-input-queue | Run Last |
| void | feed-output-queue | Run Last |
| void | notify-dependency | Run Last |
| void | resolve-dependency | Run Last |
| void | run-init-inter | Run Last |
| void | run-init-post | Run Last |
| void | run-init-pre | Run Last |
| void | run-inter | Run Last |
| void | run-post | Run Last |
| void | run-pre | Run Last |
| void | stop-persistent | Run Last |
| #define | AGS_RECALL_DEFAULT_VERSION |
| #define | AGS_RECALL_DEFAULT_BUILD_ID |
| enum | AgsRecallFlags |
| enum | AgsRecallNotifyDependencyMode |
| struct | AgsRecallHandler |
| #define | AGS_TYPE_RECALL |
| struct | AgsRecall |
| struct | AgsRecallClass |
GObject ╰── AgsRecall ├── AgsRecallAudioSignal ├── AgsRecallChannel ├── AgsRecallChannelRun ├── AgsRecallRecycling ├── AgsRecallAudio ╰── AgsRecallAudioRun
pthread_mutex_t *
ags_recall_get_class_mutex ();
Use this function's returned mutex to access mutex fields.
Since: 2.0.0
gboolean ags_recall_global_get_children_lock_free ();
Get global config value lock free children.
Since: 2.0.0
gboolean ags_recall_global_get_omit_event ();
Get global config value omit event.
Since: 2.0.0
gboolean ags_recall_global_get_performance_mode ();
Get global config value performance mode.
Since: 2.0.0
gboolean ags_recall_global_get_rt_safe ();
Get global config value rt-safe.
Since: 2.0.0
gboolean ags_recall_test_flags (AgsRecall *recall,guint flags);
Test flags
to be set on recall
.
Since: 2.0.0
void ags_recall_set_flags (AgsRecall *recall,guint flags);
Set flags.
Since: 2.0.0
void ags_recall_unset_flags (AgsRecall *recall,guint flags);
Unset flags.
Since: 2.0.0
gboolean ags_recall_test_ability_flags (AgsRecall *recall,guint ability_flags);
Test ability_flags
to be set on recall
.
Since: 2.0.0
void ags_recall_set_ability_flags (AgsRecall *recall,guint ability_flags);
Set ability flags recursively.
Since: 2.0.0
void ags_recall_unset_ability_flags (AgsRecall *recall,guint ability_flags);
Unset ability flags recursively.
Since: 2.0.0
gboolean ags_recall_check_ability_flags (AgsRecall *recall,guint ability_flags);
Check if ability_flags
is set for recall
.
Since: 2.0.0
gboolean ags_recall_match_ability_flags_to_scope (AgsRecall *recall,gint sound_scope);
Check if sound_scope
related ability flag is set.
Since: 2.0.0
gboolean ags_recall_test_behaviour_flags (AgsRecall *recall,guint behaviour_flags);
Test behaviour_flags
to be set on recall
.
Since: 2.0.0
void ags_recall_set_behaviour_flags (AgsRecall *recall,guint behaviour_flags);
Set behaviour flags of recall
.
Since: 2.0.0
void ags_recall_unset_behaviour_flags (AgsRecall *recall,guint behaviour_flags);
Unset behaviour flags of recall
.
Since: 2.0.0
gboolean ags_recall_check_behaviour_flags (AgsRecall *recall,guint behaviour_flags);
Check if behaviour_flags
is set for recall
.
Since: 2.0.0
void ags_recall_set_sound_scope (AgsRecall *recall,gint sound_scope);
Set sound_scope
for recall
.
Since: 2.0.0
gint
ags_recall_get_sound_scope (AgsRecall *recall);
Get sound scope for recall
.
Since: 2.0.0
gboolean ags_recall_check_sound_scope (AgsRecall *recall,gint sound_scope);
Check if sound_scope
is set for recall
.
Since: 2.0.0
gboolean ags_recall_test_staging_flags (AgsRecall *recall,guint behaviour_flags);
Test staging_flags
to be set on recall
.
Since: 2.0.0
void ags_recall_set_staging_flags (AgsRecall *recall,guint staging_flags);
Set staging flags.
Since: 2.0.0
void ags_recall_unset_staging_flags (AgsRecall *recall,guint staging_flags);
Unset staging flags.
Since: 2.0.0
gboolean ags_recall_check_staging_flags (AgsRecall *recall,guint staging_flags);
Check the occurence of staging_flags
in recall
.
Since: 2.0.0
gboolean ags_recall_test_state_flags (AgsRecall *recall,guint behaviour_flags);
Test state_flags
to be set on recall
.
Since: 2.0.0
void ags_recall_set_state_flags (AgsRecall *recall,guint state_flags);
Set state flags.
Since: 2.0.0
void ags_recall_unset_state_flags (AgsRecall *recall,guint state_flags);
Unset state flags.
Since: 2.0.0
gboolean ags_recall_check_state_flags (AgsRecall *recall,guint state_flags);
Check the occurence of state_flags
in recall
.
Since: 2.0.0
void ags_recall_set_recall_id (AgsRecall *recall,AgsRecallID *recall_id);
Set recall_id
of recall
and all its children.
Since: 2.0.0
void ags_recall_add_recall_dependency (AgsRecall *recall,AgsRecallDependency *recall_dependency);
Associate a new dependency for this recall.
Since: 2.0.0
void ags_recall_remove_recall_dependency (AgsRecall *recall,AgsRecallDependency *recall_dependency);
Remove a prior associated dependency.
Since: 2.0.0
void ags_recall_add_child (AgsRecall *parent,AgsRecall *child);
Add child
to parent
.
Since: 2.0.0
void ags_recall_remove_child (AgsRecall *recall,AgsRecall *child);
Remove child
from parent
.
Since: 2.0.0
void
ags_recall_handler_free (AgsRecallHandler *recall_handler);
Free recall_hanlder
.
Since: 2.0.0
AgsRecallHandler * ags_recall_handler_alloc (const gchar *signal_name,GCallback callback,GObject *data);
Allocates AgsRecallHandler.
signal_name |
signal's name to connect |
|
callback |
the GCallback function |
|
data |
the data to pass the callback |
Since: 2.0.0
void ags_recall_add_recall_handler (AgsRecall *recall,AgsRecallHandler *recall_handler);
Connect callback to recall
specified by recall_handler
.
Since: 2.0.0
void ags_recall_remove_recall_handler (AgsRecall *recall,AgsRecallHandler *recall_handler);
Remove a AgsRecallHandler from recall
.
Since: 2.0.0
void ags_recall_set_output_soundcard (AgsRecall *recall,GObject *output_soundcard);
Set output soundcard of recall
.
Since: 2.0.0
void ags_recall_set_input_soundcard (AgsRecall *recall,GObject *input_soundcard);
Set input soundcard of recall
.
Since: 2.0.0
void ags_recall_set_samplerate (AgsRecall *recall,guint samplerate);
Set samplerate of recall
.
Since: 2.0.0
void ags_recall_set_buffer_size (AgsRecall *recall,guint buffer_size);
Set buffer size of recall
.
Since: 2.0.0
void ags_recall_set_format (AgsRecall *recall,guint format);
Set format of recall
.
Since: 2.0.0
void
ags_recall_resolve_dependency (AgsRecall *recall);
A signal indicating that the inheriting object should resolve it's dependency.
Since: 2.0.0
void
ags_recall_check_rt_data (AgsRecall *recall);
Prepare for run, this is the pre stage within the preparation.
Since: 2.0.0
void
ags_recall_run_init_pre (AgsRecall *recall);
Prepare for run, this is the pre stage within the preparation.
Since: 2.0.0
void
ags_recall_run_init_inter (AgsRecall *recall);
Prepare for run, this is the inter stage within the preparation.
Since: 2.0.0
void
ags_recall_run_init_post (AgsRecall *recall);
Prepare for run, this is the post stage within the preparation.
Since: 2.0.0
void
ags_recall_feed_input_queue (AgsRecall *recall);
Feed input queue of recall
.
Since: 2.0.0
void
ags_recall_automate (AgsRecall *recall);
Automate port of recall
.
Since: 2.0.0
void
ags_recall_run_pre (AgsRecall *recall);
This is the pre stage within a run.
Since: 2.0.0
void
ags_recall_run_inter (AgsRecall *recall);
This is the inter stage within a run.
Since: 2.0.0
void
ags_recall_run_post (AgsRecall *recall);
This is the post stage within a run.
Since: 2.0.0
void
ags_recall_do_feedback (AgsRecall *recall);
Do feedback of recall
.
Since: 2.0.0
void
ags_recall_feed_output_queue (AgsRecall *recall);
Feed output queue of recall
.
Since: 2.0.0
void
ags_recall_stop_persistent (AgsRecall *recall);
Unsets the AGS_SOUND_BEHAVIOUR_PERSISTENT and related behaviour flags and
invokes ags_recall_done().
Since: 2.0.0
void
ags_recall_cancel (AgsRecall *recall);
The AgsRecall doesn't want to run anymore, it aborts further execution.
Since: 2.0.0
void
ags_recall_done (AgsRecall *recall);
The AgsRecall doesn't want to run anymore, it has been done its work.
Since: 2.0.0
AgsRecall * ags_recall_duplicate (AgsRecall *recall,AgsRecallID *recall_id,guint *n_params,gchar **parameter_name,GValue *value);
Should duplicate an AgsRecall, so it can pass the run stages. Mainly used for
creating duplicates of templates, see AGS_RECALL_TEMPLATE.
recall |
the template AgsRecAll |
|
recall_id |
the AgsRecallID |
|
n_params |
guint pointer to parameter count |
|
parameter_name |
string vector containing parameter names |
|
value |
the GValue array |
Since: 2.0.0
void ags_recall_notify_dependency (AgsRecall *recall,guint dependency,gboolean increase);
Notifies a recall that an other depends on it.
Since: 2.0.0
void ags_recall_child_added (AgsRecall *parent,AgsRecall *child);
A signal indicating that the a child has been added.
Since: 2.0.0
gboolean ags_recall_is_done (GList *recalls,GObject *recycling_context);
Check if recall is over.
Since: 2.0.0
GList * ags_recall_get_by_effect (GList *list,gchar *filename,gchar *effect);
Finds all recalls matching filename
and effect
.
Since: 2.0.0
GList * ags_recall_find_recall_id_with_effect (GList *list,AgsRecallID *recall_id,gchar *filename,gchar *effect);
Finds next matching effect name. Intended to be used as iteration function.
recall |
the GList containing AgsRecall |
|
recall_id |
the AgsRecallID, may be |
|
filename |
the filename or |
|
effect |
the effect name |
Since: 2.0.0
GList * ags_recall_find_type (GList *recall,GType type);
Finds next matching recall for type. Intended to be used as iteration function.
Since: 2.0.0
GList *
ags_recall_find_template (GList *recall);
Finds next template, see AGS_RECALL_TEMPLATE flag. Intended to be used as iteration function.
Since: 2.0.0
GList * ags_recall_template_find_type (GList *recall,GType type);
Finds next matching recall for type which is a template, see AGS_RECALL_TEMPLATE flag. Intended to be used as iteration function.
Since: 2.0.0
GList * ags_recall_template_find_all_type (GList *recall,...);
Finds next matching recall for type which is a template, see AGS_RECALL_TEMPLATE flag. Intended to be used as iteration function.
Since: 2.0.0
GList * ags_recall_find_type_with_recycling_context (GList *recall,GType type,GObject *recycling_context);
Finds next matching recall for type which has recycling_context
, see AgsRecallId for further
details about AgsRecyclingContext. Intended to be used as iteration function.
Since: 2.0.0
GList * ags_recall_find_recycling_context (GList *recall,GObject *recycling_context);
Finds next matching recall which has recycling_context
, see AgsRecallId for further
details about AgsRecyclingContext. Intended to be used as iteration function.
Since: 2.0.0
GList * ags_recall_find_provider (GList *recall,GObject *provider);
Finds provider eg. AgsAudio or AgsChannel within recall
containig AgsRecall.
Since: 2.0.0
GList * ags_recall_template_find_provider (GList *recall,GObject *provider);
GList * ags_recall_find_provider_with_recycling_context (GList *recall,GObject *provider,GObject *recycling_context);
Like ags_recall_template_find_provider() but given additionally recycling_context
as search parameter.
Since: 2.0.0
void
ags_recall_lock_port (AgsRecall *recall);
Locks the ports.
Since: 2.0.0
void
ags_recall_unlock_port (AgsRecall *recall);
Unlocks the ports.
Since: 2.0.0
#define AGS_RECALL(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), AGS_TYPE_RECALL, AgsRecall))
#define AGS_RECALL_CLASS(class) (G_TYPE_CHECK_CLASS_CAST((class), AGS_TYPE_RECALL, AgsRecallClass))
#define AGS_RECALL_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), AGS_TYPE_RECALL, AgsRecallClass))
Enum values to control the behavior or indicate internal state of AgsRecall by enable/disable as flags.
Modes to notify of dependencies.
struct AgsRecallHandler {
const gchar *signal_name;
GCallback callback;
GObject *data;
};
A AgsRecallHandler acts as a callback definition
struct AgsRecallClass {
GObjectClass object;
void (*resolve_dependency)(AgsRecall *recall);
void (*check_rt_data)(AgsRecall *recall);
void (*run_init_pre)(AgsRecall *recall);
void (*run_init_inter)(AgsRecall *recall);
void (*run_init_post)(AgsRecall *recall);
void (*feed_input_queue)(AgsRecall *recall);
void (*automate)(AgsRecall *recall);
void (*run_pre)(AgsRecall *recall);
void (*run_inter)(AgsRecall *recall);
void (*run_post)(AgsRecall *recall);
void (*do_feedback)(AgsRecall *recall);
void (*feed_output_queue)(AgsRecall *recall);
void (*stop_persistent)(AgsRecall *recall);
void (*cancel)(AgsRecall *recall);
void (*done)(AgsRecall *recall);
AgsRecall* (*duplicate)(AgsRecall *recall,
AgsRecallID *recall_id,
guint *n_params, gchar **parameter_name, GValue *value);
void (*notify_dependency)(AgsRecall *recall, guint dependency, gboolean increase);
void (*child_added)(AgsRecall *recall, AgsRecall *child);
};
“audio-channel” property“audio-channel” guint
The nth audio channel.
Flags: Read / Write
Default value: 0
Since: 2.0.0
“autamation-port” property“autamation-port” gpointer
The port doing automation.
Flags: Read / Write
“buffer-size” property“buffer-size” guint
The buffer size.
Flags: Read / Write
Default value: 0
Since: 2.0.0
“child-type” property“child-type” GType *
The type of child AgsRecall.
Flags: Read / Write
Allowed values: void
Since: 2.0.0
“effect” property“effect” gchar *
The plugin's effect.
Flags: Read / Write
Default value: NULL
Since: 2.0.0
“effect-index” property“effect-index” guint
The effect's index.
Flags: Read / Write
Default value: 0
Since: 2.0.0
“filename” property“filename” gchar *
The plugin's filename.
Flags: Read / Write
Default value: NULL
Since: 2.0.0
“input-soundcard” property“input-soundcard” GObject *
The assigned soundcard.
Flags: Read / Write
Since: 2.0.0
“input-soundcard-channel” property“input-soundcard-channel” gint
The input soundcard channel.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
Since: 2.0.0
“output-soundcard” property“output-soundcard” GObject *
The assigned soundcard.
Flags: Read / Write
Since: 2.0.0
“output-soundcard-channel” property“output-soundcard-channel” gint
The output soundcard channel.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
Since: 2.0.0
“recall-container” property“recall-container” AgsRecallContainer *
The AgsRecallContainer packed into.
Flags: Read / Write
Since: 2.0.0
“recall-dependency” property“recall-dependency” gpointer
The AgsRecall dependency.
Flags: Read / Write
Since: 2.0.0
“recall-id” property“recall-id” AgsRecallID *
The AgsRecallID running in.
Flags: Read / Write
Since: 2.0.0
“samplerate” property“samplerate” guint
The samplerate.
Flags: Read / Write
Default value: 0
Since: 2.0.0
“automate” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::automate signal notifies about running automation and is normally called during ::run-pre.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“cancel” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::cancel signal notifies about cancelling playback.
recall |
the AgsRecall to cancel playback |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“check-rt-data” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::check-rt-data signal notifies about initializing stage 0.
recall |
the AgsRecall to initialize |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“child-added” signalvoid user_function (AgsRecall *recall, GObject *child, gpointer user_data)
The ::child-added signal notifies about children added.
Flags: Run Last
Since: 2.0.0
“do-feedback” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::do-feedback signal notifies about running stage 2.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“done” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::done signal notifies about stopping playback.
recall |
the AgsRecall to finish playback |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“duplicate” signalGObject* user_function (AgsRecall *recall, GObject *recall_id, gpointer n_params, gpointer parameter_name, gpointer value, gpointer user_data)
The ::duplicate signal notifies about instantiating.
recall |
the AgsRecall to duplicate |
|
recall_id |
the assigned AgsRecallID |
|
n_params |
pointer to array length |
|
parameter_name |
parameter name string vector |
|
value |
the GValue array |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“feed-input-queue” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::feed-input-queue signal notifies about running feed input queue.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“feed-output-queue” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::feed-output-queue signal notifies about running feed output queue.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“notify-dependency” signalvoid user_function (AgsRecall *recall, guint dependency, gboolean increase, gpointer user_data)
The ::notify-dependency signal notifies about dependency added.
Flags: Run Last
Since: 2.0.0
“resolve-dependency” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::resolve-dependency signal notifies about resolving dependency.
recall |
the AgsRecall to resolve |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“run-init-inter” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::run-init-inter signal notifies about initializing stage 1.
recall |
the AgsRecall to initialize |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“run-init-post” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::run-init-post signal notifies about initializing stage 2.
recall |
the AgsRecall to initialize |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“run-init-pre” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::run-init-pre signal notifies about initializing stage 0.
recall |
the AgsRecall to initialize |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“run-inter” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::run-inter signal notifies about running stage 1.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“run-post” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::run-post signal notifies about running stage 2.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“run-pre” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::run-pre signal notifies about running stage 0.
recall |
the AgsRecall to play |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0
“stop-persistent” signalvoid user_function (AgsRecall *recall, gpointer user_data)
The ::stop-persistent signal notifies about definitively stopping playback.
recall |
the AgsRecall stop playback |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.0.0