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/utf8.h>
32 #include <pulse/xmalloc.h>
33 #include <pulse/timeval.h>
34 #include <pulse/util.h>
36 #include <pulsecore/source-output.h>
37 #include <pulsecore/namereg.h>
38 #include <pulsecore/core-subscribe.h>
39 #include <pulsecore/log.h>
40 #include <pulsecore/sample-util.h>
44 #define DEFAULT_MIN_LATENCY (4*PA_USEC_PER_MSEC)
46 static PA_DEFINE_CHECK_TYPE(pa_source
, pa_msgobject
);
48 static void source_free(pa_object
*o
);
50 pa_source_new_data
* pa_source_new_data_init(pa_source_new_data
*data
) {
53 memset(data
, 0, sizeof(*data
));
54 data
->proplist
= pa_proplist_new();
59 void pa_source_new_data_set_name(pa_source_new_data
*data
, const char *name
) {
63 data
->name
= pa_xstrdup(name
);
66 void pa_source_new_data_set_sample_spec(pa_source_new_data
*data
, const pa_sample_spec
*spec
) {
69 if ((data
->sample_spec_is_set
= !!spec
))
70 data
->sample_spec
= *spec
;
73 void pa_source_new_data_set_channel_map(pa_source_new_data
*data
, const pa_channel_map
*map
) {
76 if ((data
->channel_map_is_set
= !!map
))
77 data
->channel_map
= *map
;
80 void pa_source_new_data_set_volume(pa_source_new_data
*data
, const pa_cvolume
*volume
) {
83 if ((data
->volume_is_set
= !!volume
))
84 data
->volume
= *volume
;
87 void pa_source_new_data_set_muted(pa_source_new_data
*data
, pa_bool_t mute
) {
90 data
->muted_is_set
= TRUE
;
94 void pa_source_new_data_done(pa_source_new_data
*data
) {
98 pa_proplist_free(data
->proplist
);
101 /* Called from main context */
102 static void reset_callbacks(pa_source
*s
) {
106 s
->get_volume
= NULL
;
107 s
->set_volume
= NULL
;
110 s
->update_requested_latency
= NULL
;
113 /* Called from main context */
114 pa_source
* pa_source_new(
116 pa_source_new_data
*data
,
117 pa_source_flags_t flags
) {
121 char st
[PA_SAMPLE_SPEC_SNPRINT_MAX
], cm
[PA_CHANNEL_MAP_SNPRINT_MAX
];
126 pa_assert(data
->name
);
128 s
= pa_msgobject_new(pa_source
);
130 if (!(name
= pa_namereg_register(core
, data
->name
, PA_NAMEREG_SOURCE
, s
, data
->namereg_fail
))) {
135 pa_source_new_data_set_name(data
, name
);
137 if (pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_NEW
], data
) < 0) {
139 pa_namereg_unregister(core
, name
);
143 pa_return_null_if_fail(!data
->driver
|| pa_utf8_valid(data
->driver
));
144 pa_return_null_if_fail(data
->name
&& pa_utf8_valid(data
->name
) && data
->name
[0]);
146 pa_return_null_if_fail(data
->sample_spec_is_set
&& pa_sample_spec_valid(&data
->sample_spec
));
148 if (!data
->channel_map_is_set
)
149 pa_return_null_if_fail(pa_channel_map_init_auto(&data
->channel_map
, data
->sample_spec
.channels
, PA_CHANNEL_MAP_DEFAULT
));
151 pa_return_null_if_fail(pa_channel_map_valid(&data
->channel_map
));
152 pa_return_null_if_fail(data
->channel_map
.channels
== data
->sample_spec
.channels
);
154 if (!data
->volume_is_set
)
155 pa_cvolume_reset(&data
->volume
, data
->sample_spec
.channels
);
157 pa_return_null_if_fail(pa_cvolume_valid(&data
->volume
));
158 pa_return_null_if_fail(data
->volume
.channels
== data
->sample_spec
.channels
);
160 if (!data
->muted_is_set
)
164 pa_proplist_update(data
->proplist
, PA_UPDATE_MERGE
, data
->card
->proplist
);
166 if (pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_FIXATE
], data
) < 0) {
168 pa_namereg_unregister(core
, name
);
172 s
->parent
.parent
.free
= source_free
;
173 s
->parent
.process_msg
= pa_source_process_msg
;
176 s
->state
= PA_SOURCE_INIT
;
178 s
->name
= pa_xstrdup(name
);
179 s
->proplist
= pa_proplist_copy(data
->proplist
);
180 s
->driver
= pa_xstrdup(pa_path_get_filename(data
->driver
));
181 s
->module
= data
->module
;
182 s
->card
= data
->card
;
184 s
->sample_spec
= data
->sample_spec
;
185 s
->channel_map
= data
->channel_map
;
187 s
->outputs
= pa_idxset_new(NULL
, NULL
);
189 s
->monitor_of
= NULL
;
191 s
->virtual_volume
= data
->volume
;
192 pa_cvolume_reset(&s
->soft_volume
, s
->sample_spec
.channels
);
193 s
->base_volume
= PA_VOLUME_NORM
;
194 s
->n_volume_steps
= PA_VOLUME_NORM
+1;
195 s
->muted
= data
->muted
;
196 s
->refresh_volume
= s
->refresh_muted
= FALSE
;
204 pa_silence_memchunk_get(
205 &core
->silence_cache
,
211 s
->thread_info
.outputs
= pa_hashmap_new(pa_idxset_trivial_hash_func
, pa_idxset_trivial_compare_func
);
212 s
->thread_info
.soft_volume
= s
->soft_volume
;
213 s
->thread_info
.soft_muted
= s
->muted
;
214 s
->thread_info
.state
= s
->state
;
215 s
->thread_info
.max_rewind
= 0;
216 s
->thread_info
.requested_latency_valid
= FALSE
;
217 s
->thread_info
.requested_latency
= 0;
218 s
->thread_info
.min_latency
= DEFAULT_MIN_LATENCY
;
219 s
->thread_info
.max_latency
= 0;
221 pa_assert_se(pa_idxset_put(core
->sources
, s
, &s
->index
) >= 0);
224 pa_assert_se(pa_idxset_put(s
->card
->sources
, s
, NULL
) >= 0);
226 pt
= pa_proplist_to_string_sep(s
->proplist
, "\n ");
227 pa_log_info("Created source %u \"%s\" with sample spec %s and channel map %s\n %s",
230 pa_sample_spec_snprint(st
, sizeof(st
), &s
->sample_spec
),
231 pa_channel_map_snprint(cm
, sizeof(cm
), &s
->channel_map
),
238 /* Called from main context */
239 static int source_set_state(pa_source
*s
, pa_source_state_t state
) {
241 pa_bool_t suspend_change
;
242 pa_source_state_t original_state
;
246 if (s
->state
== state
)
249 original_state
= s
->state
;
252 (original_state
== PA_SOURCE_SUSPENDED
&& PA_SOURCE_IS_OPENED(state
)) ||
253 (PA_SOURCE_IS_OPENED(original_state
) && state
== PA_SOURCE_SUSPENDED
);
256 if ((ret
= s
->set_state(s
, state
)) < 0)
260 if ((ret
= pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_STATE
, PA_UINT_TO_PTR(state
), 0, NULL
)) < 0) {
263 s
->set_state(s
, original_state
);
270 if (state
!= PA_SOURCE_UNLINKED
) { /* if we enter UNLINKED state pa_source_unlink() will fire the apropriate events */
271 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_STATE_CHANGED
], s
);
272 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
275 if (suspend_change
) {
279 /* We're suspending or resuming, tell everyone about it */
281 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
)))
282 if (s
->state
== PA_SOURCE_SUSPENDED
&&
283 (o
->flags
& PA_SOURCE_OUTPUT_FAIL_ON_SUSPEND
))
284 pa_source_output_kill(o
);
286 o
->suspend(o
, state
== PA_SOURCE_SUSPENDED
);
293 /* Called from main context */
294 void pa_source_put(pa_source
*s
) {
295 pa_source_assert_ref(s
);
297 pa_assert(s
->state
== PA_SOURCE_INIT
);
299 /* The following fields must be initialized properly when calling _put() */
300 pa_assert(s
->asyncmsgq
);
301 pa_assert(s
->rtpoll
);
302 pa_assert(!s
->thread_info
.min_latency
|| !s
->thread_info
.max_latency
||
303 s
->thread_info
.min_latency
<= s
->thread_info
.max_latency
);
305 if (!(s
->flags
& PA_SOURCE_HW_VOLUME_CTRL
)) {
306 s
->flags
|= PA_SOURCE_DECIBEL_VOLUME
;
308 s
->thread_info
.soft_volume
= s
->soft_volume
;
309 s
->thread_info
.soft_muted
= s
->muted
;
312 if (s
->flags
& PA_SOURCE_DECIBEL_VOLUME
)
313 s
->n_volume_steps
= PA_VOLUME_NORM
+1;
315 pa_assert_se(source_set_state(s
, PA_SOURCE_IDLE
) == 0);
317 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_NEW
, s
->index
);
318 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_PUT
], s
);
321 /* Called from main context */
322 void pa_source_unlink(pa_source
*s
) {
324 pa_source_output
*o
, *j
= NULL
;
328 /* See pa_sink_unlink() for a couple of comments how this function
331 linked
= PA_SOURCE_IS_LINKED(s
->state
);
334 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK
], s
);
336 if (s
->state
!= PA_SOURCE_UNLINKED
)
337 pa_namereg_unregister(s
->core
, s
->name
);
338 pa_idxset_remove_by_data(s
->core
->sources
, s
, NULL
);
341 pa_idxset_remove_by_data(s
->card
->sources
, s
, NULL
);
343 while ((o
= pa_idxset_first(s
->outputs
, NULL
))) {
345 pa_source_output_kill(o
);
350 source_set_state(s
, PA_SOURCE_UNLINKED
);
352 s
->state
= PA_SOURCE_UNLINKED
;
357 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_REMOVE
, s
->index
);
358 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK_POST
], s
);
362 /* Called from main context */
363 static void source_free(pa_object
*o
) {
364 pa_source_output
*so
;
365 pa_source
*s
= PA_SOURCE(o
);
368 pa_assert(pa_source_refcnt(s
) == 0);
370 if (PA_SOURCE_IS_LINKED(s
->state
))
373 pa_log_info("Freeing source %u \"%s\"", s
->index
, s
->name
);
375 pa_idxset_free(s
->outputs
, NULL
, NULL
);
377 while ((so
= pa_hashmap_steal_first(s
->thread_info
.outputs
)))
378 pa_source_output_unref(so
);
380 pa_hashmap_free(s
->thread_info
.outputs
, NULL
, NULL
);
382 if (s
->silence
.memblock
)
383 pa_memblock_unref(s
->silence
.memblock
);
389 pa_proplist_free(s
->proplist
);
394 /* Called from main context */
395 void pa_source_set_asyncmsgq(pa_source
*s
, pa_asyncmsgq
*q
) {
396 pa_source_assert_ref(s
);
401 /* Called from main context */
402 void pa_source_set_rtpoll(pa_source
*s
, pa_rtpoll
*p
) {
403 pa_source_assert_ref(s
);
408 /* Called from main context */
409 int pa_source_update_status(pa_source
*s
) {
410 pa_source_assert_ref(s
);
411 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
413 if (s
->state
== PA_SOURCE_SUSPENDED
)
416 return source_set_state(s
, pa_source_used_by(s
) ? PA_SOURCE_RUNNING
: PA_SOURCE_IDLE
);
419 /* Called from main context */
420 int pa_source_suspend(pa_source
*s
, pa_bool_t suspend
) {
421 pa_source_assert_ref(s
);
422 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
425 return source_set_state(s
, PA_SOURCE_SUSPENDED
);
427 return source_set_state(s
, pa_source_used_by(s
) ? PA_SOURCE_RUNNING
: PA_SOURCE_IDLE
);
430 /* Called from main context */
431 pa_queue
*pa_source_move_all_start(pa_source
*s
) {
433 pa_source_output
*o
, *n
;
436 pa_source_assert_ref(s
);
437 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
441 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= n
) {
442 n
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
));
444 if (pa_source_output_start_move(o
) >= 0)
445 pa_queue_push(q
, pa_source_output_ref(o
));
451 /* Called from main context */
452 void pa_source_move_all_finish(pa_source
*s
, pa_queue
*q
, pa_bool_t save
) {
455 pa_source_assert_ref(s
);
456 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
459 while ((o
= PA_SOURCE_OUTPUT(pa_queue_pop(q
)))) {
460 if (pa_source_output_finish_move(o
, s
, save
) < 0)
461 pa_source_output_kill(o
);
463 pa_source_output_unref(o
);
466 pa_queue_free(q
, NULL
, NULL
);
469 /* Called from main context */
470 void pa_source_move_all_fail(pa_queue
*q
) {
474 while ((o
= PA_SOURCE_OUTPUT(pa_queue_pop(q
)))) {
475 if (pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FAIL
], o
) == PA_HOOK_OK
) {
476 pa_source_output_kill(o
);
477 pa_source_output_unref(o
);
481 pa_queue_free(q
, NULL
, NULL
);
484 /* Called from IO thread context */
485 void pa_source_process_rewind(pa_source
*s
, size_t nbytes
) {
489 pa_source_assert_ref(s
);
490 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
492 if (s
->thread_info
.state
== PA_SOURCE_SUSPENDED
)
498 pa_log_debug("Processing rewind...");
500 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
))) {
501 pa_source_output_assert_ref(o
);
502 pa_source_output_process_rewind(o
, nbytes
);
506 /* Called from IO thread context */
507 void pa_source_post(pa_source
*s
, const pa_memchunk
*chunk
) {
511 pa_source_assert_ref(s
);
512 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
515 if (s
->thread_info
.state
== PA_SOURCE_SUSPENDED
)
518 if (s
->thread_info
.soft_muted
|| !pa_cvolume_is_norm(&s
->thread_info
.soft_volume
)) {
519 pa_memchunk vchunk
= *chunk
;
521 pa_memblock_ref(vchunk
.memblock
);
522 pa_memchunk_make_writable(&vchunk
, 0);
524 if (s
->thread_info
.soft_muted
|| pa_cvolume_is_muted(&s
->thread_info
.soft_volume
))
525 pa_silence_memchunk(&vchunk
, &s
->sample_spec
);
527 pa_volume_memchunk(&vchunk
, &s
->sample_spec
, &s
->thread_info
.soft_volume
);
529 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
))) {
530 pa_source_output_assert_ref(o
);
532 if (!o
->thread_info
.direct_on_input
)
533 pa_source_output_push(o
, &vchunk
);
536 pa_memblock_unref(vchunk
.memblock
);
539 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
))) {
540 pa_source_output_assert_ref(o
);
542 if (!o
->thread_info
.direct_on_input
)
543 pa_source_output_push(o
, chunk
);
548 /* Called from IO thread context */
549 void pa_source_post_direct(pa_source
*s
, pa_source_output
*o
, const pa_memchunk
*chunk
) {
550 pa_source_assert_ref(s
);
551 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
552 pa_source_output_assert_ref(o
);
553 pa_assert(o
->thread_info
.direct_on_input
);
556 if (s
->thread_info
.state
== PA_SOURCE_SUSPENDED
)
559 if (s
->thread_info
.soft_muted
|| !pa_cvolume_is_norm(&s
->thread_info
.soft_volume
)) {
560 pa_memchunk vchunk
= *chunk
;
562 pa_memblock_ref(vchunk
.memblock
);
563 pa_memchunk_make_writable(&vchunk
, 0);
565 if (s
->thread_info
.soft_muted
|| pa_cvolume_is_muted(&s
->thread_info
.soft_volume
))
566 pa_silence_memchunk(&vchunk
, &s
->sample_spec
);
568 pa_volume_memchunk(&vchunk
, &s
->sample_spec
, &s
->thread_info
.soft_volume
);
570 pa_source_output_push(o
, &vchunk
);
572 pa_memblock_unref(vchunk
.memblock
);
574 pa_source_output_push(o
, chunk
);
577 /* Called from main thread */
578 pa_usec_t
pa_source_get_latency(pa_source
*s
) {
581 pa_source_assert_ref(s
);
582 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
584 if (s
->state
== PA_SOURCE_SUSPENDED
)
587 if (!(s
->flags
& PA_SOURCE_LATENCY
))
590 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_LATENCY
, &usec
, 0, NULL
) == 0);
595 /* Called from main thread */
596 void pa_source_set_volume(pa_source
*s
, const pa_cvolume
*volume
) {
597 pa_cvolume old_virtual_volume
;
598 pa_bool_t virtual_volume_changed
;
600 pa_source_assert_ref(s
);
601 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
603 pa_assert(pa_cvolume_valid(volume
));
604 pa_assert(pa_cvolume_compatible(volume
, &s
->sample_spec
));
606 old_virtual_volume
= s
->virtual_volume
;
607 s
->virtual_volume
= *volume
;
608 virtual_volume_changed
= !pa_cvolume_equal(&old_virtual_volume
, &s
->virtual_volume
);
611 pa_cvolume_reset(&s
->soft_volume
, s
->sample_spec
.channels
);
614 s
->soft_volume
= s
->virtual_volume
;
616 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_VOLUME
, NULL
, 0, NULL
) == 0);
618 if (virtual_volume_changed
)
619 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
622 /* Called from main thread. Only to be called by source implementor */
623 void pa_source_set_soft_volume(pa_source
*s
, const pa_cvolume
*volume
) {
624 pa_source_assert_ref(s
);
627 if (PA_SOURCE_IS_LINKED(s
->state
))
628 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_VOLUME
, NULL
, 0, NULL
) == 0);
630 s
->thread_info
.soft_volume
= *volume
;
633 /* Called from main thread */
634 const pa_cvolume
*pa_source_get_volume(pa_source
*s
, pa_bool_t force_refresh
) {
635 pa_source_assert_ref(s
);
636 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
638 if (s
->refresh_volume
|| force_refresh
) {
639 pa_cvolume old_virtual_volume
= s
->virtual_volume
;
644 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_VOLUME
, NULL
, 0, NULL
) == 0);
646 if (!pa_cvolume_equal(&old_virtual_volume
, &s
->virtual_volume
))
647 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
650 return &s
->virtual_volume
;
653 /* Called from main thread */
654 void pa_source_set_mute(pa_source
*s
, pa_bool_t mute
) {
657 pa_source_assert_ref(s
);
658 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
660 old_muted
= s
->muted
;
666 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_MUTE
, NULL
, 0, NULL
) == 0);
668 if (old_muted
!= s
->muted
)
669 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
672 /* Called from main thread */
673 pa_bool_t
pa_source_get_mute(pa_source
*s
, pa_bool_t force_refresh
) {
675 pa_source_assert_ref(s
);
676 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
678 if (s
->refresh_muted
|| force_refresh
) {
679 pa_bool_t old_muted
= s
->muted
;
684 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_MUTE
, NULL
, 0, NULL
) == 0);
686 if (old_muted
!= s
->muted
)
687 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
693 /* Called from main thread */
694 pa_bool_t
pa_source_update_proplist(pa_source
*s
, pa_update_mode_t mode
, pa_proplist
*p
) {
695 pa_source_assert_ref(s
);
698 pa_proplist_update(s
->proplist
, mode
, p
);
700 if (PA_SOURCE_IS_LINKED(s
->state
)) {
701 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED
], s
);
702 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
708 /* Called from main thread */
709 void pa_source_set_description(pa_source
*s
, const char *description
) {
711 pa_source_assert_ref(s
);
713 if (!description
&& !pa_proplist_contains(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
))
716 old
= pa_proplist_gets(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
);
718 if (old
&& description
&& !strcmp(old
, description
))
722 pa_proplist_sets(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
, description
);
724 pa_proplist_unset(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
);
726 if (PA_SOURCE_IS_LINKED(s
->state
)) {
727 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
728 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED
], s
);
732 /* Called from main thread */
733 unsigned pa_source_linked_by(pa_source
*s
) {
734 pa_source_assert_ref(s
);
735 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
737 return pa_idxset_size(s
->outputs
);
740 /* Called from main thread */
741 unsigned pa_source_used_by(pa_source
*s
) {
744 pa_source_assert_ref(s
);
745 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
747 ret
= pa_idxset_size(s
->outputs
);
748 pa_assert(ret
>= s
->n_corked
);
750 return ret
- s
->n_corked
;
753 /* Called from main thread */
754 unsigned pa_source_check_suspend(pa_source
*s
) {
759 pa_source_assert_ref(s
);
761 if (!PA_SOURCE_IS_LINKED(s
->state
))
766 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
))) {
767 pa_source_output_state_t st
;
769 st
= pa_source_output_get_state(o
);
770 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(st
));
772 if (st
== PA_SOURCE_OUTPUT_CORKED
)
775 if (o
->flags
& PA_SOURCE_OUTPUT_DONT_INHIBIT_AUTO_SUSPEND
)
784 /* Called from IO thread, except when it is not */
785 int pa_source_process_msg(pa_msgobject
*object
, int code
, void *userdata
, int64_t offset
, pa_memchunk
*chunk
) {
786 pa_source
*s
= PA_SOURCE(object
);
787 pa_source_assert_ref(s
);
789 switch ((pa_source_message_t
) code
) {
791 case PA_SOURCE_MESSAGE_ADD_OUTPUT
: {
792 pa_source_output
*o
= PA_SOURCE_OUTPUT(userdata
);
794 pa_hashmap_put(s
->thread_info
.outputs
, PA_UINT32_TO_PTR(o
->index
), pa_source_output_ref(o
));
796 if (o
->direct_on_input
) {
797 o
->thread_info
.direct_on_input
= o
->direct_on_input
;
798 pa_hashmap_put(o
->thread_info
.direct_on_input
->thread_info
.direct_outputs
, PA_UINT32_TO_PTR(o
->index
), o
);
801 pa_assert(!o
->thread_info
.attached
);
802 o
->thread_info
.attached
= TRUE
;
807 pa_source_output_set_state_within_thread(o
, o
->state
);
809 if (o
->thread_info
.requested_source_latency
!= (pa_usec_t
) -1)
810 pa_source_output_set_requested_latency_within_thread(o
, o
->thread_info
.requested_source_latency
);
812 pa_source_output_update_max_rewind(o
, s
->thread_info
.max_rewind
);
814 /* We don't just invalidate the requested latency here,
815 * because if we are in a move we might need to fix up the
816 * requested latency. */
817 pa_source_output_set_requested_latency_within_thread(o
, o
->thread_info
.requested_source_latency
);
822 case PA_SOURCE_MESSAGE_REMOVE_OUTPUT
: {
823 pa_source_output
*o
= PA_SOURCE_OUTPUT(userdata
);
825 pa_source_output_set_state_within_thread(o
, o
->state
);
830 pa_assert(o
->thread_info
.attached
);
831 o
->thread_info
.attached
= FALSE
;
833 if (o
->thread_info
.direct_on_input
) {
834 pa_hashmap_remove(o
->thread_info
.direct_on_input
->thread_info
.direct_outputs
, PA_UINT32_TO_PTR(o
->index
));
835 o
->thread_info
.direct_on_input
= NULL
;
838 if (pa_hashmap_remove(s
->thread_info
.outputs
, PA_UINT32_TO_PTR(o
->index
)))
839 pa_source_output_unref(o
);
841 pa_source_invalidate_requested_latency(s
);
846 case PA_SOURCE_MESSAGE_SET_VOLUME
:
847 s
->thread_info
.soft_volume
= s
->soft_volume
;
850 case PA_SOURCE_MESSAGE_GET_VOLUME
:
853 case PA_SOURCE_MESSAGE_SET_MUTE
:
854 s
->thread_info
.soft_muted
= s
->muted
;
857 case PA_SOURCE_MESSAGE_GET_MUTE
:
860 case PA_SOURCE_MESSAGE_SET_STATE
:
861 s
->thread_info
.state
= PA_PTR_TO_UINT(userdata
);
864 case PA_SOURCE_MESSAGE_DETACH
:
866 /* Detach all streams */
867 pa_source_detach_within_thread(s
);
870 case PA_SOURCE_MESSAGE_ATTACH
:
872 /* Reattach all streams */
873 pa_source_attach_within_thread(s
);
876 case PA_SOURCE_MESSAGE_GET_REQUESTED_LATENCY
: {
878 pa_usec_t
*usec
= userdata
;
879 *usec
= pa_source_get_requested_latency_within_thread(s
);
881 if (*usec
== (pa_usec_t
) -1)
882 *usec
= s
->thread_info
.max_latency
;
887 case PA_SOURCE_MESSAGE_SET_LATENCY_RANGE
: {
888 pa_usec_t
*r
= userdata
;
890 pa_source_update_latency_range(s
, r
[0], r
[1]);
895 case PA_SOURCE_MESSAGE_GET_LATENCY_RANGE
: {
896 pa_usec_t
*r
= userdata
;
898 r
[0] = s
->thread_info
.min_latency
;
899 r
[1] = s
->thread_info
.max_latency
;
904 case PA_SOURCE_MESSAGE_GET_MAX_REWIND
:
906 *((size_t*) userdata
) = s
->thread_info
.max_rewind
;
909 case PA_SOURCE_MESSAGE_GET_LATENCY
:
912 *((pa_usec_t
*) userdata
) = 0;
916 /* Implementors need to overwrite this implementation! */
919 case PA_SOURCE_MESSAGE_MAX
:
926 /* Called from main thread */
927 int pa_source_suspend_all(pa_core
*c
, pa_bool_t suspend
) {
932 pa_core_assert_ref(c
);
934 for (source
= PA_SOURCE(pa_idxset_first(c
->sources
, &idx
)); source
; source
= PA_SOURCE(pa_idxset_next(c
->sources
, &idx
)))
935 ret
-= pa_source_suspend(source
, suspend
) < 0;
940 /* Called from main thread */
941 void pa_source_detach(pa_source
*s
) {
942 pa_source_assert_ref(s
);
943 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
945 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_DETACH
, NULL
, 0, NULL
) == 0);
948 /* Called from main thread */
949 void pa_source_attach(pa_source
*s
) {
950 pa_source_assert_ref(s
);
951 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
953 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_ATTACH
, NULL
, 0, NULL
) == 0);
956 /* Called from IO thread */
957 void pa_source_detach_within_thread(pa_source
*s
) {
961 pa_source_assert_ref(s
);
962 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
964 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
969 /* Called from IO thread */
970 void pa_source_attach_within_thread(pa_source
*s
) {
974 pa_source_assert_ref(s
);
975 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
977 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
982 /* Called from IO thread */
983 pa_usec_t
pa_source_get_requested_latency_within_thread(pa_source
*s
) {
984 pa_usec_t result
= (pa_usec_t
) -1;
988 pa_source_assert_ref(s
);
990 if (s
->thread_info
.requested_latency_valid
)
991 return s
->thread_info
.requested_latency
;
993 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
995 if (o
->thread_info
.requested_source_latency
!= (pa_usec_t
) -1 &&
996 (result
== (pa_usec_t
) -1 || result
> o
->thread_info
.requested_source_latency
))
997 result
= o
->thread_info
.requested_source_latency
;
999 if (result
!= (pa_usec_t
) -1) {
1000 if (s
->thread_info
.max_latency
> 0 && result
> s
->thread_info
.max_latency
)
1001 result
= s
->thread_info
.max_latency
;
1003 if (s
->thread_info
.min_latency
> 0 && result
< s
->thread_info
.min_latency
)
1004 result
= s
->thread_info
.min_latency
;
1007 s
->thread_info
.requested_latency
= result
;
1008 s
->thread_info
.requested_latency_valid
= TRUE
;
1013 /* Called from main thread */
1014 pa_usec_t
pa_source_get_requested_latency(pa_source
*s
) {
1017 pa_source_assert_ref(s
);
1018 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
1020 if (s
->state
== PA_SOURCE_SUSPENDED
)
1023 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_REQUESTED_LATENCY
, &usec
, 0, NULL
) == 0);
1028 /* Called from IO thread */
1029 void pa_source_set_max_rewind(pa_source
*s
, size_t max_rewind
) {
1030 pa_source_output
*o
;
1033 pa_source_assert_ref(s
);
1035 if (max_rewind
== s
->thread_info
.max_rewind
)
1038 s
->thread_info
.max_rewind
= max_rewind
;
1040 if (PA_SOURCE_IS_LINKED(s
->thread_info
.state
)) {
1041 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
1042 pa_source_output_update_max_rewind(o
, s
->thread_info
.max_rewind
);
1046 void pa_source_invalidate_requested_latency(pa_source
*s
) {
1047 pa_source_output
*o
;
1050 pa_source_assert_ref(s
);
1052 s
->thread_info
.requested_latency_valid
= FALSE
;
1054 if (s
->update_requested_latency
)
1055 s
->update_requested_latency(s
);
1057 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
1058 if (o
->update_source_requested_latency
)
1059 o
->update_source_requested_latency(o
);
1062 pa_sink_invalidate_requested_latency(s
->monitor_of
);
1065 void pa_source_set_latency_range(pa_source
*s
, pa_usec_t min_latency
, pa_usec_t max_latency
) {
1066 pa_source_assert_ref(s
);
1068 /* min_latency == 0: no limit
1069 * min_latency == (size_t) -1: default limit
1070 * min_latency anything else: specified limit
1072 * Similar for max_latency */
1074 if (min_latency
== (pa_usec_t
) -1)
1075 min_latency
= DEFAULT_MIN_LATENCY
;
1077 if (max_latency
== (pa_usec_t
) -1)
1078 max_latency
= min_latency
;
1080 pa_assert(!min_latency
|| !max_latency
||
1081 min_latency
<= max_latency
);
1083 if (PA_SOURCE_IS_LINKED(s
->state
)) {
1089 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_LATENCY_RANGE
, r
, 0, NULL
) == 0);
1091 s
->thread_info
.min_latency
= min_latency
;
1092 s
->thread_info
.max_latency
= max_latency
;
1094 s
->thread_info
.requested_latency_valid
= FALSE
;
1098 void pa_source_get_latency_range(pa_source
*s
, pa_usec_t
*min_latency
, pa_usec_t
*max_latency
) {
1099 pa_source_assert_ref(s
);
1100 pa_assert(min_latency
);
1101 pa_assert(max_latency
);
1103 if (PA_SOURCE_IS_LINKED(s
->state
)) {
1104 pa_usec_t r
[2] = { 0, 0 };
1106 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_LATENCY_RANGE
, r
, 0, NULL
) == 0);
1108 *min_latency
= r
[0];
1109 *max_latency
= r
[1];
1111 *min_latency
= s
->thread_info
.min_latency
;
1112 *max_latency
= s
->thread_info
.max_latency
;
1116 /* Called from IO thread */
1117 void pa_source_update_latency_range(pa_source
*s
, pa_usec_t min_latency
, pa_usec_t max_latency
) {
1118 pa_source_output
*o
;
1121 pa_source_assert_ref(s
);
1123 s
->thread_info
.min_latency
= min_latency
;
1124 s
->thread_info
.max_latency
= max_latency
;
1126 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
1127 if (o
->update_source_latency_range
)
1128 o
->update_source_latency_range(o
);
1130 pa_source_invalidate_requested_latency(s
);
1133 size_t pa_source_get_max_rewind(pa_source
*s
) {
1135 pa_source_assert_ref(s
);
1137 if (!PA_SOURCE_IS_LINKED(s
->state
))
1138 return s
->thread_info
.max_rewind
;
1140 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_MAX_REWIND
, &r
, 0, NULL
) == 0);