4 This file is part of PulseAudio.
6 Copyright 2004-2006 Lennart Poettering
8 PulseAudio is free software; you can redistribute it and/or modify
9 it under the terms of the GNU Lesser General Public License as published
10 by the Free Software Foundation; either version 2 of the License,
11 or (at your option) any later version.
13 PulseAudio is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with PulseAudio; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
24 /* TODO: Some plugins cause latency, and some even report it by using a control
25 out port. We don't currently use the latency information. */
31 #include <pulse/xmalloc.h>
33 #include <pulsecore/core-error.h>
34 #include <pulsecore/namereg.h>
35 #include <pulsecore/sink.h>
36 #include <pulsecore/module.h>
37 #include <pulsecore/core-util.h>
38 #include <pulsecore/modargs.h>
39 #include <pulsecore/log.h>
40 #include <pulsecore/thread.h>
41 #include <pulsecore/thread-mq.h>
42 #include <pulsecore/rtpoll.h>
43 #include <pulsecore/sample-util.h>
45 #include "module-ladspa-sink-symdef.h"
48 PA_MODULE_AUTHOR("Lennart Poettering");
49 PA_MODULE_DESCRIPTION("Virtual LADSPA sink");
50 PA_MODULE_VERSION(PACKAGE_VERSION
);
51 PA_MODULE_LOAD_ONCE(FALSE
);
53 "sink_name=<name for the sink> "
54 "master=<name of sink to remap> "
55 "format=<sample format> "
56 "channels=<number of channels> "
58 "channel_map=<channel map> "
59 "plugin=<ladspa plugin name> "
60 "label=<ladspa plugin label> "
61 "control=<comma seperated list of input control values>");
67 pa_sink
*sink
, *master
;
68 pa_sink_input
*sink_input
;
70 const LADSPA_Descriptor
*descriptor
;
72 LADSPA_Handle handle
[PA_CHANNELS_MAX
];
73 LADSPA_Data
*input
, *output
;
75 unsigned long input_port
, output_port
;
78 /* This is a dummy buffer. Every port must be connected, but we don't care
79 about control out ports. We connect them all to this single buffer. */
80 LADSPA_Data control_out
;
83 static const char* const valid_modargs
[] = {
96 /* Called from I/O thread context */
97 static int sink_process_msg(pa_msgobject
*o
, int code
, void *data
, int64_t offset
, pa_memchunk
*chunk
) {
98 struct userdata
*u
= PA_SINK(o
)->userdata
;
102 case PA_SINK_MESSAGE_GET_LATENCY
: {
105 if (PA_MSGOBJECT(u
->master
)->process_msg(PA_MSGOBJECT(u
->master
), PA_SINK_MESSAGE_GET_LATENCY
, &usec
, 0, NULL
) < 0)
108 *((pa_usec_t
*) data
) = usec
/* + pa_bytes_to_usec(u->memchunk.length, &u->sink->sample_spec) */;
113 return pa_sink_process_msg(o
, code
, data
, offset
, chunk
);
116 /* Called from main context */
117 static int sink_set_state(pa_sink
*s
, pa_sink_state_t state
) {
120 pa_sink_assert_ref(s
);
121 pa_assert_se(u
= s
->userdata
);
123 if (PA_SINK_LINKED(state
) && u
->sink_input
&& PA_SINK_INPUT_LINKED(pa_sink_input_get_state(u
->sink_input
)))
124 pa_sink_input_cork(u
->sink_input
, state
== PA_SINK_SUSPENDED
);
129 /* Called from I/O thread context */
130 static void sink_request_rewind(pa_sink
*s
) {
133 pa_sink_assert_ref(s
);
134 pa_assert_se(u
= s
->userdata
);
136 /* Just hand this one over to the master sink */
137 pa_sink_input_request_rewrite(u
->sink_input
, s
->thread_info
.rewind_nbytes
);
140 /* Called from I/O thread context */
141 static void sink_update_requested_latency(pa_sink
*s
) {
144 pa_sink_assert_ref(s
);
145 pa_assert_se(u
= s
->userdata
);
147 /* Just hand this one over to the master sink */
148 u
->sink_input
->thread_info
.requested_sink_latency
= pa_sink_get_requested_latency(s
);
149 pa_sink_invalidate_requested_latency(u
->master
);
152 /* Called from I/O thread context */
153 static int sink_input_process_msg(pa_msgobject
*o
, int code
, void *data
, int64_t offset
, pa_memchunk
*chunk
) {
154 struct userdata
*u
= PA_SINK_INPUT(o
)->userdata
;
157 case PA_SINK_INPUT_MESSAGE_GET_LATENCY
:
158 *((pa_usec_t
*) data
) = 0 /*pa_bytes_to_usec(u->memchunk.length, &u->sink_input->sample_spec)*/;
160 /* Fall through, the default handler will add in the extra
161 * latency added by the resampler */
165 return pa_sink_input_process_msg(o
, code
, data
, offset
, chunk
);
168 /* Called from I/O thread context */
169 static int sink_input_pop_cb(pa_sink_input
*i
, size_t nbytes
, pa_memchunk
*chunk
) {
176 pa_sink_input_assert_ref(i
);
178 pa_assert_se(u
= i
->userdata
);
180 pa_sink_render(u
->sink
, nbytes
, &tchunk
);
182 fs
= pa_frame_size(&i
->sample_spec
);
183 n
= tchunk
.length
/ fs
;
187 chunk
->memblock
= pa_memblock_new(i
->sink
->core
->mempool
, tchunk
.length
);
189 chunk
->length
= tchunk
.length
;
191 src
= (float*) ((uint8_t*) pa_memblock_acquire(tchunk
.memblock
) + tchunk
.index
);
192 dst
= (float*) pa_memblock_acquire(chunk
->memblock
);
194 for (c
= 0; c
< u
->channels
; c
++) {
200 for (j
= 0; j
< n
; j
++, p
+= u
->channels
, q
++)
201 *q
= PA_CLAMP_UNLIKELY(*p
, -1.0, 1.0);
203 u
->descriptor
->run(u
->handle
[c
], n
);
207 for (j
= 0; j
< n
; j
++, q
++, p
+= u
->channels
)
208 *p
= PA_CLAMP_UNLIKELY(*q
, -1.0, 1.0);
211 pa_memblock_release(tchunk
.memblock
);
212 pa_memblock_release(chunk
->memblock
);
214 pa_memblock_unref(tchunk
.memblock
);
219 /* Called from I/O thread context */
220 static void sink_input_rewind_cb(pa_sink_input
*i
, size_t nbytes
) {
223 pa_sink_input_assert_ref(i
);
224 pa_assert_se(u
= i
->userdata
);
225 pa_assert(nbytes
> 0);
227 u
->sink
->thread_info
.rewind_nbytes
= nbytes
;
228 pa_sink_process_rewind(u
->sink
);
231 /* Called from I/O thread context */
232 static void sink_input_set_max_rewind_cb(pa_sink_input
*i
, size_t nbytes
) {
235 pa_sink_input_assert_ref(i
);
236 pa_assert_se(u
= i
->userdata
);
238 pa_sink_set_max_rewind(u
->sink
, nbytes
);
241 /* Called from I/O thread context */
242 static void sink_input_detach_cb(pa_sink_input
*i
) {
245 pa_sink_input_assert_ref(i
);
246 pa_assert_se(u
= i
->userdata
);
248 pa_sink_detach_within_thread(u
->sink
);
251 /* Called from I/O thread context */
252 static void sink_input_attach_cb(pa_sink_input
*i
) {
255 pa_sink_input_assert_ref(i
);
256 pa_assert_se(u
= i
->userdata
);
258 pa_sink_set_asyncmsgq(u
->sink
, i
->sink
->asyncmsgq
);
259 pa_sink_set_rtpoll(u
->sink
, i
->sink
->rtpoll
);
261 pa_sink_attach_within_thread(u
->sink
);
264 /* Called from main context */
265 static void sink_input_kill_cb(pa_sink_input
*i
) {
268 pa_sink_input_assert_ref(i
);
269 pa_assert_se(u
= i
->userdata
);
271 pa_sink_input_unlink(u
->sink_input
);
272 pa_sink_input_unref(u
->sink_input
);
273 u
->sink_input
= NULL
;
275 pa_sink_unlink(u
->sink
);
276 pa_sink_unref(u
->sink
);
279 pa_module_unload_request(u
->module
);
282 int pa__init(pa_module
*m
) {
290 pa_sink_input_new_data sink_input_data
;
291 pa_sink_new_data sink_data
;
292 const char *plugin
, *label
;
293 LADSPA_Descriptor_Function descriptor_func
;
294 const char *e
, *cdata
;
295 const LADSPA_Descriptor
*d
;
296 unsigned long input_port
, output_port
, p
, j
, n_control
;
298 pa_bool_t
*use_default
= NULL
;
302 pa_assert(sizeof(LADSPA_Data
) == sizeof(float));
304 if (!(ma
= pa_modargs_new(m
->argument
, valid_modargs
))) {
305 pa_log("Failed to parse module arguments.");
309 if (!(master
= pa_namereg_get(m
->core
, pa_modargs_get_value(ma
, "master", NULL
), PA_NAMEREG_SINK
, 1))) {
310 pa_log("Master sink not found");
314 ss
= master
->sample_spec
;
315 ss
.format
= PA_SAMPLE_FLOAT32
;
316 map
= master
->channel_map
;
317 if (pa_modargs_get_sample_spec_and_channel_map(ma
, &ss
, &map
, PA_CHANNEL_MAP_DEFAULT
) < 0) {
318 pa_log("Invalid sample format specification or channel map");
322 if (!(plugin
= pa_modargs_get_value(ma
, "plugin", NULL
))) {
323 pa_log("Missing LADSPA plugin name");
327 if (!(label
= pa_modargs_get_value(ma
, "label", NULL
))) {
328 pa_log("Missing LADSPA plugin label");
332 cdata
= pa_modargs_get_value(ma
, "control", NULL
);
334 u
= pa_xnew0(struct userdata
, 1);
340 u
->sink_input
= NULL
;
342 if (!(e
= getenv("LADSPA_PATH")))
345 /* FIXME: This is not exactly thread safe */
346 t
= pa_xstrdup(lt_dlgetsearchpath());
347 lt_dlsetsearchpath(e
);
348 m
->dl
= lt_dlopenext(plugin
);
349 lt_dlsetsearchpath(t
);
353 pa_log("Failed to load LADSPA plugin: %s", lt_dlerror());
357 if (!(descriptor_func
= (LADSPA_Descriptor_Function
) lt_dlsym(m
->dl
, "ladspa_descriptor"))) {
358 pa_log("LADSPA module lacks ladspa_descriptor() symbol.");
364 if (!(d
= descriptor_func(j
))) {
365 pa_log("Failed to find plugin label '%s' in plugin '%s'.", plugin
, label
);
369 if (strcmp(d
->Label
, label
) == 0)
375 pa_log_debug("Module: %s", plugin
);
376 pa_log_debug("Label: %s", d
->Label
);
377 pa_log_debug("Unique ID: %lu", d
->UniqueID
);
378 pa_log_debug("Name: %s", d
->Name
);
379 pa_log_debug("Maker: %s", d
->Maker
);
380 pa_log_debug("Copyright: %s", d
->Copyright
);
382 input_port
= output_port
= (unsigned long) -1;
385 for (p
= 0; p
< d
->PortCount
; p
++) {
387 if (LADSPA_IS_PORT_INPUT(d
->PortDescriptors
[p
]) && LADSPA_IS_PORT_AUDIO(d
->PortDescriptors
[p
])) {
389 if (strcmp(d
->PortNames
[p
], "Input") == 0) {
390 pa_assert(input_port
== (unsigned long) -1);
393 pa_log("Found audio input port on plugin we cannot handle: %s", d
->PortNames
[p
]);
397 } else if (LADSPA_IS_PORT_OUTPUT(d
->PortDescriptors
[p
]) && LADSPA_IS_PORT_AUDIO(d
->PortDescriptors
[p
])) {
399 if (strcmp(d
->PortNames
[p
], "Output") == 0) {
400 pa_assert(output_port
== (unsigned long) -1);
403 pa_log("Found audio output port on plugin we cannot handle: %s", d
->PortNames
[p
]);
407 } else if (LADSPA_IS_PORT_INPUT(d
->PortDescriptors
[p
]) && LADSPA_IS_PORT_CONTROL(d
->PortDescriptors
[p
]))
410 pa_assert(LADSPA_IS_PORT_OUTPUT(d
->PortDescriptors
[p
]) && LADSPA_IS_PORT_CONTROL(d
->PortDescriptors
[p
]));
411 pa_log_debug("Ignored control output port \"%s\".", d
->PortNames
[p
]);
415 if ((input_port
== (unsigned long) -1) || (output_port
== (unsigned long) -1)) {
416 pa_log("Failed to identify input and output ports. "
417 "Right now this module can only deal with plugins which provide an 'Input' and an 'Output' audio port. "
422 u
->block_size
= pa_frame_align(pa_mempool_block_size_max(m
->core
->mempool
), &ss
);
424 u
->input
= (LADSPA_Data
*) pa_xnew(uint8_t, u
->block_size
);
425 if (LADSPA_IS_INPLACE_BROKEN(d
->Properties
))
426 u
->output
= (LADSPA_Data
*) pa_xnew(uint8_t, u
->block_size
);
428 u
->output
= u
->input
;
430 u
->channels
= ss
.channels
;
432 for (c
= 0; c
< ss
.channels
; c
++) {
433 if (!(u
->handle
[c
] = d
->instantiate(d
, ss
.rate
))) {
434 pa_log("Failed to instantiate plugin %s with label %s for channel %i", plugin
, d
->Label
, c
);
438 d
->connect_port(u
->handle
[c
], input_port
, u
->input
);
439 d
->connect_port(u
->handle
[c
], output_port
, u
->output
);
442 if (!cdata
&& n_control
> 0) {
443 pa_log("This plugin requires specification of %lu control parameters.", n_control
);
448 const char *state
= NULL
;
452 u
->control
= pa_xnew(LADSPA_Data
, n_control
);
453 use_default
= pa_xnew(pa_bool_t
, n_control
);
456 while ((k
= pa_split(cdata
, ",", &state
)) && p
< n_control
) {
460 use_default
[p
++] = TRUE
;
465 if (pa_atof(k
, &f
) < 0) {
466 pa_log("Failed to parse control value '%s'", k
);
473 use_default
[p
] = FALSE
;
477 /* The previous loop doesn't take the last control value into account
478 if it is left empty, so we do it here. */
479 if (*cdata
== 0 || cdata
[strlen(cdata
) - 1] == ',') {
481 use_default
[p
] = TRUE
;
485 if (p
> n_control
|| k
) {
486 pa_log("Too many control values passed, %lu expected.", n_control
);
493 pa_log("Not enough control values passed, %lu expected, %lu passed.", n_control
, p
);
498 for (p
= 0; p
< d
->PortCount
; p
++) {
499 LADSPA_PortRangeHintDescriptor hint
= d
->PortRangeHints
[p
].HintDescriptor
;
501 if (!LADSPA_IS_PORT_CONTROL(d
->PortDescriptors
[p
]))
504 if (LADSPA_IS_PORT_OUTPUT(d
->PortDescriptors
[p
])) {
505 for (c
= 0; c
< ss
.channels
; c
++)
506 d
->connect_port(u
->handle
[c
], p
, &u
->control_out
);
510 pa_assert(h
< n_control
);
512 if (use_default
[h
]) {
513 LADSPA_Data lower
, upper
;
515 if (!LADSPA_IS_HINT_HAS_DEFAULT(hint
)) {
516 pa_log("Control port value left empty but plugin defines no default.");
520 lower
= d
->PortRangeHints
[p
].LowerBound
;
521 upper
= d
->PortRangeHints
[p
].UpperBound
;
523 if (LADSPA_IS_HINT_SAMPLE_RATE(hint
)) {
528 switch (hint
& LADSPA_HINT_DEFAULT_MASK
) {
530 case LADSPA_HINT_DEFAULT_MINIMUM
:
531 u
->control
[h
] = lower
;
534 case LADSPA_HINT_DEFAULT_MAXIMUM
:
535 u
->control
[h
] = upper
;
538 case LADSPA_HINT_DEFAULT_LOW
:
539 if (LADSPA_IS_HINT_LOGARITHMIC(hint
))
540 u
->control
[h
] = exp(log(lower
) * 0.75 + log(upper
) * 0.25);
542 u
->control
[h
] = lower
* 0.75 + upper
* 0.25;
545 case LADSPA_HINT_DEFAULT_MIDDLE
:
546 if (LADSPA_IS_HINT_LOGARITHMIC(hint
))
547 u
->control
[h
] = exp(log(lower
) * 0.5 + log(upper
) * 0.5);
549 u
->control
[h
] = lower
* 0.5 + upper
* 0.5;
552 case LADSPA_HINT_DEFAULT_HIGH
:
553 if (LADSPA_IS_HINT_LOGARITHMIC(hint
))
554 u
->control
[h
] = exp(log(lower
) * 0.25 + log(upper
) * 0.75);
556 u
->control
[h
] = lower
* 0.25 + upper
* 0.75;
559 case LADSPA_HINT_DEFAULT_0
:
563 case LADSPA_HINT_DEFAULT_1
:
567 case LADSPA_HINT_DEFAULT_100
:
571 case LADSPA_HINT_DEFAULT_440
:
576 pa_assert_not_reached();
580 if (LADSPA_IS_HINT_INTEGER(hint
))
581 u
->control
[h
] = roundf(u
->control
[h
]);
583 pa_log_debug("Binding %f to port %s", u
->control
[h
], d
->PortNames
[p
]);
585 for (c
= 0; c
< ss
.channels
; c
++)
586 d
->connect_port(u
->handle
[c
], p
, &u
->control
[h
]);
591 pa_assert(h
== n_control
);
595 for (c
= 0; c
< u
->channels
; c
++)
596 d
->activate(u
->handle
[c
]);
599 pa_sink_new_data_init(&sink_data
);
600 sink_data
.driver
= __FILE__
;
601 sink_data
.module
= m
;
602 if (!(sink_data
.name
= pa_xstrdup(pa_modargs_get_value(ma
, "sink_name", NULL
))))
603 sink_data
.name
= pa_sprintf_malloc("%s.ladspa", master
->name
);
604 sink_data
.namereg_fail
= FALSE
;
605 pa_sink_new_data_set_sample_spec(&sink_data
, &ss
);
606 pa_sink_new_data_set_channel_map(&sink_data
, &map
);
607 z
= pa_proplist_gets(master
->proplist
, PA_PROP_DEVICE_DESCRIPTION
);
608 pa_proplist_sets(sink_data
.proplist
, PA_PROP_DEVICE_DESCRIPTION
, t
= pa_sprintf_malloc("LADSPA Plugin %s on %s", label
, z
? z
: master
->name
));
610 pa_proplist_sets(sink_data
.proplist
, PA_PROP_DEVICE_MASTER_DEVICE
, master
->name
);
611 pa_proplist_sets(sink_data
.proplist
, "device.ladspa.module", plugin
);
612 pa_proplist_sets(sink_data
.proplist
, "device.ladspa.label", d
->Label
);
613 pa_proplist_sets(sink_data
.proplist
, "device.ladspa.name", d
->Name
);
614 pa_proplist_sets(sink_data
.proplist
, "device.ladspa.maker", d
->Maker
);
615 pa_proplist_sets(sink_data
.proplist
, "device.ladspa.copyright", d
->Copyright
);
616 pa_proplist_sets(sink_data
.proplist
, "device.ladspa.unique_id", t
= pa_sprintf_malloc("%lu", (unsigned long) d
->UniqueID
));
619 u
->sink
= pa_sink_new(m
->core
, &sink_data
, 0);
620 pa_sink_new_data_done(&sink_data
);
623 pa_log("Failed to create sink.");
627 u
->sink
->parent
.process_msg
= sink_process_msg
;
628 u
->sink
->set_state
= sink_set_state
;
629 u
->sink
->update_requested_latency
= sink_update_requested_latency
;
630 u
->sink
->request_rewind
= sink_request_rewind
;
631 u
->sink
->userdata
= u
;
632 u
->sink
->flags
= PA_SINK_LATENCY
;
634 pa_sink_set_asyncmsgq(u
->sink
, master
->asyncmsgq
);
635 pa_sink_set_rtpoll(u
->sink
, master
->rtpoll
);
637 /* Create sink input */
638 pa_sink_input_new_data_init(&sink_input_data
);
639 sink_input_data
.driver
= __FILE__
;
640 sink_input_data
.module
= m
;
641 sink_input_data
.sink
= u
->master
;
642 pa_proplist_sets(sink_input_data
.proplist
, PA_PROP_MEDIA_NAME
, "LADSPA Stream");
643 pa_proplist_sets(sink_input_data
.proplist
, PA_PROP_MEDIA_ROLE
, "routing");
644 pa_sink_input_new_data_set_sample_spec(&sink_input_data
, &ss
);
645 pa_sink_input_new_data_set_channel_map(&sink_input_data
, &map
);
647 u
->sink_input
= pa_sink_input_new(m
->core
, &sink_input_data
, PA_SINK_INPUT_DONT_MOVE
);
648 pa_sink_input_new_data_done(&sink_input_data
);
653 u
->sink_input
->parent
.process_msg
= sink_input_process_msg
;
654 u
->sink_input
->pop
= sink_input_pop_cb
;
655 u
->sink_input
->rewind
= sink_input_rewind_cb
;
656 u
->sink_input
->set_max_rewind
= sink_input_set_max_rewind_cb
;
657 u
->sink_input
->kill
= sink_input_kill_cb
;
658 u
->sink_input
->attach
= sink_input_attach_cb
;
659 u
->sink_input
->detach
= sink_input_detach_cb
;
660 u
->sink_input
->userdata
= u
;
662 pa_sink_put(u
->sink
);
663 pa_sink_input_put(u
->sink_input
);
667 pa_xfree(use_default
);
675 pa_xfree(use_default
);
682 void pa__done(pa_module
*m
) {
688 if (!(u
= m
->userdata
))
692 pa_sink_input_unlink(u
->sink_input
);
693 pa_sink_input_unref(u
->sink_input
);
697 pa_sink_unlink(u
->sink
);
698 pa_sink_unref(u
->sink
);
701 for (c
= 0; c
< u
->channels
; c
++)
703 if (u
->descriptor
->deactivate
)
704 u
->descriptor
->deactivate(u
->handle
[c
]);
705 u
->descriptor
->cleanup(u
->handle
[c
]);
708 if (u
->output
!= u
->input
)
713 pa_xfree(u
->control
);