pipewire/src/modules/module-protocol-pulse/modules/module-ladspa-source.c
Wim Taymans 9bcbd7b586 pulse: generate Usage from module_args definition
Add some more fields like the type, default value and possible enum
values for the module_args.

Use this to generate the Usage in describe-module and the docs.

This should give more consistent and correct Usage output in all
modules.
2026-06-24 18:59:19 +02:00

276 lines
9.1 KiB
C

/* PipeWire */
/* SPDX-FileCopyrightText: Copyright © 2021 Wim Taymans <wim.taymans@gmail.com> */
/* SPDX-License-Identifier: MIT */
#include <spa/utils/cleanup.h>
#include <spa/utils/hook.h>
#include <spa/utils/json-builder.h>
#include <spa/param/audio/format-utils.h>
#include <pipewire/pipewire.h>
#include "../defs.h"
#include "../module.h"
/** \page page_pulse_module_ladspa_source LADSPA Source
*
* ## Module Name
*
* `module-ladspa-source`
*
* ## Module Options
*
* @pulse_module_options@
*
* ## See Also
*
* \ref page_module_filter_chain "libpipewire-module-filter-chain"
*/
static const struct module_args valid_args[] = {
{ "source_name", "name for the source", 0, MODULE_TYPE_STRING, NULL },
{ "source_properties", "properties for the source", 0, MODULE_TYPE_PROPS, NULL },
{ "source_output_properties", "properties for the source output", 0, MODULE_TYPE_PROPS, NULL },
{ "master", "name of source to filter", 0, MODULE_TYPE_STRING, NULL },
{ "source_master", "name of source to filter", 0, MODULE_TYPE_STRING, NULL },
{ "format", "sample format", 0, MODULE_TYPE_FORMAT, NULL },
{ "rate", "sample rate", 0, MODULE_TYPE_INT, NULL },
{ "channels", "number of channels", 0, MODULE_TYPE_INT, NULL },
{ "channel_map", "channel map", 0, MODULE_TYPE_CHMAP, NULL },
{ "plugin", "LADSPA plugin name", MODULE_ARG_MANDATORY, MODULE_TYPE_STRING, NULL },
{ "label", "LADSPA plugin label", MODULE_ARG_MANDATORY, MODULE_TYPE_STRING, NULL },
{ "control", "comma separated list of input control values", 0, MODULE_TYPE_STRINGV, NULL },
{ "input_ladspaport_map", "comma separated list of input LADSPA port names", 0, MODULE_TYPE_STRINGV, NULL },
{ "output_ladspaport_map", "comma separated list of output LADSPA port names", 0, MODULE_TYPE_STRINGV, NULL },
{ NULL, }
};
#define NAME "ladspa-source"
PW_LOG_TOPIC_STATIC(mod_topic, "mod." NAME);
#define PW_LOG_TOPIC_DEFAULT mod_topic
struct module_ladspa_source_data {
struct module *module;
struct pw_impl_module *mod;
struct spa_hook mod_listener;
struct pw_properties *capture_props;
struct pw_properties *playback_props;
};
static void module_destroy(void *data)
{
struct module_ladspa_source_data *d = data;
spa_hook_remove(&d->mod_listener);
d->mod = NULL;
module_schedule_unload(d->module);
}
static const struct pw_impl_module_events module_events = {
PW_VERSION_IMPL_MODULE_EVENTS,
.destroy = module_destroy
};
static int module_ladspa_source_load(struct module *module)
{
struct module_ladspa_source_data *data = module->user_data;
struct spa_json_builder b;
spa_autofree char *args = NULL;
const char *str, *plugin, *label;
size_t size;
int res;
if ((plugin = pw_properties_get(module->props, "plugin")) == NULL)
return -EINVAL;
if ((label = pw_properties_get(module->props, "label")) == NULL)
return -EINVAL;
pw_properties_setf(data->capture_props, PW_KEY_NODE_GROUP, "ladspa-source-%u", module->index);
pw_properties_setf(data->playback_props, PW_KEY_NODE_GROUP, "ladspa-source-%u", module->index);
pw_properties_setf(data->capture_props, "pulse.module.id", "%u", module->index);
pw_properties_setf(data->playback_props, "pulse.module.id", "%u", module->index);
if ((res = spa_json_builder_memstream(&b, &args, &size, 0)) < 0)
return res;
spa_json_builder_array_push(&b, "{");
pw_properties_serialize_dict(b.f, &module->props->dict, 0);
spa_json_builder_object_push(&b, "filter.graph", "{");
spa_json_builder_object_push(&b, "nodes", "[");
spa_json_builder_array_push(&b, "{");
spa_json_builder_object_string(&b, "type", "ladspa");
spa_json_builder_object_string(&b, "plugin", plugin);
spa_json_builder_object_string(&b, "label", label);
if ((str = pw_properties_get(module->props, "control")) != NULL) {
size_t len;
const char *s, *state = NULL;
int count = 0;
spa_json_builder_object_push(&b, "control", "{");
while ((s = pw_split_walk(str, ", ", &len, &state))) {
char key[16];
snprintf(key, sizeof(key), "%d", count);
spa_json_builder_object_value_full(&b, false,
key, INT_MAX, s, len);
count++;
}
spa_json_builder_pop(&b, "}");
}
spa_json_builder_pop(&b, "}");
spa_json_builder_pop(&b, "]");
if ((str = pw_properties_get(module->props, "input_ladspaport_map")) != NULL) {
const char *s, *state = NULL;
size_t len;
spa_json_builder_object_push(&b, "inputs", "[");
while ((s = pw_split_walk(str, ", ", &len, &state)))
spa_json_builder_add_simple(&b, NULL, 0, 'S', s, len);
spa_json_builder_pop(&b, "]");
}
if ((str = pw_properties_get(module->props, "output_ladspaport_map")) != NULL) {
const char *s, *state = NULL;
size_t len;
spa_json_builder_object_push(&b, "outputs", "[");
while ((s = pw_split_walk(str, ", ", &len, &state)))
spa_json_builder_add_simple(&b, NULL, 0, 'S', s, len);
spa_json_builder_pop(&b, "]");
}
spa_json_builder_pop(&b, "}");
spa_json_builder_object_push(&b, "capture.props", "{");
pw_properties_serialize_dict(b.f, &data->capture_props->dict, 0);
spa_json_builder_pop(&b, "}");
spa_json_builder_object_push(&b, "playback.props", "{");
pw_properties_serialize_dict(b.f, &data->playback_props->dict, 0);
spa_json_builder_pop(&b, "}");
spa_json_builder_pop(&b, "}");
if ((res = spa_json_builder_close(&b)) < 0)
return res;
data->mod = pw_context_load_module(module->impl->context,
"libpipewire-module-filter-chain",
args, NULL);
if (data->mod == NULL)
return -errno;
pw_impl_module_add_listener(data->mod,
&data->mod_listener,
&module_events, data);
return 0;
}
static int module_ladspa_source_unload(struct module *module)
{
struct module_ladspa_source_data *d = module->user_data;
if (d->mod) {
spa_hook_remove(&d->mod_listener);
pw_impl_module_destroy(d->mod);
d->mod = NULL;
}
pw_properties_free(d->capture_props);
pw_properties_free(d->playback_props);
return 0;
}
static const struct spa_dict_item module_ladspa_source_info[] = {
{ PW_KEY_MODULE_AUTHOR, "Wim Taymans <wim.taymans@gmail.com>" },
{ PW_KEY_MODULE_DESCRIPTION, "Virtual LADSPA source" },
{ PW_KEY_MODULE_VERSION, PACKAGE_VERSION },
};
static int module_ladspa_source_prepare(struct module * const module)
{
struct module_ladspa_source_data * const d = module->user_data;
struct pw_properties * const props = module->props;
struct pw_properties *playback_props = NULL, *capture_props = NULL;
const char *str;
struct spa_audio_info_raw capture_info = { 0 };
struct spa_audio_info_raw playback_info = { 0 };
int res;
PW_LOG_TOPIC_INIT(mod_topic);
capture_props = pw_properties_new(NULL, NULL);
playback_props = pw_properties_new(NULL, NULL);
if (!capture_props || !playback_props) {
res = -EINVAL;
goto out;
}
if ((str = pw_properties_get(props, "source_name")) != NULL) {
pw_properties_set(playback_props, PW_KEY_NODE_NAME, str);
pw_properties_set(props, "source_name", NULL);
}
if ((str = pw_properties_get(props, "source_properties")) != NULL) {
module_args_add_props(playback_props, str);
pw_properties_set(props, "source_properties", NULL);
}
if (pw_properties_get(playback_props, PW_KEY_MEDIA_CLASS) == NULL)
pw_properties_set(playback_props, PW_KEY_MEDIA_CLASS, "Audio/Source");
if (pw_properties_get(playback_props, PW_KEY_DEVICE_CLASS) == NULL)
pw_properties_set(playback_props, PW_KEY_DEVICE_CLASS, "filter");
if ((str = pw_properties_get(playback_props, PW_KEY_NODE_DESCRIPTION)) == NULL) {
str = pw_properties_get(playback_props, PW_KEY_NODE_NAME);
if (str != NULL)
pw_properties_setf(props, PW_KEY_NODE_DESCRIPTION,
"%s Source", str);
} else {
pw_properties_set(props, PW_KEY_NODE_DESCRIPTION, str);
}
pw_properties_set(props, "library.filter-path", "true");
if ((str = pw_properties_get(props, "master")) != NULL ||
(str = pw_properties_get(props, "source_master")) != NULL) {
if (spa_strendswith(str, ".monitor")) {
pw_properties_setf(capture_props, PW_KEY_TARGET_OBJECT,
"%.*s", (int)strlen(str)-8, str);
pw_properties_set(capture_props, PW_KEY_STREAM_CAPTURE_SINK,
"true");
} else {
pw_properties_set(capture_props, PW_KEY_TARGET_OBJECT, str);
}
pw_properties_set(props, "source_master", NULL);
pw_properties_set(props, "master", NULL);
}
if (module_args_to_audioinfo_keys(module->impl, props,
NULL, NULL, "channels", "channel_map", &playback_info) < 0) {
res = -EINVAL;
goto out;
}
capture_info = playback_info;
audioinfo_to_properties(&capture_info, capture_props);
audioinfo_to_properties(&playback_info, playback_props);
if (pw_properties_get(capture_props, PW_KEY_NODE_PASSIVE) == NULL)
pw_properties_set(capture_props, PW_KEY_NODE_PASSIVE, "true");
d->module = module;
d->capture_props = capture_props;
d->playback_props = playback_props;
return 0;
out:
pw_properties_free(playback_props);
pw_properties_free(capture_props);
return res;
}
DEFINE_MODULE_INFO(module_ladspa_source) = {
.name = "module-ladspa-source",
.valid_args = valid_args,
.prepare = module_ladspa_source_prepare,
.load = module_ladspa_source_load,
.unload = module_ladspa_source_unload,
.properties = &SPA_DICT_INIT_ARRAY(module_ladspa_source_info),
.data_size = sizeof(struct module_ladspa_source_data),
};