src/lib/player.cc

   1 /*
   2     Copyright (C) 2013-2021 Carl Hetherington <cth@carlh.net>
   3
   4     This file is part of DCP-o-matic.
   5
   6     DCP-o-matic is free software; you can redistribute it and/or modify
   7     it under the terms of the GNU General Public License as published by
   8     the Free Software Foundation; either version 2 of the License, or
   9     (at your option) any later version.
  10
  11     DCP-o-matic is distributed in the hope that it will be useful,
  12     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14     GNU General Public License for more details.
  15
  16     You should have received a copy of the GNU General Public License
  17     along with DCP-o-matic.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 */
  20
  21
  22 #include "atmos_decoder.h"
  23 #include "audio_buffers.h"
  24 #include "audio_content.h"
  25 #include "audio_decoder.h"
  26 #include "audio_processor.h"
  27 #include "compose.hpp"
  28 #include "config.h"
  29 #include "content_audio.h"
  30 #include "content_video.h"
  31 #include "dcp_content.h"
  32 #include "dcp_decoder.h"
  33 #include "dcpomatic_log.h"
  34 #include "decoder.h"
  35 #include "decoder_factory.h"
  36 #include "ffmpeg_content.h"
  37 #include "film.h"
  38 #include "frame_rate_change.h"
  39 #include "image.h"
  40 #include "image_decoder.h"
  41 #include "job.h"
  42 #include "log.h"
  43 #include "maths_util.h"
  44 #include "piece.h"
  45 #include "player.h"
  46 #include "player_video.h"
  47 #include "playlist.h"
  48 #include "ratio.h"
  49 #include "raw_image_proxy.h"
  50 #include "render_text.h"
  51 #include "shuffler.h"
  52 #include "text_content.h"
  53 #include "text_decoder.h"
  54 #include "timer.h"
  55 #include "video_decoder.h"
  56 #include <dcp/reel.h>
  57 #include <dcp/reel_closed_caption_asset.h>
  58 #include <dcp/reel_picture_asset.h>
  59 #include <dcp/reel_sound_asset.h>
  60 #include <dcp/reel_subtitle_asset.h>
  61 #include <algorithm>
  62 #include <iostream>
  63 #include <stdint.h>
  64
  65 #include "i18n.h"
  66
  67
  68 using std::copy;
  69 using std::cout;
  70 using std::dynamic_pointer_cast;
  71 using std::list;
  72 using std::make_pair;
  73 using std::make_shared;
  74 using std::make_shared;
  75 using std::max;
  76 using std::min;
  77 using std::min;
  78 using std::pair;
  79 using std::shared_ptr;
  80 using std::vector;
  81 using std::weak_ptr;
  82 using boost::optional;
  83 using boost::scoped_ptr;
  84 #if BOOST_VERSION >= 106100
  85 using namespace boost::placeholders;
  86 #endif
  87 using namespace dcpomatic;
  88
  89
  90 int const PlayerProperty::VIDEO_CONTAINER_SIZE = 700;
  91 int const PlayerProperty::PLAYLIST = 701;
  92 int const PlayerProperty::FILM_CONTAINER = 702;
  93 int const PlayerProperty::FILM_VIDEO_FRAME_RATE = 703;
  94 int const PlayerProperty::DCP_DECODE_REDUCTION = 704;
  95 int const PlayerProperty::PLAYBACK_LENGTH = 705;
  96 int const PlayerProperty::IGNORE_VIDEO = 706;
  97 int const PlayerProperty::IGNORE_AUDIO = 707;
  98 int const PlayerProperty::IGNORE_TEXT = 708;
  99 int const PlayerProperty::ALWAYS_BURN_OPEN_SUBTITLES = 709;
 100 int const PlayerProperty::PLAY_REFERENCED = 710;
 101
 102
 103 Player::Player (shared_ptr<const Film> film, Image::Alignment subtitle_alignment)
 104         : _film (film)
 105         , _suspended (0)
 106         , _ignore_video(false)
 107         , _ignore_audio(false)
 108         , _ignore_text(false)
 109         , _always_burn_open_subtitles(false)
 110         , _fast(false)
 111         , _tolerant (film->tolerant())
 112         , _play_referenced(false)
 113         , _audio_merger(film->audio_frame_rate())
 114         , _subtitle_alignment (subtitle_alignment)
 115 {
 116         construct ();
 117 }
 118
 119
 120 Player::Player (shared_ptr<const Film> film, shared_ptr<const Playlist> playlist_)
 121         : _film (film)
 122         , _playlist (playlist_)
 123         , _suspended (0)
 124         , _ignore_video(false)
 125         , _ignore_audio(false)
 126         , _ignore_text(false)
 127         , _always_burn_open_subtitles(false)
 128         , _fast(false)
 129         , _tolerant (film->tolerant())
 130         , _play_referenced(false)
 131         , _audio_merger(film->audio_frame_rate())
 132 {
 133         construct ();
 134 }
 135
 136
 137 void
 138 Player::construct ()
 139 {
 140         auto film = _film.lock();
 141         DCPOMATIC_ASSERT(film);
 142
 143         connect();
 144         set_video_container_size(film->frame_size());
 145
 146         film_change (ChangeType::DONE, Film::Property::AUDIO_PROCESSOR);
 147
 148         setup_pieces ();
 149         seek (DCPTime (), true);
 150 }
 151
 152
 153 void
 154 Player::connect()
 155 {
 156         auto film = _film.lock();
 157         DCPOMATIC_ASSERT(film);
 158
 159         _film_changed_connection = film->Change.connect(bind(&Player::film_change, this, _1, _2));
 160         /* The butler must hear about this first, so since we are proxying this through to the butler we must
 161            be first.
 162         */
 163         _playlist_change_connection = playlist()->Change.connect (bind (&Player::playlist_change, this, _1), boost::signals2::at_front);
 164         _playlist_content_change_connection = playlist()->ContentChange.connect (bind(&Player::playlist_content_change, this, _1, _3, _4));
 165 }
 166
 167
 168 Player::Player(Player&& other)
 169         : _film(other._film)
 170         , _playlist(std::move(other._playlist))
 171         , _suspended(other._suspended.load())
 172         , _pieces(std::move(other._pieces))
 173         , _video_container_size(other._video_container_size.load())
 174         , _black_image(std::move(other._black_image))
 175         , _ignore_video(other._ignore_video.load())
 176         , _ignore_audio(other._ignore_audio.load())
 177         , _ignore_text(other._ignore_text.load())
 178         , _always_burn_open_subtitles(other._always_burn_open_subtitles.load())
 179         , _fast(other._fast.load())
 180         , _tolerant(other._tolerant)
 181         , _play_referenced(other._play_referenced.load())
 182         , _next_video_time(other._next_video_time)
 183         , _next_audio_time(other._next_audio_time)
 184         , _dcp_decode_reduction(other._dcp_decode_reduction.load())
 185         , _last_video(std::move(other._last_video))
 186         , _audio_merger(std::move(other._audio_merger))
 187         , _shuffler(std::move(other._shuffler))
 188         , _delay(std::move(other._delay))
 189         , _stream_states(std::move(other._stream_states))
 190         , _black(std::move(other._black))
 191         , _silent(std::move(other._silent))
 192         , _active_texts(std::move(other._active_texts))
 193         , _audio_processor(std::move(other._audio_processor))
 194         , _playback_length(other._playback_length.load())
 195         , _subtitle_alignment(other._subtitle_alignment)
 196 {
 197         connect();
 198 }
 199
 200
 201 Player&
 202 Player::operator=(Player&& other)
 203 {
 204         if (this == &other) {
 205                 return *this;
 206         }
 207
 208         _film = std::move(other._film);
 209         _playlist = std::move(other._playlist);
 210         _suspended = other._suspended.load();
 211         _pieces = std::move(other._pieces);
 212         _video_container_size = other._video_container_size.load();
 213         _black_image = std::move(other._black_image);
 214         _ignore_video = other._ignore_video.load();
 215         _ignore_audio = other._ignore_audio.load();
 216         _ignore_text = other._ignore_text.load();
 217         _always_burn_open_subtitles = other._always_burn_open_subtitles.load();
 218         _fast = other._fast.load();
 219         _tolerant = other._tolerant;
 220         _play_referenced = other._play_referenced.load();
 221         _next_video_time = other._next_video_time;
 222         _next_audio_time = other._next_audio_time;
 223         _dcp_decode_reduction = other._dcp_decode_reduction.load();
 224         _last_video = std::move(other._last_video);
 225         _audio_merger = std::move(other._audio_merger);
 226         _shuffler = std::move(other._shuffler);
 227         _delay = std::move(other._delay);
 228         _stream_states = std::move(other._stream_states);
 229         _black = std::move(other._black);
 230         _silent = std::move(other._silent);
 231         _active_texts = std::move(other._active_texts);
 232         _audio_processor = std::move(other._audio_processor);
 233         _playback_length = other._playback_length.load();
 234         _subtitle_alignment = other._subtitle_alignment;
 235
 236         connect();
 237
 238         return *this;
 239 }
 240
 241
 242 bool
 243 have_video (shared_ptr<const Content> content)
 244 {
 245         return static_cast<bool>(content->video) && content->video->use() && content->can_be_played();
 246 }
 247
 248
 249 bool
 250 have_audio (shared_ptr<const Content> content)
 251 {
 252         return static_cast<bool>(content->audio) && content->can_be_played();
 253 }
 254
 255
 256 void
 257 Player::setup_pieces ()
 258 {
 259         boost::mutex::scoped_lock lm (_mutex);
 260
 261         auto old_pieces = _pieces;
 262         _pieces.clear ();
 263
 264         auto film = _film.lock();
 265         if (!film) {
 266                 return;
 267         }
 268
 269         _playback_length = _playlist ? _playlist->length(film) : film->length();
 270
 271         auto playlist_content = playlist()->content();
 272         bool const have_threed = std::any_of(
 273                 playlist_content.begin(),
 274                 playlist_content.end(),
 275                 [](shared_ptr<const Content> c) {
 276                         return c->video && (c->video->frame_type() == VideoFrameType::THREE_D_LEFT || c->video->frame_type() == VideoFrameType::THREE_D_RIGHT);
 277                 });
 278
 279
 280         if (have_threed) {
 281                 _shuffler.reset(new Shuffler());
 282                 _shuffler->Video.connect(bind(&Player::video, this, _1, _2));
 283         }
 284
 285         for (auto content: playlist()->content()) {
 286
 287                 if (!content->paths_valid()) {
 288                         continue;
 289                 }
 290
 291                 if (_ignore_video && _ignore_audio && content->text.empty()) {
 292                         /* We're only interested in text and this content has none */
 293                         continue;
 294                 }
 295
 296                 shared_ptr<Decoder> old_decoder;
 297                 for (auto j: old_pieces) {
 298                         if (j->content == content) {
 299                                 old_decoder = j->decoder;
 300                                 break;
 301                         }
 302                 }
 303
 304                 auto decoder = decoder_factory(film, content, _fast, _tolerant, old_decoder);
 305                 DCPOMATIC_ASSERT (decoder);
 306
 307                 FrameRateChange frc(film, content);
 308
 309                 if (decoder->video && _ignore_video) {
 310                         decoder->video->set_ignore (true);
 311                 }
 312
 313                 if (decoder->audio && _ignore_audio) {
 314                         decoder->audio->set_ignore (true);
 315                 }
 316
 317                 if (_ignore_text) {
 318                         for (auto i: decoder->text) {
 319                                 i->set_ignore (true);
 320                         }
 321                 }
 322
 323                 auto dcp = dynamic_pointer_cast<DCPDecoder> (decoder);
 324                 if (dcp) {
 325                         dcp->set_decode_referenced (_play_referenced);
 326                         if (_play_referenced) {
 327                                 dcp->set_forced_reduction (_dcp_decode_reduction);
 328                         }
 329                 }
 330
 331                 auto piece = make_shared<Piece>(content, decoder, frc);
 332                 _pieces.push_back (piece);
 333
 334                 if (decoder->video) {
 335                         if (have_threed) {
 336                                 /* We need a Shuffler to cope with 3D L/R video data arriving out of sequence */
 337                                 decoder->video->Data.connect (bind(&Shuffler::video, _shuffler.get(), weak_ptr<Piece>(piece), _1));
 338                         } else {
 339                                 decoder->video->Data.connect (bind(&Player::video, this, weak_ptr<Piece>(piece), _1));
 340                         }
 341                 }
 342
 343                 if (decoder->audio) {
 344                         decoder->audio->Data.connect (bind (&Player::audio, this, weak_ptr<Piece> (piece), _1, _2));
 345                 }
 346
 347                 auto j = decoder->text.begin();
 348
 349                 while (j != decoder->text.end()) {
 350                         (*j)->BitmapStart.connect (
 351                                 bind(&Player::bitmap_text_start, this, weak_ptr<Piece>(piece), weak_ptr<const TextContent>((*j)->content()), _1)
 352                                 );
 353                         (*j)->PlainStart.connect (
 354                                 bind(&Player::plain_text_start, this, weak_ptr<Piece>(piece), weak_ptr<const TextContent>((*j)->content()), _1)
 355                                 );
 356                         (*j)->Stop.connect (
 357                                 bind(&Player::subtitle_stop, this, weak_ptr<Piece>(piece), weak_ptr<const TextContent>((*j)->content()), _1)
 358                                 );
 359
 360                         ++j;
 361                 }
 362
 363                 if (decoder->atmos) {
 364                         decoder->atmos->Data.connect (bind(&Player::atmos, this, weak_ptr<Piece>(piece), _1));
 365                 }
 366         }
 367
 368         _stream_states.clear ();
 369         for (auto i: _pieces) {
 370                 if (i->content->audio) {
 371                         for (auto j: i->content->audio->streams()) {
 372                                 _stream_states[j] = StreamState(i);
 373                         }
 374                 }
 375         }
 376
 377         auto ignore_overlap = [](shared_ptr<VideoContent> v) {
 378                 return v && v->use() && v->frame_type() != VideoFrameType::THREE_D_LEFT && v->frame_type() != VideoFrameType::THREE_D_RIGHT;
 379         };
 380
 381         for (auto piece = _pieces.begin(); piece != _pieces.end(); ++piece) {
 382                 if (ignore_overlap((*piece)->content->video)) {
 383                         /* Look for content later in the content list with in-use video that overlaps this */
 384                         auto const period = (*piece)->content->period(film);
 385                         for (auto later_piece = std::next(piece); later_piece != _pieces.end(); ++later_piece) {
 386                                 if (ignore_overlap((*later_piece)->content->video)) {
 387                                         (*piece)->ignore_video = (*later_piece)->content->period(film).overlap(period);
 388                                 }
 389                         }
 390                 }
 391         }
 392
 393         _black = Empty(film, playlist(), bind(&have_video, _1), _playback_length);
 394         _silent = Empty(film, playlist(), bind(&have_audio, _1), _playback_length);
 395
 396         _next_video_time = boost::none;
 397         _next_video_eyes = Eyes::BOTH;
 398         _next_audio_time = boost::none;
 399 }
 400
 401
 402 void
 403 Player::playlist_content_change (ChangeType type, int property, bool frequent)
 404 {
 405         auto film = _film.lock();
 406         if (!film) {
 407                 return;
 408         }
 409
 410         if (property == VideoContentProperty::CROP) {
 411                 if (type == ChangeType::DONE) {
 412                         boost::mutex::scoped_lock lm (_mutex);
 413                         for (auto const& i: _delay) {
 414                                 i.first->reset_metadata(film, _video_container_size);
 415                         }
 416                 }
 417         } else {
 418                 if (type == ChangeType::PENDING) {
 419                         /* The player content is probably about to change, so we can't carry on
 420                            until that has happened and we've rebuilt our pieces.  Stop pass()
 421                            and seek() from working until then.
 422                         */
 423                         ++_suspended;
 424                 } else if (type == ChangeType::DONE) {
 425                         /* A change in our content has gone through.  Re-build our pieces. */
 426                         setup_pieces ();
 427                         --_suspended;
 428                 } else if (type == ChangeType::CANCELLED) {
 429                         --_suspended;
 430                 }
 431         }
 432
 433         Change (type, property, frequent);
 434 }
 435
 436
 437 void
 438 Player::set_video_container_size (dcp::Size s)
 439 {
 440         ChangeSignaller<Player, int> cc(this, PlayerProperty::VIDEO_CONTAINER_SIZE);
 441
 442         if (s == _video_container_size) {
 443                 cc.abort();
 444                 return;
 445         }
 446
 447         _video_container_size = s;
 448
 449         {
 450                 boost::mutex::scoped_lock lm(_black_image_mutex);
 451                 _black_image = make_shared<Image>(AV_PIX_FMT_RGB24, _video_container_size, Image::Alignment::PADDED);
 452                 _black_image->make_black ();
 453         }
 454 }
 455
 456
 457 void
 458 Player::playlist_change (ChangeType type)
 459 {
 460         if (type == ChangeType::DONE) {
 461                 setup_pieces ();
 462         }
 463         Change (type, PlayerProperty::PLAYLIST, false);
 464 }
 465
 466
 467 void
 468 Player::film_change (ChangeType type, Film::Property p)
 469 {
 470         /* Here we should notice Film properties that affect our output, and
 471            alert listeners that our output now would be different to how it was
 472            last time we were run.
 473         */
 474
 475         auto film = _film.lock();
 476         if (!film) {
 477                 return;
 478         }
 479
 480         if (p == Film::Property::CONTAINER) {
 481                 Change (type, PlayerProperty::FILM_CONTAINER, false);
 482         } else if (p == Film::Property::VIDEO_FRAME_RATE) {
 483                 /* Pieces contain a FrameRateChange which contains the DCP frame rate,
 484                    so we need new pieces here.
 485                 */
 486                 if (type == ChangeType::DONE) {
 487                         setup_pieces ();
 488                 }
 489                 Change (type, PlayerProperty::FILM_VIDEO_FRAME_RATE, false);
 490         } else if (p == Film::Property::AUDIO_PROCESSOR) {
 491                 if (type == ChangeType::DONE && film->audio_processor ()) {
 492                         boost::mutex::scoped_lock lm (_mutex);
 493                         _audio_processor = film->audio_processor()->clone(film->audio_frame_rate());
 494                 }
 495         } else if (p == Film::Property::AUDIO_CHANNELS) {
 496                 if (type == ChangeType::DONE) {
 497                         boost::mutex::scoped_lock lm (_mutex);
 498                         _audio_merger.clear ();
 499                 }
 500         }
 501 }
 502
 503
 504 shared_ptr<PlayerVideo>
 505 Player::black_player_video_frame (Eyes eyes) const
 506 {
 507         boost::mutex::scoped_lock lm(_black_image_mutex);
 508
 509         return std::make_shared<PlayerVideo> (
 510                 std::make_shared<const RawImageProxy>(_black_image),
 511                 Crop(),
 512                 optional<double>(),
 513                 _video_container_size,
 514                 _video_container_size,
 515                 eyes,
 516                 Part::WHOLE,
 517                 PresetColourConversion::all().front().conversion,
 518                 VideoRange::FULL,
 519                 std::weak_ptr<Content>(),
 520                 boost::optional<Frame>(),
 521                 false
 522         );
 523 }
 524
 525
 526 Frame
 527 Player::dcp_to_content_video (shared_ptr<const Piece> piece, DCPTime t) const
 528 {
 529         auto film = _film.lock();
 530         DCPOMATIC_ASSERT(film);
 531
 532         auto s = t - piece->content->position ();
 533         s = min (piece->content->length_after_trim(film), s);
 534         s = max (DCPTime(), s + DCPTime (piece->content->trim_start(), piece->frc));
 535
 536         /* It might seem more logical here to convert s to a ContentTime (using the FrameRateChange)
 537            then convert that ContentTime to frames at the content's rate.  However this fails for
 538            situations like content at 29.9978733fps, DCP at 30fps.  The accuracy of the Time type is not
 539            enough to distinguish between the two with low values of time (e.g. 3200 in Time units).
 540
 541            Instead we convert the DCPTime using the DCP video rate then account for any skip/repeat.
 542         */
 543         return s.frames_floor (piece->frc.dcp) / piece->frc.factor ();
 544 }
 545
 546
 547 DCPTime
 548 Player::content_video_to_dcp (shared_ptr<const Piece> piece, Frame f) const
 549 {
 550         /* See comment in dcp_to_content_video */
 551         auto const d = DCPTime::from_frames (f * piece->frc.factor(), piece->frc.dcp) - DCPTime(piece->content->trim_start(), piece->frc);
 552         return d + piece->content->position();
 553 }
 554
 555
 556 Frame
 557 Player::dcp_to_resampled_audio (shared_ptr<const Piece> piece, DCPTime t) const
 558 {
 559         auto film = _film.lock();
 560         DCPOMATIC_ASSERT(film);
 561
 562         auto s = t - piece->content->position ();
 563         s = min (piece->content->length_after_trim(film), s);
 564         /* See notes in dcp_to_content_video */
 565         return max (DCPTime(), DCPTime(piece->content->trim_start(), piece->frc) + s).frames_floor(film->audio_frame_rate());
 566 }
 567
 568
 569 DCPTime
 570 Player::resampled_audio_to_dcp (shared_ptr<const Piece> piece, Frame f) const
 571 {
 572         auto film = _film.lock();
 573         DCPOMATIC_ASSERT(film);
 574
 575         /* See comment in dcp_to_content_video */
 576         return DCPTime::from_frames(f, film->audio_frame_rate())
 577                 - DCPTime (piece->content->trim_start(), piece->frc)
 578                 + piece->content->position();
 579 }
 580
 581
 582 ContentTime
 583 Player::dcp_to_content_time (shared_ptr<const Piece> piece, DCPTime t) const
 584 {
 585         auto film = _film.lock();
 586         DCPOMATIC_ASSERT(film);
 587
 588         auto s = t - piece->content->position ();
 589         s = min (piece->content->length_after_trim(film), s);
 590         return max (ContentTime (), ContentTime (s, piece->frc) + piece->content->trim_start());
 591 }
 592
 593
 594 DCPTime
 595 Player::content_time_to_dcp (shared_ptr<const Piece> piece, ContentTime t) const
 596 {
 597         return max (DCPTime(), DCPTime(t - piece->content->trim_start(), piece->frc) + piece->content->position());
 598 }
 599
 600
 601 vector<shared_ptr<Font>>
 602 Player::get_subtitle_fonts ()
 603 {
 604         boost::mutex::scoped_lock lm (_mutex);
 605
 606         vector<shared_ptr<Font>> fonts;
 607         for (auto piece: _pieces) {
 608                 for (auto text: piece->content->text) {
 609                         auto text_fonts = text->fonts();
 610                         copy (text_fonts.begin(), text_fonts.end(), back_inserter(fonts));
 611                 }
 612         }
 613
 614         return fonts;
 615 }
 616
 617
 618 /** Set this player never to produce any video data */
 619 void
 620 Player::set_ignore_video ()
 621 {
 622         ChangeSignaller<Player, int> cc(this, PlayerProperty::IGNORE_VIDEO);
 623         _ignore_video = true;
 624         setup_pieces();
 625 }
 626
 627
 628 void
 629 Player::set_ignore_audio ()
 630 {
 631         ChangeSignaller<Player, int> cc(this, PlayerProperty::IGNORE_AUDIO);
 632         _ignore_audio = true;
 633         setup_pieces();
 634 }
 635
 636
 637 void
 638 Player::set_ignore_text ()
 639 {
 640         ChangeSignaller<Player, int> cc(this, PlayerProperty::IGNORE_TEXT);
 641         _ignore_text = true;
 642         setup_pieces();
 643 }
 644
 645
 646 /** Set the player to always burn open texts into the image regardless of the content settings */
 647 void
 648 Player::set_always_burn_open_subtitles ()
 649 {
 650         ChangeSignaller<Player, int> cc(this, PlayerProperty::ALWAYS_BURN_OPEN_SUBTITLES);
 651         _always_burn_open_subtitles = true;
 652 }
 653
 654
 655 /** Sets up the player to be faster, possibly at the expense of quality */
 656 void
 657 Player::set_fast ()
 658 {
 659         _fast = true;
 660         setup_pieces();
 661 }
 662
 663
 664 void
 665 Player::set_play_referenced ()
 666 {
 667         ChangeSignaller<Player, int> cc(this, PlayerProperty::PLAY_REFERENCED);
 668         _play_referenced = true;
 669         setup_pieces();
 670 }
 671
 672
 673 bool
 674 Player::pass ()
 675 {
 676         boost::mutex::scoped_lock lm (_mutex);
 677
 678         if (_suspended) {
 679                 /* We can't pass in this state */
 680                 LOG_DEBUG_PLAYER_NC ("Player is suspended");
 681                 return false;
 682         }
 683
 684         auto film = _film.lock();
 685
 686         if (_playback_length.load() == DCPTime() || !film) {
 687                 /* Special; just give one black frame */
 688                 emit_video (black_player_video_frame(Eyes::BOTH), DCPTime());
 689                 return true;
 690         }
 691
 692         /* Find the decoder or empty which is farthest behind where we are and make it emit some data */
 693
 694         shared_ptr<Piece> earliest_content;
 695         optional<DCPTime> earliest_time;
 696
 697         for (auto i: _pieces) {
 698                 if (i->done) {
 699                         continue;
 700                 }
 701
 702                 auto const t = content_time_to_dcp (i, max(i->decoder->position(), i->content->trim_start()));
 703                 if (t > i->content->end(film)) {
 704                         i->done = true;
 705                 } else {
 706
 707                         /* Given two choices at the same time, pick the one with texts so we see it before
 708                            the video.
 709                         */
 710                         if (!earliest_time || t < *earliest_time || (t == *earliest_time && !i->decoder->text.empty())) {
 711                                 earliest_time = t;
 712                                 earliest_content = i;
 713                         }
 714                 }
 715         }
 716
 717         bool done = false;
 718
 719         enum {
 720                 NONE,
 721                 CONTENT,
 722                 BLACK,
 723                 SILENT
 724         } which = NONE;
 725
 726         if (earliest_content) {
 727                 which = CONTENT;
 728         }
 729
 730         if (!_black.done() && !_ignore_video && (!earliest_time || _black.position() < *earliest_time)) {
 731                 earliest_time = _black.position ();
 732                 which = BLACK;
 733         }
 734
 735         if (!_silent.done() && !_ignore_audio && (!earliest_time || _silent.position() < *earliest_time)) {
 736                 earliest_time = _silent.position ();
 737                 which = SILENT;
 738         }
 739
 740         switch (which) {
 741         case CONTENT:
 742         {
 743                 LOG_DEBUG_PLAYER ("Calling pass() on %1", earliest_content->content->path(0));
 744                 earliest_content->done = earliest_content->decoder->pass ();
 745                 auto dcp = dynamic_pointer_cast<DCPContent>(earliest_content->content);
 746                 if (dcp && !_play_referenced && dcp->reference_audio()) {
 747                         /* We are skipping some referenced DCP audio content, so we need to update _next_audio_time
 748                            to `hide' the fact that no audio was emitted during the referenced DCP (though
 749                            we need to behave as though it was).
 750                         */
 751                         _next_audio_time = dcp->end(film);
 752                 }
 753                 break;
 754         }
 755         case BLACK:
 756                 LOG_DEBUG_PLAYER ("Emit black for gap at %1", to_string(_black.position()));
 757                 emit_video (black_player_video_frame(Eyes::BOTH), _black.position());
 758                 _black.set_position (_black.position() + one_video_frame());
 759                 break;
 760         case SILENT:
 761         {
 762                 LOG_DEBUG_PLAYER ("Emit silence for gap at %1", to_string(_silent.position()));
 763                 DCPTimePeriod period (_silent.period_at_position());
 764                 if (_next_audio_time) {
 765                         /* Sometimes the thing that happened last finishes fractionally before
 766                            or after this silence.  Bodge the start time of the silence to fix it.
 767                            I think this is nothing to worry about since we will just add or
 768                            remove a little silence at the end of some content.
 769                         */
 770                         int64_t const error = labs(period.from.get() - _next_audio_time->get());
 771                         /* Let's not worry about less than a frame at 24fps */
 772                         int64_t const too_much_error = DCPTime::from_frames(1, 24).get();
 773                         if (error >= too_much_error) {
 774                                 film->log()->log(String::compose("Silence starting before or after last audio by %1", error), LogEntry::TYPE_ERROR);
 775                         }
 776                         DCPOMATIC_ASSERT (error < too_much_error);
 777                         period.from = *_next_audio_time;
 778                 }
 779                 if (period.duration() > one_video_frame()) {
 780                         period.to = period.from + one_video_frame();
 781                 }
 782                 fill_audio (period);
 783                 _silent.set_position (period.to);
 784                 break;
 785         }
 786         case NONE:
 787                 done = true;
 788                 break;
 789         }
 790
 791         /* Emit any audio that is ready */
 792
 793         /* Work out the time before which the audio is definitely all here.  This is the earliest last_push_end of one
 794            of our streams, or the position of the _silent.  First, though we choose only streams that are less than
 795            ignore_streams_behind seconds behind the furthest ahead (we assume that if a stream has fallen that far
 796            behind it has finished).  This is so that we don't withhold audio indefinitely awaiting data from a stream
 797            that will never come, causing bugs like #2101.
 798         */
 799         constexpr int ignore_streams_behind = 5;
 800
 801         using state_pair = std::pair<AudioStreamPtr, StreamState>;
 802
 803         /* Find streams that have pushed */
 804         std::vector<state_pair> have_pushed;
 805         std::copy_if(_stream_states.begin(), _stream_states.end(), std::back_inserter(have_pushed), [](state_pair const& a) { return static_cast<bool>(a.second.last_push_end); });
 806
 807         /* Find the 'leading' stream (i.e. the one that pushed data most recently) */
 808         auto latest_last_push_end = std::max_element(
 809                 have_pushed.begin(),
 810                 have_pushed.end(),
 811                 [](state_pair const& a, state_pair const& b) { return a.second.last_push_end.get() < b.second.last_push_end.get(); }
 812                 );
 813
 814         if (latest_last_push_end != have_pushed.end()) {
 815                 LOG_DEBUG_PLAYER("Leading audio stream is in %1 at %2", latest_last_push_end->second.piece->content->path(0), to_string(latest_last_push_end->second.last_push_end.get()));
 816         }
 817
 818         /* Now make a list of those streams that are less than ignore_streams_behind behind the leader */
 819         std::map<AudioStreamPtr, StreamState> alive_stream_states;
 820         for (auto const& i: _stream_states) {
 821                 if (!i.second.last_push_end || (latest_last_push_end->second.last_push_end.get() - i.second.last_push_end.get()) < dcpomatic::DCPTime::from_seconds(ignore_streams_behind)) {
 822                         alive_stream_states.insert(i);
 823                 } else {
 824                         LOG_DEBUG_PLAYER("Ignoring stream %1 because it is too far behind", i.second.piece->content->path(0));
 825                 }
 826         }
 827
 828         auto pull_to = _playback_length.load();
 829         for (auto const& i: alive_stream_states) {
 830                 auto position = i.second.last_push_end.get_value_or(i.second.piece->content->position());
 831                 if (!i.second.piece->done && position < pull_to) {
 832                         pull_to = position;
 833                 }
 834         }
 835         if (!_silent.done() && _silent.position() < pull_to) {
 836                 pull_to = _silent.position();
 837         }
 838
 839         LOG_DEBUG_PLAYER("Emitting audio up to %1", to_string(pull_to));
 840         auto audio = _audio_merger.pull (pull_to);
 841         for (auto i = audio.begin(); i != audio.end(); ++i) {
 842                 if (_next_audio_time && i->second < *_next_audio_time) {
 843                         /* This new data comes before the last we emitted (or the last seek); discard it */
 844                         auto cut = discard_audio (i->first, i->second, *_next_audio_time);
 845                         if (!cut.first) {
 846                                 continue;
 847                         }
 848                         *i = cut;
 849                 } else if (_next_audio_time && i->second > *_next_audio_time) {
 850                         /* There's a gap between this data and the last we emitted; fill with silence */
 851                         fill_audio (DCPTimePeriod (*_next_audio_time, i->second));
 852                 }
 853
 854                 emit_audio (i->first, i->second);
 855         }
 856
 857         if (done) {
 858                 if (_shuffler) {
 859                         _shuffler->flush ();
 860                 }
 861                 for (auto const& i: _delay) {
 862                         do_emit_video(i.first, i.second);
 863                 }
 864
 865                 /* Perhaps we should have Empty entries for both eyes in the 3D case (somehow).
 866                  * However, if we have L and R video files, and one is shorter than the other,
 867                  * the fill code in ::video mostly takes care of filling in the gaps.
 868                  * However, since it fills at the point when it knows there is more video coming
 869                  * at time t (so it should fill any gap up to t) it can't do anything right at the
 870                  * end.  This is particularly bad news if the last frame emitted is a LEFT
 871                  * eye, as the MXF writer will complain about the 3D sequence being wrong.
 872                  * Here's a hack to workaround that particular case.
 873                  */
 874                 if (_next_video_eyes && _next_video_time && *_next_video_eyes == Eyes::RIGHT) {
 875                         do_emit_video (black_player_video_frame(Eyes::RIGHT), *_next_video_time);
 876                 }
 877         }
 878
 879         return done;
 880 }
 881
 882
 883 /** @return Open subtitles for the frame at the given time, converted to images */
 884 optional<PositionImage>
 885 Player::open_subtitles_for_frame (DCPTime time) const
 886 {
 887         auto film = _film.lock();
 888         if (!film) {
 889                 return {};
 890         }
 891
 892         list<PositionImage> captions;
 893         int const vfr = film->video_frame_rate();
 894
 895         for (
 896                 auto j:
 897                 _active_texts[TextType::OPEN_SUBTITLE].get_burnt(DCPTimePeriod(time, time + DCPTime::from_frames(1, vfr)), _always_burn_open_subtitles)
 898                 ) {
 899
 900                 /* Bitmap subtitles */
 901                 for (auto i: j.bitmap) {
 902                         if (!i.image) {
 903                                 continue;
 904                         }
 905
 906                         /* i.image will already have been scaled to fit _video_container_size */
 907                         dcp::Size scaled_size (i.rectangle.width * _video_container_size.load().width, i.rectangle.height * _video_container_size.load().height);
 908
 909                         captions.push_back (
 910                                 PositionImage (
 911                                         i.image,
 912                                         Position<int> (
 913                                                 lrint(_video_container_size.load().width * i.rectangle.x),
 914                                                 lrint(_video_container_size.load().height * i.rectangle.y)
 915                                                 )
 916                                         )
 917                                 );
 918                 }
 919
 920                 /* String subtitles (rendered to an image) */
 921                 if (!j.string.empty()) {
 922                         auto s = render_text(j.string, _video_container_size, time, vfr);
 923                         copy (s.begin(), s.end(), back_inserter (captions));
 924                 }
 925         }
 926
 927         if (captions.empty()) {
 928                 return {};
 929         }
 930
 931         return merge (captions, _subtitle_alignment);
 932 }
 933
 934
 935 static
 936 Eyes
 937 increment_eyes (Eyes e)
 938 {
 939         if (e == Eyes::LEFT) {
 940                 return Eyes::RIGHT;
 941         }
 942
 943         return Eyes::LEFT;
 944 }
 945
 946
 947 void
 948 Player::video (weak_ptr<Piece> weak_piece, ContentVideo video)
 949 {
 950         if (_suspended) {
 951                 return;
 952         }
 953
 954         auto piece = weak_piece.lock ();
 955         if (!piece) {
 956                 return;
 957         }
 958
 959         if (!piece->content->video->use()) {
 960                 return;
 961         }
 962
 963         auto film = _film.lock();
 964         if (!film) {
 965                 return;
 966         }
 967
 968         FrameRateChange frc(film, piece->content);
 969         if (frc.skip && (video.frame % 2) == 1) {
 970                 return;
 971         }
 972
 973         vector<Eyes> eyes_to_emit;
 974
 975         if (!film->three_d()) {
 976                 if (video.eyes == Eyes::RIGHT) {
 977                         /* 2D film, 3D content: discard right */
 978                         return;
 979                 } else if (video.eyes == Eyes::LEFT) {
 980                         /* 2D film, 3D content: emit left as "both" */
 981                         video.eyes = Eyes::BOTH;
 982                         eyes_to_emit = { Eyes::BOTH };
 983                 }
 984         } else {
 985                 if (video.eyes == Eyes::BOTH) {
 986                         /* 3D film, 2D content; emit "both" for left and right */
 987                         eyes_to_emit = { Eyes::LEFT, Eyes::RIGHT };
 988                 }
 989         }
 990
 991         if (eyes_to_emit.empty()) {
 992                 eyes_to_emit = { video.eyes };
 993         }
 994
 995         /* Time of the first frame we will emit */
 996         DCPTime const time = content_video_to_dcp (piece, video.frame);
 997         LOG_DEBUG_PLAYER("Received video frame %1 at %2", video.frame, to_string(time));
 998
 999         /* Discard if it's before the content's period or the last accurate seek.  We can't discard
1000            if it's after the content's period here as in that case we still need to fill any gap between
1001            `now' and the end of the content's period.
1002         */
1003         if (time < piece->content->position() || (_next_video_time && time < *_next_video_time)) {
1004                 return;
1005         }
1006
1007         if (piece->ignore_video && piece->ignore_video->contains(time)) {
1008                 return;
1009         }
1010
1011         /* Fill gaps that we discover now that we have some video which needs to be emitted.
1012            This is where we need to fill to.
1013         */
1014         DCPTime fill_to = min(time, piece->content->end(film));
1015
1016         if (_next_video_time) {
1017                 DCPTime fill_from = max (*_next_video_time, piece->content->position());
1018
1019                 /* Fill if we have more than half a frame to do */
1020                 if ((fill_to - fill_from) > one_video_frame() / 2) {
1021                         auto last = _last_video.find (weak_piece);
1022                         if (film->three_d()) {
1023                                 auto fill_to_eyes = eyes_to_emit[0];
1024                                 if (fill_to_eyes == Eyes::BOTH) {
1025                                         fill_to_eyes = Eyes::LEFT;
1026                                 }
1027                                 if (fill_to == piece->content->end(film)) {
1028                                         /* Don't fill after the end of the content */
1029                                         fill_to_eyes = Eyes::LEFT;
1030                                 }
1031                                 auto j = fill_from;
1032                                 auto eyes = _next_video_eyes.get_value_or(Eyes::LEFT);
1033                                 if (eyes == Eyes::BOTH) {
1034                                         eyes = Eyes::LEFT;
1035                                 }
1036                                 while (j < fill_to || eyes != fill_to_eyes) {
1037                                         if (last != _last_video.end()) {
1038                                                 LOG_DEBUG_PLAYER("Fill using last video at %1 in 3D mode", to_string(j));
1039                                                 auto copy = last->second->shallow_copy();
1040                                                 copy->set_eyes (eyes);
1041                                                 emit_video (copy, j);
1042                                         } else {
1043                                                 LOG_DEBUG_PLAYER("Fill using black at %1 in 3D mode", to_string(j));
1044                                                 emit_video (black_player_video_frame(eyes), j);
1045                                         }
1046                                         if (eyes == Eyes::RIGHT) {
1047                                                 j += one_video_frame();
1048                                         }
1049                                         eyes = increment_eyes (eyes);
1050                                 }
1051                         } else {
1052                                 for (DCPTime j = fill_from; j < fill_to; j += one_video_frame()) {
1053                                         if (last != _last_video.end()) {
1054                                                 emit_video (last->second, j);
1055                                         } else {
1056                                                 emit_video (black_player_video_frame(Eyes::BOTH), j);
1057                                         }
1058                                 }
1059                         }
1060                 }
1061         }
1062
1063         auto const content_video = piece->content->video;
1064
1065         for (auto eyes: eyes_to_emit) {
1066                 _last_video[weak_piece] = std::make_shared<PlayerVideo>(
1067                         video.image,
1068                         content_video->actual_crop(),
1069                         content_video->fade(film, video.frame),
1070                         scale_for_display(
1071                                 content_video->scaled_size(film->frame_size()),
1072                                 _video_container_size,
1073                                 film->frame_size(),
1074                                 content_video->pixel_quanta()
1075                                 ),
1076                         _video_container_size,
1077                         eyes,
1078                         video.part,
1079                         content_video->colour_conversion(),
1080                         content_video->range(),
1081                         piece->content,
1082                         video.frame,
1083                         false
1084                         );
1085
1086                 DCPTime t = time;
1087                 for (int i = 0; i < frc.repeat; ++i) {
1088                         if (t < piece->content->end(film)) {
1089                                 emit_video (_last_video[weak_piece], t);
1090                         }
1091                         t += one_video_frame ();
1092                 }
1093         }
1094 }
1095
1096
1097 void
1098 Player::audio (weak_ptr<Piece> weak_piece, AudioStreamPtr stream, ContentAudio content_audio)
1099 {
1100         if (_suspended) {
1101                 return;
1102         }
1103
1104         DCPOMATIC_ASSERT (content_audio.audio->frames() > 0);
1105
1106         auto piece = weak_piece.lock ();
1107         if (!piece) {
1108                 return;
1109         }
1110
1111         auto film = _film.lock();
1112         if (!film) {
1113                 return;
1114         }
1115
1116         auto content = piece->content->audio;
1117         DCPOMATIC_ASSERT (content);
1118
1119         int const rfr = content->resampled_frame_rate(film);
1120
1121         /* Compute time in the DCP */
1122         auto time = resampled_audio_to_dcp (piece, content_audio.frame);
1123
1124         /* And the end of this block in the DCP */
1125         auto end = time + DCPTime::from_frames(content_audio.audio->frames(), rfr);
1126         LOG_DEBUG_PLAYER("Received audio frame %1 covering %2 to %3 (%4)", content_audio.frame, to_string(time), to_string(end), piece->content->path(0).filename());
1127
1128         /* Remove anything that comes before the start or after the end of the content */
1129         if (time < piece->content->position()) {
1130                 auto cut = discard_audio (content_audio.audio, time, piece->content->position());
1131                 if (!cut.first) {
1132                         /* This audio is entirely discarded */
1133                         return;
1134                 }
1135                 content_audio.audio = cut.first;
1136                 time = cut.second;
1137         } else if (time > piece->content->end(film)) {
1138                 /* Discard it all */
1139                 return;
1140         } else if (end > piece->content->end(film)) {
1141                 Frame const remaining_frames = DCPTime(piece->content->end(film) - time).frames_round(rfr);
1142                 if (remaining_frames == 0) {
1143                         return;
1144                 }
1145                 content_audio.audio = make_shared<AudioBuffers>(content_audio.audio, remaining_frames, 0);
1146         }
1147
1148         DCPOMATIC_ASSERT (content_audio.audio->frames() > 0);
1149
1150         /* Gain and fade */
1151
1152         auto const fade_coeffs = content->fade (stream, content_audio.frame, content_audio.audio->frames(), rfr);
1153         if (content->gain() != 0 || !fade_coeffs.empty()) {
1154                 auto gain_buffers = make_shared<AudioBuffers>(content_audio.audio);
1155                 if (!fade_coeffs.empty()) {
1156                         /* Apply both fade and gain */
1157                         DCPOMATIC_ASSERT (fade_coeffs.size() == static_cast<size_t>(gain_buffers->frames()));
1158                         auto const channels = gain_buffers->channels();
1159                         auto const frames = fade_coeffs.size();
1160                         auto data = gain_buffers->data();
1161                         auto const gain = db_to_linear (content->gain());
1162                         for (auto channel = 0; channel < channels; ++channel) {
1163                                 for (auto frame = 0U; frame < frames; ++frame) {
1164                                         data[channel][frame] *= gain * fade_coeffs[frame];
1165                                 }
1166                         }
1167                 } else {
1168                         /* Just apply gain */
1169                         gain_buffers->apply_gain (content->gain());
1170                 }
1171                 content_audio.audio = gain_buffers;
1172         }
1173
1174         /* Remap */
1175
1176         content_audio.audio = remap(content_audio.audio, film->audio_channels(), stream->mapping());
1177
1178         /* Process */
1179
1180         if (_audio_processor) {
1181                 content_audio.audio = _audio_processor->run(content_audio.audio, film->audio_channels());
1182         }
1183
1184         /* Push */
1185
1186         _audio_merger.push (content_audio.audio, time);
1187         DCPOMATIC_ASSERT (_stream_states.find (stream) != _stream_states.end ());
1188         _stream_states[stream].last_push_end = time + DCPTime::from_frames(content_audio.audio->frames(), film->audio_frame_rate());
1189 }
1190
1191
1192 void
1193 Player::bitmap_text_start (weak_ptr<Piece> weak_piece, weak_ptr<const TextContent> weak_content, ContentBitmapText subtitle)
1194 {
1195         if (_suspended) {
1196                 return;
1197         }
1198
1199         auto piece = weak_piece.lock ();
1200         auto content = weak_content.lock ();
1201         if (!piece || !content) {
1202                 return;
1203         }
1204
1205         PlayerText ps;
1206         for (auto& sub: subtitle.subs)
1207         {
1208                 /* Apply content's subtitle offsets */
1209                 sub.rectangle.x += content->x_offset ();
1210                 sub.rectangle.y += content->y_offset ();
1211
1212                 /* Apply a corrective translation to keep the subtitle centred after the scale that is coming up */
1213                 sub.rectangle.x -= sub.rectangle.width * ((content->x_scale() - 1) / 2);
1214                 sub.rectangle.y -= sub.rectangle.height * ((content->y_scale() - 1) / 2);
1215
1216                 /* Apply content's subtitle scale */
1217                 sub.rectangle.width *= content->x_scale ();
1218                 sub.rectangle.height *= content->y_scale ();
1219
1220                 auto image = sub.image;
1221
1222                 /* We will scale the subtitle up to fit _video_container_size */
1223                 int const width = sub.rectangle.width * _video_container_size.load().width;
1224                 int const height = sub.rectangle.height * _video_container_size.load().height;
1225                 if (width == 0 || height == 0) {
1226                         return;
1227                 }
1228
1229                 dcp::Size scaled_size (width, height);
1230                 ps.bitmap.push_back (BitmapText(image->scale(scaled_size, dcp::YUVToRGB::REC601, image->pixel_format(), Image::Alignment::PADDED, _fast), sub.rectangle));
1231         }
1232
1233         DCPTime from(content_time_to_dcp(piece, subtitle.from()));
1234         _active_texts[content->type()].add_from(weak_content, ps, from);
1235 }
1236
1237
1238 void
1239 Player::plain_text_start (weak_ptr<Piece> weak_piece, weak_ptr<const TextContent> weak_content, ContentStringText subtitle)
1240 {
1241         if (_suspended) {
1242                 return;
1243         }
1244
1245         auto piece = weak_piece.lock ();
1246         auto content = weak_content.lock ();
1247         auto film = _film.lock();
1248         if (!piece || !content || !film) {
1249                 return;
1250         }
1251
1252         PlayerText ps;
1253         DCPTime const from (content_time_to_dcp (piece, subtitle.from()));
1254
1255         if (from > piece->content->end(film)) {
1256                 return;
1257         }
1258
1259         for (auto s: subtitle.subs) {
1260                 s.set_h_position (s.h_position() + content->x_offset());
1261                 s.set_v_position (s.v_position() + content->y_offset());
1262                 float const xs = content->x_scale();
1263                 float const ys = content->y_scale();
1264                 float size = s.size();
1265
1266                 /* Adjust size to express the common part of the scaling;
1267                    e.g. if xs = ys = 0.5 we scale size by 2.
1268                 */
1269                 if (xs > 1e-5 && ys > 1e-5) {
1270                         size *= 1 / min (1 / xs, 1 / ys);
1271                 }
1272                 s.set_size (size);
1273
1274                 /* Then express aspect ratio changes */
1275                 if (fabs (1.0 - xs / ys) > dcp::ASPECT_ADJUST_EPSILON) {
1276                         s.set_aspect_adjust (xs / ys);
1277                 }
1278
1279                 s.set_in (dcp::Time(from.seconds(), 1000));
1280                 ps.string.push_back (s);
1281         }
1282
1283         _active_texts[content->type()].add_from(weak_content, ps, from);
1284 }
1285
1286
1287 void
1288 Player::subtitle_stop (weak_ptr<Piece> weak_piece, weak_ptr<const TextContent> weak_content, ContentTime to)
1289 {
1290         if (_suspended) {
1291                 return;
1292         }
1293
1294         auto content = weak_content.lock ();
1295         if (!content) {
1296                 return;
1297         }
1298
1299         if (!_active_texts[content->type()].have(weak_content)) {
1300                 return;
1301         }
1302
1303         auto piece = weak_piece.lock ();
1304         auto film = _film.lock();
1305         if (!piece || !film) {
1306                 return;
1307         }
1308
1309         DCPTime const dcp_to = content_time_to_dcp (piece, to);
1310
1311         if (dcp_to > piece->content->end(film)) {
1312                 return;
1313         }
1314
1315         auto from = _active_texts[content->type()].add_to(weak_content, dcp_to);
1316
1317         bool const always = (content->type() == TextType::OPEN_SUBTITLE && _always_burn_open_subtitles);
1318         if (content->use() && !always && !content->burn()) {
1319                 Text (from.first, content->type(), content->dcp_track().get_value_or(DCPTextTrack()), DCPTimePeriod(from.second, dcp_to));
1320         }
1321 }
1322
1323
1324 void
1325 Player::seek (DCPTime time, bool accurate)
1326 {
1327         boost::mutex::scoped_lock lm (_mutex);
1328         LOG_DEBUG_PLAYER("Seek to %1 (%2accurate)", to_string(time), accurate ? "" : "in");
1329
1330         if (_suspended) {
1331                 /* We can't seek in this state */
1332                 return;
1333         }
1334
1335         auto film = _film.lock();
1336         if (!film) {
1337                 return;
1338         }
1339
1340         if (_shuffler) {
1341                 _shuffler->clear ();
1342         }
1343
1344         _delay.clear ();
1345
1346         if (_audio_processor) {
1347                 _audio_processor->flush ();
1348         }
1349
1350         _audio_merger.clear ();
1351         std::for_each(_active_texts.begin(), _active_texts.end(), [](ActiveText& a) { a.clear(); });
1352
1353         for (auto i: _pieces) {
1354                 if (time < i->content->position()) {
1355                         /* Before; seek to the start of the content.  Even if this request is for an inaccurate seek
1356                            we must seek this (following) content accurately, otherwise when we come to the end of the current
1357                            content we may not start right at the beginning of the next, causing a gap (if the next content has
1358                            been trimmed to a point between keyframes, or something).
1359                         */
1360                         i->decoder->seek (dcp_to_content_time (i, i->content->position()), true);
1361                         i->done = false;
1362                 } else if (i->content->position() <= time && time < i->content->end(film)) {
1363                         /* During; seek to position */
1364                         i->decoder->seek (dcp_to_content_time (i, time), accurate);
1365                         i->done = false;
1366                 } else {
1367                         /* After; this piece is done */
1368                         i->done = true;
1369                 }
1370         }
1371
1372         if (accurate) {
1373                 _next_video_time = time;
1374                 _next_video_eyes = Eyes::LEFT;
1375                 _next_audio_time = time;
1376         } else {
1377                 _next_video_time = boost::none;
1378                 _next_video_eyes = boost::none;
1379                 _next_audio_time = boost::none;
1380         }
1381
1382         _black.set_position (time);
1383         _silent.set_position (time);
1384
1385         _last_video.clear ();
1386
1387         for (auto& state: _stream_states) {
1388                 state.second.last_push_end = boost::none;
1389         }
1390 }
1391
1392
1393 void
1394 Player::emit_video (shared_ptr<PlayerVideo> pv, DCPTime time)
1395 {
1396         auto film = _film.lock();
1397         DCPOMATIC_ASSERT(film);
1398
1399         if (!film->three_d()) {
1400                 if (pv->eyes() == Eyes::LEFT) {
1401                         /* Use left-eye images for both eyes... */
1402                         pv->set_eyes (Eyes::BOTH);
1403                 } else if (pv->eyes() == Eyes::RIGHT) {
1404                         /* ...and discard the right */
1405                         return;
1406                 }
1407         }
1408
1409         /* We need a delay to give a little wiggle room to ensure that relevant subtitles arrive at the
1410            player before the video that requires them.
1411         */
1412         _delay.push_back (make_pair (pv, time));
1413
1414         if (pv->eyes() == Eyes::BOTH || pv->eyes() == Eyes::RIGHT) {
1415                 _next_video_time = time + one_video_frame();
1416         }
1417         _next_video_eyes = increment_eyes (pv->eyes());
1418
1419         if (_delay.size() < 3) {
1420                 return;
1421         }
1422
1423         auto to_do = _delay.front();
1424         _delay.pop_front();
1425         do_emit_video (to_do.first, to_do.second);
1426 }
1427
1428
1429 void
1430 Player::do_emit_video (shared_ptr<PlayerVideo> pv, DCPTime time)
1431 {
1432         if (pv->eyes() == Eyes::BOTH || pv->eyes() == Eyes::RIGHT) {
1433                 std::for_each(_active_texts.begin(), _active_texts.end(), [time](ActiveText& a) { a.clear_before(time); });
1434         }
1435
1436         auto subtitles = open_subtitles_for_frame (time);
1437         if (subtitles) {
1438                 pv->set_text (subtitles.get ());
1439         }
1440
1441         Video (pv, time);
1442 }
1443
1444
1445 void
1446 Player::emit_audio (shared_ptr<AudioBuffers> data, DCPTime time)
1447 {
1448         auto film = _film.lock();
1449         DCPOMATIC_ASSERT(film);
1450
1451         /* Log if the assert below is about to fail */
1452         if (_next_audio_time && labs(time.get() - _next_audio_time->get()) > 1) {
1453                 film->log()->log(String::compose("Out-of-sequence emit %1 vs %2", to_string(time), to_string(*_next_audio_time)), LogEntry::TYPE_WARNING);
1454         }
1455
1456         /* This audio must follow on from the previous, allowing for half a sample (at 48kHz) leeway */
1457         DCPOMATIC_ASSERT (!_next_audio_time || labs(time.get() - _next_audio_time->get()) < 2);
1458         Audio(data, time, film->audio_frame_rate());
1459         _next_audio_time = time + DCPTime::from_frames(data->frames(), film->audio_frame_rate());
1460 }
1461
1462
1463 void
1464 Player::fill_audio (DCPTimePeriod period)
1465 {
1466         auto film = _film.lock();
1467         DCPOMATIC_ASSERT(film);
1468
1469         if (period.from == period.to) {
1470                 return;
1471         }
1472
1473         DCPOMATIC_ASSERT (period.from < period.to);
1474
1475         DCPTime t = period.from;
1476         while (t < period.to) {
1477                 DCPTime block = min (DCPTime::from_seconds (0.5), period.to - t);
1478                 Frame const samples = block.frames_round(film->audio_frame_rate());
1479                 if (samples) {
1480                         auto silence = make_shared<AudioBuffers>(film->audio_channels(), samples);
1481                         silence->make_silent ();
1482                         emit_audio (silence, t);
1483                 }
1484                 t += block;
1485         }
1486 }
1487
1488
1489 DCPTime
1490 Player::one_video_frame () const
1491 {
1492         auto film = _film.lock();
1493         DCPOMATIC_ASSERT(film);
1494
1495         return DCPTime::from_frames(1, film->video_frame_rate ());
1496 }
1497
1498
1499 pair<shared_ptr<AudioBuffers>, DCPTime>
1500 Player::discard_audio (shared_ptr<const AudioBuffers> audio, DCPTime time, DCPTime discard_to) const
1501 {
1502         auto film = _film.lock();
1503         DCPOMATIC_ASSERT(film);
1504
1505         auto const discard_time = discard_to - time;
1506         auto const discard_frames = discard_time.frames_round(film->audio_frame_rate());
1507         auto remaining_frames = audio->frames() - discard_frames;
1508         if (remaining_frames <= 0) {
1509                 return make_pair(shared_ptr<AudioBuffers>(), DCPTime());
1510         }
1511         auto cut = make_shared<AudioBuffers>(audio, remaining_frames, discard_frames);
1512         return make_pair(cut, time + discard_time);
1513 }
1514
1515
1516 void
1517 Player::set_dcp_decode_reduction (optional<int> reduction)
1518 {
1519         ChangeSignaller<Player, int> cc(this, PlayerProperty::DCP_DECODE_REDUCTION);
1520
1521         if (reduction == _dcp_decode_reduction.load()) {
1522                 cc.abort();
1523                 return;
1524         }
1525
1526         _dcp_decode_reduction = reduction;
1527         setup_pieces();
1528 }
1529
1530
1531 optional<DCPTime>
1532 Player::content_time_to_dcp (shared_ptr<const Content> content, ContentTime t) const
1533 {
1534         boost::mutex::scoped_lock lm (_mutex);
1535
1536         for (auto i: _pieces) {
1537                 if (i->content == content) {
1538                         return content_time_to_dcp (i, t);
1539                 }
1540         }
1541
1542         /* We couldn't find this content; perhaps things are being changed over */
1543         return {};
1544 }
1545
1546
1547 optional<ContentTime>
1548 Player::dcp_to_content_time (shared_ptr<const Content> content, DCPTime t) const
1549 {
1550         boost::mutex::scoped_lock lm (_mutex);
1551
1552         for (auto i: _pieces) {
1553                 if (i->content == content) {
1554                         return dcp_to_content_time (i, t);
1555                 }
1556         }
1557
1558         /* We couldn't find this content; perhaps things are being changed over */
1559         return {};
1560 }
1561
1562
1563 shared_ptr<const Playlist>
1564 Player::playlist () const
1565 {
1566         auto film = _film.lock();
1567         if (!film) {
1568                 return {};
1569         }
1570
1571         return _playlist ? _playlist : film->playlist();
1572 }
1573
1574
1575 void
1576 Player::atmos (weak_ptr<Piece> weak_piece, ContentAtmos data)
1577 {
1578         if (_suspended) {
1579                 return;
1580         }
1581
1582         auto film = _film.lock();
1583         DCPOMATIC_ASSERT(film);
1584
1585         auto piece = weak_piece.lock ();
1586         DCPOMATIC_ASSERT (piece);
1587
1588         auto const vfr = film->video_frame_rate();
1589
1590         DCPTime const dcp_time = DCPTime::from_frames(data.frame, vfr) - DCPTime(piece->content->trim_start(), FrameRateChange(vfr, vfr));
1591         if (dcp_time < piece->content->position() || dcp_time >= (piece->content->end(film))) {
1592                 return;
1593         }
1594
1595         Atmos (data.data, dcp_time, data.metadata);
1596 }
1597
1598
1599 void
1600 Player::signal_change(ChangeType type, int property)
1601 {
1602         Change(type, property, false);
1603 }
1604