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
32 #include <pulse/utf8.h>
33 #include <pulse/xmalloc.h>
35 #include <pulsecore/sample-util.h>
36 #include <pulsecore/core-subscribe.h>
37 #include <pulsecore/log.h>
38 #include <pulsecore/namereg.h>
40 #include "source-output.h"
42 static PA_DEFINE_CHECK_TYPE(pa_source_output
, pa_msgobject
);
44 static void source_output_free(pa_object
* mo
);
46 pa_source_output_new_data
* pa_source_output_new_data_init(pa_source_output_new_data
*data
) {
49 memset(data
, 0, sizeof(*data
));
50 data
->resample_method
= PA_RESAMPLER_INVALID
;
51 data
->proplist
= pa_proplist_new();
56 void pa_source_output_new_data_set_sample_spec(pa_source_output_new_data
*data
, const pa_sample_spec
*spec
) {
59 if ((data
->sample_spec_is_set
= !!spec
))
60 data
->sample_spec
= *spec
;
63 void pa_source_output_new_data_set_channel_map(pa_source_output_new_data
*data
, const pa_channel_map
*map
) {
66 if ((data
->channel_map_is_set
= !!map
))
67 data
->channel_map
= *map
;
70 void pa_source_output_new_data_done(pa_source_output_new_data
*data
) {
73 pa_proplist_free(data
->proplist
);
76 pa_source_output
* pa_source_output_new(
78 pa_source_output_new_data
*data
,
79 pa_source_output_flags_t flags
) {
82 pa_resampler
*resampler
= NULL
;
83 char st
[PA_SAMPLE_SPEC_SNPRINT_MAX
], cm
[PA_CHANNEL_MAP_SNPRINT_MAX
];
88 if (pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_NEW
], data
) < 0)
91 pa_return_null_if_fail(!data
->driver
|| pa_utf8_valid(data
->driver
));
94 data
->source
= pa_namereg_get(core
, NULL
, PA_NAMEREG_SOURCE
, 1);
96 pa_return_null_if_fail(data
->source
);
97 pa_return_null_if_fail(pa_source_get_state(data
->source
) != PA_SOURCE_UNLINKED
);
99 if (!data
->sample_spec_is_set
)
100 data
->sample_spec
= data
->source
->sample_spec
;
102 pa_return_null_if_fail(pa_sample_spec_valid(&data
->sample_spec
));
104 if (!data
->channel_map_is_set
) {
105 if (data
->source
->channel_map
.channels
== data
->sample_spec
.channels
)
106 data
->channel_map
= data
->source
->channel_map
;
108 pa_return_null_if_fail(pa_channel_map_init_auto(&data
->channel_map
, data
->sample_spec
.channels
, PA_CHANNEL_MAP_DEFAULT
));
111 pa_return_null_if_fail(pa_channel_map_valid(&data
->channel_map
));
112 pa_return_null_if_fail(data
->channel_map
.channels
== data
->sample_spec
.channels
);
114 if (flags
& PA_SOURCE_OUTPUT_FIX_FORMAT
)
115 data
->sample_spec
.format
= data
->source
->sample_spec
.format
;
117 if (flags
& PA_SOURCE_OUTPUT_FIX_RATE
)
118 data
->sample_spec
.rate
= data
->source
->sample_spec
.rate
;
120 if (flags
& PA_SOURCE_OUTPUT_FIX_CHANNELS
) {
121 data
->sample_spec
.channels
= data
->source
->sample_spec
.channels
;
122 data
->channel_map
= data
->source
->channel_map
;
125 pa_assert(pa_sample_spec_valid(&data
->sample_spec
));
126 pa_assert(pa_channel_map_valid(&data
->channel_map
));
128 if (data
->resample_method
== PA_RESAMPLER_INVALID
)
129 data
->resample_method
= core
->resample_method
;
131 pa_return_null_if_fail(data
->resample_method
< PA_RESAMPLER_MAX
);
133 if (pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_FIXATE
], data
) < 0)
136 if (pa_idxset_size(data
->source
->outputs
) >= PA_MAX_OUTPUTS_PER_SOURCE
) {
137 pa_log("Failed to create source output: too many outputs per source.");
141 if ((flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ||
142 !pa_sample_spec_equal(&data
->sample_spec
, &data
->source
->sample_spec
) ||
143 !pa_channel_map_equal(&data
->channel_map
, &data
->source
->channel_map
)) {
145 if (!(resampler
= pa_resampler_new(
147 &data
->source
->sample_spec
, &data
->source
->channel_map
,
148 &data
->sample_spec
, &data
->channel_map
,
149 data
->resample_method
,
150 ((flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ? PA_RESAMPLER_VARIABLE_RATE
: 0) |
151 ((flags
& PA_SOURCE_OUTPUT_NO_REMAP
) ? PA_RESAMPLER_NO_REMAP
: 0) |
152 (core
->disable_remixing
|| (flags
& PA_SOURCE_OUTPUT_NO_REMIX
) ? PA_RESAMPLER_NO_REMIX
: 0)))) {
153 pa_log_warn("Unsupported resampling operation.");
157 data
->resample_method
= pa_resampler_get_method(resampler
);
160 o
= pa_msgobject_new(pa_source_output
);
161 o
->parent
.parent
.free
= source_output_free
;
162 o
->parent
.process_msg
= pa_source_output_process_msg
;
165 o
->state
= PA_SOURCE_OUTPUT_INIT
;
167 o
->proplist
= pa_proplist_copy(data
->proplist
);
168 o
->driver
= pa_xstrdup(data
->driver
);
169 o
->module
= data
->module
;
170 o
->source
= data
->source
;
171 o
->client
= data
->client
;
173 o
->resample_method
= data
->resample_method
;
174 o
->sample_spec
= data
->sample_spec
;
175 o
->channel_map
= data
->channel_map
;
179 o
->get_latency
= NULL
;
186 o
->thread_info
.state
= o
->state
;
187 o
->thread_info
.attached
= FALSE
;
188 o
->thread_info
.sample_spec
= o
->sample_spec
;
189 o
->thread_info
.resampler
= resampler
;
190 o
->thread_info
.requested_source_latency
= 0;
192 pa_assert_se(pa_idxset_put(core
->source_outputs
, o
, &o
->index
) == 0);
193 pa_assert_se(pa_idxset_put(o
->source
->outputs
, pa_source_output_ref(o
), NULL
) == 0);
195 pa_log_info("Created output %u \"%s\" on %s with sample spec %s and channel map %s",
197 pa_strnull(pa_proplist_gets(o
->proplist
, PA_PROP_MEDIA_NAME
)),
199 pa_sample_spec_snprint(st
, sizeof(st
), &o
->sample_spec
),
200 pa_channel_map_snprint(cm
, sizeof(cm
), &o
->channel_map
));
202 /* Don't forget to call pa_source_output_put! */
207 static int source_output_set_state(pa_source_output
*o
, pa_source_output_state_t state
) {
210 if (o
->state
== state
)
213 if (pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_STATE
, PA_UINT_TO_PTR(state
), 0, NULL
) < 0)
216 if (o
->state
== PA_SOURCE_OUTPUT_CORKED
&& state
!= PA_SOURCE_OUTPUT_CORKED
)
217 pa_assert_se(o
->source
->n_corked
-- >= 1);
218 else if (o
->state
!= PA_SOURCE_OUTPUT_CORKED
&& state
== PA_SOURCE_OUTPUT_CORKED
)
219 o
->source
->n_corked
++;
221 pa_source_update_status(o
->source
);
224 if (state
!= PA_SOURCE_OUTPUT_UNLINKED
)
225 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_STATE_CHANGED
], o
);
230 void pa_source_output_unlink(pa_source_output
*o
) {
234 /* See pa_sink_unlink() for a couple of comments how this function
237 pa_source_output_ref(o
);
239 linked
= PA_SOURCE_OUTPUT_LINKED(o
->state
);
242 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK
], o
);
244 pa_idxset_remove_by_data(o
->source
->core
->source_outputs
, o
, NULL
);
245 if (pa_idxset_remove_by_data(o
->source
->outputs
, o
, NULL
))
246 pa_source_output_unref(o
);
249 pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_REMOVE_OUTPUT
, o
, 0, NULL
);
250 source_output_set_state(o
, PA_SOURCE_OUTPUT_UNLINKED
);
251 pa_source_update_status(o
->source
);
253 o
->state
= PA_SOURCE_OUTPUT_UNLINKED
;
257 o
->get_latency
= NULL
;
264 pa_subscription_post(o
->source
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_REMOVE
, o
->index
);
265 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK_POST
], o
);
269 pa_source_output_unref(o
);
272 static void source_output_free(pa_object
* mo
) {
273 pa_source_output
*o
= PA_SOURCE_OUTPUT(mo
);
275 pa_assert(pa_source_output_refcnt(o
) == 0);
277 if (PA_SOURCE_OUTPUT_LINKED(o
->state
))
278 pa_source_output_unlink(o
);
280 pa_log_info("Freeing output %u \"%s\"", o
->index
, pa_strnull(pa_proplist_gets(o
->proplist
, PA_PROP_MEDIA_NAME
)));
282 pa_assert(!o
->thread_info
.attached
);
284 if (o
->thread_info
.resampler
)
285 pa_resampler_free(o
->thread_info
.resampler
);
288 pa_proplist_free(o
->proplist
);
294 void pa_source_output_put(pa_source_output
*o
) {
295 pa_source_output_assert_ref(o
);
297 pa_assert(o
->state
== PA_SOURCE_OUTPUT_INIT
);
300 o
->thread_info
.state
= o
->state
= o
->flags
& PA_SOURCE_OUTPUT_START_CORKED
? PA_SOURCE_OUTPUT_CORKED
: PA_SOURCE_OUTPUT_RUNNING
;
302 if (o
->state
== PA_SOURCE_OUTPUT_CORKED
)
303 o
->source
->n_corked
++;
305 pa_source_update_status(o
->source
);
306 pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_ADD_OUTPUT
, o
, 0, NULL
);
308 pa_subscription_post(o
->source
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_NEW
, o
->index
);
309 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_PUT
], o
);
312 void pa_source_output_kill(pa_source_output
*o
) {
313 pa_source_output_assert_ref(o
);
314 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->state
));
320 pa_usec_t
pa_source_output_get_latency(pa_source_output
*o
) {
323 pa_source_output_assert_ref(o
);
324 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->state
));
326 if (pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_GET_LATENCY
, &r
, 0, NULL
) < 0)
330 r
+= o
->get_latency(o
);
335 /* Called from thread context */
336 void pa_source_output_push(pa_source_output
*o
, const pa_memchunk
*chunk
) {
339 pa_source_output_assert_ref(o
);
340 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->thread_info
.state
));
342 pa_assert(pa_frame_aligned(chunk
->length
, &o
->source
->sample_spec
));
344 if (!o
->push
|| o
->state
== PA_SOURCE_OUTPUT_CORKED
)
347 pa_assert(o
->state
== PA_SOURCE_OUTPUT_RUNNING
);
349 if (!o
->thread_info
.resampler
) {
354 pa_resampler_run(o
->thread_info
.resampler
, chunk
, &rchunk
);
358 pa_assert(rchunk
.memblock
);
360 pa_memblock_unref(rchunk
.memblock
);
363 void pa_source_output_set_requested_latency(pa_source_output
*o
, pa_usec_t usec
) {
364 pa_source_output_assert_ref(o
);
365 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->state
));
367 pa_asyncmsgq_post(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_REQUESTED_LATENCY
, NULL
, (int64_t) usec
, NULL
, NULL
);
371 void pa_source_output_cork(pa_source_output
*o
, pa_bool_t b
) {
372 pa_source_output_assert_ref(o
);
373 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->state
));
375 source_output_set_state(o
, b
? PA_SOURCE_OUTPUT_CORKED
: PA_SOURCE_OUTPUT_RUNNING
);
378 int pa_source_output_set_rate(pa_source_output
*o
, uint32_t rate
) {
379 pa_source_output_assert_ref(o
);
380 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->state
));
381 pa_return_val_if_fail(o
->thread_info
.resampler
, -1);
383 if (o
->sample_spec
.rate
== rate
)
386 o
->sample_spec
.rate
= rate
;
388 pa_asyncmsgq_post(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_RATE
, PA_UINT_TO_PTR(rate
), 0, NULL
, NULL
);
390 pa_subscription_post(o
->source
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
394 void pa_source_output_set_name(pa_source_output
*o
, const char *name
) {
396 pa_source_output_assert_ref(o
);
398 old
= pa_proplist_gets(o
->proplist
, PA_PROP_MEDIA_NAME
);
403 if (old
&& name
&& !strcmp(old
, name
))
407 pa_proplist_sets(o
->proplist
, PA_PROP_MEDIA_NAME
, name
);
409 pa_proplist_unset(o
->proplist
, PA_PROP_MEDIA_NAME
);
411 if (PA_SOURCE_OUTPUT_LINKED(o
->state
)) {
412 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED
], o
);
413 pa_subscription_post(o
->source
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
417 pa_resample_method_t
pa_source_output_get_resample_method(pa_source_output
*o
) {
418 pa_source_output_assert_ref(o
);
420 return o
->resample_method
;
423 int pa_source_output_move_to(pa_source_output
*o
, pa_source
*dest
) {
425 pa_resampler
*new_resampler
= NULL
;
426 pa_source_output_move_hook_data hook_data
;
428 pa_source_output_assert_ref(o
);
429 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->state
));
430 pa_source_assert_ref(dest
);
437 if (o
->flags
& PA_SOURCE_OUTPUT_DONT_MOVE
)
440 if (pa_idxset_size(dest
->outputs
) >= PA_MAX_OUTPUTS_PER_SOURCE
) {
441 pa_log_warn("Failed to move source output: too many outputs per source.");
445 if (o
->thread_info
.resampler
&&
446 pa_sample_spec_equal(&origin
->sample_spec
, &dest
->sample_spec
) &&
447 pa_channel_map_equal(&origin
->channel_map
, &dest
->channel_map
))
449 /* Try to reuse the old resampler if possible */
450 new_resampler
= o
->thread_info
.resampler
;
452 else if ((o
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ||
453 !pa_sample_spec_equal(&o
->sample_spec
, &dest
->sample_spec
) ||
454 !pa_channel_map_equal(&o
->channel_map
, &dest
->channel_map
)) {
456 /* Okey, we need a new resampler for the new source */
458 if (!(new_resampler
= pa_resampler_new(
460 &dest
->sample_spec
, &dest
->channel_map
,
461 &o
->sample_spec
, &o
->channel_map
,
463 ((o
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ? PA_RESAMPLER_VARIABLE_RATE
: 0) |
464 ((o
->flags
& PA_SOURCE_OUTPUT_NO_REMAP
) ? PA_RESAMPLER_NO_REMAP
: 0) |
465 (o
->core
->disable_remixing
|| (o
->flags
& PA_SOURCE_OUTPUT_NO_REMIX
) ? PA_RESAMPLER_NO_REMIX
: 0)))) {
466 pa_log_warn("Unsupported resampling operation.");
471 hook_data
.source_output
= o
;
472 hook_data
.destination
= dest
;
473 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE
], &hook_data
);
475 /* Okey, let's move it */
476 pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_REMOVE_OUTPUT
, o
, 0, NULL
);
478 pa_idxset_remove_by_data(origin
->outputs
, o
, NULL
);
479 pa_idxset_put(dest
->outputs
, o
, NULL
);
482 if (pa_source_output_get_state(o
) == PA_SOURCE_OUTPUT_CORKED
) {
483 pa_assert_se(origin
->n_corked
-- >= 1);
487 /* Replace resampler */
488 if (new_resampler
!= o
->thread_info
.resampler
) {
489 if (o
->thread_info
.resampler
)
490 pa_resampler_free(o
->thread_info
.resampler
);
491 o
->thread_info
.resampler
= new_resampler
;
494 pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_ADD_OUTPUT
, o
, 0, NULL
);
496 pa_source_update_status(origin
);
497 pa_source_update_status(dest
);
502 pa_hook_fire(&o
->source
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_POST
], o
);
504 pa_log_debug("Successfully moved source output %i from %s to %s.", o
->index
, origin
->name
, dest
->name
);
506 /* Notify everyone */
507 pa_subscription_post(o
->source
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
512 /* Called from thread context */
513 int pa_source_output_process_msg(pa_msgobject
*mo
, int code
, void *userdata
, int64_t offset
, pa_memchunk
* chunk
) {
514 pa_source_output
*o
= PA_SOURCE_OUTPUT(mo
);
516 pa_source_output_assert_ref(o
);
517 pa_assert(PA_SOURCE_OUTPUT_LINKED(o
->thread_info
.state
));
521 case PA_SOURCE_OUTPUT_MESSAGE_SET_RATE
: {
523 o
->thread_info
.sample_spec
.rate
= PA_PTR_TO_UINT(userdata
);
524 pa_resampler_set_output_rate(o
->thread_info
.resampler
, PA_PTR_TO_UINT(userdata
));
529 case PA_SOURCE_OUTPUT_MESSAGE_SET_STATE
: {
530 o
->thread_info
.state
= PA_PTR_TO_UINT(userdata
);
535 case PA_SOURCE_OUTPUT_MESSAGE_SET_REQUESTED_LATENCY
:
537 o
->thread_info
.requested_source_latency
= (pa_usec_t
) offset
;
538 pa_source_invalidate_requested_latency(o
->source
);