2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
5 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
7 PulseAudio is free software; you can redistribute it and/or modify
8 it under the terms of the GNU Lesser General Public License as published
9 by the Free Software Foundation; either version 2 of the License,
10 or (at your option) any later version.
12 PulseAudio is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
17 You should have received a copy of the GNU Lesser General Public License
18 along with PulseAudio; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
31 #include <pulse/introspect.h>
32 #include <pulse/utf8.h>
33 #include <pulse/xmalloc.h>
34 #include <pulse/timeval.h>
36 #include <pulsecore/sink-input.h>
37 #include <pulsecore/namereg.h>
38 #include <pulsecore/core-util.h>
39 #include <pulsecore/sample-util.h>
40 #include <pulsecore/core-subscribe.h>
41 #include <pulsecore/log.h>
42 #include <pulsecore/macro.h>
43 #include <pulsecore/play-memblockq.h>
47 #define MAX_MIX_CHANNELS 32
48 #define MIX_BUFFER_LENGTH (PA_PAGE_SIZE)
49 #define DEFAULT_MIN_LATENCY (4*PA_USEC_PER_MSEC)
51 static PA_DEFINE_CHECK_TYPE(pa_sink, pa_msgobject);
53 static void sink_free(pa_object *s);
55 pa_sink_new_data* pa_sink_new_data_init(pa_sink_new_data *data) {
58 memset(data, 0, sizeof(*data));
59 data->proplist = pa_proplist_new();
64 void pa_sink_new_data_set_name(pa_sink_new_data *data, const char *name) {
68 data->name = pa_xstrdup(name);
71 void pa_sink_new_data_set_sample_spec(pa_sink_new_data *data, const pa_sample_spec *spec) {
74 if ((data->sample_spec_is_set = !!spec))
75 data->sample_spec = *spec;
78 void pa_sink_new_data_set_channel_map(pa_sink_new_data *data, const pa_channel_map *map) {
81 if ((data->channel_map_is_set = !!map))
82 data->channel_map = *map;
85 void pa_sink_new_data_set_volume(pa_sink_new_data *data, const pa_cvolume *volume) {
88 if ((data->volume_is_set = !!volume))
89 data->volume = *volume;
92 void pa_sink_new_data_set_muted(pa_sink_new_data *data, pa_bool_t mute) {
95 data->muted_is_set = TRUE;
99 void pa_sink_new_data_done(pa_sink_new_data *data) {
102 pa_xfree(data->name);
103 pa_proplist_free(data->proplist);
106 /* Called from main context */
107 static void reset_callbacks(pa_sink *s) {
111 s->get_volume = NULL;
112 s->set_volume = NULL;
115 s->request_rewind = NULL;
116 s->update_requested_latency = NULL;
119 /* Called from main context */
120 pa_sink* pa_sink_new(
122 pa_sink_new_data *data,
123 pa_sink_flags_t flags) {
127 char st[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX];
128 pa_source_new_data source_data;
133 pa_assert(data->name);
135 s = pa_msgobject_new(pa_sink);
137 if (!(name = pa_namereg_register(core, data->name, PA_NAMEREG_SINK, s, data->namereg_fail))) {
142 pa_sink_new_data_set_name(data, name);
144 if (pa_hook_fire(&core->hooks[PA_CORE_HOOK_SINK_NEW], data) < 0) {
146 pa_namereg_unregister(core, name);
150 pa_return_null_if_fail(!data->driver || pa_utf8_valid(data->driver));
151 pa_return_null_if_fail(data->name && pa_utf8_valid(data->name) && data->name[0]);
153 pa_return_null_if_fail(data->sample_spec_is_set && pa_sample_spec_valid(&data->sample_spec));
155 if (!data->channel_map_is_set)
156 pa_return_null_if_fail(pa_channel_map_init_auto(&data->channel_map, data->sample_spec.channels, PA_CHANNEL_MAP_DEFAULT));
158 pa_return_null_if_fail(pa_channel_map_valid(&data->channel_map));
159 pa_return_null_if_fail(data->channel_map.channels == data->sample_spec.channels);
161 if (!data->volume_is_set)
162 pa_cvolume_reset(&data->volume, data->sample_spec.channels);
164 pa_return_null_if_fail(pa_cvolume_valid(&data->volume));
165 pa_return_null_if_fail(data->volume.channels == data->sample_spec.channels);
167 if (!data->muted_is_set)
170 if (pa_hook_fire(&core->hooks[PA_CORE_HOOK_SINK_FIXATE], data) < 0) {
172 pa_namereg_unregister(core, name);
176 s->parent.parent.free = sink_free;
177 s->parent.process_msg = pa_sink_process_msg;
180 s->state = PA_SINK_INIT;
182 s->name = pa_xstrdup(name);
183 s->proplist = pa_proplist_copy(data->proplist);
184 s->driver = pa_xstrdup(data->driver);
185 s->module = data->module;
187 s->sample_spec = data->sample_spec;
188 s->channel_map = data->channel_map;
190 s->inputs = pa_idxset_new(NULL, NULL);
193 s->volume = data->volume;
194 s->muted = data->muted;
195 s->refresh_volume = s->refresh_muted = FALSE;
203 pa_silence_memchunk_get(
204 &core->silence_cache,
210 s->thread_info.inputs = pa_hashmap_new(pa_idxset_trivial_hash_func, pa_idxset_trivial_compare_func);
211 pa_cvolume_reset(&s->thread_info.soft_volume, s->sample_spec.channels);
212 s->thread_info.soft_muted = FALSE;
213 s->thread_info.state = s->state;
214 s->thread_info.rewind_nbytes = 0;
215 s->thread_info.rewind_requested = FALSE;
216 s->thread_info.max_rewind = 0;
217 s->thread_info.max_request = 0;
218 s->thread_info.requested_latency_valid = FALSE;
219 s->thread_info.requested_latency = 0;
220 s->thread_info.min_latency = DEFAULT_MIN_LATENCY;
221 s->thread_info.max_latency = 0;
223 pa_assert_se(pa_idxset_put(core->sinks, s, &s->index) >= 0);
225 pa_log_info("Created sink %u \"%s\" with sample spec %s and channel map %s",
228 pa_sample_spec_snprint(st, sizeof(st), &s->sample_spec),
229 pa_channel_map_snprint(cm, sizeof(cm), &s->channel_map));
231 pa_source_new_data_init(&source_data);
232 pa_source_new_data_set_sample_spec(&source_data, &s->sample_spec);
233 pa_source_new_data_set_channel_map(&source_data, &s->channel_map);
234 source_data.name = pa_sprintf_malloc("%s.monitor", name);
235 source_data.driver = data->driver;
236 source_data.module = data->module;
238 dn = pa_proplist_gets(s->proplist, PA_PROP_DEVICE_DESCRIPTION);
239 pa_proplist_setf(source_data.proplist, PA_PROP_DEVICE_DESCRIPTION, "Monitor of %s", dn ? dn : s->name);
240 pa_proplist_sets(source_data.proplist, PA_PROP_DEVICE_CLASS, "monitor");
242 s->monitor_source = pa_source_new(core, &source_data, 0);
244 pa_source_new_data_done(&source_data);
246 if (!s->monitor_source) {
252 s->monitor_source->monitor_of = s;
254 pa_source_set_latency_range(s->monitor_source, s->thread_info.min_latency, s->thread_info.max_latency);
255 pa_source_set_max_rewind(s->monitor_source, s->thread_info.max_rewind);
260 /* Called from main context */
261 static int sink_set_state(pa_sink *s, pa_sink_state_t state) {
263 pa_bool_t suspend_change;
264 pa_sink_state_t original_state;
268 if (s->state == state)
271 original_state = s->state;
274 (original_state == PA_SINK_SUSPENDED && PA_SINK_IS_OPENED(state)) ||
275 (PA_SINK_IS_OPENED(original_state) && state == PA_SINK_SUSPENDED);
278 if ((ret = s->set_state(s, state)) < 0)
282 if ((ret = pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_STATE, PA_UINT_TO_PTR(state), 0, NULL)) < 0) {
285 s->set_state(s, original_state);
292 if (suspend_change) {
296 /* We're suspending or resuming, tell everyone about it */
298 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx)))
300 i->suspend(i, state == PA_SINK_SUSPENDED);
303 if (state != PA_SINK_UNLINKED) /* if we enter UNLINKED state pa_sink_unlink() will fire the apropriate events */
304 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_STATE_CHANGED], s);
309 /* Called from main context */
310 void pa_sink_put(pa_sink* s) {
311 pa_sink_assert_ref(s);
313 pa_assert(s->state == PA_SINK_INIT);
315 /* The following fields must be initialized properly when calling _put() */
316 pa_assert(s->asyncmsgq);
317 pa_assert(s->rtpoll);
318 pa_assert(!s->thread_info.min_latency || !s->thread_info.max_latency ||
319 s->thread_info.min_latency <= s->thread_info.max_latency);
321 if (!(s->flags & PA_SINK_HW_VOLUME_CTRL)) {
322 s->flags |= PA_SINK_DECIBEL_VOLUME;
324 s->thread_info.soft_volume = s->volume;
325 s->thread_info.soft_muted = s->muted;
328 pa_assert_se(sink_set_state(s, PA_SINK_IDLE) == 0);
330 pa_source_put(s->monitor_source);
332 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK | PA_SUBSCRIPTION_EVENT_NEW, s->index);
333 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_PUT], s);
336 /* Called from main context */
337 void pa_sink_unlink(pa_sink* s) {
339 pa_sink_input *i, *j = NULL;
343 /* Please note that pa_sink_unlink() does more than simply
344 * reversing pa_sink_put(). It also undoes the registrations
345 * already done in pa_sink_new()! */
347 /* All operations here shall be idempotent, i.e. pa_sink_unlink()
348 * may be called multiple times on the same sink without bad
351 linked = PA_SINK_IS_LINKED(s->state);
354 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_UNLINK], s);
356 if (s->state != PA_SINK_UNLINKED)
357 pa_namereg_unregister(s->core, s->name);
358 pa_idxset_remove_by_data(s->core->sinks, s, NULL);
360 while ((i = pa_idxset_first(s->inputs, NULL))) {
362 pa_sink_input_kill(i);
367 sink_set_state(s, PA_SINK_UNLINKED);
369 s->state = PA_SINK_UNLINKED;
373 if (s->monitor_source)
374 pa_source_unlink(s->monitor_source);
377 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK | PA_SUBSCRIPTION_EVENT_REMOVE, s->index);
378 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_UNLINK_POST], s);
382 /* Called from main context */
383 static void sink_free(pa_object *o) {
384 pa_sink *s = PA_SINK(o);
388 pa_assert(pa_sink_refcnt(s) == 0);
390 if (PA_SINK_IS_LINKED(s->state))
393 pa_log_info("Freeing sink %u \"%s\"", s->index, s->name);
395 if (s->monitor_source) {
396 pa_source_unref(s->monitor_source);
397 s->monitor_source = NULL;
400 pa_idxset_free(s->inputs, NULL, NULL);
402 while ((i = pa_hashmap_steal_first(s->thread_info.inputs)))
403 pa_sink_input_unref(i);
405 pa_hashmap_free(s->thread_info.inputs, NULL, NULL);
407 if (s->silence.memblock)
408 pa_memblock_unref(s->silence.memblock);
414 pa_proplist_free(s->proplist);
419 /* Called from main context */
420 void pa_sink_set_asyncmsgq(pa_sink *s, pa_asyncmsgq *q) {
421 pa_sink_assert_ref(s);
425 if (s->monitor_source)
426 pa_source_set_asyncmsgq(s->monitor_source, q);
429 /* Called from main context */
430 void pa_sink_set_rtpoll(pa_sink *s, pa_rtpoll *p) {
431 pa_sink_assert_ref(s);
434 if (s->monitor_source)
435 pa_source_set_rtpoll(s->monitor_source, p);
438 /* Called from main context */
439 int pa_sink_update_status(pa_sink*s) {
440 pa_sink_assert_ref(s);
441 pa_assert(PA_SINK_IS_LINKED(s->state));
443 if (s->state == PA_SINK_SUSPENDED)
446 return sink_set_state(s, pa_sink_used_by(s) ? PA_SINK_RUNNING : PA_SINK_IDLE);
449 /* Called from main context */
450 int pa_sink_suspend(pa_sink *s, pa_bool_t suspend) {
451 pa_sink_assert_ref(s);
452 pa_assert(PA_SINK_IS_LINKED(s->state));
455 return sink_set_state(s, PA_SINK_SUSPENDED);
457 return sink_set_state(s, pa_sink_used_by(s) ? PA_SINK_RUNNING : PA_SINK_IDLE);
460 /* Called from IO thread context */
461 void pa_sink_process_rewind(pa_sink *s, size_t nbytes) {
464 pa_sink_assert_ref(s);
465 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
467 s->thread_info.rewind_nbytes = 0;
468 s->thread_info.rewind_requested = FALSE;
471 pa_log_debug("Processing rewind...");
473 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL))) {
474 pa_sink_input_assert_ref(i);
475 pa_sink_input_process_rewind(i, nbytes);
479 if (s->monitor_source && PA_SOURCE_IS_OPENED(s->monitor_source->thread_info.state))
480 pa_source_process_rewind(s->monitor_source, nbytes);
483 /* Called from IO thread context */
484 static unsigned fill_mix_info(pa_sink *s, size_t *length, pa_mix_info *info, unsigned maxinfo) {
488 size_t mixlength = *length;
490 pa_sink_assert_ref(s);
493 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)) && maxinfo > 0) {
494 pa_sink_input_assert_ref(i);
496 if (pa_sink_input_peek(i, *length, &info->chunk, &info->volume) < 0)
499 if (mixlength == 0 || info->chunk.length < mixlength)
500 mixlength = info->chunk.length;
502 if (pa_memblock_is_silence(info->chunk.memblock)) {
503 pa_memblock_unref(info->chunk.memblock);
507 info->userdata = pa_sink_input_ref(i);
509 pa_assert(info->chunk.memblock);
510 pa_assert(info->chunk.length > 0);
523 /* Called from IO thread context */
524 static void inputs_drop(pa_sink *s, pa_mix_info *info, unsigned n, pa_memchunk *result) {
528 unsigned n_unreffed = 0;
530 pa_sink_assert_ref(s);
532 pa_assert(result->memblock);
533 pa_assert(result->length > 0);
535 /* We optimize for the case where the order of the inputs has not changed */
537 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL))) {
539 pa_mix_info* m = NULL;
541 pa_sink_input_assert_ref(i);
543 /* Let's try to find the matching entry info the pa_mix_info array */
544 for (j = 0; j < n; j ++) {
546 if (info[p].userdata == i) {
557 pa_sink_input_drop(i, result->length);
559 if (s->monitor_source && PA_SOURCE_IS_OPENED(pa_source_get_state(s->monitor_source))) {
561 if (pa_hashmap_size(i->thread_info.direct_outputs) > 0) {
566 if (m && m->chunk.memblock) {
568 pa_memblock_ref(c.memblock);
569 pa_assert(result->length <= c.length);
570 c.length = result->length;
572 pa_memchunk_make_writable(&c, 0);
573 pa_volume_memchunk(&c, &s->sample_spec, &m->volume);
576 pa_memblock_ref(c.memblock);
577 pa_assert(result->length <= c.length);
578 c.length = result->length;
581 while ((o = pa_hashmap_iterate(i->thread_info.direct_outputs, &ostate, NULL))) {
582 pa_source_output_assert_ref(o);
583 pa_assert(o->direct_on_input == i);
584 pa_source_post_direct(s->monitor_source, o, &c);
587 pa_memblock_unref(c.memblock);
592 if (m->chunk.memblock)
593 pa_memblock_unref(m->chunk.memblock);
594 pa_memchunk_reset(&m->chunk);
596 pa_sink_input_unref(m->userdata);
603 /* Now drop references to entries that are included in the
604 * pa_mix_info array but don't exist anymore */
606 if (n_unreffed < n) {
607 for (; n > 0; info++, n--) {
609 pa_sink_input_unref(info->userdata);
610 if (info->chunk.memblock)
611 pa_memblock_unref(info->chunk.memblock);
615 if (s->monitor_source && PA_SOURCE_IS_OPENED(pa_source_get_state(s->monitor_source)))
616 pa_source_post(s->monitor_source, result);
619 /* Called from IO thread context */
620 void pa_sink_render(pa_sink*s, size_t length, pa_memchunk *result) {
621 pa_mix_info info[MAX_MIX_CHANNELS];
623 size_t block_size_max;
625 pa_sink_assert_ref(s);
626 pa_assert(PA_SINK_IS_OPENED(s->thread_info.state));
627 pa_assert(pa_frame_aligned(length, &s->sample_spec));
632 pa_assert(!s->thread_info.rewind_requested);
633 pa_assert(s->thread_info.rewind_nbytes == 0);
636 length = pa_frame_align(MIX_BUFFER_LENGTH, &s->sample_spec);
638 block_size_max = pa_mempool_block_size_max(s->core->mempool);
639 if (length > block_size_max)
640 length = pa_frame_align(block_size_max, &s->sample_spec);
642 pa_assert(length > 0);
644 n = s->thread_info.state == PA_SINK_RUNNING ? fill_mix_info(s, &length, info, MAX_MIX_CHANNELS) : 0;
648 *result = s->silence;
649 pa_memblock_ref(result->memblock);
651 if (result->length > length)
652 result->length = length;
657 *result = info[0].chunk;
658 pa_memblock_ref(result->memblock);
660 if (result->length > length)
661 result->length = length;
663 pa_sw_cvolume_multiply(&volume, &s->thread_info.soft_volume, &info[0].volume);
665 if (s->thread_info.soft_muted || !pa_cvolume_is_norm(&volume)) {
666 pa_memchunk_make_writable(result, 0);
667 if (s->thread_info.soft_muted || pa_cvolume_is_muted(&volume))
668 pa_silence_memchunk(result, &s->sample_spec);
670 pa_volume_memchunk(result, &s->sample_spec, &volume);
674 result->memblock = pa_memblock_new(s->core->mempool, length);
676 ptr = pa_memblock_acquire(result->memblock);
677 result->length = pa_mix(info, n,
680 &s->thread_info.soft_volume,
681 s->thread_info.soft_muted);
682 pa_memblock_release(result->memblock);
687 if (s->thread_info.state == PA_SINK_RUNNING)
688 inputs_drop(s, info, n, result);
693 /* Called from IO thread context */
694 void pa_sink_render_into(pa_sink*s, pa_memchunk *target) {
695 pa_mix_info info[MAX_MIX_CHANNELS];
697 size_t length, block_size_max;
699 pa_sink_assert_ref(s);
700 pa_assert(PA_SINK_IS_OPENED(s->thread_info.state));
702 pa_assert(target->memblock);
703 pa_assert(target->length > 0);
704 pa_assert(pa_frame_aligned(target->length, &s->sample_spec));
708 pa_assert(!s->thread_info.rewind_requested);
709 pa_assert(s->thread_info.rewind_nbytes == 0);
711 length = target->length;
712 block_size_max = pa_mempool_block_size_max(s->core->mempool);
713 if (length > block_size_max)
714 length = pa_frame_align(block_size_max, &s->sample_spec);
716 pa_assert(length > 0);
718 n = s->thread_info.state == PA_SINK_RUNNING ? fill_mix_info(s, &length, info, MAX_MIX_CHANNELS) : 0;
721 if (target->length > length)
722 target->length = length;
724 pa_silence_memchunk(target, &s->sample_spec);
728 if (target->length > length)
729 target->length = length;
731 pa_sw_cvolume_multiply(&volume, &s->thread_info.soft_volume, &info[0].volume);
733 if (s->thread_info.soft_muted || pa_cvolume_is_muted(&volume))
734 pa_silence_memchunk(target, &s->sample_spec);
738 vchunk = info[0].chunk;
739 pa_memblock_ref(vchunk.memblock);
741 if (vchunk.length > length)
742 vchunk.length = length;
744 if (!pa_cvolume_is_norm(&volume)) {
745 pa_memchunk_make_writable(&vchunk, 0);
746 pa_volume_memchunk(&vchunk, &s->sample_spec, &volume);
749 pa_memchunk_memcpy(target, &vchunk);
750 pa_memblock_unref(vchunk.memblock);
756 ptr = pa_memblock_acquire(target->memblock);
758 target->length = pa_mix(info, n,
759 (uint8_t*) ptr + target->index, length,
761 &s->thread_info.soft_volume,
762 s->thread_info.soft_muted);
764 pa_memblock_release(target->memblock);
767 if (s->thread_info.state == PA_SINK_RUNNING)
768 inputs_drop(s, info, n, target);
773 /* Called from IO thread context */
774 void pa_sink_render_into_full(pa_sink *s, pa_memchunk *target) {
778 pa_sink_assert_ref(s);
779 pa_assert(PA_SINK_IS_OPENED(s->thread_info.state));
781 pa_assert(target->memblock);
782 pa_assert(target->length > 0);
783 pa_assert(pa_frame_aligned(target->length, &s->sample_spec));
787 pa_assert(!s->thread_info.rewind_requested);
788 pa_assert(s->thread_info.rewind_nbytes == 0);
797 pa_sink_render_into(s, &chunk);
806 /* Called from IO thread context */
807 void pa_sink_render_full(pa_sink *s, size_t length, pa_memchunk *result) {
808 pa_sink_assert_ref(s);
809 pa_assert(PA_SINK_IS_OPENED(s->thread_info.state));
810 pa_assert(length > 0);
811 pa_assert(pa_frame_aligned(length, &s->sample_spec));
814 pa_assert(!s->thread_info.rewind_requested);
815 pa_assert(s->thread_info.rewind_nbytes == 0);
817 /*** This needs optimization ***/
820 result->length = length;
821 result->memblock = pa_memblock_new(s->core->mempool, length);
823 pa_sink_render_into_full(s, result);
826 /* Called from main thread */
827 pa_usec_t pa_sink_get_latency(pa_sink *s) {
830 pa_sink_assert_ref(s);
831 pa_assert(PA_SINK_IS_LINKED(s->state));
833 /* The returned value is supposed to be in the time domain of the sound card! */
835 if (!PA_SINK_IS_OPENED(s->state))
838 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY, &usec, 0, NULL) == 0);
843 /* Called from main thread */
844 void pa_sink_set_volume(pa_sink *s, const pa_cvolume *volume) {
846 pa_sink_set_volume_data data;
848 pa_sink_assert_ref(s);
849 pa_assert(PA_SINK_IS_LINKED(s->state));
851 pa_assert(pa_cvolume_valid(volume));
852 pa_assert(pa_cvolume_compatible(volume, &s->sample_spec));
855 data.volume = *volume;
857 changed = !pa_cvolume_equal(&data.volume, &s->volume);
860 if (pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_SET_VOLUME], &data) < 0)
863 changed = !pa_cvolume_equal(&data.volume, &s->volume);
866 s->volume = data.volume;
868 if (s->set_volume && s->set_volume(s) < 0)
869 s->set_volume = NULL;
872 pa_sink_set_soft_volume(s, volume);
875 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
878 /* Called from main thread */
879 void pa_sink_set_soft_volume(pa_sink *s, const pa_cvolume *volume) {
880 pa_sink_assert_ref(s);
883 if (PA_SINK_IS_LINKED(s->state))
884 pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_VOLUME, volume, 0, NULL);
886 s->thread_info.soft_volume = *volume;
889 /* Called from main thread */
890 const pa_cvolume *pa_sink_get_volume(pa_sink *s, pa_bool_t force_refresh) {
891 pa_sink_assert_ref(s);
892 pa_assert(PA_SINK_IS_LINKED(s->state));
894 if (s->refresh_volume || force_refresh) {
895 struct pa_cvolume old_volume = s->volume;
897 if (s->get_volume && s->get_volume(s) < 0)
898 s->get_volume = NULL;
901 pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_VOLUME, &s->volume, 0, NULL);
903 if (!pa_cvolume_equal(&old_volume, &s->volume))
904 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
910 /* Called from main thread */
911 void pa_sink_set_mute(pa_sink *s, pa_bool_t mute) {
914 pa_sink_assert_ref(s);
915 pa_assert(PA_SINK_IS_LINKED(s->state));
917 changed = s->muted != mute;
920 if (s->set_mute && s->set_mute(s) < 0)
924 pa_asyncmsgq_post(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_MUTE, PA_UINT_TO_PTR(mute), 0, NULL, NULL);
927 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
930 /* Called from main thread */
931 pa_bool_t pa_sink_get_mute(pa_sink *s, pa_bool_t force_refresh) {
933 pa_sink_assert_ref(s);
934 pa_assert(PA_SINK_IS_LINKED(s->state));
936 if (s->refresh_muted || force_refresh) {
937 pa_bool_t old_muted = s->muted;
939 if (s->get_mute && s->get_mute(s) < 0)
943 pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_MUTE, &s->muted, 0, NULL);
945 if (old_muted != s->muted)
946 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
952 /* Called from main thread */
953 void pa_sink_set_description(pa_sink *s, const char *description) {
955 pa_sink_assert_ref(s);
957 if (!description && !pa_proplist_contains(s->proplist, PA_PROP_DEVICE_DESCRIPTION))
960 old = pa_proplist_gets(s->proplist, PA_PROP_DEVICE_DESCRIPTION);
962 if (old && description && !strcmp(old, description))
966 pa_proplist_sets(s->proplist, PA_PROP_DEVICE_DESCRIPTION, description);
968 pa_proplist_unset(s->proplist, PA_PROP_DEVICE_DESCRIPTION);
970 if (s->monitor_source) {
973 n = pa_sprintf_malloc("Monitor Source of %s", description ? description : s->name);
974 pa_source_set_description(s->monitor_source, n);
978 if (PA_SINK_IS_LINKED(s->state)) {
979 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
980 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_PROPLIST_CHANGED], s);
984 /* Called from main thread */
985 unsigned pa_sink_linked_by(pa_sink *s) {
988 pa_sink_assert_ref(s);
989 pa_assert(PA_SINK_IS_LINKED(s->state));
991 ret = pa_idxset_size(s->inputs);
993 /* We add in the number of streams connected to us here. Please
994 * not the asymmmetry to pa_sink_used_by()! */
996 if (s->monitor_source)
997 ret += pa_source_linked_by(s->monitor_source);
1002 /* Called from main thread */
1003 unsigned pa_sink_used_by(pa_sink *s) {
1006 pa_sink_assert_ref(s);
1007 pa_assert(PA_SINK_IS_LINKED(s->state));
1009 ret = pa_idxset_size(s->inputs);
1010 pa_assert(ret >= s->n_corked);
1012 /* Streams connected to our monitor source do not matter for
1013 * pa_sink_used_by()!.*/
1015 return ret - s->n_corked;
1018 /* Called from IO thread, except when it is not */
1019 int pa_sink_process_msg(pa_msgobject *o, int code, void *userdata, int64_t offset, pa_memchunk *chunk) {
1020 pa_sink *s = PA_SINK(o);
1021 pa_sink_assert_ref(s);
1023 switch ((pa_sink_message_t) code) {
1025 case PA_SINK_MESSAGE_ADD_INPUT: {
1026 pa_sink_input *i = PA_SINK_INPUT(userdata);
1028 /* If you change anything here, make sure to change the
1029 * sink input handling a few lines down at
1030 * PA_SINK_MESSAGE_FINISH_MOVE, too. */
1032 pa_hashmap_put(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index), pa_sink_input_ref(i));
1034 /* Since the caller sleeps in pa_sink_input_put(), we can
1035 * safely access data outside of thread_info even though
1038 if ((i->thread_info.sync_prev = i->sync_prev)) {
1039 pa_assert(i->sink == i->thread_info.sync_prev->sink);
1040 pa_assert(i->sync_prev->sync_next == i);
1041 i->thread_info.sync_prev->thread_info.sync_next = i;
1044 if ((i->thread_info.sync_next = i->sync_next)) {
1045 pa_assert(i->sink == i->thread_info.sync_next->sink);
1046 pa_assert(i->sync_next->sync_prev == i);
1047 i->thread_info.sync_next->thread_info.sync_prev = i;
1050 pa_assert(!i->thread_info.attached);
1051 i->thread_info.attached = TRUE;
1056 pa_sink_input_set_state_within_thread(i, i->state);
1058 /* The requested latency of the sink input needs to be
1059 * fixed up and then configured on the sink */
1061 if (i->thread_info.requested_sink_latency != (pa_usec_t) -1)
1062 pa_sink_input_set_requested_latency_within_thread(i, i->thread_info.requested_sink_latency);
1064 pa_sink_input_update_max_rewind(i, s->thread_info.max_rewind);
1065 pa_sink_input_update_max_request(i, s->thread_info.max_request);
1067 /* We don't rewind here automatically. This is left to the
1068 * sink input implementor because some sink inputs need a
1069 * slow start, i.e. need some time to buffer client
1070 * samples before beginning streaming. */
1075 case PA_SINK_MESSAGE_REMOVE_INPUT: {
1076 pa_sink_input *i = PA_SINK_INPUT(userdata);
1078 /* If you change anything here, make sure to change the
1079 * sink input handling a few lines down at
1080 * PA_SINK_MESSAGE_PREPAPRE_MOVE, too. */
1085 pa_sink_input_set_state_within_thread(i, i->state);
1087 pa_assert(i->thread_info.attached);
1088 i->thread_info.attached = FALSE;
1090 /* Since the caller sleeps in pa_sink_input_unlink(),
1091 * we can safely access data outside of thread_info even
1092 * though it is mutable */
1094 pa_assert(!i->sync_prev);
1095 pa_assert(!i->sync_next);
1097 if (i->thread_info.sync_prev) {
1098 i->thread_info.sync_prev->thread_info.sync_next = i->thread_info.sync_prev->sync_next;
1099 i->thread_info.sync_prev = NULL;
1102 if (i->thread_info.sync_next) {
1103 i->thread_info.sync_next->thread_info.sync_prev = i->thread_info.sync_next->sync_prev;
1104 i->thread_info.sync_next = NULL;
1107 if (pa_hashmap_remove(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index)))
1108 pa_sink_input_unref(i);
1110 pa_sink_invalidate_requested_latency(s);
1111 pa_sink_request_rewind(s, (size_t) -1);
1116 case PA_SINK_MESSAGE_START_MOVE: {
1117 pa_sink_input *i = PA_SINK_INPUT(userdata);
1119 /* We don't support moving synchronized streams. */
1120 pa_assert(!i->sync_prev);
1121 pa_assert(!i->sync_next);
1122 pa_assert(!i->thread_info.sync_next);
1123 pa_assert(!i->thread_info.sync_prev);
1125 if (i->thread_info.state != PA_SINK_INPUT_CORKED) {
1127 size_t sink_nbytes, total_nbytes;
1129 /* Get the latency of the sink */
1130 if (PA_MSGOBJECT(s)->process_msg(PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY, &usec, 0, NULL) < 0)
1133 sink_nbytes = pa_usec_to_bytes(usec, &s->sample_spec);
1134 total_nbytes = sink_nbytes + pa_memblockq_get_length(i->thread_info.render_memblockq);
1136 if (total_nbytes > 0) {
1137 i->thread_info.rewrite_nbytes = i->thread_info.resampler ? pa_resampler_request(i->thread_info.resampler, total_nbytes) : total_nbytes;
1138 i->thread_info.rewrite_flush = TRUE;
1139 pa_sink_input_process_rewind(i, sink_nbytes);
1146 pa_assert(i->thread_info.attached);
1147 i->thread_info.attached = FALSE;
1149 /* Let's remove the sink input ...*/
1150 if (pa_hashmap_remove(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index)))
1151 pa_sink_input_unref(i);
1153 pa_sink_invalidate_requested_latency(s);
1155 pa_log_debug("Requesting rewind due to started move");
1156 pa_sink_request_rewind(s, (size_t) -1);
1161 case PA_SINK_MESSAGE_FINISH_MOVE: {
1162 pa_sink_input *i = PA_SINK_INPUT(userdata);
1164 /* We don't support moving synchronized streams. */
1165 pa_assert(!i->sync_prev);
1166 pa_assert(!i->sync_next);
1167 pa_assert(!i->thread_info.sync_next);
1168 pa_assert(!i->thread_info.sync_prev);
1170 pa_hashmap_put(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index), pa_sink_input_ref(i));
1172 pa_assert(!i->thread_info.attached);
1173 i->thread_info.attached = TRUE;
1178 if (i->thread_info.requested_sink_latency != (pa_usec_t) -1)
1179 pa_sink_input_set_requested_latency_within_thread(i, i->thread_info.requested_sink_latency);
1181 pa_sink_input_update_max_rewind(i, s->thread_info.max_rewind);
1182 pa_sink_input_update_max_request(i, s->thread_info.max_request);
1184 if (i->thread_info.state != PA_SINK_INPUT_CORKED) {
1188 /* Get the latency of the sink */
1189 if (PA_MSGOBJECT(s)->process_msg(PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY, &usec, 0, NULL) < 0)
1192 nbytes = pa_usec_to_bytes(usec, &s->sample_spec);
1195 pa_sink_input_drop(i, nbytes);
1197 pa_log_debug("Requesting rewind due to finished move");
1198 pa_sink_request_rewind(s, nbytes);
1204 case PA_SINK_MESSAGE_SET_VOLUME:
1205 s->thread_info.soft_volume = *((pa_cvolume*) userdata);
1207 pa_sink_request_rewind(s, (size_t) -1);
1210 case PA_SINK_MESSAGE_SET_MUTE:
1211 s->thread_info.soft_muted = PA_PTR_TO_UINT(userdata);
1213 pa_sink_request_rewind(s, (size_t) -1);
1216 case PA_SINK_MESSAGE_GET_VOLUME:
1217 *((pa_cvolume*) userdata) = s->thread_info.soft_volume;
1220 case PA_SINK_MESSAGE_GET_MUTE:
1221 *((pa_bool_t*) userdata) = s->thread_info.soft_muted;
1224 case PA_SINK_MESSAGE_SET_STATE:
1226 s->thread_info.state = PA_PTR_TO_UINT(userdata);
1229 case PA_SINK_MESSAGE_DETACH:
1231 /* Detach all streams */
1232 pa_sink_detach_within_thread(s);
1235 case PA_SINK_MESSAGE_ATTACH:
1237 /* Reattach all streams */
1238 pa_sink_attach_within_thread(s);
1241 case PA_SINK_MESSAGE_GET_REQUESTED_LATENCY: {
1243 pa_usec_t *usec = userdata;
1244 *usec = pa_sink_get_requested_latency_within_thread(s);
1246 if (*usec == (pa_usec_t) -1)
1247 *usec = s->thread_info.max_latency;
1252 case PA_SINK_MESSAGE_SET_LATENCY_RANGE: {
1253 pa_usec_t *r = userdata;
1255 pa_sink_update_latency_range(s, r[0], r[1]);
1260 case PA_SINK_MESSAGE_GET_LATENCY_RANGE: {
1261 pa_usec_t *r = userdata;
1263 r[0] = s->thread_info.min_latency;
1264 r[1] = s->thread_info.max_latency;
1269 case PA_SINK_MESSAGE_GET_MAX_REWIND:
1271 *((size_t*) userdata) = s->thread_info.max_rewind;
1274 case PA_SINK_MESSAGE_GET_MAX_REQUEST:
1276 *((size_t*) userdata) = s->thread_info.max_request;
1279 case PA_SINK_MESSAGE_GET_LATENCY:
1280 case PA_SINK_MESSAGE_MAX:
1287 /* Called from main thread */
1288 int pa_sink_suspend_all(pa_core *c, pa_bool_t suspend) {
1293 pa_core_assert_ref(c);
1295 for (sink = PA_SINK(pa_idxset_first(c->sinks, &idx)); sink; sink = PA_SINK(pa_idxset_next(c->sinks, &idx)))
1296 ret -= pa_sink_suspend(sink, suspend) < 0;
1301 /* Called from main thread */
1302 void pa_sink_detach(pa_sink *s) {
1303 pa_sink_assert_ref(s);
1304 pa_assert(PA_SINK_IS_LINKED(s->state));
1306 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_DETACH, NULL, 0, NULL) == 0);
1309 /* Called from main thread */
1310 void pa_sink_attach(pa_sink *s) {
1311 pa_sink_assert_ref(s);
1312 pa_assert(PA_SINK_IS_LINKED(s->state));
1314 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_ATTACH, NULL, 0, NULL) == 0);
1317 /* Called from IO thread */
1318 void pa_sink_detach_within_thread(pa_sink *s) {
1322 pa_sink_assert_ref(s);
1323 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
1325 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1329 if (s->monitor_source)
1330 pa_source_detach_within_thread(s->monitor_source);
1333 /* Called from IO thread */
1334 void pa_sink_attach_within_thread(pa_sink *s) {
1338 pa_sink_assert_ref(s);
1339 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
1341 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1345 if (s->monitor_source)
1346 pa_source_attach_within_thread(s->monitor_source);
1349 /* Called from IO thread */
1350 void pa_sink_request_rewind(pa_sink*s, size_t nbytes) {
1351 pa_sink_assert_ref(s);
1352 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
1354 if (nbytes == (size_t) -1)
1355 nbytes = s->thread_info.max_rewind;
1357 nbytes = PA_MIN(nbytes, s->thread_info.max_rewind);
1359 if (s->thread_info.rewind_requested &&
1360 nbytes <= s->thread_info.rewind_nbytes)
1363 s->thread_info.rewind_nbytes = nbytes;
1364 s->thread_info.rewind_requested = TRUE;
1366 if (s->request_rewind)
1367 s->request_rewind(s);
1370 /* Called from IO thread */
1371 pa_usec_t pa_sink_get_requested_latency_within_thread(pa_sink *s) {
1372 pa_usec_t result = (pa_usec_t) -1;
1375 pa_usec_t monitor_latency;
1377 pa_sink_assert_ref(s);
1379 if (s->thread_info.requested_latency_valid)
1380 return s->thread_info.requested_latency;
1382 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1384 if (i->thread_info.requested_sink_latency != (pa_usec_t) -1 &&
1385 (result == (pa_usec_t) -1 || result > i->thread_info.requested_sink_latency))
1386 result = i->thread_info.requested_sink_latency;
1388 monitor_latency = pa_source_get_requested_latency_within_thread(s->monitor_source);
1390 if (monitor_latency != (pa_usec_t) -1 &&
1391 (result == (pa_usec_t) -1 || result > monitor_latency))
1392 result = monitor_latency;
1394 if (result != (pa_usec_t) -1) {
1395 if (s->thread_info.max_latency > 0 && result > s->thread_info.max_latency)
1396 result = s->thread_info.max_latency;
1398 if (s->thread_info.min_latency > 0 && result < s->thread_info.min_latency)
1399 result = s->thread_info.min_latency;
1402 s->thread_info.requested_latency = result;
1403 s->thread_info.requested_latency_valid = TRUE;
1408 /* Called from main thread */
1409 pa_usec_t pa_sink_get_requested_latency(pa_sink *s) {
1412 pa_sink_assert_ref(s);
1413 pa_assert(PA_SINK_IS_LINKED(s->state));
1415 if (!PA_SINK_IS_OPENED(s->state))
1418 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_REQUESTED_LATENCY, &usec, 0, NULL) == 0);
1422 /* Called from IO thread */
1423 void pa_sink_set_max_rewind(pa_sink *s, size_t max_rewind) {
1427 pa_sink_assert_ref(s);
1429 if (max_rewind == s->thread_info.max_rewind)
1432 s->thread_info.max_rewind = max_rewind;
1434 if (PA_SINK_IS_LINKED(s->thread_info.state)) {
1435 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1436 pa_sink_input_update_max_rewind(i, s->thread_info.max_rewind);
1439 if (s->monitor_source)
1440 pa_source_set_max_rewind(s->monitor_source, s->thread_info.max_rewind);
1443 /* Called from IO thread */
1444 void pa_sink_set_max_request(pa_sink *s, size_t max_request) {
1447 pa_sink_assert_ref(s);
1449 if (max_request == s->thread_info.max_request)
1452 s->thread_info.max_request = max_request;
1454 if (PA_SINK_IS_LINKED(s->thread_info.state)) {
1457 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1458 pa_sink_input_update_max_request(i, s->thread_info.max_request);
1462 /* Called from IO thread */
1463 void pa_sink_invalidate_requested_latency(pa_sink *s) {
1467 pa_sink_assert_ref(s);
1469 s->thread_info.requested_latency_valid = FALSE;
1471 if (s->update_requested_latency)
1472 s->update_requested_latency(s);
1474 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1475 if (i->update_sink_requested_latency)
1476 i->update_sink_requested_latency(i);
1479 /* Called from main thread */
1480 void pa_sink_set_latency_range(pa_sink *s, pa_usec_t min_latency, pa_usec_t max_latency) {
1481 pa_sink_assert_ref(s);
1483 /* min_latency == 0: no limit
1484 * min_latency == (size_t) -1: default limit
1485 * min_latency anything else: specified limit
1487 * Similar for max_latency */
1489 if (min_latency == (pa_usec_t) -1)
1490 min_latency = DEFAULT_MIN_LATENCY;
1492 if (max_latency == (pa_usec_t) -1)
1493 max_latency = min_latency;
1495 pa_assert(!min_latency || !max_latency ||
1496 min_latency <= max_latency);
1498 if (PA_SINK_IS_LINKED(s->state)) {
1504 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_LATENCY_RANGE, r, 0, NULL) == 0);
1506 s->thread_info.min_latency = min_latency;
1507 s->thread_info.max_latency = max_latency;
1509 s->monitor_source->thread_info.min_latency = min_latency;
1510 s->monitor_source->thread_info.max_latency = max_latency;
1512 s->thread_info.requested_latency_valid = s->monitor_source->thread_info.requested_latency_valid = FALSE;
1516 /* Called from main thread */
1517 void pa_sink_get_latency_range(pa_sink *s, pa_usec_t *min_latency, pa_usec_t *max_latency) {
1518 pa_sink_assert_ref(s);
1519 pa_assert(min_latency);
1520 pa_assert(max_latency);
1522 if (PA_SINK_IS_LINKED(s->state)) {
1523 pa_usec_t r[2] = { 0, 0 };
1525 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY_RANGE, r, 0, NULL) == 0);
1527 *min_latency = r[0];
1528 *max_latency = r[1];
1530 *min_latency = s->thread_info.min_latency;
1531 *max_latency = s->thread_info.max_latency;
1535 /* Called from IO thread */
1536 void pa_sink_update_latency_range(pa_sink *s, pa_usec_t min_latency, pa_usec_t max_latency) {
1540 pa_sink_assert_ref(s);
1542 s->thread_info.min_latency = min_latency;
1543 s->thread_info.max_latency = max_latency;
1545 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1546 if (i->update_sink_latency_range)
1547 i->update_sink_latency_range(i);
1549 pa_sink_invalidate_requested_latency(s);
1551 pa_source_update_latency_range(s->monitor_source, min_latency, max_latency);
1554 size_t pa_sink_get_max_rewind(pa_sink *s) {
1556 pa_sink_assert_ref(s);
1558 if (!PA_SINK_IS_LINKED(s->state))
1559 return s->thread_info.max_rewind;
1561 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_MAX_REWIND, &r, 0, NULL) == 0);
1566 size_t pa_sink_get_max_request(pa_sink *s) {
1568 pa_sink_assert_ref(s);
1570 if (!PA_SINK_IS_LINKED(s->state))
1571 return s->thread_info.max_request;
1573 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_MAX_REQUEST, &r, 0, NULL) == 0);