code.delx.au - pulseaudio/blob - src/pulsecore/source-output.c

   1 /***
   2   This file is part of PulseAudio.
   3
   4   Copyright 2004-2006 Lennart Poettering
   5
   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 of the License,
   9   or (at your option) any later version.
  10
  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.
  15
  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
  19   USA.
  20 ***/
  21
  22 #ifdef HAVE_CONFIG_H
  23 #include <config.h>
  24 #endif
  25
  26 #include <stdio.h>
  27 #include <stdlib.h>
  28 #include <string.h>
  29
  30 #include <pulse/utf8.h>
  31 #include <pulse/xmalloc.h>
  32 #include <pulse/util.h>
  33
  34 #include <pulsecore/sample-util.h>
  35 #include <pulsecore/core-subscribe.h>
  36 #include <pulsecore/log.h>
  37 #include <pulsecore/namereg.h>
  38 #include <pulsecore/core-util.h>
  39
  40 #include "source-output.h"
  41
  42 #define MEMBLOCKQ_MAXLENGTH (32*1024*1024)
  43
  44 static PA_DEFINE_CHECK_TYPE(pa_source_output, pa_msgobject);
  45
  46 static void source_output_free(pa_object* mo);
  47
  48 pa_source_output_new_data* pa_source_output_new_data_init(pa_source_output_new_data *data) {
  49     pa_assert(data);
  50
  51     memset(data, 0, sizeof(*data));
  52     data->resample_method = PA_RESAMPLER_INVALID;
  53     data->proplist = pa_proplist_new();
  54
  55     return data;
  56 }
  57
  58 void pa_source_output_new_data_set_sample_spec(pa_source_output_new_data *data, const pa_sample_spec *spec) {
  59     pa_assert(data);
  60
  61     if ((data->sample_spec_is_set = !!spec))
  62         data->sample_spec = *spec;
  63 }
  64
  65 void pa_source_output_new_data_set_channel_map(pa_source_output_new_data *data, const pa_channel_map *map) {
  66     pa_assert(data);
  67
  68     if ((data->channel_map_is_set = !!map))
  69         data->channel_map = *map;
  70 }
  71
  72 void pa_source_output_new_data_done(pa_source_output_new_data *data) {
  73     pa_assert(data);
  74
  75     pa_proplist_free(data->proplist);
  76 }
  77
  78 /* Called from main context */
  79 static void reset_callbacks(pa_source_output *o) {
  80     pa_assert(o);
  81
  82     o->push = NULL;
  83     o->process_rewind = NULL;
  84     o->update_max_rewind = NULL;
  85     o->update_source_requested_latency = NULL;
  86     o->update_source_latency_range = NULL;
  87     o->attach = NULL;
  88     o->detach = NULL;
  89     o->suspend = NULL;
  90     o->moved = NULL;
  91     o->kill = NULL;
  92     o->get_latency = NULL;
  93     o->state_change = NULL;
  94     o->may_move_to = NULL;
  95 }
  96
  97 /* Called from main context */
  98 int pa_source_output_new(
  99         pa_source_output**_o,
 100         pa_core *core,
 101         pa_source_output_new_data *data,
 102         pa_source_output_flags_t flags) {
 103
 104     pa_source_output *o;
 105     pa_resampler *resampler = NULL;
 106     char st[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX];
 107     int r;
 108
 109     pa_assert(_o);
 110     pa_assert(core);
 111     pa_assert(data);
 112
 113     if ((r = pa_hook_fire(&core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_NEW], data)) < 0)
 114         return r;
 115
 116     pa_return_val_if_fail(!data->driver || pa_utf8_valid(data->driver), -PA_ERR_INVALID);
 117
 118     if (!data->source) {
 119         data->source = pa_namereg_get(core, NULL, PA_NAMEREG_SOURCE);
 120         data->save_source = FALSE;
 121     }
 122
 123     pa_return_val_if_fail(data->source, -PA_ERR_NOENTITY);
 124     pa_return_val_if_fail(PA_SOURCE_IS_LINKED(pa_source_get_state(data->source)), -PA_ERR_BADSTATE);
 125     pa_return_val_if_fail(!data->direct_on_input || data->direct_on_input->sink == data->source->monitor_of, -PA_ERR_INVALID);
 126     pa_return_val_if_fail(!(flags & PA_SOURCE_OUTPUT_FAIL_ON_SUSPEND) || pa_source_get_state(data->source) != PA_SOURCE_SUSPENDED, -PA_ERR_BADSTATE);
 127
 128     if (!data->sample_spec_is_set)
 129         data->sample_spec = data->source->sample_spec;
 130
 131     pa_return_val_if_fail(pa_sample_spec_valid(&data->sample_spec), -PA_ERR_INVALID);
 132
 133     if (!data->channel_map_is_set) {
 134         if (pa_channel_map_compatible(&data->source->channel_map, &data->sample_spec))
 135             data->channel_map = data->source->channel_map;
 136         else
 137             pa_channel_map_init_extend(&data->channel_map, data->sample_spec.channels, PA_CHANNEL_MAP_DEFAULT);
 138     }
 139
 140     pa_return_val_if_fail(pa_channel_map_valid(&data->channel_map), -PA_ERR_INVALID);
 141     pa_return_val_if_fail(pa_channel_map_compatible(&data->channel_map, &data->sample_spec), -PA_ERR_INVALID);
 142
 143     if (flags & PA_SOURCE_OUTPUT_FIX_FORMAT)
 144         data->sample_spec.format = data->source->sample_spec.format;
 145
 146     if (flags & PA_SOURCE_OUTPUT_FIX_RATE)
 147         data->sample_spec.rate = data->source->sample_spec.rate;
 148
 149     if (flags & PA_SOURCE_OUTPUT_FIX_CHANNELS) {
 150         data->sample_spec.channels = data->source->sample_spec.channels;
 151         data->channel_map = data->source->channel_map;
 152     }
 153
 154     pa_assert(pa_sample_spec_valid(&data->sample_spec));
 155     pa_assert(pa_channel_map_valid(&data->channel_map));
 156
 157     if (data->resample_method == PA_RESAMPLER_INVALID)
 158         data->resample_method = core->resample_method;
 159
 160     pa_return_val_if_fail(data->resample_method < PA_RESAMPLER_MAX, -PA_ERR_INVALID);
 161
 162     if (data->client)
 163         pa_proplist_update(data->proplist, PA_UPDATE_MERGE, data->client->proplist);
 164
 165     if ((r = pa_hook_fire(&core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_FIXATE], data)) < 0)
 166         return r;
 167
 168     if (pa_idxset_size(data->source->outputs) >= PA_MAX_OUTPUTS_PER_SOURCE) {
 169         pa_log("Failed to create source output: too many outputs per source.");
 170         return -PA_ERR_TOOLARGE;
 171     }
 172
 173     if ((flags & PA_SOURCE_OUTPUT_VARIABLE_RATE) ||
 174         !pa_sample_spec_equal(&data->sample_spec, &data->source->sample_spec) ||
 175         !pa_channel_map_equal(&data->channel_map, &data->source->channel_map)) {
 176
 177         if (!(resampler = pa_resampler_new(
 178                       core->mempool,
 179                       &data->source->sample_spec, &data->source->channel_map,
 180                       &data->sample_spec, &data->channel_map,
 181                       data->resample_method,
 182                       ((flags & PA_SOURCE_OUTPUT_VARIABLE_RATE) ? PA_RESAMPLER_VARIABLE_RATE : 0) |
 183                       ((flags & PA_SOURCE_OUTPUT_NO_REMAP) ? PA_RESAMPLER_NO_REMAP : 0) |
 184                       (core->disable_remixing || (flags & PA_SOURCE_OUTPUT_NO_REMIX) ? PA_RESAMPLER_NO_REMIX : 0) |
 185                       (core->disable_lfe_remixing ? PA_RESAMPLER_NO_LFE : 0)))) {
 186             pa_log_warn("Unsupported resampling operation.");
 187             return -PA_ERR_NOTSUPPORTED;
 188         }
 189     }
 190
 191     o = pa_msgobject_new(pa_source_output);
 192     o->parent.parent.free = source_output_free;
 193     o->parent.process_msg = pa_source_output_process_msg;
 194
 195     o->core = core;
 196     o->state = PA_SOURCE_OUTPUT_INIT;
 197     o->flags = flags;
 198     o->proplist = pa_proplist_copy(data->proplist);
 199     o->driver = pa_xstrdup(pa_path_get_filename(data->driver));
 200     o->module = data->module;
 201     o->source = data->source;
 202     o->client = data->client;
 203
 204     o->actual_resample_method = resampler ? pa_resampler_get_method(resampler) : PA_RESAMPLER_INVALID;
 205     o->requested_resample_method = data->resample_method;
 206     o->sample_spec = data->sample_spec;
 207     o->channel_map = data->channel_map;
 208
 209     o->direct_on_input = data->direct_on_input;
 210
 211     o->save_source = data->save_source;
 212
 213     reset_callbacks(o);
 214     o->userdata = NULL;
 215
 216     o->thread_info.state = o->state;
 217     o->thread_info.attached = FALSE;
 218     o->thread_info.sample_spec = o->sample_spec;
 219     o->thread_info.resampler = resampler;
 220     o->thread_info.requested_source_latency = (pa_usec_t) -1;
 221     o->thread_info.direct_on_input = o->direct_on_input;
 222
 223     o->thread_info.delay_memblockq = pa_memblockq_new(
 224             0,
 225             MEMBLOCKQ_MAXLENGTH,
 226             0,
 227             pa_frame_size(&o->source->sample_spec),
 228             0,
 229             1,
 230             0,
 231             &o->source->silence);
 232
 233     pa_assert_se(pa_idxset_put(core->source_outputs, o, &o->index) == 0);
 234     pa_assert_se(pa_idxset_put(o->source->outputs, pa_source_output_ref(o), NULL) == 0);
 235
 236     if (o->client)
 237         pa_assert_se(pa_idxset_put(o->client->source_outputs, o, NULL) >= 0);
 238
 239     if (o->direct_on_input)
 240         pa_assert_se(pa_idxset_put(o->direct_on_input->direct_outputs, o, NULL) == 0);
 241
 242     pa_log_info("Created output %u \"%s\" on %s with sample spec %s and channel map %s",
 243                 o->index,
 244                 pa_strnull(pa_proplist_gets(o->proplist, PA_PROP_MEDIA_NAME)),
 245                 o->source->name,
 246                 pa_sample_spec_snprint(st, sizeof(st), &o->sample_spec),
 247                 pa_channel_map_snprint(cm, sizeof(cm), &o->channel_map));
 248
 249     /* Don't forget to call pa_source_output_put! */
 250
 251     *_o = o;
 252     return 0;
 253 }
 254
 255 /* Called from main context */
 256 static void update_n_corked(pa_source_output *o, pa_source_output_state_t state) {
 257     pa_assert(o);
 258
 259     if (!o->source)
 260         return;
 261
 262     if (o->state == PA_SOURCE_OUTPUT_CORKED && state != PA_SOURCE_OUTPUT_CORKED)
 263         pa_assert_se(o->source->n_corked -- >= 1);
 264     else if (o->state != PA_SOURCE_OUTPUT_CORKED && state == PA_SOURCE_OUTPUT_CORKED)
 265         o->source->n_corked++;
 266 }
 267
 268 /* Called from main context */
 269 static void source_output_set_state(pa_source_output *o, pa_source_output_state_t state) {
 270     pa_assert(o);
 271
 272     if (o->state == state)
 273         return;
 274
 275     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);
 276
 277     update_n_corked(o, state);
 278     o->state = state;
 279
 280     if (state != PA_SOURCE_OUTPUT_UNLINKED)
 281         pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_STATE_CHANGED], o);
 282
 283     pa_source_update_status(o->source);
 284 }
 285
 286 /* Called from main context */
 287 void pa_source_output_unlink(pa_source_output*o) {
 288     pa_bool_t linked;
 289     pa_assert(o);
 290
 291     /* See pa_sink_unlink() for a couple of comments how this function
 292      * works */
 293
 294     pa_source_output_ref(o);
 295
 296     linked = PA_SOURCE_OUTPUT_IS_LINKED(o->state);
 297
 298     if (linked)
 299         pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK], o);
 300
 301     if (o->direct_on_input)
 302         pa_idxset_remove_by_data(o->direct_on_input->direct_outputs, o, NULL);
 303
 304     pa_idxset_remove_by_data(o->core->source_outputs, o, NULL);
 305
 306     if (o->source)
 307         if (pa_idxset_remove_by_data(o->source->outputs, o, NULL))
 308             pa_source_output_unref(o);
 309
 310     if (o->client)
 311         pa_idxset_remove_by_data(o->client->source_outputs, o, NULL);
 312
 313     update_n_corked(o, PA_SOURCE_OUTPUT_UNLINKED);
 314     o->state = PA_SOURCE_OUTPUT_UNLINKED;
 315
 316     if (linked && o->source)
 317         if (o->source->asyncmsgq)
 318             pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o->source), PA_SOURCE_MESSAGE_REMOVE_OUTPUT, o, 0, NULL) == 0);
 319
 320     reset_callbacks(o);
 321
 322     if (linked) {
 323         pa_subscription_post(o->core, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT|PA_SUBSCRIPTION_EVENT_REMOVE, o->index);
 324         pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK_POST], o);
 325     }
 326
 327     if (o->source) {
 328         pa_source_update_status(o->source);
 329         o->source = NULL;
 330     }
 331
 332     pa_source_output_unref(o);
 333 }
 334
 335 /* Called from main context */
 336 static void source_output_free(pa_object* mo) {
 337     pa_source_output *o = PA_SOURCE_OUTPUT(mo);
 338
 339     pa_assert(o);
 340     pa_assert(pa_source_output_refcnt(o) == 0);
 341
 342     if (PA_SOURCE_OUTPUT_IS_LINKED(o->state))
 343         pa_source_output_unlink(o);
 344
 345     pa_log_info("Freeing output %u \"%s\"", o->index, pa_strnull(pa_proplist_gets(o->proplist, PA_PROP_MEDIA_NAME)));
 346
 347     pa_assert(!o->thread_info.attached);
 348
 349     if (o->thread_info.delay_memblockq)
 350         pa_memblockq_free(o->thread_info.delay_memblockq);
 351
 352     if (o->thread_info.resampler)
 353         pa_resampler_free(o->thread_info.resampler);
 354
 355     if (o->proplist)
 356         pa_proplist_free(o->proplist);
 357
 358     pa_xfree(o->driver);
 359     pa_xfree(o);
 360 }
 361
 362 /* Called from main context */
 363 void pa_source_output_put(pa_source_output *o) {
 364     pa_source_output_state_t state;
 365     pa_source_output_assert_ref(o);
 366
 367     pa_assert(o->state == PA_SOURCE_OUTPUT_INIT);
 368
 369     /* The following fields must be initialized properly */
 370     pa_assert(o->push);
 371     pa_assert(o->kill);
 372
 373     state = o->flags & PA_SOURCE_OUTPUT_START_CORKED ? PA_SOURCE_OUTPUT_CORKED : PA_SOURCE_OUTPUT_RUNNING;
 374
 375     update_n_corked(o, state);
 376     o->state = state;
 377
 378     pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o->source), PA_SOURCE_MESSAGE_ADD_OUTPUT, o, 0, NULL) == 0);
 379
 380     pa_subscription_post(o->core, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT|PA_SUBSCRIPTION_EVENT_NEW, o->index);
 381     pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_PUT], o);
 382
 383     pa_source_update_status(o->source);
 384 }
 385
 386 /* Called from main context */
 387 void pa_source_output_kill(pa_source_output*o) {
 388     pa_source_output_assert_ref(o);
 389     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 390
 391     o->kill(o);
 392 }
 393
 394 /* Called from main context */
 395 pa_usec_t pa_source_output_get_latency(pa_source_output *o, pa_usec_t *source_latency) {
 396     pa_usec_t r[2] = { 0, 0 };
 397
 398     pa_source_output_assert_ref(o);
 399     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 400
 401     pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o), PA_SOURCE_OUTPUT_MESSAGE_GET_LATENCY, r, 0, NULL) == 0);
 402
 403     if (o->get_latency)
 404         r[0] += o->get_latency(o);
 405
 406     if (source_latency)
 407         *source_latency = r[1];
 408
 409     return r[0];
 410 }
 411
 412 /* Called from thread context */
 413 void pa_source_output_push(pa_source_output *o, const pa_memchunk *chunk) {
 414     size_t length;
 415     size_t limit, mbs = 0;
 416
 417     pa_source_output_assert_ref(o);
 418     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->thread_info.state));
 419     pa_assert(chunk);
 420     pa_assert(pa_frame_aligned(chunk->length, &o->source->sample_spec));
 421
 422     if (!o->push || o->thread_info.state == PA_SOURCE_OUTPUT_CORKED)
 423         return;
 424
 425     pa_assert(o->thread_info.state == PA_SOURCE_OUTPUT_RUNNING);
 426
 427     if (pa_memblockq_push(o->thread_info.delay_memblockq, chunk) < 0) {
 428         pa_log_debug("Delay queue overflow!");
 429         pa_memblockq_seek(o->thread_info.delay_memblockq, (int64_t) chunk->length, PA_SEEK_RELATIVE);
 430     }
 431
 432     limit = o->process_rewind ? 0 : o->source->thread_info.max_rewind;
 433
 434     /* Implement the delay queue */
 435     while ((length = pa_memblockq_get_length(o->thread_info.delay_memblockq)) > limit) {
 436         pa_memchunk qchunk;
 437
 438         length -= limit;
 439
 440         pa_assert_se(pa_memblockq_peek(o->thread_info.delay_memblockq, &qchunk) >= 0);
 441
 442         if (qchunk.length > length)
 443             qchunk.length = length;
 444
 445         pa_assert(qchunk.length > 0);
 446
 447         if (!o->thread_info.resampler)
 448             o->push(o, &qchunk);
 449         else {
 450             pa_memchunk rchunk;
 451
 452             if (mbs == 0)
 453                 mbs = pa_resampler_max_block_size(o->thread_info.resampler);
 454
 455             if (qchunk.length > mbs)
 456                 qchunk.length = mbs;
 457
 458             pa_resampler_run(o->thread_info.resampler, &qchunk, &rchunk);
 459
 460             if (rchunk.length > 0)
 461                 o->push(o, &rchunk);
 462
 463             if (rchunk.memblock)
 464                 pa_memblock_unref(rchunk.memblock);
 465         }
 466
 467         pa_memblock_unref(qchunk.memblock);
 468         pa_memblockq_drop(o->thread_info.delay_memblockq, qchunk.length);
 469     }
 470 }
 471
 472 /* Called from thread context */
 473 void pa_source_output_process_rewind(pa_source_output *o, size_t nbytes /* in source sample spec */) {
 474     pa_source_output_assert_ref(o);
 475
 476     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->thread_info.state));
 477     pa_assert(pa_frame_aligned(nbytes, &o->source->sample_spec));
 478
 479     if (nbytes <= 0)
 480         return;
 481
 482     if (o->process_rewind) {
 483         pa_assert(pa_memblockq_get_length(o->thread_info.delay_memblockq) == 0);
 484
 485         if (o->thread_info.resampler)
 486             nbytes = pa_resampler_result(o->thread_info.resampler, nbytes);
 487
 488         pa_log_debug("Have to rewind %lu bytes on implementor.", (unsigned long) nbytes);
 489
 490         if (nbytes > 0)
 491             o->process_rewind(o, nbytes);
 492
 493         if (o->thread_info.resampler)
 494             pa_resampler_reset(o->thread_info.resampler);
 495
 496     } else
 497         pa_memblockq_rewind(o->thread_info.delay_memblockq, nbytes);
 498 }
 499
 500 /* Called from thread context */
 501 void pa_source_output_update_max_rewind(pa_source_output *o, size_t nbytes  /* in the source's sample spec */) {
 502     pa_source_output_assert_ref(o);
 503     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->thread_info.state));
 504     pa_assert(pa_frame_aligned(nbytes, &o->source->sample_spec));
 505
 506     if (o->update_max_rewind)
 507         o->update_max_rewind(o, o->thread_info.resampler ? pa_resampler_result(o->thread_info.resampler, nbytes) : nbytes);
 508 }
 509
 510 /* Called from thread context */
 511 static pa_usec_t fixup_latency(pa_source *s, pa_usec_t usec) {
 512     pa_source_assert_ref(s);
 513
 514     if (usec == (pa_usec_t) -1)
 515         return usec;
 516
 517     if (s->thread_info.max_latency > 0 && usec > s->thread_info.max_latency)
 518         usec = s->thread_info.max_latency;
 519
 520     if (s->thread_info.min_latency > 0 && usec < s->thread_info.min_latency)
 521         usec = s->thread_info.min_latency;
 522
 523     return usec;
 524 }
 525
 526 /* Called from thread context */
 527 pa_usec_t pa_source_output_set_requested_latency_within_thread(pa_source_output *o, pa_usec_t usec) {
 528     pa_source_output_assert_ref(o);
 529
 530     usec = fixup_latency(o->source, usec);
 531     o->thread_info.requested_source_latency = usec;
 532     pa_source_invalidate_requested_latency(o->source);
 533
 534     return usec;
 535 }
 536
 537 /* Called from main context */
 538 pa_usec_t pa_source_output_set_requested_latency(pa_source_output *o, pa_usec_t usec) {
 539     pa_source_output_assert_ref(o);
 540
 541     if (PA_SOURCE_OUTPUT_IS_LINKED(o->state))
 542         pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o), PA_SOURCE_OUTPUT_MESSAGE_SET_REQUESTED_LATENCY, &usec, 0, NULL) == 0);
 543     else
 544         /* If this source output is not realized yet, we have to touch
 545          * the thread info data directly */
 546
 547         o->thread_info.requested_source_latency = usec;
 548
 549     return usec;
 550 }
 551
 552 /* Called from main context */
 553 pa_usec_t pa_source_output_get_requested_latency(pa_source_output *o) {
 554     pa_usec_t usec = 0;
 555
 556     pa_source_output_assert_ref(o);
 557
 558     if (PA_SOURCE_OUTPUT_IS_LINKED(o->state))
 559         pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o), PA_SOURCE_OUTPUT_MESSAGE_GET_REQUESTED_LATENCY, &usec, 0, NULL) == 0);
 560     else
 561         /* If this source output is not realized yet, we have to touch
 562          * the thread info data directly */
 563         usec = o->thread_info.requested_source_latency;
 564
 565     return usec;
 566 }
 567
 568 /* Called from main context */
 569 void pa_source_output_cork(pa_source_output *o, pa_bool_t b) {
 570     pa_source_output_assert_ref(o);
 571     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 572
 573     source_output_set_state(o, b ? PA_SOURCE_OUTPUT_CORKED : PA_SOURCE_OUTPUT_RUNNING);
 574 }
 575
 576 /* Called from main context */
 577 int pa_source_output_set_rate(pa_source_output *o, uint32_t rate) {
 578     pa_source_output_assert_ref(o);
 579     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 580     pa_return_val_if_fail(o->thread_info.resampler, -PA_ERR_BADSTATE);
 581
 582     if (o->sample_spec.rate == rate)
 583         return 0;
 584
 585     o->sample_spec.rate = rate;
 586
 587     pa_asyncmsgq_post(o->source->asyncmsgq, PA_MSGOBJECT(o), PA_SOURCE_OUTPUT_MESSAGE_SET_RATE, PA_UINT_TO_PTR(rate), 0, NULL, NULL);
 588
 589     pa_subscription_post(o->core, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT|PA_SUBSCRIPTION_EVENT_CHANGE, o->index);
 590     return 0;
 591 }
 592
 593 /* Called from main context */
 594 void pa_source_output_set_name(pa_source_output *o, const char *name) {
 595     const char *old;
 596     pa_source_output_assert_ref(o);
 597
 598     if (!name && !pa_proplist_contains(o->proplist, PA_PROP_MEDIA_NAME))
 599         return;
 600
 601     old = pa_proplist_gets(o->proplist, PA_PROP_MEDIA_NAME);
 602
 603     if (old && name && !strcmp(old, name))
 604         return;
 605
 606     if (name)
 607         pa_proplist_sets(o->proplist, PA_PROP_MEDIA_NAME, name);
 608     else
 609         pa_proplist_unset(o->proplist, PA_PROP_MEDIA_NAME);
 610
 611     if (PA_SOURCE_OUTPUT_IS_LINKED(o->state)) {
 612         pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED], o);
 613         pa_subscription_post(o->core, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT|PA_SUBSCRIPTION_EVENT_CHANGE, o->index);
 614     }
 615 }
 616
 617 /* Called from main thread */
 618 pa_bool_t pa_source_output_update_proplist(pa_source_output *o, pa_update_mode_t mode, pa_proplist *p) {
 619
 620   pa_source_output_assert_ref(o);
 621
 622   pa_proplist_update(o->proplist, mode, p);
 623
 624   if (PA_SINK_IS_LINKED(o->state)) {
 625     pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED], o);
 626     pa_subscription_post(o->core, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT|PA_SUBSCRIPTION_EVENT_CHANGE, o->index);
 627   }
 628
 629   return TRUE;
 630 }
 631
 632 /* Called from main context */
 633 pa_resample_method_t pa_source_output_get_resample_method(pa_source_output *o) {
 634     pa_source_output_assert_ref(o);
 635
 636     return o->actual_resample_method;
 637 }
 638
 639 /* Called from main context */
 640 pa_bool_t pa_source_output_may_move(pa_source_output *o) {
 641     pa_source_output_assert_ref(o);
 642     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 643
 644     if (o->flags & PA_SOURCE_OUTPUT_DONT_MOVE)
 645         return FALSE;
 646
 647     if (o->direct_on_input)
 648         return FALSE;
 649
 650     return TRUE;
 651 }
 652
 653 /* Called from main context */
 654 pa_bool_t pa_source_output_may_move_to(pa_source_output *o, pa_source *dest) {
 655     pa_source_output_assert_ref(o);
 656     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 657     pa_source_assert_ref(dest);
 658
 659     if (dest == o->source)
 660         return TRUE;
 661
 662     if (!pa_source_output_may_move(o))
 663         return FALSE;
 664
 665     if (pa_idxset_size(dest->outputs) >= PA_MAX_OUTPUTS_PER_SOURCE) {
 666         pa_log_warn("Failed to move source output: too many outputs per source.");
 667         return FALSE;
 668     }
 669
 670     if (o->may_move_to)
 671         if (!o->may_move_to(o, dest))
 672             return FALSE;
 673
 674     return TRUE;
 675 }
 676
 677 /* Called from main context */
 678 int pa_source_output_start_move(pa_source_output *o) {
 679     pa_source *origin;
 680     int r;
 681
 682     pa_source_output_assert_ref(o);
 683     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 684     pa_assert(o->source);
 685
 686     if (!pa_source_output_may_move(o))
 687         return -PA_ERR_NOTSUPPORTED;
 688
 689     if ((r = pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_START], o)) < 0)
 690         return r;
 691
 692     origin = o->source;
 693
 694     pa_idxset_remove_by_data(o->source->outputs, o, NULL);
 695
 696     if (pa_source_output_get_state(o) == PA_SOURCE_OUTPUT_CORKED)
 697         pa_assert_se(origin->n_corked-- >= 1);
 698
 699     pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o->source), PA_SOURCE_MESSAGE_REMOVE_OUTPUT, o, 0, NULL) == 0);
 700
 701     pa_source_update_status(o->source);
 702     o->source = NULL;
 703
 704     return 0;
 705 }
 706
 707 /* Called from main context */
 708 int pa_source_output_finish_move(pa_source_output *o, pa_source *dest, pa_bool_t save) {
 709     pa_resampler *new_resampler;
 710
 711     pa_source_output_assert_ref(o);
 712     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 713     pa_assert(!o->source);
 714     pa_source_assert_ref(dest);
 715
 716     if (!pa_source_output_may_move_to(o, dest))
 717         return -1;
 718
 719     if (o->thread_info.resampler &&
 720         pa_sample_spec_equal(pa_resampler_input_sample_spec(o->thread_info.resampler), &dest->sample_spec) &&
 721         pa_channel_map_equal(pa_resampler_input_channel_map(o->thread_info.resampler), &dest->channel_map))
 722
 723         /* Try to reuse the old resampler if possible */
 724         new_resampler = o->thread_info.resampler;
 725
 726     else if ((o->flags & PA_SOURCE_OUTPUT_VARIABLE_RATE) ||
 727              !pa_sample_spec_equal(&o->sample_spec, &dest->sample_spec) ||
 728              !pa_channel_map_equal(&o->channel_map, &dest->channel_map)) {
 729
 730         /* Okey, we need a new resampler for the new source */
 731
 732         if (!(new_resampler = pa_resampler_new(
 733                       o->core->mempool,
 734                       &dest->sample_spec, &dest->channel_map,
 735                       &o->sample_spec, &o->channel_map,
 736                       o->requested_resample_method,
 737                       ((o->flags & PA_SOURCE_OUTPUT_VARIABLE_RATE) ? PA_RESAMPLER_VARIABLE_RATE : 0) |
 738                       ((o->flags & PA_SOURCE_OUTPUT_NO_REMAP) ? PA_RESAMPLER_NO_REMAP : 0) |
 739                       (o->core->disable_remixing || (o->flags & PA_SOURCE_OUTPUT_NO_REMIX) ? PA_RESAMPLER_NO_REMIX : 0)))) {
 740             pa_log_warn("Unsupported resampling operation.");
 741             return -PA_ERR_NOTSUPPORTED;
 742         }
 743     } else
 744         new_resampler = NULL;
 745
 746     o->source = dest;
 747     o->save_source = save;
 748     pa_idxset_put(o->source->outputs, o, NULL);
 749
 750     if (pa_source_output_get_state(o) == PA_SOURCE_OUTPUT_CORKED)
 751         o->source->n_corked++;
 752
 753     /* Replace resampler */
 754     if (new_resampler != o->thread_info.resampler) {
 755         if (o->thread_info.resampler)
 756             pa_resampler_free(o->thread_info.resampler);
 757         o->thread_info.resampler = new_resampler;
 758
 759         pa_memblockq_free(o->thread_info.delay_memblockq);
 760
 761         o->thread_info.delay_memblockq = pa_memblockq_new(
 762                 0,
 763                 MEMBLOCKQ_MAXLENGTH,
 764                 0,
 765                 pa_frame_size(&o->source->sample_spec),
 766                 0,
 767                 1,
 768                 0,
 769                 &o->source->silence);
 770     }
 771
 772     pa_source_update_status(dest);
 773     pa_assert_se(pa_asyncmsgq_send(o->source->asyncmsgq, PA_MSGOBJECT(o->source), PA_SOURCE_MESSAGE_ADD_OUTPUT, o, 0, NULL) == 0);
 774
 775     pa_log_debug("Successfully moved source output %i to %s.", o->index, dest->name);
 776
 777     /* Notify everyone */
 778     if (o->moved)
 779         o->moved(o);
 780
 781     pa_hook_fire(&o->core->hooks[PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FINISH], o);
 782     pa_subscription_post(o->core, PA_SUBSCRIPTION_EVENT_SOURCE_OUTPUT|PA_SUBSCRIPTION_EVENT_CHANGE, o->index);
 783
 784     return 0;
 785 }
 786
 787 /* Called from main context */
 788 int pa_source_output_move_to(pa_source_output *o, pa_source *dest, pa_bool_t save) {
 789     int r;
 790
 791     pa_source_output_assert_ref(o);
 792     pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(o->state));
 793     pa_assert(o->source);
 794     pa_source_assert_ref(dest);
 795
 796     if (dest == o->source)
 797         return 0;
 798
 799     if (!pa_source_output_may_move_to(o, dest))
 800         return -PA_ERR_NOTSUPPORTED;
 801
 802     if ((r = pa_source_output_start_move(o)) < 0)
 803         return r;
 804
 805     if ((r = pa_source_output_finish_move(o, dest, save)) < 0)
 806         return r;
 807
 808     return 0;
 809 }
 810
 811 /* Called from IO thread context */
 812 void pa_source_output_set_state_within_thread(pa_source_output *o, pa_source_output_state_t state) {
 813     pa_source_output_assert_ref(o);
 814
 815     if (state == o->thread_info.state)
 816         return;
 817
 818     if (o->state_change)
 819         o->state_change(o, state);
 820
 821     o->thread_info.state = state;
 822 }
 823
 824 /* Called from IO thread context, except when it is not */
 825 int pa_source_output_process_msg(pa_msgobject *mo, int code, void *userdata, int64_t offset, pa_memchunk* chunk) {
 826     pa_source_output *o = PA_SOURCE_OUTPUT(mo);
 827     pa_source_output_assert_ref(o);
 828
 829     switch (code) {
 830
 831         case PA_SOURCE_OUTPUT_MESSAGE_GET_LATENCY: {
 832             pa_usec_t *r = userdata;
 833             pa_usec_t source_usec = 0;
 834
 835             r[0] += pa_bytes_to_usec(pa_memblockq_get_length(o->thread_info.delay_memblockq), &o->source->sample_spec);
 836
 837             if (o->source->parent.process_msg(PA_MSGOBJECT(o->source), PA_SOURCE_MESSAGE_GET_LATENCY, &source_usec, 0, NULL) >= 0)
 838                 r[1] += source_usec;
 839
 840             return 0;
 841         }
 842
 843         case PA_SOURCE_OUTPUT_MESSAGE_SET_RATE:
 844
 845             o->thread_info.sample_spec.rate = PA_PTR_TO_UINT(userdata);
 846             pa_resampler_set_output_rate(o->thread_info.resampler, PA_PTR_TO_UINT(userdata));
 847             return 0;
 848
 849         case PA_SOURCE_OUTPUT_MESSAGE_SET_STATE:
 850
 851             pa_source_output_set_state_within_thread(o, PA_PTR_TO_UINT(userdata));
 852             return 0;
 853
 854         case PA_SOURCE_OUTPUT_MESSAGE_SET_REQUESTED_LATENCY: {
 855             pa_usec_t *usec = userdata;
 856
 857             *usec = pa_source_output_set_requested_latency_within_thread(o, *usec);
 858
 859             return 0;
 860         }
 861
 862         case PA_SOURCE_OUTPUT_MESSAGE_GET_REQUESTED_LATENCY: {
 863             pa_usec_t *r = userdata;
 864
 865             *r = o->thread_info.requested_source_latency;
 866             return 0;
 867         }
 868     }
 869
 870     return -PA_ERR_NOTIMPLEMENTED;
 871 }