4 This file is part of PulseAudio.
6 Copyright 2004-2006 Lennart Poettering
7 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
9 PulseAudio is free software; you can redistribute it and/or modify
10 it under the terms of the GNU Lesser General Public License as published
11 by the Free Software Foundation; either version 2 of the License,
12 or (at your option) any later version.
14 PulseAudio is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with PulseAudio; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
33 #include <pulse/utf8.h>
34 #include <pulse/xmalloc.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 static PA_DEFINE_CHECK_TYPE(pa_source
, pa_msgobject
);
46 static void source_free(pa_object
*o
);
48 pa_source
* pa_source_new(
53 const pa_sample_spec
*spec
,
54 const pa_channel_map
*map
) {
64 pa_return_null_if_fail(pa_sample_spec_valid(spec
));
67 map
= pa_channel_map_init_auto(&tmap
, spec
->channels
, PA_CHANNEL_MAP_DEFAULT
);
69 pa_return_null_if_fail(map
&& pa_channel_map_valid(map
));
70 pa_return_null_if_fail(map
->channels
== spec
->channels
);
71 pa_return_null_if_fail(!driver
|| pa_utf8_valid(driver
));
72 pa_return_null_if_fail(pa_utf8_valid(name
) && *name
);
74 s
= pa_msgobject_new(pa_source
);
76 if (!(name
= pa_namereg_register(core
, name
, PA_NAMEREG_SOURCE
, s
, fail
))) {
81 s
->parent
.parent
.free
= source_free
;
82 s
->parent
.process_msg
= pa_source_process_msg
;
85 s
->state
= PA_SOURCE_INIT
;
87 s
->name
= pa_xstrdup(name
);
88 s
->description
= NULL
;
89 s
->driver
= pa_xstrdup(driver
);
92 s
->sample_spec
= *spec
;
93 s
->channel_map
= *map
;
95 s
->outputs
= pa_idxset_new(NULL
, NULL
);
99 pa_cvolume_reset(&s
->volume
, spec
->channels
);
101 s
->refresh_volume
= s
->refresh_muted
= FALSE
;
103 s
->get_latency
= NULL
;
104 s
->set_volume
= NULL
;
105 s
->get_volume
= NULL
;
114 pa_assert_se(pa_idxset_put(core
->sources
, s
, &s
->index
) >= 0);
116 pa_sample_spec_snprint(st
, sizeof(st
), spec
);
117 pa_log_info("Created source %u \"%s\" with sample spec \"%s\"", s
->index
, s
->name
, st
);
119 s
->thread_info
.outputs
= pa_hashmap_new(pa_idxset_trivial_hash_func
, pa_idxset_trivial_compare_func
);
120 s
->thread_info
.soft_volume
= s
->volume
;
121 s
->thread_info
.soft_muted
= s
->muted
;
122 s
->thread_info
.state
= s
->state
;
127 void pa_source_put(pa_source
*s
) {
128 pa_source_assert_ref(s
);
130 pa_assert(s
->state
== PA_SINK_INIT
);
131 pa_assert(s
->rtpoll
);
132 pa_assert(s
->asyncmsgq
);
134 s
->thread_info
.state
= s
->state
= PA_SOURCE_IDLE
;
136 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_NEW
, s
->index
);
137 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_NEW_POST
], s
);
140 static int source_set_state(pa_source
*s
, pa_source_state_t state
) {
145 if (s
->state
== state
)
148 if (state
== PA_SOURCE_SUSPENDED
&& !(s
->flags
& PA_SOURCE_CAN_SUSPEND
))
151 if ((s
->state
== PA_SOURCE_SUSPENDED
&& PA_SOURCE_OPENED(state
)) ||
152 (PA_SOURCE_OPENED(s
->state
) && state
== PA_SOURCE_SUSPENDED
)) {
156 /* We're suspending or resuming, tell everyone about it */
158 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
)))
160 o
->suspend(o
, state
== PA_SINK_SUSPENDED
);
164 if ((ret
= s
->set_state(s
, state
)) < 0)
167 if (pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_STATE
, PA_UINT_TO_PTR(state
), 0, NULL
) < 0)
172 if (state
!= PA_SOURCE_UNLINKED
) /* if we enter UNLINKED state pa_source_unlink() will fire the apropriate events */
173 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_STATE_CHANGED
], s
);
177 void pa_source_unlink(pa_source
*s
) {
179 pa_source_output
*o
, *j
= NULL
;
183 /* See pa_sink_unlink() for a couple of comments how this function
186 linked
= PA_SOURCE_LINKED(s
->state
);
189 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK
], s
);
191 if (s
->state
!= PA_SOURCE_UNLINKED
)
192 pa_namereg_unregister(s
->core
, s
->name
);
193 pa_idxset_remove_by_data(s
->core
->sources
, s
, NULL
);
195 while ((o
= pa_idxset_first(s
->outputs
, NULL
))) {
197 pa_source_output_kill(o
);
202 source_set_state(s
, PA_SOURCE_UNLINKED
);
204 s
->state
= PA_SOURCE_UNLINKED
;
206 s
->get_latency
= NULL
;
207 s
->get_volume
= NULL
;
208 s
->set_volume
= NULL
;
214 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_REMOVE
, s
->index
);
215 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK_POST
], s
);
219 static void source_free(pa_object
*o
) {
220 pa_source_output
*so
;
221 pa_source
*s
= PA_SOURCE(o
);
224 pa_assert(pa_source_refcnt(s
) == 0);
226 if (PA_SOURCE_LINKED(s
->state
))
229 pa_log_info("Freeing source %u \"%s\"", s
->index
, s
->name
);
231 pa_idxset_free(s
->outputs
, NULL
, NULL
);
233 while ((so
= pa_hashmap_steal_first(s
->thread_info
.outputs
)))
234 pa_source_output_unref(so
);
236 pa_hashmap_free(s
->thread_info
.outputs
, NULL
, NULL
);
239 pa_xfree(s
->description
);
244 int pa_source_update_status(pa_source
*s
) {
245 pa_source_assert_ref(s
);
246 pa_assert(PA_SOURCE_LINKED(s
->state
));
248 if (s
->state
== PA_SOURCE_SUSPENDED
)
251 return source_set_state(s
, pa_source_used_by(s
) ? PA_SOURCE_RUNNING
: PA_SOURCE_IDLE
);
254 int pa_source_suspend(pa_source
*s
, pa_bool_t suspend
) {
255 pa_source_assert_ref(s
);
256 pa_assert(PA_SOURCE_LINKED(s
->state
));
259 return source_set_state(s
, PA_SOURCE_SUSPENDED
);
261 return source_set_state(s
, pa_source_used_by(s
) ? PA_SOURCE_RUNNING
: PA_SOURCE_IDLE
);
264 void pa_source_ping(pa_source
*s
) {
265 pa_source_assert_ref(s
);
266 pa_assert(PA_SOURCE_LINKED(s
->state
));
268 pa_asyncmsgq_post(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_PING
, NULL
, 0, NULL
, NULL
);
271 void pa_source_post(pa_source
*s
, const pa_memchunk
*chunk
) {
275 pa_source_assert_ref(s
);
276 pa_assert(PA_SOURCE_OPENED(s
->thread_info
.state
));
279 if (s
->thread_info
.state
!= PA_SOURCE_RUNNING
)
282 if (s
->thread_info
.soft_muted
|| !pa_cvolume_is_norm(&s
->thread_info
.soft_volume
)) {
283 pa_memchunk vchunk
= *chunk
;
285 pa_memblock_ref(vchunk
.memblock
);
286 pa_memchunk_make_writable(&vchunk
, 0);
288 if (s
->thread_info
.soft_muted
|| pa_cvolume_is_muted(&s
->thread_info
.soft_volume
))
289 pa_silence_memchunk(&vchunk
, &s
->sample_spec
);
291 pa_volume_memchunk(&vchunk
, &s
->sample_spec
, &s
->thread_info
.soft_volume
);
293 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
294 pa_source_output_push(o
, &vchunk
);
296 pa_memblock_unref(vchunk
.memblock
);
299 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
300 pa_source_output_push(o
, chunk
);
304 pa_usec_t
pa_source_get_latency(pa_source
*s
) {
307 pa_source_assert_ref(s
);
308 pa_assert(PA_SOURCE_LINKED(s
->state
));
310 if (!PA_SOURCE_OPENED(s
->state
))
314 return s
->get_latency(s
);
316 if (pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_LATENCY
, &usec
, 0, NULL
) < 0)
322 void pa_source_set_volume(pa_source
*s
, const pa_cvolume
*volume
) {
325 pa_source_assert_ref(s
);
326 pa_assert(PA_SOURCE_LINKED(s
->state
));
329 changed
= !pa_cvolume_equal(volume
, &s
->volume
);
332 if (s
->set_volume
&& s
->set_volume(s
) < 0)
333 s
->set_volume
= NULL
;
336 pa_asyncmsgq_post(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_VOLUME
, pa_xnewdup(struct pa_cvolume
, volume
, 1), 0, NULL
, pa_xfree
);
339 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
342 const pa_cvolume
*pa_source_get_volume(pa_source
*s
) {
343 pa_cvolume old_volume
;
345 pa_source_assert_ref(s
);
346 pa_assert(PA_SOURCE_LINKED(s
->state
));
348 old_volume
= s
->volume
;
350 if (s
->get_volume
&& s
->get_volume(s
) < 0)
351 s
->get_volume
= NULL
;
353 if (!s
->get_volume
&& s
->refresh_volume
)
354 pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_VOLUME
, &s
->volume
, 0, NULL
);
356 if (!pa_cvolume_equal(&old_volume
, &s
->volume
))
357 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
362 void pa_source_set_mute(pa_source
*s
, pa_bool_t mute
) {
365 pa_source_assert_ref(s
);
366 pa_assert(PA_SOURCE_LINKED(s
->state
));
368 changed
= s
->muted
!= mute
;
371 if (s
->set_mute
&& s
->set_mute(s
) < 0)
375 pa_asyncmsgq_post(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_MUTE
, PA_UINT_TO_PTR(mute
), 0, NULL
, NULL
);
378 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
381 pa_bool_t
pa_source_get_mute(pa_source
*s
) {
384 pa_source_assert_ref(s
);
385 pa_assert(PA_SOURCE_LINKED(s
->state
));
387 old_muted
= s
->muted
;
389 if (s
->get_mute
&& s
->get_mute(s
) < 0)
392 if (!s
->get_mute
&& s
->refresh_muted
)
393 pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_MUTE
, &s
->muted
, 0, NULL
);
395 if (old_muted
!= s
->muted
)
396 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
401 void pa_source_set_module(pa_source
*s
, pa_module
*m
) {
402 pa_source_assert_ref(s
);
409 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
412 void pa_source_set_description(pa_source
*s
, const char *description
) {
413 pa_source_assert_ref(s
);
415 if (!description
&& !s
->description
)
418 if (description
&& s
->description
&& !strcmp(description
, s
->description
))
421 pa_xfree(s
->description
);
422 s
->description
= pa_xstrdup(description
);
424 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
427 void pa_source_set_asyncmsgq(pa_source
*s
, pa_asyncmsgq
*q
) {
428 pa_source_assert_ref(s
);
434 void pa_source_set_rtpoll(pa_source
*s
, pa_rtpoll
*p
) {
435 pa_source_assert_ref(s
);
441 unsigned pa_source_linked_by(pa_source
*s
) {
442 pa_source_assert_ref(s
);
443 pa_assert(PA_SOURCE_LINKED(s
->state
));
445 return pa_idxset_size(s
->outputs
);
448 unsigned pa_source_used_by(pa_source
*s
) {
451 pa_source_assert_ref(s
);
452 pa_assert(PA_SOURCE_LINKED(s
->state
));
454 ret
= pa_idxset_size(s
->outputs
);
455 pa_assert(ret
>= s
->n_corked
);
457 return ret
- s
->n_corked
;
460 int pa_source_process_msg(pa_msgobject
*object
, int code
, void *userdata
, int64_t offset
, pa_memchunk
*chunk
) {
461 pa_source
*s
= PA_SOURCE(object
);
462 pa_source_assert_ref(s
);
463 pa_assert(PA_SOURCE_LINKED(s
->thread_info
.state
));
465 switch ((pa_source_message_t
) code
) {
466 case PA_SOURCE_MESSAGE_ADD_OUTPUT
: {
467 pa_source_output
*o
= PA_SOURCE_OUTPUT(userdata
);
468 pa_hashmap_put(s
->thread_info
.outputs
, PA_UINT32_TO_PTR(o
->index
), pa_source_output_ref(o
));
470 pa_assert(!o
->thread_info
.attached
);
471 o
->thread_info
.attached
= TRUE
;
479 case PA_SOURCE_MESSAGE_REMOVE_OUTPUT
: {
480 pa_source_output
*o
= PA_SOURCE_OUTPUT(userdata
);
485 pa_assert(o
->thread_info
.attached
);
486 o
->thread_info
.attached
= FALSE
;
488 if (pa_hashmap_remove(s
->thread_info
.outputs
, PA_UINT32_TO_PTR(o
->index
)))
489 pa_source_output_unref(o
);
494 case PA_SOURCE_MESSAGE_SET_VOLUME
:
495 s
->thread_info
.soft_volume
= *((pa_cvolume
*) userdata
);
498 case PA_SOURCE_MESSAGE_SET_MUTE
:
499 s
->thread_info
.soft_muted
= PA_PTR_TO_UINT(userdata
);
502 case PA_SOURCE_MESSAGE_GET_VOLUME
:
503 *((pa_cvolume
*) userdata
) = s
->thread_info
.soft_volume
;
506 case PA_SOURCE_MESSAGE_GET_MUTE
:
507 *((pa_bool_t
*) userdata
) = s
->thread_info
.soft_muted
;
510 case PA_SOURCE_MESSAGE_PING
:
513 case PA_SOURCE_MESSAGE_SET_STATE
:
514 s
->thread_info
.state
= PA_PTR_TO_UINT(userdata
);
517 case PA_SOURCE_MESSAGE_DETACH
:
519 /* We're detaching all our output streams so that the
520 * asyncmsgq and rtpoll fields can be changed without
522 pa_source_detach_within_thread(s
);
525 case PA_SOURCE_MESSAGE_ATTACH
:
527 /* Reattach all streams */
528 pa_source_attach_within_thread(s
);
531 case PA_SOURCE_MESSAGE_GET_LATENCY
:
532 case PA_SOURCE_MESSAGE_MAX
:
539 int pa_source_suspend_all(pa_core
*c
, pa_bool_t suspend
) {
544 pa_core_assert_ref(c
);
546 for (source
= PA_SOURCE(pa_idxset_first(c
->sources
, &idx
)); source
; source
= PA_SOURCE(pa_idxset_next(c
->sources
, &idx
)))
547 ret
-= pa_source_suspend(source
, suspend
) < 0;
552 void pa_source_detach(pa_source
*s
) {
553 pa_source_assert_ref(s
);
554 pa_assert(PA_SOURCE_LINKED(s
->state
));
556 pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_DETACH
, NULL
, 0, NULL
);
559 void pa_source_attach(pa_source
*s
) {
560 pa_source_assert_ref(s
);
561 pa_assert(PA_SOURCE_LINKED(s
->state
));
563 pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_ATTACH
, NULL
, 0, NULL
);
566 void pa_source_detach_within_thread(pa_source
*s
) {
570 pa_source_assert_ref(s
);
571 pa_assert(PA_SOURCE_LINKED(s
->thread_info
.state
));
573 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
578 void pa_source_attach_within_thread(pa_source
*s
) {
582 pa_source_assert_ref(s
);
583 pa_assert(PA_SOURCE_LINKED(s
->thread_info
.state
));
585 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))