2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
6 PulseAudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published
8 by the Free Software Foundation; either version 2.1 of the License,
9 or (at your option) any later version.
11 PulseAudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with PulseAudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
30 #include <pulse/utf8.h>
31 #include <pulse/xmalloc.h>
32 #include <pulse/util.h>
33 #include <pulse/internal.h>
35 #include <pulsecore/sample-util.h>
36 #include <pulsecore/core-subscribe.h>
37 #include <pulsecore/log.h>
38 #include <pulsecore/namereg.h>
39 #include <pulsecore/core-util.h>
41 #include "source-output.h"
43 #define MEMBLOCKQ_MAXLENGTH (32*1024*1024)
45 PA_DEFINE_PUBLIC_CLASS(pa_source_output
, pa_msgobject
);
47 static void source_output_free(pa_object
* mo
);
48 static void set_real_ratio(pa_source_output
*o
, const pa_cvolume
*v
);
50 pa_source_output_new_data
* pa_source_output_new_data_init(pa_source_output_new_data
*data
) {
54 data
->resample_method
= PA_RESAMPLER_INVALID
;
55 data
->proplist
= pa_proplist_new();
56 data
->volume_writable
= TRUE
;
61 void pa_source_output_new_data_set_sample_spec(pa_source_output_new_data
*data
, const pa_sample_spec
*spec
) {
64 if ((data
->sample_spec_is_set
= !!spec
))
65 data
->sample_spec
= *spec
;
68 void pa_source_output_new_data_set_channel_map(pa_source_output_new_data
*data
, const pa_channel_map
*map
) {
71 if ((data
->channel_map_is_set
= !!map
))
72 data
->channel_map
= *map
;
75 pa_bool_t
pa_source_output_new_data_is_passthrough(pa_source_output_new_data
*data
) {
78 if (PA_LIKELY(data
->format
) && PA_UNLIKELY(!pa_format_info_is_pcm(data
->format
)))
81 if (PA_UNLIKELY(data
->flags
& PA_SOURCE_OUTPUT_PASSTHROUGH
))
87 void pa_source_output_new_data_set_volume(pa_source_output_new_data
*data
, const pa_cvolume
*volume
) {
89 pa_assert(data
->volume_writable
);
91 if ((data
->volume_is_set
= !!volume
))
92 data
->volume
= *volume
;
95 void pa_source_output_new_data_apply_volume_factor(pa_source_output_new_data
*data
, const pa_cvolume
*volume_factor
) {
97 pa_assert(volume_factor
);
99 if (data
->volume_factor_is_set
)
100 pa_sw_cvolume_multiply(&data
->volume_factor
, &data
->volume_factor
, volume_factor
);
102 data
->volume_factor_is_set
= TRUE
;
103 data
->volume_factor
= *volume_factor
;
107 void pa_source_output_new_data_apply_volume_factor_source(pa_source_output_new_data
*data
, const pa_cvolume
*volume_factor
) {
109 pa_assert(volume_factor
);
111 if (data
->volume_factor_source_is_set
)
112 pa_sw_cvolume_multiply(&data
->volume_factor_source
, &data
->volume_factor_source
, volume_factor
);
114 data
->volume_factor_source_is_set
= TRUE
;
115 data
->volume_factor_source
= *volume_factor
;
119 void pa_source_output_new_data_set_muted(pa_source_output_new_data
*data
, pa_bool_t mute
) {
122 data
->muted_is_set
= TRUE
;
123 data
->muted
= !!mute
;
126 pa_bool_t
pa_source_output_new_data_set_source(pa_source_output_new_data
*data
, pa_source
*s
, pa_bool_t save
) {
127 pa_bool_t ret
= TRUE
;
128 pa_idxset
*formats
= NULL
;
133 if (!data
->req_formats
) {
134 /* We're not working with the extended API */
136 data
->save_source
= save
;
138 /* Extended API: let's see if this source supports the formats the client would like */
139 formats
= pa_source_check_formats(s
, data
->req_formats
);
141 if (formats
&& !pa_idxset_isempty(formats
)) {
142 /* Source supports at least one of the requested formats */
144 data
->save_source
= save
;
145 if (data
->nego_formats
)
146 pa_idxset_free(data
->nego_formats
, (pa_free2_cb_t
) pa_format_info_free2
, NULL
);
147 data
->nego_formats
= formats
;
149 /* Source doesn't support any of the formats requested by the client */
151 pa_idxset_free(formats
, (pa_free2_cb_t
) pa_format_info_free2
, NULL
);
159 pa_bool_t
pa_source_output_new_data_set_formats(pa_source_output_new_data
*data
, pa_idxset
*formats
) {
163 if (data
->req_formats
)
164 pa_idxset_free(formats
, (pa_free2_cb_t
) pa_format_info_free2
, NULL
);
166 data
->req_formats
= formats
;
169 /* Trigger format negotiation */
170 return pa_source_output_new_data_set_source(data
, data
->source
, data
->save_source
);
176 void pa_source_output_new_data_done(pa_source_output_new_data
*data
) {
179 if (data
->req_formats
)
180 pa_idxset_free(data
->req_formats
, (pa_free2_cb_t
) pa_format_info_free2
, NULL
);
182 if (data
->nego_formats
)
183 pa_idxset_free(data
->nego_formats
, (pa_free2_cb_t
) pa_format_info_free2
, NULL
);
186 pa_format_info_free(data
->format
);
188 pa_proplist_free(data
->proplist
);
191 /* Called from main context */
192 static void reset_callbacks(pa_source_output
*o
) {
196 o
->process_rewind
= NULL
;
197 o
->update_max_rewind
= NULL
;
198 o
->update_source_requested_latency
= NULL
;
199 o
->update_source_latency_range
= NULL
;
200 o
->update_source_fixed_latency
= NULL
;
204 o
->suspend_within_thread
= NULL
;
207 o
->get_latency
= NULL
;
208 o
->state_change
= NULL
;
209 o
->may_move_to
= NULL
;
210 o
->send_event
= NULL
;
211 o
->volume_changed
= NULL
;
212 o
->mute_changed
= NULL
;
215 /* Called from main context */
216 int pa_source_output_new(
217 pa_source_output
**_o
,
219 pa_source_output_new_data
*data
) {
222 pa_resampler
*resampler
= NULL
;
223 char st
[PA_SAMPLE_SPEC_SNPRINT_MAX
], cm
[PA_CHANNEL_MAP_SNPRINT_MAX
];
224 pa_channel_map original_cm
;
233 pa_assert_ctl_context();
236 pa_proplist_update(data
->proplist
, PA_UPDATE_MERGE
, data
->client
->proplist
);
238 if (data
->destination_source
&& (data
->destination_source
->flags
& PA_SOURCE_SHARE_VOLUME_WITH_MASTER
))
239 data
->volume_writable
= FALSE
;
241 if (!data
->req_formats
) {
242 /* From this point on, we want to work only with formats, and get back
243 * to using the sample spec and channel map after all decisions w.r.t.
244 * routing are complete. */
245 pa_idxset
*tmp
= pa_idxset_new(NULL
, NULL
);
246 pa_format_info
*f
= pa_format_info_from_sample_spec(&data
->sample_spec
,
247 data
->channel_map_is_set
? &data
->channel_map
: NULL
);
248 pa_idxset_put(tmp
, f
, NULL
);
249 pa_source_output_new_data_set_formats(data
, tmp
);
252 if ((r
= pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_NEW
], data
)) < 0)
255 pa_return_val_if_fail(!data
->driver
|| pa_utf8_valid(data
->driver
), -PA_ERR_INVALID
);
258 pa_source
*source
= pa_namereg_get(core
, NULL
, PA_NAMEREG_SOURCE
);
259 pa_return_val_if_fail(source
, -PA_ERR_NOENTITY
);
260 pa_source_output_new_data_set_source(data
, source
, FALSE
);
263 /* Routing's done, we have a source. Now let's fix the format and set up the
266 /* If something didn't pick a format for us, pick the top-most format since
267 * we assume this is sorted in priority order */
268 if (!data
->format
&& data
->nego_formats
&& !pa_idxset_isempty(data
->nego_formats
))
269 data
->format
= pa_format_info_copy(pa_idxset_first(data
->nego_formats
, NULL
));
271 pa_return_val_if_fail(data
->format
, -PA_ERR_NOTSUPPORTED
);
273 /* Now populate the sample spec and format according to the final
274 * format that we've negotiated */
275 if (PA_LIKELY(data
->format
->encoding
== PA_ENCODING_PCM
)) {
276 pa_return_val_if_fail(pa_format_info_to_sample_spec(data
->format
, &ss
, &map
), -PA_ERR_INVALID
);
277 pa_source_output_new_data_set_sample_spec(data
, &ss
);
278 if (pa_channel_map_valid(&map
))
279 pa_source_output_new_data_set_channel_map(data
, &map
);
281 pa_return_val_if_fail(pa_format_info_to_sample_spec_fake(data
->format
, &ss
), -PA_ERR_INVALID
);
282 pa_source_output_new_data_set_sample_spec(data
, &ss
);
285 pa_return_val_if_fail(PA_SOURCE_IS_LINKED(pa_source_get_state(data
->source
)), -PA_ERR_BADSTATE
);
286 pa_return_val_if_fail(!data
->direct_on_input
|| data
->direct_on_input
->sink
== data
->source
->monitor_of
, -PA_ERR_INVALID
);
288 if (!data
->sample_spec_is_set
)
289 data
->sample_spec
= data
->source
->sample_spec
;
291 pa_return_val_if_fail(pa_sample_spec_valid(&data
->sample_spec
), -PA_ERR_INVALID
);
293 if (!data
->channel_map_is_set
) {
294 if (pa_channel_map_compatible(&data
->source
->channel_map
, &data
->sample_spec
))
295 data
->channel_map
= data
->source
->channel_map
;
297 pa_channel_map_init_extend(&data
->channel_map
, data
->sample_spec
.channels
, PA_CHANNEL_MAP_DEFAULT
);
300 pa_return_val_if_fail(pa_channel_map_compatible(&data
->channel_map
, &data
->sample_spec
), -PA_ERR_INVALID
);
302 /* Don't restore (or save) stream volume for passthrough streams and
303 * prevent attenuation/gain */
304 if (pa_source_output_new_data_is_passthrough(data
)) {
305 data
->volume_is_set
= TRUE
;
306 pa_cvolume_reset(&data
->volume
, data
->sample_spec
.channels
);
307 data
->volume_is_absolute
= TRUE
;
308 data
->save_volume
= FALSE
;
311 if (!data
->volume_is_set
) {
312 pa_cvolume_reset(&data
->volume
, data
->sample_spec
.channels
);
313 data
->volume_is_absolute
= FALSE
;
314 data
->save_volume
= FALSE
;
317 pa_return_val_if_fail(pa_cvolume_compatible(&data
->volume
, &data
->sample_spec
), -PA_ERR_INVALID
);
319 if (!data
->volume_factor_is_set
)
320 pa_cvolume_reset(&data
->volume_factor
, data
->sample_spec
.channels
);
322 pa_return_val_if_fail(pa_cvolume_compatible(&data
->volume_factor
, &data
->sample_spec
), -PA_ERR_INVALID
);
324 if (!data
->volume_factor_source_is_set
)
325 pa_cvolume_reset(&data
->volume_factor_source
, data
->source
->sample_spec
.channels
);
327 pa_return_val_if_fail(pa_cvolume_compatible(&data
->volume_factor_source
, &data
->source
->sample_spec
), -PA_ERR_INVALID
);
329 if (!data
->muted_is_set
)
332 if (data
->flags
& PA_SOURCE_OUTPUT_FIX_FORMAT
)
333 data
->sample_spec
.format
= data
->source
->sample_spec
.format
;
335 if (data
->flags
& PA_SOURCE_OUTPUT_FIX_RATE
)
336 data
->sample_spec
.rate
= data
->source
->sample_spec
.rate
;
338 original_cm
= data
->channel_map
;
340 if (data
->flags
& PA_SOURCE_OUTPUT_FIX_CHANNELS
) {
341 data
->sample_spec
.channels
= data
->source
->sample_spec
.channels
;
342 data
->channel_map
= data
->source
->channel_map
;
345 pa_assert(pa_sample_spec_valid(&data
->sample_spec
));
346 pa_assert(pa_channel_map_valid(&data
->channel_map
));
348 /* Due to the fixing of the sample spec the volume might not match anymore */
349 pa_cvolume_remap(&data
->volume
, &original_cm
, &data
->channel_map
);
351 if (!(data
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) &&
352 !pa_sample_spec_equal(&data
->sample_spec
, &data
->source
->sample_spec
)){
353 /* try to change source rate. This is done before the FIXATE hook since
354 module-suspend-on-idle can resume a source */
356 pa_log_info("Trying to change sample rate");
357 if (pa_source_update_rate(data
->source
, data
->sample_spec
.rate
, pa_source_output_new_data_is_passthrough(data
)) == TRUE
)
358 pa_log_info("Rate changed to %u Hz",
359 data
->source
->sample_spec
.rate
);
361 pa_log_info("Resampling enabled to %u Hz", data
->source
->sample_spec
.rate
);
364 if (data
->resample_method
== PA_RESAMPLER_INVALID
)
365 data
->resample_method
= core
->resample_method
;
367 pa_return_val_if_fail(data
->resample_method
< PA_RESAMPLER_MAX
, -PA_ERR_INVALID
);
369 if ((r
= pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_FIXATE
], data
)) < 0)
372 if ((data
->flags
& PA_SOURCE_OUTPUT_NO_CREATE_ON_SUSPEND
) &&
373 pa_source_get_state(data
->source
) == PA_SOURCE_SUSPENDED
) {
374 pa_log("Failed to create source output: source is suspended.");
375 return -PA_ERR_BADSTATE
;
378 if (pa_idxset_size(data
->source
->outputs
) >= PA_MAX_OUTPUTS_PER_SOURCE
) {
379 pa_log("Failed to create source output: too many outputs per source.");
380 return -PA_ERR_TOOLARGE
;
383 if ((data
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ||
384 !pa_sample_spec_equal(&data
->sample_spec
, &data
->source
->sample_spec
) ||
385 !pa_channel_map_equal(&data
->channel_map
, &data
->source
->channel_map
)) {
387 if (!pa_source_output_new_data_is_passthrough(data
)) /* no resampler for passthrough content */
388 if (!(resampler
= pa_resampler_new(
390 &data
->source
->sample_spec
, &data
->source
->channel_map
,
391 &data
->sample_spec
, &data
->channel_map
,
392 data
->resample_method
,
393 ((data
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ? PA_RESAMPLER_VARIABLE_RATE
: 0) |
394 ((data
->flags
& PA_SOURCE_OUTPUT_NO_REMAP
) ? PA_RESAMPLER_NO_REMAP
: 0) |
395 (core
->disable_remixing
|| (data
->flags
& PA_SOURCE_OUTPUT_NO_REMIX
) ? PA_RESAMPLER_NO_REMIX
: 0) |
396 (core
->disable_lfe_remixing
? PA_RESAMPLER_NO_LFE
: 0)))) {
397 pa_log_warn("Unsupported resampling operation.");
398 return -PA_ERR_NOTSUPPORTED
;
402 o
= pa_msgobject_new(pa_source_output
);
403 o
->parent
.parent
.free
= source_output_free
;
404 o
->parent
.process_msg
= pa_source_output_process_msg
;
407 o
->state
= PA_SOURCE_OUTPUT_INIT
;
408 o
->flags
= data
->flags
;
409 o
->proplist
= pa_proplist_copy(data
->proplist
);
410 o
->driver
= pa_xstrdup(pa_path_get_filename(data
->driver
));
411 o
->module
= data
->module
;
412 o
->source
= data
->source
;
413 o
->destination_source
= data
->destination_source
;
414 o
->client
= data
->client
;
416 o
->requested_resample_method
= data
->resample_method
;
417 o
->actual_resample_method
= resampler
? pa_resampler_get_method(resampler
) : PA_RESAMPLER_INVALID
;
418 o
->sample_spec
= data
->sample_spec
;
419 o
->channel_map
= data
->channel_map
;
420 o
->format
= pa_format_info_copy(data
->format
);
422 if (!data
->volume_is_absolute
&& pa_source_flat_volume_enabled(o
->source
)) {
425 /* When the 'absolute' bool is not set then we'll treat the volume
426 * as relative to the source volume even in flat volume mode */
427 remapped
= data
->source
->reference_volume
;
428 pa_cvolume_remap(&remapped
, &data
->source
->channel_map
, &data
->channel_map
);
429 pa_sw_cvolume_multiply(&o
->volume
, &data
->volume
, &remapped
);
431 o
->volume
= data
->volume
;
433 o
->volume_factor
= data
->volume_factor
;
434 o
->volume_factor_source
= data
->volume_factor_source
;
435 o
->real_ratio
= o
->reference_ratio
= data
->volume
;
436 pa_cvolume_reset(&o
->soft_volume
, o
->sample_spec
.channels
);
437 pa_cvolume_reset(&o
->real_ratio
, o
->sample_spec
.channels
);
438 o
->volume_writable
= data
->volume_writable
;
439 o
->save_volume
= data
->save_volume
;
440 o
->save_source
= data
->save_source
;
441 o
->save_muted
= data
->save_muted
;
443 o
->muted
= data
->muted
;
445 o
->direct_on_input
= data
->direct_on_input
;
450 o
->thread_info
.state
= o
->state
;
451 o
->thread_info
.attached
= FALSE
;
452 o
->thread_info
.sample_spec
= o
->sample_spec
;
453 o
->thread_info
.resampler
= resampler
;
454 o
->thread_info
.soft_volume
= o
->soft_volume
;
455 o
->thread_info
.muted
= o
->muted
;
456 o
->thread_info
.requested_source_latency
= (pa_usec_t
) -1;
457 o
->thread_info
.direct_on_input
= o
->direct_on_input
;
459 o
->thread_info
.delay_memblockq
= pa_memblockq_new(
460 "source output delay_memblockq",
464 &o
->source
->sample_spec
,
468 &o
->source
->silence
);
470 pa_assert_se(pa_idxset_put(core
->source_outputs
, o
, &o
->index
) == 0);
471 pa_assert_se(pa_idxset_put(o
->source
->outputs
, pa_source_output_ref(o
), NULL
) == 0);
474 pa_assert_se(pa_idxset_put(o
->client
->source_outputs
, o
, NULL
) >= 0);
476 if (o
->direct_on_input
)
477 pa_assert_se(pa_idxset_put(o
->direct_on_input
->direct_outputs
, o
, NULL
) == 0);
479 pt
= pa_proplist_to_string_sep(o
->proplist
, "\n ");
480 pa_log_info("Created output %u \"%s\" on %s with sample spec %s and channel map %s\n %s",
482 pa_strnull(pa_proplist_gets(o
->proplist
, PA_PROP_MEDIA_NAME
)),
484 pa_sample_spec_snprint(st
, sizeof(st
), &o
->sample_spec
),
485 pa_channel_map_snprint(cm
, sizeof(cm
), &o
->channel_map
),
489 /* Don't forget to call pa_source_output_put! */
495 /* Called from main context */
496 static void update_n_corked(pa_source_output
*o
, pa_source_output_state_t state
) {
498 pa_assert_ctl_context();
503 if (o
->state
== PA_SOURCE_OUTPUT_CORKED
&& state
!= PA_SOURCE_OUTPUT_CORKED
)
504 pa_assert_se(o
->source
->n_corked
-- >= 1);
505 else if (o
->state
!= PA_SOURCE_OUTPUT_CORKED
&& state
== PA_SOURCE_OUTPUT_CORKED
)
506 o
->source
->n_corked
++;
509 /* Called from main context */
510 static void source_output_set_state(pa_source_output
*o
, pa_source_output_state_t state
) {
513 pa_assert_ctl_context();
515 if (o
->state
== state
)
518 if (o
->state
== PA_SOURCE_OUTPUT_CORKED
&& state
== PA_SOURCE_OUTPUT_RUNNING
&& pa_source_used_by(o
->source
) == 0) {
519 /* We were uncorked and the source was not playing anything -- let's try
520 * to update the sample rate to avoid resampling */
521 pa_source_update_rate(o
->source
, o
->sample_spec
.rate
, pa_source_output_is_passthrough(o
));
524 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_STATE
, PA_UINT_TO_PTR(state
), 0, NULL
) == 0);
526 update_n_corked(o
, state
);
529 if (state
!= PA_SOURCE_OUTPUT_UNLINKED
) {
530 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_STATE_CHANGED
], o
);
532 if (PA_SOURCE_OUTPUT_IS_LINKED(state
))
533 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
536 pa_source_update_status(o
->source
);
539 /* Called from main context */
540 void pa_source_output_unlink(pa_source_output
*o
) {
543 pa_assert_ctl_context();
545 /* See pa_sink_unlink() for a couple of comments how this function
548 pa_source_output_ref(o
);
550 linked
= PA_SOURCE_OUTPUT_IS_LINKED(o
->state
);
553 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK
], o
);
555 if (o
->direct_on_input
)
556 pa_idxset_remove_by_data(o
->direct_on_input
->direct_outputs
, o
, NULL
);
558 pa_idxset_remove_by_data(o
->core
->source_outputs
, o
, NULL
);
561 if (pa_idxset_remove_by_data(o
->source
->outputs
, o
, NULL
))
562 pa_source_output_unref(o
);
565 pa_idxset_remove_by_data(o
->client
->source_outputs
, o
, NULL
);
567 update_n_corked(o
, PA_SOURCE_OUTPUT_UNLINKED
);
568 o
->state
= PA_SOURCE_OUTPUT_UNLINKED
;
570 if (linked
&& o
->source
) {
571 if (pa_source_output_is_passthrough(o
))
572 pa_source_leave_passthrough(o
->source
);
574 /* We might need to update the source's volume if we are in flat volume mode. */
575 if (pa_source_flat_volume_enabled(o
->source
))
576 pa_source_set_volume(o
->source
, NULL
, FALSE
, FALSE
);
578 if (o
->source
->asyncmsgq
)
579 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_REMOVE_OUTPUT
, o
, 0, NULL
) == 0);
585 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_REMOVE
, o
->index
);
586 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK_POST
], o
);
590 if (PA_SOURCE_IS_LINKED(pa_source_get_state(o
->source
)))
591 pa_source_update_status(o
->source
);
596 pa_core_maybe_vacuum(o
->core
);
598 pa_source_output_unref(o
);
601 /* Called from main context */
602 static void source_output_free(pa_object
* mo
) {
603 pa_source_output
*o
= PA_SOURCE_OUTPUT(mo
);
606 pa_assert_ctl_context();
607 pa_assert(pa_source_output_refcnt(o
) == 0);
609 if (PA_SOURCE_OUTPUT_IS_LINKED(o
->state
))
610 pa_source_output_unlink(o
);
612 pa_log_info("Freeing output %u \"%s\"", o
->index
, pa_strnull(pa_proplist_gets(o
->proplist
, PA_PROP_MEDIA_NAME
)));
614 if (o
->thread_info
.delay_memblockq
)
615 pa_memblockq_free(o
->thread_info
.delay_memblockq
);
617 if (o
->thread_info
.resampler
)
618 pa_resampler_free(o
->thread_info
.resampler
);
621 pa_format_info_free(o
->format
);
624 pa_proplist_free(o
->proplist
);
630 /* Called from main context */
631 void pa_source_output_put(pa_source_output
*o
) {
632 pa_source_output_state_t state
;
634 pa_source_output_assert_ref(o
);
635 pa_assert_ctl_context();
637 pa_assert(o
->state
== PA_SOURCE_OUTPUT_INIT
);
639 /* The following fields must be initialized properly */
643 state
= o
->flags
& PA_SOURCE_OUTPUT_START_CORKED
? PA_SOURCE_OUTPUT_CORKED
: PA_SOURCE_OUTPUT_RUNNING
;
645 update_n_corked(o
, state
);
648 /* We might need to update the source's volume if we are in flat volume mode. */
649 if (pa_source_flat_volume_enabled(o
->source
))
650 pa_source_set_volume(o
->source
, NULL
, FALSE
, o
->save_volume
);
652 if (o
->destination_source
&& (o
->destination_source
->flags
& PA_SOURCE_SHARE_VOLUME_WITH_MASTER
)) {
653 pa_assert(pa_cvolume_is_norm(&o
->volume
));
654 pa_assert(pa_cvolume_is_norm(&o
->reference_ratio
));
657 set_real_ratio(o
, &o
->volume
);
660 if (pa_source_output_is_passthrough(o
))
661 pa_source_enter_passthrough(o
->source
);
663 o
->thread_info
.soft_volume
= o
->soft_volume
;
664 o
->thread_info
.muted
= o
->muted
;
666 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_ADD_OUTPUT
, o
, 0, NULL
) == 0);
668 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_NEW
, o
->index
);
669 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_PUT
], o
);
671 pa_source_update_status(o
->source
);
674 /* Called from main context */
675 void pa_source_output_kill(pa_source_output
*o
) {
676 pa_source_output_assert_ref(o
);
677 pa_assert_ctl_context();
678 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
683 /* Called from main context */
684 pa_usec_t
pa_source_output_get_latency(pa_source_output
*o
, pa_usec_t
*source_latency
) {
685 pa_usec_t r
[2] = { 0, 0 };
687 pa_source_output_assert_ref(o
);
688 pa_assert_ctl_context();
689 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
691 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_GET_LATENCY
, r
, 0, NULL
) == 0);
694 r
[0] += o
->get_latency(o
);
697 *source_latency
= r
[1];
702 /* Called from thread context */
703 void pa_source_output_push(pa_source_output
*o
, const pa_memchunk
*chunk
) {
704 pa_bool_t need_volume_factor_source
;
705 pa_bool_t volume_is_norm
;
707 size_t limit
, mbs
= 0;
709 pa_source_output_assert_ref(o
);
710 pa_source_output_assert_io_context(o
);
711 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->thread_info
.state
));
713 pa_assert(pa_frame_aligned(chunk
->length
, &o
->source
->sample_spec
));
715 if (!o
->push
|| o
->thread_info
.state
== PA_SOURCE_OUTPUT_CORKED
)
718 pa_assert(o
->thread_info
.state
== PA_SOURCE_OUTPUT_RUNNING
);
720 if (pa_memblockq_push(o
->thread_info
.delay_memblockq
, chunk
) < 0) {
721 pa_log_debug("Delay queue overflow!");
722 pa_memblockq_seek(o
->thread_info
.delay_memblockq
, (int64_t) chunk
->length
, PA_SEEK_RELATIVE
, TRUE
);
725 limit
= o
->process_rewind
? 0 : o
->source
->thread_info
.max_rewind
;
727 volume_is_norm
= pa_cvolume_is_norm(&o
->thread_info
.soft_volume
) && !o
->thread_info
.muted
;
728 need_volume_factor_source
= !pa_cvolume_is_norm(&o
->volume_factor_source
);
730 if (limit
> 0 && o
->source
->monitor_of
) {
734 /* Hmm, check the latency for knowing how much of the buffered
735 * data is actually still unplayed and might hence still
736 * change. This is suboptimal. Ideally we'd have a call like
737 * pa_sink_get_changeable_size() or so that tells us how much
738 * of the queued data is actually still changeable. Hence
741 latency
= pa_sink_get_latency_within_thread(o
->source
->monitor_of
);
743 n
= pa_usec_to_bytes(latency
, &o
->source
->sample_spec
);
749 /* Implement the delay queue */
750 while ((length
= pa_memblockq_get_length(o
->thread_info
.delay_memblockq
)) > limit
) {
752 pa_bool_t nvfs
= need_volume_factor_source
;
756 pa_assert_se(pa_memblockq_peek(o
->thread_info
.delay_memblockq
, &qchunk
) >= 0);
758 if (qchunk
.length
> length
)
759 qchunk
.length
= length
;
761 pa_assert(qchunk
.length
> 0);
763 /* It might be necessary to adjust the volume here */
764 if (!volume_is_norm
) {
765 pa_memchunk_make_writable(&qchunk
, 0);
767 if (o
->thread_info
.muted
) {
768 pa_silence_memchunk(&qchunk
, &o
->source
->sample_spec
);
771 } else if (!o
->thread_info
.resampler
&& nvfs
) {
774 /* If we don't need a resampler we can merge the
775 * post and the pre volume adjustment into one */
777 pa_sw_cvolume_multiply(&v
, &o
->thread_info
.soft_volume
, &o
->volume_factor_source
);
778 pa_volume_memchunk(&qchunk
, &o
->source
->sample_spec
, &v
);
782 pa_volume_memchunk(&qchunk
, &o
->source
->sample_spec
, &o
->thread_info
.soft_volume
);
785 if (!o
->thread_info
.resampler
) {
787 pa_memchunk_make_writable(&qchunk
, 0);
788 pa_volume_memchunk(&qchunk
, &o
->thread_info
.sample_spec
, &o
->volume_factor_source
);
796 mbs
= pa_resampler_max_block_size(o
->thread_info
.resampler
);
798 if (qchunk
.length
> mbs
)
801 pa_resampler_run(o
->thread_info
.resampler
, &qchunk
, &rchunk
);
803 if (rchunk
.length
> 0) {
805 pa_memchunk_make_writable(&rchunk
, 0);
806 pa_volume_memchunk(&rchunk
, &o
->thread_info
.sample_spec
, &o
->volume_factor_source
);
813 pa_memblock_unref(rchunk
.memblock
);
816 pa_memblock_unref(qchunk
.memblock
);
817 pa_memblockq_drop(o
->thread_info
.delay_memblockq
, qchunk
.length
);
821 /* Called from thread context */
822 void pa_source_output_process_rewind(pa_source_output
*o
, size_t nbytes
/* in source sample spec */) {
824 pa_source_output_assert_ref(o
);
825 pa_source_output_assert_io_context(o
);
826 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->thread_info
.state
));
827 pa_assert(pa_frame_aligned(nbytes
, &o
->source
->sample_spec
));
832 if (o
->process_rewind
) {
833 pa_assert(pa_memblockq_get_length(o
->thread_info
.delay_memblockq
) == 0);
835 if (o
->thread_info
.resampler
)
836 nbytes
= pa_resampler_result(o
->thread_info
.resampler
, nbytes
);
838 pa_log_debug("Have to rewind %lu bytes on implementor.", (unsigned long) nbytes
);
841 o
->process_rewind(o
, nbytes
);
843 if (o
->thread_info
.resampler
)
844 pa_resampler_reset(o
->thread_info
.resampler
);
847 pa_memblockq_rewind(o
->thread_info
.delay_memblockq
, nbytes
);
850 /* Called from thread context */
851 size_t pa_source_output_get_max_rewind(pa_source_output
*o
) {
852 pa_source_output_assert_ref(o
);
853 pa_source_output_assert_io_context(o
);
855 return o
->thread_info
.resampler
? pa_resampler_request(o
->thread_info
.resampler
, o
->source
->thread_info
.max_rewind
) : o
->source
->thread_info
.max_rewind
;
858 /* Called from thread context */
859 void pa_source_output_update_max_rewind(pa_source_output
*o
, size_t nbytes
/* in the source's sample spec */) {
860 pa_source_output_assert_ref(o
);
861 pa_source_output_assert_io_context(o
);
862 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->thread_info
.state
));
863 pa_assert(pa_frame_aligned(nbytes
, &o
->source
->sample_spec
));
865 if (o
->update_max_rewind
)
866 o
->update_max_rewind(o
, o
->thread_info
.resampler
? pa_resampler_result(o
->thread_info
.resampler
, nbytes
) : nbytes
);
869 /* Called from thread context */
870 pa_usec_t
pa_source_output_set_requested_latency_within_thread(pa_source_output
*o
, pa_usec_t usec
) {
871 pa_source_output_assert_ref(o
);
872 pa_source_output_assert_io_context(o
);
874 if (!(o
->source
->flags
& PA_SOURCE_DYNAMIC_LATENCY
))
875 usec
= o
->source
->thread_info
.fixed_latency
;
877 if (usec
!= (pa_usec_t
) -1)
878 usec
= PA_CLAMP(usec
, o
->source
->thread_info
.min_latency
, o
->source
->thread_info
.max_latency
);
880 o
->thread_info
.requested_source_latency
= usec
;
881 pa_source_invalidate_requested_latency(o
->source
, TRUE
);
886 /* Called from main context */
887 pa_usec_t
pa_source_output_set_requested_latency(pa_source_output
*o
, pa_usec_t usec
) {
888 pa_source_output_assert_ref(o
);
889 pa_assert_ctl_context();
891 if (PA_SOURCE_OUTPUT_IS_LINKED(o
->state
) && o
->source
) {
892 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_REQUESTED_LATENCY
, &usec
, 0, NULL
) == 0);
896 /* If this source output is not realized yet or is being moved, we
897 * have to touch the thread info data directly */
900 if (!(o
->source
->flags
& PA_SOURCE_DYNAMIC_LATENCY
))
901 usec
= pa_source_get_fixed_latency(o
->source
);
903 if (usec
!= (pa_usec_t
) -1) {
904 pa_usec_t min_latency
, max_latency
;
905 pa_source_get_latency_range(o
->source
, &min_latency
, &max_latency
);
906 usec
= PA_CLAMP(usec
, min_latency
, max_latency
);
910 o
->thread_info
.requested_source_latency
= usec
;
915 /* Called from main context */
916 pa_usec_t
pa_source_output_get_requested_latency(pa_source_output
*o
) {
917 pa_source_output_assert_ref(o
);
918 pa_assert_ctl_context();
920 if (PA_SOURCE_OUTPUT_IS_LINKED(o
->state
) && o
->source
) {
922 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_GET_REQUESTED_LATENCY
, &usec
, 0, NULL
) == 0);
926 /* If this source output is not realized yet or is being moved, we
927 * have to touch the thread info data directly */
929 return o
->thread_info
.requested_source_latency
;
932 /* Called from main context */
933 void pa_source_output_set_volume(pa_source_output
*o
, const pa_cvolume
*volume
, pa_bool_t save
, pa_bool_t absolute
) {
936 pa_source_output_assert_ref(o
);
937 pa_assert_ctl_context();
938 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
940 pa_assert(pa_cvolume_valid(volume
));
941 pa_assert(volume
->channels
== 1 || pa_cvolume_compatible(volume
, &o
->sample_spec
));
942 pa_assert(o
->volume_writable
);
944 if (!absolute
&& pa_source_flat_volume_enabled(o
->source
)) {
945 v
= o
->source
->reference_volume
;
946 pa_cvolume_remap(&v
, &o
->source
->channel_map
, &o
->channel_map
);
948 if (pa_cvolume_compatible(volume
, &o
->sample_spec
))
949 volume
= pa_sw_cvolume_multiply(&v
, &v
, volume
);
951 volume
= pa_sw_cvolume_multiply_scalar(&v
, &v
, pa_cvolume_max(volume
));
953 if (!pa_cvolume_compatible(volume
, &o
->sample_spec
)) {
955 volume
= pa_cvolume_scale(&v
, pa_cvolume_max(volume
));
959 if (pa_cvolume_equal(volume
, &o
->volume
)) {
960 o
->save_volume
= o
->save_volume
|| save
;
965 o
->save_volume
= save
;
967 if (pa_source_flat_volume_enabled(o
->source
)) {
968 /* We are in flat volume mode, so let's update all source input
969 * volumes and update the flat volume of the source */
971 pa_source_set_volume(o
->source
, NULL
, TRUE
, save
);
974 /* OK, we are in normal volume mode. The volume only affects
976 set_real_ratio(o
, volume
);
978 /* Copy the new soft_volume to the thread_info struct */
979 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_SOFT_VOLUME
, NULL
, 0, NULL
) == 0);
982 /* The volume changed, let's tell people so */
983 if (o
->volume_changed
)
984 o
->volume_changed(o
);
986 /* The virtual volume changed, let's tell people so */
987 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
990 /* Called from main context */
991 static void set_real_ratio(pa_source_output
*o
, const pa_cvolume
*v
) {
992 pa_source_output_assert_ref(o
);
993 pa_assert_ctl_context();
994 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
995 pa_assert(!v
|| pa_cvolume_compatible(v
, &o
->sample_spec
));
997 /* This basically calculates:
1000 * o->soft_volume := o->real_ratio * o->volume_factor */
1005 pa_cvolume_reset(&o
->real_ratio
, o
->sample_spec
.channels
);
1007 pa_sw_cvolume_multiply(&o
->soft_volume
, &o
->real_ratio
, &o
->volume_factor
);
1008 /* We don't copy the data to the thread_info data. That's left for someone else to do */
1011 /* Called from main or I/O context */
1012 pa_bool_t
pa_source_output_is_passthrough(pa_source_output
*o
) {
1013 pa_source_output_assert_ref(o
);
1015 if (PA_UNLIKELY(!pa_format_info_is_pcm(o
->format
)))
1018 if (PA_UNLIKELY(o
->flags
& PA_SOURCE_OUTPUT_PASSTHROUGH
))
1024 /* Called from main context */
1025 pa_bool_t
pa_source_output_is_volume_readable(pa_source_output
*o
) {
1026 pa_source_output_assert_ref(o
);
1027 pa_assert_ctl_context();
1029 return !pa_source_output_is_passthrough(o
);
1032 /* Called from main context */
1033 pa_cvolume
*pa_source_output_get_volume(pa_source_output
*o
, pa_cvolume
*volume
, pa_bool_t absolute
) {
1034 pa_source_output_assert_ref(o
);
1035 pa_assert_ctl_context();
1036 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1037 pa_assert(pa_source_output_is_volume_readable(o
));
1039 if (absolute
|| !pa_source_flat_volume_enabled(o
->source
))
1040 *volume
= o
->volume
;
1042 *volume
= o
->reference_ratio
;
1047 /* Called from main context */
1048 void pa_source_output_set_mute(pa_source_output
*o
, pa_bool_t mute
, pa_bool_t save
) {
1049 pa_source_output_assert_ref(o
);
1050 pa_assert_ctl_context();
1051 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1053 if (!o
->muted
== !mute
) {
1054 o
->save_muted
= o
->save_muted
|| mute
;
1059 o
->save_muted
= save
;
1061 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_SOFT_MUTE
, NULL
, 0, NULL
) == 0);
1063 /* The mute status changed, let's tell people so */
1064 if (o
->mute_changed
)
1067 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1070 /* Called from main context */
1071 pa_bool_t
pa_source_output_get_mute(pa_source_output
*o
) {
1072 pa_source_output_assert_ref(o
);
1073 pa_assert_ctl_context();
1074 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1079 /* Called from main thread */
1080 void pa_source_output_update_proplist(pa_source_output
*o
, pa_update_mode_t mode
, pa_proplist
*p
) {
1081 pa_source_output_assert_ref(o
);
1082 pa_assert_ctl_context();
1085 pa_proplist_update(o
->proplist
, mode
, p
);
1087 if (PA_SOURCE_OUTPUT_IS_LINKED(o
->state
)) {
1088 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED
], o
);
1089 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1093 /* Called from main context */
1094 void pa_source_output_cork(pa_source_output
*o
, pa_bool_t b
) {
1095 pa_source_output_assert_ref(o
);
1096 pa_assert_ctl_context();
1097 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1099 source_output_set_state(o
, b
? PA_SOURCE_OUTPUT_CORKED
: PA_SOURCE_OUTPUT_RUNNING
);
1102 /* Called from main context */
1103 int pa_source_output_set_rate(pa_source_output
*o
, uint32_t rate
) {
1104 pa_source_output_assert_ref(o
);
1105 pa_assert_ctl_context();
1106 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1107 pa_return_val_if_fail(o
->thread_info
.resampler
, -PA_ERR_BADSTATE
);
1109 if (o
->sample_spec
.rate
== rate
)
1112 o
->sample_spec
.rate
= rate
;
1114 pa_asyncmsgq_post(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
), PA_SOURCE_OUTPUT_MESSAGE_SET_RATE
, PA_UINT_TO_PTR(rate
), 0, NULL
, NULL
);
1116 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1120 /* Called from main context */
1121 void pa_source_output_set_name(pa_source_output
*o
, const char *name
) {
1123 pa_assert_ctl_context();
1124 pa_source_output_assert_ref(o
);
1126 if (!name
&& !pa_proplist_contains(o
->proplist
, PA_PROP_MEDIA_NAME
))
1129 old
= pa_proplist_gets(o
->proplist
, PA_PROP_MEDIA_NAME
);
1131 if (old
&& name
&& !strcmp(old
, name
))
1135 pa_proplist_sets(o
->proplist
, PA_PROP_MEDIA_NAME
, name
);
1137 pa_proplist_unset(o
->proplist
, PA_PROP_MEDIA_NAME
);
1139 if (PA_SOURCE_OUTPUT_IS_LINKED(o
->state
)) {
1140 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED
], o
);
1141 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1145 /* Called from main context */
1146 pa_resample_method_t
pa_source_output_get_resample_method(pa_source_output
*o
) {
1147 pa_source_output_assert_ref(o
);
1148 pa_assert_ctl_context();
1150 return o
->actual_resample_method
;
1153 /* Called from main context */
1154 pa_bool_t
pa_source_output_may_move(pa_source_output
*o
) {
1155 pa_source_output_assert_ref(o
);
1156 pa_assert_ctl_context();
1157 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1159 if (o
->flags
& PA_SOURCE_OUTPUT_DONT_MOVE
)
1162 if (o
->direct_on_input
)
1168 /* Called from main context */
1169 pa_bool_t
pa_source_output_may_move_to(pa_source_output
*o
, pa_source
*dest
) {
1170 pa_source_output_assert_ref(o
);
1171 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1172 pa_source_assert_ref(dest
);
1174 if (dest
== o
->source
)
1177 if (!pa_source_output_may_move(o
))
1180 if (pa_idxset_size(dest
->outputs
) >= PA_MAX_OUTPUTS_PER_SOURCE
) {
1181 pa_log_warn("Failed to move source output: too many outputs per source.");
1186 if (!o
->may_move_to(o
, dest
))
1192 /* Called from main context */
1193 int pa_source_output_start_move(pa_source_output
*o
) {
1197 pa_source_output_assert_ref(o
);
1198 pa_assert_ctl_context();
1199 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1200 pa_assert(o
->source
);
1202 if (!pa_source_output_may_move(o
))
1203 return -PA_ERR_NOTSUPPORTED
;
1205 if ((r
= pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_START
], o
)) < 0)
1210 pa_idxset_remove_by_data(o
->source
->outputs
, o
, NULL
);
1212 if (pa_source_output_get_state(o
) == PA_SOURCE_OUTPUT_CORKED
)
1213 pa_assert_se(origin
->n_corked
-- >= 1);
1215 if (pa_source_output_is_passthrough(o
))
1216 pa_source_leave_passthrough(o
->source
);
1218 if (pa_source_flat_volume_enabled(o
->source
))
1219 /* We might need to update the source's volume if we are in flat
1221 pa_source_set_volume(o
->source
, NULL
, FALSE
, FALSE
);
1223 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_REMOVE_OUTPUT
, o
, 0, NULL
) == 0);
1225 pa_source_update_status(o
->source
);
1228 pa_source_output_unref(o
);
1233 /* Called from main context. If it has an origin source that uses volume sharing,
1234 * then also the origin source and all streams connected to it need to update
1235 * their volume - this function does all that by using recursion. */
1236 static void update_volume_due_to_moving(pa_source_output
*o
, pa_source
*dest
) {
1237 pa_cvolume old_volume
;
1241 pa_assert(o
->source
); /* The destination source should already be set. */
1243 if (o
->destination_source
&& (o
->destination_source
->flags
& PA_SOURCE_SHARE_VOLUME_WITH_MASTER
)) {
1244 pa_source
*root_source
;
1245 pa_source_output
*destination_source_output
;
1248 root_source
= pa_source_get_master(o
->source
);
1250 if (PA_UNLIKELY(!root_source
))
1253 if (pa_source_flat_volume_enabled(o
->source
)) {
1254 /* Ok, so the origin source uses volume sharing, and flat volume is
1255 * enabled. The volume will have to be updated as follows:
1257 * o->volume := o->source->real_volume
1258 * (handled later by pa_source_set_volume)
1259 * o->reference_ratio := o->volume / o->source->reference_volume
1260 * (handled later by pa_source_set_volume)
1261 * o->real_ratio stays unchanged
1262 * (streams whose origin source uses volume sharing should
1263 * always have real_ratio of 0 dB)
1264 * o->soft_volume stays unchanged
1265 * (streams whose origin source uses volume sharing should
1266 * always have volume_factor as soft_volume, so no change
1267 * should be needed) */
1269 pa_assert(pa_cvolume_is_norm(&o
->real_ratio
));
1270 pa_assert(pa_cvolume_equal(&o
->soft_volume
, &o
->volume_factor
));
1272 /* Notifications will be sent by pa_source_set_volume(). */
1275 /* Ok, so the origin source uses volume sharing, and flat volume is
1276 * disabled. The volume will have to be updated as follows:
1279 * o->reference_ratio := 0 dB
1280 * o->real_ratio stays unchanged
1281 * (streams whose origin source uses volume sharing should
1282 * always have real_ratio of 0 dB)
1283 * o->soft_volume stays unchanged
1284 * (streams whose origin source uses volume sharing should
1285 * always have volume_factor as soft_volume, so no change
1286 * should be needed) */
1288 old_volume
= o
->volume
;
1289 pa_cvolume_reset(&o
->volume
, o
->volume
.channels
);
1290 pa_cvolume_reset(&o
->reference_ratio
, o
->reference_ratio
.channels
);
1291 pa_assert(pa_cvolume_is_norm(&o
->real_ratio
));
1292 pa_assert(pa_cvolume_equal(&o
->soft_volume
, &o
->volume_factor
));
1294 /* Notify others about the changed source output volume. */
1295 if (!pa_cvolume_equal(&o
->volume
, &old_volume
)) {
1296 if (o
->volume_changed
)
1297 o
->volume_changed(o
);
1299 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1303 /* Additionally, the origin source volume needs updating:
1305 * o->destination_source->reference_volume := root_source->reference_volume
1306 * o->destination_source->real_volume := root_source->real_volume
1307 * o->destination_source->soft_volume stays unchanged
1308 * (sources that use volume sharing should always have
1309 * soft_volume of 0 dB) */
1311 old_volume
= o
->destination_source
->reference_volume
;
1313 o
->destination_source
->reference_volume
= root_source
->reference_volume
;
1314 pa_cvolume_remap(&o
->destination_source
->reference_volume
, &root_source
->channel_map
, &o
->destination_source
->channel_map
);
1316 o
->destination_source
->real_volume
= root_source
->real_volume
;
1317 pa_cvolume_remap(&o
->destination_source
->real_volume
, &root_source
->channel_map
, &o
->destination_source
->channel_map
);
1319 pa_assert(pa_cvolume_is_norm(&o
->destination_source
->soft_volume
));
1321 /* Notify others about the changed source volume. If you wonder whether
1322 * o->destination_source->set_volume() should be called somewhere, that's not
1323 * the case, because sources that use volume sharing shouldn't have any
1324 * internal volume that set_volume() would update. If you wonder
1325 * whether the thread_info variables should be synced, yes, they
1326 * should, and it's done by the PA_SOURCE_MESSAGE_FINISH_MOVE message
1328 if (!pa_cvolume_equal(&o
->destination_source
->reference_volume
, &old_volume
))
1329 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->destination_source
->index
);
1331 /* Recursively update origin source outputs. */
1332 PA_IDXSET_FOREACH(destination_source_output
, o
->destination_source
->outputs
, idx
)
1333 update_volume_due_to_moving(destination_source_output
, dest
);
1336 old_volume
= o
->volume
;
1338 if (pa_source_flat_volume_enabled(o
->source
)) {
1339 /* Ok, so this is a regular stream, and flat volume is enabled. The
1340 * volume will have to be updated as follows:
1342 * o->volume := o->reference_ratio * o->source->reference_volume
1343 * o->reference_ratio stays unchanged
1344 * o->real_ratio := o->volume / o->source->real_volume
1345 * (handled later by pa_source_set_volume)
1346 * o->soft_volume := o->real_ratio * o->volume_factor
1347 * (handled later by pa_source_set_volume) */
1349 o
->volume
= o
->source
->reference_volume
;
1350 pa_cvolume_remap(&o
->volume
, &o
->source
->channel_map
, &o
->channel_map
);
1351 pa_sw_cvolume_multiply(&o
->volume
, &o
->volume
, &o
->reference_ratio
);
1354 /* Ok, so this is a regular stream, and flat volume is disabled.
1355 * The volume will have to be updated as follows:
1357 * o->volume := o->reference_ratio
1358 * o->reference_ratio stays unchanged
1359 * o->real_ratio := o->reference_ratio
1360 * o->soft_volume := o->real_ratio * o->volume_factor */
1362 o
->volume
= o
->reference_ratio
;
1363 o
->real_ratio
= o
->reference_ratio
;
1364 pa_sw_cvolume_multiply(&o
->soft_volume
, &o
->real_ratio
, &o
->volume_factor
);
1367 /* Notify others about the changed source output volume. */
1368 if (!pa_cvolume_equal(&o
->volume
, &old_volume
)) {
1369 /* XXX: In case o->source has flat volume enabled, then real_ratio
1370 * and soft_volume are not updated yet. Let's hope that the
1371 * callback implementation doesn't care about those variables... */
1372 if (o
->volume_changed
)
1373 o
->volume_changed(o
);
1375 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1379 /* If o->source == dest, then recursion has finished, and we can finally call
1380 * pa_source_set_volume(), which will do the rest of the updates. */
1381 if ((o
->source
== dest
) && pa_source_flat_volume_enabled(o
->source
))
1382 pa_source_set_volume(o
->source
, NULL
, FALSE
, o
->save_volume
);
1385 /* Called from main context */
1386 int pa_source_output_finish_move(pa_source_output
*o
, pa_source
*dest
, pa_bool_t save
) {
1387 pa_source_output_assert_ref(o
);
1388 pa_assert_ctl_context();
1389 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1390 pa_assert(!o
->source
);
1391 pa_source_assert_ref(dest
);
1393 if (!pa_source_output_may_move_to(o
, dest
))
1394 return -PA_ERR_NOTSUPPORTED
;
1396 if (pa_source_output_is_passthrough(o
) && !pa_source_check_format(dest
, o
->format
)) {
1397 pa_proplist
*p
= pa_proplist_new();
1398 pa_log_debug("New source doesn't support stream format, sending format-changed and killing");
1399 /* Tell the client what device we want to be on if it is going to
1401 pa_proplist_sets(p
, "device", dest
->name
);
1402 pa_source_output_send_event(o
, PA_STREAM_EVENT_FORMAT_LOST
, p
);
1403 pa_proplist_free(p
);
1404 return -PA_ERR_NOTSUPPORTED
;
1407 if (!(o
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) &&
1408 !pa_sample_spec_equal(&o
->sample_spec
, &dest
->sample_spec
)){
1409 /* try to change dest sink rate if possible without glitches.
1410 module-suspend-on-idle resumes destination source with
1411 SOURCE_OUTPUT_MOVE_FINISH hook */
1413 pa_log_info("Trying to change sample rate");
1414 if (pa_source_update_rate(dest
, o
->sample_spec
.rate
, pa_source_output_is_passthrough(o
)) == TRUE
)
1415 pa_log_info("Rate changed to %u Hz",
1416 dest
->sample_spec
.rate
);
1418 pa_log_info("Resampling enabled to %u Hz",
1419 dest
->sample_spec
.rate
);
1426 o
->save_source
= save
;
1427 pa_idxset_put(o
->source
->outputs
, pa_source_output_ref(o
), NULL
);
1429 pa_cvolume_remap(&o
->volume_factor_source
, &o
->channel_map
, &o
->source
->channel_map
);
1431 if (pa_source_output_get_state(o
) == PA_SOURCE_OUTPUT_CORKED
)
1432 o
->source
->n_corked
++;
1434 pa_source_output_update_rate(o
);
1436 pa_source_update_status(dest
);
1438 update_volume_due_to_moving(o
, dest
);
1440 if (pa_source_output_is_passthrough(o
))
1441 pa_source_enter_passthrough(o
->source
);
1443 pa_assert_se(pa_asyncmsgq_send(o
->source
->asyncmsgq
, PA_MSGOBJECT(o
->source
), PA_SOURCE_MESSAGE_ADD_OUTPUT
, o
, 0, NULL
) == 0);
1445 pa_log_debug("Successfully moved source output %i to %s.", o
->index
, dest
->name
);
1447 /* Notify everyone */
1448 pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FINISH
], o
);
1449 pa_subscription_post(o
->core
, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT
|PA_SUBSCRIPTION_EVENT_CHANGE
, o
->index
);
1454 /* Called from main context */
1455 void pa_source_output_fail_move(pa_source_output
*o
) {
1457 pa_source_output_assert_ref(o
);
1458 pa_assert_ctl_context();
1459 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1460 pa_assert(!o
->source
);
1462 /* Check if someone wants this source output? */
1463 if (pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FAIL
], o
) == PA_HOOK_STOP
)
1469 pa_source_output_kill(o
);
1472 /* Called from main context */
1473 int pa_source_output_move_to(pa_source_output
*o
, pa_source
*dest
, pa_bool_t save
) {
1476 pa_source_output_assert_ref(o
);
1477 pa_assert_ctl_context();
1478 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o
->state
));
1479 pa_assert(o
->source
);
1480 pa_source_assert_ref(dest
);
1482 if (dest
== o
->source
)
1485 if (!pa_source_output_may_move_to(o
, dest
))
1486 return -PA_ERR_NOTSUPPORTED
;
1488 pa_source_output_ref(o
);
1490 if ((r
= pa_source_output_start_move(o
)) < 0) {
1491 pa_source_output_unref(o
);
1495 if ((r
= pa_source_output_finish_move(o
, dest
, save
)) < 0) {
1496 pa_source_output_fail_move(o
);
1497 pa_source_output_unref(o
);
1501 pa_source_output_unref(o
);
1506 /* Called from IO thread context */
1507 void pa_source_output_set_state_within_thread(pa_source_output
*o
, pa_source_output_state_t state
) {
1508 pa_source_output_assert_ref(o
);
1509 pa_source_output_assert_io_context(o
);
1511 if (state
== o
->thread_info
.state
)
1514 if (o
->state_change
)
1515 o
->state_change(o
, state
);
1517 o
->thread_info
.state
= state
;
1520 /* Called from IO thread context, except when it is not */
1521 int pa_source_output_process_msg(pa_msgobject
*mo
, int code
, void *userdata
, int64_t offset
, pa_memchunk
* chunk
) {
1522 pa_source_output
*o
= PA_SOURCE_OUTPUT(mo
);
1523 pa_source_output_assert_ref(o
);
1527 case PA_SOURCE_OUTPUT_MESSAGE_GET_LATENCY
: {
1528 pa_usec_t
*r
= userdata
;
1530 r
[0] += pa_bytes_to_usec(pa_memblockq_get_length(o
->thread_info
.delay_memblockq
), &o
->source
->sample_spec
);
1531 r
[1] += pa_source_get_latency_within_thread(o
->source
);
1536 case PA_SOURCE_OUTPUT_MESSAGE_SET_RATE
:
1538 o
->thread_info
.sample_spec
.rate
= PA_PTR_TO_UINT(userdata
);
1539 pa_resampler_set_output_rate(o
->thread_info
.resampler
, PA_PTR_TO_UINT(userdata
));
1542 case PA_SOURCE_OUTPUT_MESSAGE_SET_STATE
:
1544 pa_source_output_set_state_within_thread(o
, PA_PTR_TO_UINT(userdata
));
1548 case PA_SOURCE_OUTPUT_MESSAGE_SET_REQUESTED_LATENCY
: {
1549 pa_usec_t
*usec
= userdata
;
1551 *usec
= pa_source_output_set_requested_latency_within_thread(o
, *usec
);
1556 case PA_SOURCE_OUTPUT_MESSAGE_GET_REQUESTED_LATENCY
: {
1557 pa_usec_t
*r
= userdata
;
1559 *r
= o
->thread_info
.requested_source_latency
;
1563 case PA_SOURCE_OUTPUT_MESSAGE_SET_SOFT_VOLUME
:
1564 if (!pa_cvolume_equal(&o
->thread_info
.soft_volume
, &o
->soft_volume
)) {
1565 o
->thread_info
.soft_volume
= o
->soft_volume
;
1569 case PA_SOURCE_OUTPUT_MESSAGE_SET_SOFT_MUTE
:
1570 if (o
->thread_info
.muted
!= o
->muted
) {
1571 o
->thread_info
.muted
= o
->muted
;
1576 return -PA_ERR_NOTIMPLEMENTED
;
1579 /* Called from main context */
1580 void pa_source_output_send_event(pa_source_output
*o
, const char *event
, pa_proplist
*data
) {
1581 pa_proplist
*pl
= NULL
;
1582 pa_source_output_send_event_hook_data hook_data
;
1584 pa_source_output_assert_ref(o
);
1585 pa_assert_ctl_context();
1592 data
= pl
= pa_proplist_new();
1594 hook_data
.source_output
= o
;
1595 hook_data
.data
= data
;
1596 hook_data
.event
= event
;
1598 if (pa_hook_fire(&o
->core
->hooks
[PA_CORE_HOOK_SOURCE_OUTPUT_SEND_EVENT
], &hook_data
) < 0)
1601 o
->send_event(o
, event
, data
);
1605 pa_proplist_free(pl
);
1608 /* Called from main context */
1609 /* Updates the source output's resampler with whatever the current source
1610 * requires -- useful when the underlying source's rate might have changed */
1611 int pa_source_output_update_rate(pa_source_output
*o
) {
1612 pa_resampler
*new_resampler
;
1613 char *memblockq_name
;
1615 pa_source_output_assert_ref(o
);
1616 pa_assert_ctl_context();
1618 if (o
->thread_info
.resampler
&&
1619 pa_sample_spec_equal(pa_resampler_input_sample_spec(o
->thread_info
.resampler
), &o
->source
->sample_spec
) &&
1620 pa_channel_map_equal(pa_resampler_input_channel_map(o
->thread_info
.resampler
), &o
->source
->channel_map
))
1622 new_resampler
= o
->thread_info
.resampler
;
1624 else if (!pa_source_output_is_passthrough(o
) &&
1625 ((o
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ||
1626 !pa_sample_spec_equal(&o
->sample_spec
, &o
->source
->sample_spec
) ||
1627 !pa_channel_map_equal(&o
->channel_map
, &o
->source
->channel_map
))) {
1629 new_resampler
= pa_resampler_new(o
->core
->mempool
,
1630 &o
->source
->sample_spec
, &o
->source
->channel_map
,
1631 &o
->sample_spec
, &o
->channel_map
,
1632 o
->requested_resample_method
,
1633 ((o
->flags
& PA_SOURCE_OUTPUT_VARIABLE_RATE
) ? PA_RESAMPLER_VARIABLE_RATE
: 0) |
1634 ((o
->flags
& PA_SOURCE_OUTPUT_NO_REMAP
) ? PA_RESAMPLER_NO_REMAP
: 0) |
1635 (o
->core
->disable_remixing
|| (o
->flags
& PA_SOURCE_OUTPUT_NO_REMIX
) ? PA_RESAMPLER_NO_REMIX
: 0));
1637 if (!new_resampler
) {
1638 pa_log_warn("Unsupported resampling operation.");
1639 return -PA_ERR_NOTSUPPORTED
;
1642 new_resampler
= NULL
;
1644 if (new_resampler
== o
->thread_info
.resampler
)
1647 if (o
->thread_info
.resampler
)
1648 pa_resampler_free(o
->thread_info
.resampler
);
1650 o
->thread_info
.resampler
= new_resampler
;
1652 pa_memblockq_free(o
->thread_info
.delay_memblockq
);
1654 memblockq_name
= pa_sprintf_malloc("source output delay_memblockq [%u]", o
->index
);
1655 o
->thread_info
.delay_memblockq
= pa_memblockq_new(
1658 MEMBLOCKQ_MAXLENGTH
,
1660 &o
->source
->sample_spec
,
1664 &o
->source
->silence
);
1665 pa_xfree(memblockq_name
);
1667 o
->actual_resample_method
= new_resampler
? pa_resampler_get_method(new_resampler
) : PA_RESAMPLER_INVALID
;
1669 pa_log_debug("Updated resampler for source output %d", o
->index
);