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                                         if (auto overlap = (*later_piece)->content->period(film).overlap(period)) {
 388                                                 (*piece)->ignore_video.push_back(*overlap);
 389                                         }
 390                                 }
 391                         }
 392                 }
 393         }
 394
 395         for (auto piece = _pieces.begin(); piece != _pieces.end(); ++piece) {
 396                 if ((*piece)->content->atmos) {
 397                         /* Look for content later in the content list with ATMOS that overlaps this */
 398                         auto const period = (*piece)->content->period(film);
 399                         for (auto later_piece = std::next(piece); later_piece != _pieces.end(); ++later_piece) {
 400                                 if ((*later_piece)->content->atmos) {
 401                                         if (auto overlap = (*later_piece)->content->period(film).overlap(period)) {
 402                                                 (*piece)->ignore_atmos.push_back(*overlap);
 403                                         }
 404                                 }
 405                         }
 406                 }
 407         }
 408
 409         _black = Empty(film, playlist(), bind(&have_video, _1), _playback_length);
 410         _silent = Empty(film, playlist(), bind(&have_audio, _1), _playback_length);
 411
 412         _next_video_time = boost::none;
 413         _next_video_eyes = Eyes::BOTH;
 414         _next_audio_time = boost::none;
 415 }
 416
 417
 418 void
 419 Player::playlist_content_change (ChangeType type, int property, bool frequent)
 420 {
 421         auto film = _film.lock();
 422         if (!film) {
 423                 return;
 424         }
 425
 426         if (property == VideoContentProperty::CROP) {
 427                 if (type == ChangeType::DONE) {
 428                         boost::mutex::scoped_lock lm (_mutex);
 429                         for (auto const& i: _delay) {
 430                                 i.first->reset_metadata(film, _video_container_size);
 431                         }
 432                 }
 433         } else {
 434                 if (type == ChangeType::PENDING) {
 435                         /* The player content is probably about to change, so we can't carry on
 436                            until that has happened and we've rebuilt our pieces.  Stop pass()
 437                            and seek() from working until then.
 438                         */
 439                         ++_suspended;
 440                 } else if (type == ChangeType::DONE) {
 441                         /* A change in our content has gone through.  Re-build our pieces. */
 442                         setup_pieces ();
 443                         --_suspended;
 444                 } else if (type == ChangeType::CANCELLED) {
 445                         --_suspended;
 446                 }
 447         }
 448
 449         Change (type, property, frequent);
 450 }
 451
 452
 453 void
 454 Player::set_video_container_size (dcp::Size s)
 455 {
 456         ChangeSignaller<Player, int> cc(this, PlayerProperty::VIDEO_CONTAINER_SIZE);
 457
 458         if (s == _video_container_size) {
 459                 cc.abort();
 460                 return;
 461         }
 462
 463         _video_container_size = s;
 464
 465         {
 466                 boost::mutex::scoped_lock lm(_black_image_mutex);
 467                 _black_image = make_shared<Image>(AV_PIX_FMT_RGB24, _video_container_size, Image::Alignment::PADDED);
 468                 _black_image->make_black ();
 469         }
 470 }
 471
 472
 473 void
 474 Player::playlist_change (ChangeType type)
 475 {
 476         if (type == ChangeType::DONE) {
 477                 setup_pieces ();
 478         }
 479         Change (type, PlayerProperty::PLAYLIST, false);
 480 }
 481
 482
 483 void
 484 Player::film_change (ChangeType type, Film::Property p)
 485 {
 486         /* Here we should notice Film properties that affect our output, and
 487            alert listeners that our output now would be different to how it was
 488            last time we were run.
 489         */
 490
 491         auto film = _film.lock();
 492         if (!film) {
 493                 return;
 494         }
 495
 496         if (p == Film::Property::CONTAINER) {
 497                 Change (type, PlayerProperty::FILM_CONTAINER, false);
 498         } else if (p == Film::Property::VIDEO_FRAME_RATE) {
 499                 /* Pieces contain a FrameRateChange which contains the DCP frame rate,
 500                    so we need new pieces here.
 501                 */
 502                 if (type == ChangeType::DONE) {
 503                         setup_pieces ();
 504                 }
 505                 Change (type, PlayerProperty::FILM_VIDEO_FRAME_RATE, false);
 506         } else if (p == Film::Property::AUDIO_PROCESSOR) {
 507                 if (type == ChangeType::DONE && film->audio_processor ()) {
 508                         boost::mutex::scoped_lock lm (_mutex);
 509                         _audio_processor = film->audio_processor()->clone(film->audio_frame_rate());
 510                 }
 511         } else if (p == Film::Property::AUDIO_CHANNELS) {
 512                 if (type == ChangeType::DONE) {
 513                         boost::mutex::scoped_lock lm (_mutex);
 514                         _audio_merger.clear ();
 515                 }
 516         }
 517 }
 518
 519
 520 shared_ptr<PlayerVideo>
 521 Player::black_player_video_frame (Eyes eyes) const
 522 {
 523         boost::mutex::scoped_lock lm(_black_image_mutex);
 524
 525         return std::make_shared<PlayerVideo> (
 526                 std::make_shared<const RawImageProxy>(_black_image),
 527                 Crop(),
 528                 optional<double>(),
 529                 _video_container_size,
 530                 _video_container_size,
 531                 eyes,
 532                 Part::WHOLE,
 533                 PresetColourConversion::all().front().conversion,
 534                 VideoRange::FULL,
 535                 std::weak_ptr<Content>(),
 536                 boost::optional<Frame>(),
 537                 false
 538         );
 539 }
 540
 541
 542 Frame
 543 Player::dcp_to_content_video (shared_ptr<const Piece> piece, DCPTime t) const
 544 {
 545         auto film = _film.lock();
 546         DCPOMATIC_ASSERT(film);
 547
 548         auto s = t - piece->content->position ();
 549         s = min (piece->content->length_after_trim(film), s);
 550         s = max (DCPTime(), s + DCPTime (piece->content->trim_start(), piece->frc));
 551
 552         /* It might seem more logical here to convert s to a ContentTime (using the FrameRateChange)
 553            then convert that ContentTime to frames at the content's rate.  However this fails for
 554            situations like content at 29.9978733fps, DCP at 30fps.  The accuracy of the Time type is not
 555            enough to distinguish between the two with low values of time (e.g. 3200 in Time units).
 556
 557            Instead we convert the DCPTime using the DCP video rate then account for any skip/repeat.
 558         */
 559         return s.frames_floor (piece->frc.dcp) / piece->frc.factor ();
 560 }
 561
 562
 563 DCPTime
 564 Player::content_video_to_dcp (shared_ptr<const Piece> piece, Frame f) const
 565 {
 566         /* See comment in dcp_to_content_video */
 567         auto const d = DCPTime::from_frames (f * piece->frc.factor(), piece->frc.dcp) - DCPTime(piece->content->trim_start(), piece->frc);
 568         return d + piece->content->position();
 569 }
 570
 571
 572 Frame
 573 Player::dcp_to_resampled_audio (shared_ptr<const Piece> piece, DCPTime t) const
 574 {
 575         auto film = _film.lock();
 576         DCPOMATIC_ASSERT(film);
 577
 578         auto s = t - piece->content->position ();
 579         s = min (piece->content->length_after_trim(film), s);
 580         /* See notes in dcp_to_content_video */
 581         return max (DCPTime(), DCPTime(piece->content->trim_start(), piece->frc) + s).frames_floor(film->audio_frame_rate());
 582 }
 583
 584
 585 DCPTime
 586 Player::resampled_audio_to_dcp (shared_ptr<const Piece> piece, Frame f) const
 587 {
 588         auto film = _film.lock();
 589         DCPOMATIC_ASSERT(film);
 590
 591         /* See comment in dcp_to_content_video */
 592         return DCPTime::from_frames(f, film->audio_frame_rate())
 593                 - DCPTime (piece->content->trim_start(), piece->frc)
 594                 + piece->content->position();
 595 }
 596
 597
 598 ContentTime
 599 Player::dcp_to_content_time (shared_ptr<const Piece> piece, DCPTime t) const
 600 {
 601         auto film = _film.lock();
 602         DCPOMATIC_ASSERT(film);
 603
 604         auto s = t - piece->content->position ();
 605         s = min (piece->content->length_after_trim(film), s);
 606         return max (ContentTime (), ContentTime (s, piece->frc) + piece->content->trim_start());
 607 }
 608
 609
 610 DCPTime
 611 Player::content_time_to_dcp (shared_ptr<const Piece> piece, ContentTime t) const
 612 {
 613         return max (DCPTime(), DCPTime(t - piece->content->trim_start(), piece->frc) + piece->content->position());
 614 }
 615
 616
 617 vector<shared_ptr<Font>>
 618 Player::get_subtitle_fonts ()
 619 {
 620         boost::mutex::scoped_lock lm (_mutex);
 621
 622         vector<shared_ptr<Font>> fonts;
 623         for (auto piece: _pieces) {
 624                 for (auto text: piece->content->text) {
 625                         auto text_fonts = text->fonts();
 626                         copy (text_fonts.begin(), text_fonts.end(), back_inserter(fonts));
 627                 }
 628         }
 629
 630         return fonts;
 631 }
 632
 633
 634 /** Set this player never to produce any video data */
 635 void
 636 Player::set_ignore_video ()
 637 {
 638         ChangeSignaller<Player, int> cc(this, PlayerProperty::IGNORE_VIDEO);
 639         _ignore_video = true;
 640         setup_pieces();
 641 }
 642
 643
 644 void
 645 Player::set_ignore_audio ()
 646 {
 647         ChangeSignaller<Player, int> cc(this, PlayerProperty::IGNORE_AUDIO);
 648         _ignore_audio = true;
 649         setup_pieces();
 650 }
 651
 652
 653 void
 654 Player::set_ignore_text ()
 655 {
 656         ChangeSignaller<Player, int> cc(this, PlayerProperty::IGNORE_TEXT);
 657         _ignore_text = true;
 658         setup_pieces();
 659 }
 660
 661
 662 /** Set the player to always burn open texts into the image regardless of the content settings */
 663 void
 664 Player::set_always_burn_open_subtitles ()
 665 {
 666         ChangeSignaller<Player, int> cc(this, PlayerProperty::ALWAYS_BURN_OPEN_SUBTITLES);
 667         _always_burn_open_subtitles = true;
 668 }
 669
 670
 671 /** Sets up the player to be faster, possibly at the expense of quality */
 672 void
 673 Player::set_fast ()
 674 {
 675         _fast = true;
 676         setup_pieces();
 677 }
 678
 679
 680 void
 681 Player::set_play_referenced ()
 682 {
 683         ChangeSignaller<Player, int> cc(this, PlayerProperty::PLAY_REFERENCED);
 684         _play_referenced = true;
 685         setup_pieces();
 686 }
 687
 688
 689 bool
 690 Player::pass ()
 691 {
 692         boost::mutex::scoped_lock lm (_mutex);
 693
 694         if (_suspended) {
 695                 /* We can't pass in this state */
 696                 LOG_DEBUG_PLAYER_NC ("Player is suspended");
 697                 return false;
 698         }
 699
 700         auto film = _film.lock();
 701
 702         if (_playback_length.load() == DCPTime() || !film) {
 703                 /* Special; just give one black frame */
 704                 emit_video (black_player_video_frame(Eyes::BOTH), DCPTime());
 705                 return true;
 706         }
 707
 708         /* Find the decoder or empty which is farthest behind where we are and make it emit some data */
 709
 710         shared_ptr<Piece> earliest_content;
 711         optional<DCPTime> earliest_time;
 712
 713         for (auto i: _pieces) {
 714                 if (i->done) {
 715                         continue;
 716                 }
 717
 718                 auto const t = content_time_to_dcp (i, max(i->decoder->position(), i->content->trim_start()));
 719                 if (t > i->content->end(film)) {
 720                         i->done = true;
 721                 } else {
 722
 723                         /* Given two choices at the same time, pick the one with texts so we see it before
 724                            the video.
 725                         */
 726                         if (!earliest_time || t < *earliest_time || (t == *earliest_time && !i->decoder->text.empty())) {
 727                                 earliest_time = t;
 728                                 earliest_content = i;
 729                         }
 730                 }
 731         }
 732
 733         bool done = false;
 734
 735         enum {
 736                 NONE,
 737                 CONTENT,
 738                 BLACK,
 739                 SILENT
 740         } which = NONE;
 741
 742         if (earliest_content) {
 743                 which = CONTENT;
 744         }
 745
 746         if (!_black.done() && !_ignore_video && (!earliest_time || _black.position() < *earliest_time)) {
 747                 earliest_time = _black.position ();
 748                 which = BLACK;
 749         }
 750
 751         if (!_silent.done() && !_ignore_audio && (!earliest_time || _silent.position() < *earliest_time)) {
 752                 earliest_time = _silent.position ();
 753                 which = SILENT;
 754         }
 755
 756         switch (which) {
 757         case CONTENT:
 758         {
 759                 LOG_DEBUG_PLAYER ("Calling pass() on %1", earliest_content->content->path(0));
 760                 earliest_content->done = earliest_content->decoder->pass ();
 761                 auto dcp = dynamic_pointer_cast<DCPContent>(earliest_content->content);
 762                 if (dcp && !_play_referenced && dcp->reference_audio()) {
 763                         /* We are skipping some referenced DCP audio content, so we need to update _next_audio_time
 764                            to `hide' the fact that no audio was emitted during the referenced DCP (though
 765                            we need to behave as though it was).
 766                         */
 767                         _next_audio_time = dcp->end(film);
 768                 }
 769                 break;
 770         }
 771         case BLACK:
 772                 LOG_DEBUG_PLAYER ("Emit black for gap at %1", to_string(_black.position()));
 773                 if (film->three_d()) {
 774                         emit_video(black_player_video_frame(Eyes::LEFT), _black.position());
 775                         emit_video(black_player_video_frame(Eyes::RIGHT), _black.position());
 776                 } else {
 777                         emit_video(black_player_video_frame(Eyes::BOTH), _black.position());
 778                 }
 779                 _black.set_position (_black.position() + one_video_frame());
 780                 break;
 781         case SILENT:
 782         {
 783                 LOG_DEBUG_PLAYER ("Emit silence for gap at %1", to_string(_silent.position()));
 784                 DCPTimePeriod period (_silent.period_at_position());
 785                 if (_next_audio_time) {
 786                         /* Sometimes the thing that happened last finishes fractionally before
 787                            or after this silence.  Bodge the start time of the silence to fix it.
 788                            I think this is nothing to worry about since we will just add or
 789                            remove a little silence at the end of some content.
 790                         */
 791                         int64_t const error = labs(period.from.get() - _next_audio_time->get());
 792                         /* Let's not worry about less than a frame at 24fps */
 793                         int64_t const too_much_error = DCPTime::from_frames(1, 24).get();
 794                         if (error >= too_much_error) {
 795                                 film->log()->log(String::compose("Silence starting before or after last audio by %1", error), LogEntry::TYPE_ERROR);
 796                         }
 797                         DCPOMATIC_ASSERT (error < too_much_error);
 798                         period.from = *_next_audio_time;
 799                 }
 800                 if (period.duration() > one_video_frame()) {
 801                         period.to = period.from + one_video_frame();
 802                 }
 803                 fill_audio (period);
 804                 _silent.set_position (period.to);
 805                 break;
 806         }
 807         case NONE:
 808                 done = true;
 809                 break;
 810         }
 811
 812         /* Emit any audio that is ready */
 813
 814         /* Work out the time before which the audio is definitely all here.  This is the earliest last_push_end of one
 815            of our streams, or the position of the _silent.  First, though we choose only streams that are less than
 816            ignore_streams_behind seconds behind the furthest ahead (we assume that if a stream has fallen that far
 817            behind it has finished).  This is so that we don't withhold audio indefinitely awaiting data from a stream
 818            that will never come, causing bugs like #2101.
 819         */
 820         constexpr int ignore_streams_behind = 5;
 821
 822         using state_pair = std::pair<AudioStreamPtr, StreamState>;
 823
 824         /* Find streams that have pushed */
 825         std::vector<state_pair> have_pushed;
 826         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); });
 827
 828         /* Find the 'leading' stream (i.e. the one that pushed data most recently) */
 829         auto latest_last_push_end = std::max_element(
 830                 have_pushed.begin(),
 831                 have_pushed.end(),
 832                 [](state_pair const& a, state_pair const& b) { return a.second.last_push_end.get() < b.second.last_push_end.get(); }
 833                 );
 834
 835         if (latest_last_push_end != have_pushed.end()) {
 836                 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()));
 837         }
 838
 839         /* Now make a list of those streams that are less than ignore_streams_behind behind the leader */
 840         std::map<AudioStreamPtr, StreamState> alive_stream_states;
 841         for (auto const& i: _stream_states) {
 842                 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)) {
 843                         alive_stream_states.insert(i);
 844                 } else {
 845                         LOG_DEBUG_PLAYER("Ignoring stream %1 because it is too far behind", i.second.piece->content->path(0));
 846                 }
 847         }
 848
 849         auto pull_to = _playback_length.load();
 850         for (auto const& i: alive_stream_states) {
 851                 auto position = i.second.last_push_end.get_value_or(i.second.piece->content->position());
 852                 if (!i.second.piece->done && position < pull_to) {
 853                         pull_to = position;
 854                 }
 855         }
 856         if (!_silent.done() && _silent.position() < pull_to) {
 857                 pull_to = _silent.position();
 858         }
 859
 860         LOG_DEBUG_PLAYER("Emitting audio up to %1", to_string(pull_to));
 861         auto audio = _audio_merger.pull (pull_to);
 862         for (auto i = audio.begin(); i != audio.end(); ++i) {
 863                 if (_next_audio_time && i->second < *_next_audio_time) {
 864                         /* This new data comes before the last we emitted (or the last seek); discard it */
 865                         auto cut = discard_audio (i->first, i->second, *_next_audio_time);
 866                         if (!cut.first) {
 867                                 continue;
 868                         }
 869                         *i = cut;
 870                 } else if (_next_audio_time && i->second > *_next_audio_time) {
 871                         /* There's a gap between this data and the last we emitted; fill with silence */
 872                         fill_audio (DCPTimePeriod (*_next_audio_time, i->second));
 873                 }
 874
 875                 emit_audio (i->first, i->second);
 876         }
 877
 878         if (done) {
 879                 if (_shuffler) {
 880                         _shuffler->flush ();
 881                 }
 882                 for (auto const& i: _delay) {
 883                         do_emit_video(i.first, i.second);
 884                 }
 885
 886                 /* Perhaps we should have Empty entries for both eyes in the 3D case (somehow).
 887                  * However, if we have L and R video files, and one is shorter than the other,
 888                  * the fill code in ::video mostly takes care of filling in the gaps.
 889                  * However, since it fills at the point when it knows there is more video coming
 890                  * at time t (so it should fill any gap up to t) it can't do anything right at the
 891                  * end.  This is particularly bad news if the last frame emitted is a LEFT
 892                  * eye, as the MXF writer will complain about the 3D sequence being wrong.
 893                  * Here's a hack to workaround that particular case.
 894                  */
 895                 if (_next_video_eyes && _next_video_time && *_next_video_eyes == Eyes::RIGHT) {
 896                         do_emit_video (black_player_video_frame(Eyes::RIGHT), *_next_video_time);
 897                 }
 898         }
 899
 900         return done;
 901 }
 902
 903
 904 /** @return Open subtitles for the frame at the given time, converted to images */
 905 optional<PositionImage>
 906 Player::open_subtitles_for_frame (DCPTime time) const
 907 {
 908         auto film = _film.lock();
 909         if (!film) {
 910                 return {};
 911         }
 912
 913         list<PositionImage> captions;
 914         int const vfr = film->video_frame_rate();
 915
 916         for (
 917                 auto j:
 918                 _active_texts[TextType::OPEN_SUBTITLE].get_burnt(DCPTimePeriod(time, time + DCPTime::from_frames(1, vfr)), _always_burn_open_subtitles)
 919                 ) {
 920
 921                 /* Bitmap subtitles */
 922                 for (auto i: j.bitmap) {
 923                         if (!i.image) {
 924                                 continue;
 925                         }
 926
 927                         /* i.image will already have been scaled to fit _video_container_size */
 928                         dcp::Size scaled_size (i.rectangle.width * _video_container_size.load().width, i.rectangle.height * _video_container_size.load().height);
 929
 930                         captions.push_back (
 931                                 PositionImage (
 932                                         i.image,
 933                                         Position<int> (
 934                                                 lrint(_video_container_size.load().width * i.rectangle.x),
 935                                                 lrint(_video_container_size.load().height * i.rectangle.y)
 936                                                 )
 937                                         )
 938                                 );
 939                 }
 940
 941                 /* String subtitles (rendered to an image) */
 942                 if (!j.string.empty()) {
 943                         auto s = render_text(j.string, _video_container_size, time, vfr);
 944                         copy (s.begin(), s.end(), back_inserter (captions));
 945                 }
 946         }
 947
 948         if (captions.empty()) {
 949                 return {};
 950         }
 951
 952         return merge (captions, _subtitle_alignment);
 953 }
 954
 955
 956 static
 957 Eyes
 958 increment_eyes (Eyes e)
 959 {
 960         if (e == Eyes::LEFT) {
 961                 return Eyes::RIGHT;
 962         }
 963
 964         return Eyes::LEFT;
 965 }
 966
 967
 968 void
 969 Player::video (weak_ptr<Piece> weak_piece, ContentVideo video)
 970 {
 971         if (_suspended) {
 972                 return;
 973         }
 974
 975         auto piece = weak_piece.lock ();
 976         if (!piece) {
 977                 return;
 978         }
 979
 980         if (!piece->content->video->use()) {
 981                 return;
 982         }
 983
 984         auto film = _film.lock();
 985         if (!film) {
 986                 return;
 987         }
 988
 989         FrameRateChange frc(film, piece->content);
 990         if (frc.skip && (video.frame % 2) == 1) {
 991                 return;
 992         }
 993
 994         vector<Eyes> eyes_to_emit;
 995
 996         if (!film->three_d()) {
 997                 if (video.eyes == Eyes::RIGHT) {
 998                         /* 2D film, 3D content: discard right */
 999                         return;
1000                 } else if (video.eyes == Eyes::LEFT) {
1001                         /* 2D film, 3D content: emit left as "both" */
1002                         video.eyes = Eyes::BOTH;
1003                         eyes_to_emit = { Eyes::BOTH };
1004                 }
1005         } else {
1006                 if (video.eyes == Eyes::BOTH) {
1007                         /* 3D film, 2D content; emit "both" for left and right */
1008                         eyes_to_emit = { Eyes::LEFT, Eyes::RIGHT };
1009                 }
1010         }
1011
1012         if (eyes_to_emit.empty()) {
1013                 eyes_to_emit = { video.eyes };
1014         }
1015
1016         /* Time of the first frame we will emit */
1017         DCPTime const time = content_video_to_dcp (piece, video.frame);
1018         LOG_DEBUG_PLAYER("Received video frame %1 at %2", video.frame, to_string(time));
1019
1020         /* Discard if it's before the content's period or the last accurate seek.  We can't discard
1021            if it's after the content's period here as in that case we still need to fill any gap between
1022            `now' and the end of the content's period.
1023         */
1024         if (time < piece->content->position() || (_next_video_time && time < *_next_video_time)) {
1025                 return;
1026         }
1027
1028         auto ignore_video = std::find_if(
1029                 piece->ignore_video.begin(),
1030                 piece->ignore_video.end(),
1031                 [time](DCPTimePeriod period) { return period.contains(time); }
1032                 );
1033         if (ignore_video != piece->ignore_video.end()) {
1034                 return;
1035         }
1036
1037         /* Fill gaps that we discover now that we have some video which needs to be emitted.
1038            This is where we need to fill to.
1039         */
1040         DCPTime fill_to = min(time, piece->content->end(film));
1041
1042         if (_next_video_time) {
1043                 DCPTime fill_from = max (*_next_video_time, piece->content->position());
1044
1045                 /* Fill if we have more than half a frame to do */
1046                 if ((fill_to - fill_from) > one_video_frame() / 2) {
1047                         auto last = _last_video.find (weak_piece);
1048                         if (film->three_d()) {
1049                                 auto fill_to_eyes = eyes_to_emit[0];
1050                                 if (fill_to_eyes == Eyes::BOTH) {
1051                                         fill_to_eyes = Eyes::LEFT;
1052                                 }
1053                                 if (fill_to == piece->content->end(film)) {
1054                                         /* Don't fill after the end of the content */
1055                                         fill_to_eyes = Eyes::LEFT;
1056                                 }
1057                                 auto j = fill_from;
1058                                 auto eyes = _next_video_eyes.get_value_or(Eyes::LEFT);
1059                                 if (eyes == Eyes::BOTH) {
1060                                         eyes = Eyes::LEFT;
1061                                 }
1062                                 while (j < fill_to || eyes != fill_to_eyes) {
1063                                         if (last != _last_video.end()) {
1064                                                 LOG_DEBUG_PLAYER("Fill using last video at %1 in 3D mode", to_string(j));
1065                                                 auto copy = last->second->shallow_copy();
1066                                                 copy->set_eyes (eyes);
1067                                                 emit_video (copy, j);
1068                                         } else {
1069                                                 LOG_DEBUG_PLAYER("Fill using black at %1 in 3D mode", to_string(j));
1070                                                 emit_video (black_player_video_frame(eyes), j);
1071                                         }
1072                                         if (eyes == Eyes::RIGHT) {
1073                                                 j += one_video_frame();
1074                                         }
1075                                         eyes = increment_eyes (eyes);
1076                                 }
1077                         } else {
1078                                 for (DCPTime j = fill_from; j < fill_to; j += one_video_frame()) {
1079                                         if (last != _last_video.end()) {
1080                                                 emit_video (last->second, j);
1081                                         } else {
1082                                                 emit_video (black_player_video_frame(Eyes::BOTH), j);
1083                                         }
1084                                 }
1085                         }
1086                 }
1087         }
1088
1089         auto const content_video = piece->content->video;
1090
1091         for (auto eyes: eyes_to_emit) {
1092                 _last_video[weak_piece] = std::make_shared<PlayerVideo>(
1093                         video.image,
1094                         content_video->actual_crop(),
1095                         content_video->fade(film, video.frame),
1096                         scale_for_display(
1097                                 content_video->scaled_size(film->frame_size()),
1098                                 _video_container_size,
1099                                 film->frame_size(),
1100                                 content_video->pixel_quanta()
1101                                 ),
1102                         _video_container_size,
1103                         eyes,
1104                         video.part,
1105                         content_video->colour_conversion(),
1106                         content_video->range(),
1107                         piece->content,
1108                         video.frame,
1109                         false
1110                         );
1111
1112                 DCPTime t = time;
1113                 for (int i = 0; i < frc.repeat; ++i) {
1114                         if (t < piece->content->end(film)) {
1115                                 emit_video (_last_video[weak_piece], t);
1116                         }
1117                         t += one_video_frame ();
1118                 }
1119         }
1120 }
1121
1122
1123 void
1124 Player::audio (weak_ptr<Piece> weak_piece, AudioStreamPtr stream, ContentAudio content_audio)
1125 {
1126         if (_suspended) {
1127                 return;
1128         }
1129
1130         DCPOMATIC_ASSERT (content_audio.audio->frames() > 0);
1131
1132         auto piece = weak_piece.lock ();
1133         if (!piece) {
1134                 return;
1135         }
1136
1137         auto film = _film.lock();
1138         if (!film) {
1139                 return;
1140         }
1141
1142         auto content = piece->content->audio;
1143         DCPOMATIC_ASSERT (content);
1144
1145         int const rfr = content->resampled_frame_rate(film);
1146
1147         /* Compute time in the DCP */
1148         auto time = resampled_audio_to_dcp (piece, content_audio.frame);
1149
1150         /* And the end of this block in the DCP */
1151         auto end = time + DCPTime::from_frames(content_audio.audio->frames(), rfr);
1152         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());
1153
1154         /* Remove anything that comes before the start or after the end of the content */
1155         if (time < piece->content->position()) {
1156                 auto cut = discard_audio (content_audio.audio, time, piece->content->position());
1157                 if (!cut.first) {
1158                         /* This audio is entirely discarded */
1159                         return;
1160                 }
1161                 content_audio.audio = cut.first;
1162                 time = cut.second;
1163         } else if (time > piece->content->end(film)) {
1164                 /* Discard it all */
1165                 return;
1166         } else if (end > piece->content->end(film)) {
1167                 Frame const remaining_frames = DCPTime(piece->content->end(film) - time).frames_round(rfr);
1168                 if (remaining_frames == 0) {
1169                         return;
1170                 }
1171                 content_audio.audio = make_shared<AudioBuffers>(content_audio.audio, remaining_frames, 0);
1172         }
1173
1174         DCPOMATIC_ASSERT (content_audio.audio->frames() > 0);
1175
1176         /* Gain and fade */
1177
1178         auto const fade_coeffs = content->fade (stream, content_audio.frame, content_audio.audio->frames(), rfr);
1179         if (content->gain() != 0 || !fade_coeffs.empty()) {
1180                 auto gain_buffers = make_shared<AudioBuffers>(content_audio.audio);
1181                 if (!fade_coeffs.empty()) {
1182                         /* Apply both fade and gain */
1183                         DCPOMATIC_ASSERT (fade_coeffs.size() == static_cast<size_t>(gain_buffers->frames()));
1184                         auto const channels = gain_buffers->channels();
1185                         auto const frames = fade_coeffs.size();
1186                         auto data = gain_buffers->data();
1187                         auto const gain = db_to_linear (content->gain());
1188                         for (auto channel = 0; channel < channels; ++channel) {
1189                                 for (auto frame = 0U; frame < frames; ++frame) {
1190                                         data[channel][frame] *= gain * fade_coeffs[frame];
1191                                 }
1192                         }
1193                 } else {
1194                         /* Just apply gain */
1195                         gain_buffers->apply_gain (content->gain());
1196                 }
1197                 content_audio.audio = gain_buffers;
1198         }
1199
1200         /* Remap */
1201
1202         content_audio.audio = remap(content_audio.audio, film->audio_channels(), stream->mapping());
1203
1204         /* Process */
1205
1206         if (_audio_processor) {
1207                 content_audio.audio = _audio_processor->run(content_audio.audio, film->audio_channels());
1208         }
1209
1210         /* Push */
1211
1212         _audio_merger.push (content_audio.audio, time);
1213         DCPOMATIC_ASSERT (_stream_states.find (stream) != _stream_states.end ());
1214         _stream_states[stream].last_push_end = time + DCPTime::from_frames(content_audio.audio->frames(), film->audio_frame_rate());
1215 }
1216
1217
1218 void
1219 Player::bitmap_text_start (weak_ptr<Piece> weak_piece, weak_ptr<const TextContent> weak_content, ContentBitmapText subtitle)
1220 {
1221         if (_suspended) {
1222                 return;
1223         }
1224
1225         auto piece = weak_piece.lock ();
1226         auto content = weak_content.lock ();
1227         if (!piece || !content) {
1228                 return;
1229         }
1230
1231         PlayerText ps;
1232         for (auto& sub: subtitle.subs)
1233         {
1234                 /* Apply content's subtitle offsets */
1235                 sub.rectangle.x += content->x_offset ();
1236                 sub.rectangle.y += content->y_offset ();
1237
1238                 /* Apply a corrective translation to keep the subtitle centred after the scale that is coming up */
1239                 sub.rectangle.x -= sub.rectangle.width * ((content->x_scale() - 1) / 2);
1240                 sub.rectangle.y -= sub.rectangle.height * ((content->y_scale() - 1) / 2);
1241
1242                 /* Apply content's subtitle scale */
1243                 sub.rectangle.width *= content->x_scale ();
1244                 sub.rectangle.height *= content->y_scale ();
1245
1246                 auto image = sub.image;
1247
1248                 /* We will scale the subtitle up to fit _video_container_size */
1249                 int const width = sub.rectangle.width * _video_container_size.load().width;
1250                 int const height = sub.rectangle.height * _video_container_size.load().height;
1251                 if (width == 0 || height == 0) {
1252                         return;
1253                 }
1254
1255                 dcp::Size scaled_size (width, height);
1256                 ps.bitmap.push_back (BitmapText(image->scale(scaled_size, dcp::YUVToRGB::REC601, image->pixel_format(), Image::Alignment::PADDED, _fast), sub.rectangle));
1257         }
1258
1259         DCPTime from(content_time_to_dcp(piece, subtitle.from()));
1260         _active_texts[content->type()].add_from(weak_content, ps, from);
1261 }
1262
1263
1264 void
1265 Player::plain_text_start (weak_ptr<Piece> weak_piece, weak_ptr<const TextContent> weak_content, ContentStringText subtitle)
1266 {
1267         if (_suspended) {
1268                 return;
1269         }
1270
1271         auto piece = weak_piece.lock ();
1272         auto content = weak_content.lock ();
1273         auto film = _film.lock();
1274         if (!piece || !content || !film) {
1275                 return;
1276         }
1277
1278         PlayerText ps;
1279         DCPTime const from (content_time_to_dcp (piece, subtitle.from()));
1280
1281         if (from > piece->content->end(film)) {
1282                 return;
1283         }
1284
1285         for (auto s: subtitle.subs) {
1286                 s.set_h_position (s.h_position() + content->x_offset());
1287                 s.set_v_position (s.v_position() + content->y_offset());
1288                 float const xs = content->x_scale();
1289                 float const ys = content->y_scale();
1290                 float size = s.size();
1291
1292                 /* Adjust size to express the common part of the scaling;
1293                    e.g. if xs = ys = 0.5 we scale size by 2.
1294                 */
1295                 if (xs > 1e-5 && ys > 1e-5) {
1296                         size *= 1 / min (1 / xs, 1 / ys);
1297                 }
1298                 s.set_size (size);
1299
1300                 /* Then express aspect ratio changes */
1301                 if (fabs (1.0 - xs / ys) > dcp::ASPECT_ADJUST_EPSILON) {
1302                         s.set_aspect_adjust (xs / ys);
1303                 }
1304
1305                 s.set_in (dcp::Time(from.seconds(), 1000));
1306                 ps.string.push_back (s);
1307         }
1308
1309         _active_texts[content->type()].add_from(weak_content, ps, from);
1310 }
1311
1312
1313 void
1314 Player::subtitle_stop (weak_ptr<Piece> weak_piece, weak_ptr<const TextContent> weak_content, ContentTime to)
1315 {
1316         if (_suspended) {
1317                 return;
1318         }
1319
1320         auto content = weak_content.lock ();
1321         if (!content) {
1322                 return;
1323         }
1324
1325         if (!_active_texts[content->type()].have(weak_content)) {
1326                 return;
1327         }
1328
1329         auto piece = weak_piece.lock ();
1330         auto film = _film.lock();
1331         if (!piece || !film) {
1332                 return;
1333         }
1334
1335         DCPTime const dcp_to = content_time_to_dcp (piece, to);
1336
1337         if (dcp_to > piece->content->end(film)) {
1338                 return;
1339         }
1340
1341         auto from = _active_texts[content->type()].add_to(weak_content, dcp_to);
1342
1343         bool const always = (content->type() == TextType::OPEN_SUBTITLE && _always_burn_open_subtitles);
1344         if (content->use() && !always && !content->burn()) {
1345                 Text (from.first, content->type(), content->dcp_track().get_value_or(DCPTextTrack()), DCPTimePeriod(from.second, dcp_to));
1346         }
1347 }
1348
1349
1350 void
1351 Player::seek (DCPTime time, bool accurate)
1352 {
1353         boost::mutex::scoped_lock lm (_mutex);
1354         LOG_DEBUG_PLAYER("Seek to %1 (%2accurate)", to_string(time), accurate ? "" : "in");
1355
1356         if (_suspended) {
1357                 /* We can't seek in this state */
1358                 return;
1359         }
1360
1361         auto film = _film.lock();
1362         if (!film) {
1363                 return;
1364         }
1365
1366         if (_shuffler) {
1367                 _shuffler->clear ();
1368         }
1369
1370         _delay.clear ();
1371
1372         if (_audio_processor) {
1373                 _audio_processor->flush ();
1374         }
1375
1376         _audio_merger.clear ();
1377         std::for_each(_active_texts.begin(), _active_texts.end(), [](ActiveText& a) { a.clear(); });
1378
1379         for (auto i: _pieces) {
1380                 if (time < i->content->position()) {
1381                         /* Before; seek to the start of the content.  Even if this request is for an inaccurate seek
1382                            we must seek this (following) content accurately, otherwise when we come to the end of the current
1383                            content we may not start right at the beginning of the next, causing a gap (if the next content has
1384                            been trimmed to a point between keyframes, or something).
1385                         */
1386                         i->decoder->seek (dcp_to_content_time (i, i->content->position()), true);
1387                         i->done = false;
1388                 } else if (i->content->position() <= time && time < i->content->end(film)) {
1389                         /* During; seek to position */
1390                         i->decoder->seek (dcp_to_content_time (i, time), accurate);
1391                         i->done = false;
1392                 } else {
1393                         /* After; this piece is done */
1394                         i->done = true;
1395                 }
1396         }
1397
1398         if (accurate) {
1399                 _next_video_time = time;
1400                 _next_video_eyes = Eyes::LEFT;
1401                 _next_audio_time = time;
1402         } else {
1403                 _next_video_time = boost::none;
1404                 _next_video_eyes = boost::none;
1405                 _next_audio_time = boost::none;
1406         }
1407
1408         _black.set_position (time);
1409         _silent.set_position (time);
1410
1411         _last_video.clear ();
1412
1413         for (auto& state: _stream_states) {
1414                 state.second.last_push_end = boost::none;
1415         }
1416 }
1417
1418
1419 void
1420 Player::emit_video (shared_ptr<PlayerVideo> pv, DCPTime time)
1421 {
1422         auto film = _film.lock();
1423         DCPOMATIC_ASSERT(film);
1424
1425         if (!film->three_d()) {
1426                 if (pv->eyes() == Eyes::LEFT) {
1427                         /* Use left-eye images for both eyes... */
1428                         pv->set_eyes (Eyes::BOTH);
1429                 } else if (pv->eyes() == Eyes::RIGHT) {
1430                         /* ...and discard the right */
1431                         return;
1432                 }
1433         }
1434
1435         /* We need a delay to give a little wiggle room to ensure that relevant subtitles arrive at the
1436            player before the video that requires them.
1437         */
1438         _delay.push_back (make_pair (pv, time));
1439
1440         if (pv->eyes() == Eyes::BOTH || pv->eyes() == Eyes::RIGHT) {
1441                 _next_video_time = time + one_video_frame();
1442         }
1443         _next_video_eyes = increment_eyes (pv->eyes());
1444
1445         if (_delay.size() < 3) {
1446                 return;
1447         }
1448
1449         auto to_do = _delay.front();
1450         _delay.pop_front();
1451         do_emit_video (to_do.first, to_do.second);
1452 }
1453
1454
1455 void
1456 Player::do_emit_video (shared_ptr<PlayerVideo> pv, DCPTime time)
1457 {
1458         if (pv->eyes() == Eyes::BOTH || pv->eyes() == Eyes::RIGHT) {
1459                 std::for_each(_active_texts.begin(), _active_texts.end(), [time](ActiveText& a) { a.clear_before(time); });
1460         }
1461
1462         auto subtitles = open_subtitles_for_frame (time);
1463         if (subtitles) {
1464                 pv->set_text (subtitles.get ());
1465         }
1466
1467         Video (pv, time);
1468 }
1469
1470
1471 void
1472 Player::emit_audio (shared_ptr<AudioBuffers> data, DCPTime time)
1473 {
1474         auto film = _film.lock();
1475         DCPOMATIC_ASSERT(film);
1476
1477         /* Log if the assert below is about to fail */
1478         if (_next_audio_time && labs(time.get() - _next_audio_time->get()) > 1) {
1479                 film->log()->log(String::compose("Out-of-sequence emit %1 vs %2", to_string(time), to_string(*_next_audio_time)), LogEntry::TYPE_WARNING);
1480         }
1481
1482         /* This audio must follow on from the previous, allowing for half a sample (at 48kHz) leeway */
1483         DCPOMATIC_ASSERT (!_next_audio_time || labs(time.get() - _next_audio_time->get()) < 2);
1484         Audio(data, time, film->audio_frame_rate());
1485         _next_audio_time = time + DCPTime::from_frames(data->frames(), film->audio_frame_rate());
1486 }
1487
1488
1489 void
1490 Player::fill_audio (DCPTimePeriod period)
1491 {
1492         auto film = _film.lock();
1493         DCPOMATIC_ASSERT(film);
1494
1495         if (period.from == period.to) {
1496                 return;
1497         }
1498
1499         DCPOMATIC_ASSERT (period.from < period.to);
1500
1501         DCPTime t = period.from;
1502         while (t < period.to) {
1503                 DCPTime block = min (DCPTime::from_seconds (0.5), period.to - t);
1504                 Frame const samples = block.frames_round(film->audio_frame_rate());
1505                 if (samples) {
1506                         auto silence = make_shared<AudioBuffers>(film->audio_channels(), samples);
1507                         silence->make_silent ();
1508                         emit_audio (silence, t);
1509                 }
1510                 t += block;
1511         }
1512 }
1513
1514
1515 DCPTime
1516 Player::one_video_frame () const
1517 {
1518         auto film = _film.lock();
1519         DCPOMATIC_ASSERT(film);
1520
1521         return DCPTime::from_frames(1, film->video_frame_rate ());
1522 }
1523
1524
1525 pair<shared_ptr<AudioBuffers>, DCPTime>
1526 Player::discard_audio (shared_ptr<const AudioBuffers> audio, DCPTime time, DCPTime discard_to) const
1527 {
1528         auto film = _film.lock();
1529         DCPOMATIC_ASSERT(film);
1530
1531         auto const discard_time = discard_to - time;
1532         auto const discard_frames = discard_time.frames_round(film->audio_frame_rate());
1533         auto remaining_frames = audio->frames() - discard_frames;
1534         if (remaining_frames <= 0) {
1535                 return make_pair(shared_ptr<AudioBuffers>(), DCPTime());
1536         }
1537         auto cut = make_shared<AudioBuffers>(audio, remaining_frames, discard_frames);
1538         return make_pair(cut, time + discard_time);
1539 }
1540
1541
1542 void
1543 Player::set_dcp_decode_reduction (optional<int> reduction)
1544 {
1545         ChangeSignaller<Player, int> cc(this, PlayerProperty::DCP_DECODE_REDUCTION);
1546
1547         if (reduction == _dcp_decode_reduction.load()) {
1548                 cc.abort();
1549                 return;
1550         }
1551
1552         _dcp_decode_reduction = reduction;
1553         setup_pieces();
1554 }
1555
1556
1557 optional<DCPTime>
1558 Player::content_time_to_dcp (shared_ptr<const Content> content, ContentTime t) const
1559 {
1560         boost::mutex::scoped_lock lm (_mutex);
1561
1562         for (auto i: _pieces) {
1563                 if (i->content == content) {
1564                         return content_time_to_dcp (i, t);
1565                 }
1566         }
1567
1568         /* We couldn't find this content; perhaps things are being changed over */
1569         return {};
1570 }
1571
1572
1573 optional<ContentTime>
1574 Player::dcp_to_content_time (shared_ptr<const Content> content, DCPTime t) const
1575 {
1576         boost::mutex::scoped_lock lm (_mutex);
1577
1578         for (auto i: _pieces) {
1579                 if (i->content == content) {
1580                         return dcp_to_content_time (i, t);
1581                 }
1582         }
1583
1584         /* We couldn't find this content; perhaps things are being changed over */
1585         return {};
1586 }
1587
1588
1589 shared_ptr<const Playlist>
1590 Player::playlist () const
1591 {
1592         auto film = _film.lock();
1593         if (!film) {
1594                 return {};
1595         }
1596
1597         return _playlist ? _playlist : film->playlist();
1598 }
1599
1600
1601 void
1602 Player::atmos (weak_ptr<Piece> weak_piece, ContentAtmos data)
1603 {
1604         if (_suspended) {
1605                 return;
1606         }
1607
1608         auto film = _film.lock();
1609         DCPOMATIC_ASSERT(film);
1610
1611         auto piece = weak_piece.lock ();
1612         DCPOMATIC_ASSERT (piece);
1613
1614         auto const vfr = film->video_frame_rate();
1615
1616         DCPTime const dcp_time = DCPTime::from_frames(data.frame, vfr) - DCPTime(piece->content->trim_start(), FrameRateChange(vfr, vfr));
1617         if (dcp_time < piece->content->position() || dcp_time >= (piece->content->end(film))) {
1618                 return;
1619         }
1620
1621         auto ignore_atmos = std::find_if(
1622                 piece->ignore_atmos.begin(),
1623                 piece->ignore_atmos.end(),
1624                 [dcp_time](DCPTimePeriod period) { return period.contains(dcp_time); }
1625                 );
1626         if (ignore_atmos != piece->ignore_atmos.end()) {
1627                 return;
1628         }
1629
1630         Atmos (data.data, dcp_time, data.metadata);
1631 }
1632
1633
1634 void
1635 Player::signal_change(ChangeType type, int property)
1636 {
1637         Change(type, property, false);
1638 }
1639