Merge branch 'master' of ssh://git.carlh.net/home/carl/git/dcpomatic
[dcpomatic.git] / src / lib / player.cc
1 /*
2     Copyright (C) 2013-2018 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 #include "player.h"
22 #include "film.h"
23 #include "audio_buffers.h"
24 #include "content_audio.h"
25 #include "dcp_content.h"
26 #include "job.h"
27 #include "image.h"
28 #include "raw_image_proxy.h"
29 #include "ratio.h"
30 #include "log.h"
31 #include "render_subtitles.h"
32 #include "config.h"
33 #include "content_video.h"
34 #include "player_video.h"
35 #include "frame_rate_change.h"
36 #include "audio_processor.h"
37 #include "playlist.h"
38 #include "referenced_reel_asset.h"
39 #include "decoder_factory.h"
40 #include "decoder.h"
41 #include "video_decoder.h"
42 #include "audio_decoder.h"
43 #include "subtitle_content.h"
44 #include "subtitle_decoder.h"
45 #include "ffmpeg_content.h"
46 #include "audio_content.h"
47 #include "content_subtitle.h"
48 #include "dcp_decoder.h"
49 #include "image_decoder.h"
50 #include "compose.hpp"
51 #include "shuffler.h"
52 #include <dcp/reel.h>
53 #include <dcp/reel_sound_asset.h>
54 #include <dcp/reel_subtitle_asset.h>
55 #include <dcp/reel_picture_asset.h>
56 #include <boost/foreach.hpp>
57 #include <stdint.h>
58 #include <algorithm>
59 #include <iostream>
60
61 #include "i18n.h"
62
63 #define LOG_GENERAL(...) _film->log()->log (String::compose (__VA_ARGS__), LogEntry::TYPE_GENERAL);
64
65 using std::list;
66 using std::cout;
67 using std::min;
68 using std::max;
69 using std::min;
70 using std::vector;
71 using std::pair;
72 using std::map;
73 using std::make_pair;
74 using std::copy;
75 using boost::shared_ptr;
76 using boost::weak_ptr;
77 using boost::dynamic_pointer_cast;
78 using boost::optional;
79 using boost::scoped_ptr;
80
81 Player::Player (shared_ptr<const Film> film, shared_ptr<const Playlist> playlist)
82         : _film (film)
83         , _playlist (playlist)
84         , _have_valid_pieces (false)
85         , _ignore_video (false)
86         , _ignore_subtitle (false)
87         , _always_burn_subtitles (false)
88         , _fast (false)
89         , _play_referenced (false)
90         , _audio_merger (_film->audio_frame_rate())
91         , _shuffler (0)
92 {
93         _film_changed_connection = _film->Changed.connect (bind (&Player::film_changed, this, _1));
94         _playlist_changed_connection = _playlist->Changed.connect (bind (&Player::playlist_changed, this));
95         _playlist_content_changed_connection = _playlist->ContentChanged.connect (bind (&Player::playlist_content_changed, this, _1, _2, _3));
96         set_video_container_size (_film->frame_size ());
97
98         film_changed (Film::AUDIO_PROCESSOR);
99
100         seek (DCPTime (), true);
101 }
102
103 Player::~Player ()
104 {
105         delete _shuffler;
106 }
107
108 void
109 Player::setup_pieces ()
110 {
111         _pieces.clear ();
112
113         delete _shuffler;
114         _shuffler = new Shuffler();
115         _shuffler->Video.connect(bind(&Player::video, this, _1, _2));
116
117         BOOST_FOREACH (shared_ptr<Content> i, _playlist->content ()) {
118
119                 if (!i->paths_valid ()) {
120                         continue;
121                 }
122
123                 shared_ptr<Decoder> decoder = decoder_factory (i, _film->log(), _fast);
124                 FrameRateChange frc (i->active_video_frame_rate(), _film->video_frame_rate());
125
126                 if (!decoder) {
127                         /* Not something that we can decode; e.g. Atmos content */
128                         continue;
129                 }
130
131                 if (decoder->video && _ignore_video) {
132                         decoder->video->set_ignore ();
133                 }
134
135                 if (decoder->subtitle && _ignore_subtitle) {
136                         decoder->subtitle->set_ignore ();
137                 }
138
139                 shared_ptr<DCPDecoder> dcp = dynamic_pointer_cast<DCPDecoder> (decoder);
140                 if (dcp && _play_referenced) {
141                         if (_play_referenced) {
142                                 dcp->set_decode_referenced ();
143                         }
144                         dcp->set_forced_reduction (_dcp_decode_reduction);
145                 }
146
147                 shared_ptr<Piece> piece (new Piece (i, decoder, frc));
148                 _pieces.push_back (piece);
149
150                 if (decoder->video) {
151                         if (i->video->frame_type() == VIDEO_FRAME_TYPE_3D_LEFT || i->video->frame_type() == VIDEO_FRAME_TYPE_3D_RIGHT) {
152                                 decoder->video->Data.connect (bind (&Shuffler::video, _shuffler, weak_ptr<Piece>(piece), _1));
153                         } else {
154                                 decoder->video->Data.connect (bind (&Player::video, this, weak_ptr<Piece>(piece), _1));
155                         }
156                 }
157
158                 if (decoder->audio) {
159                         decoder->audio->Data.connect (bind (&Player::audio, this, weak_ptr<Piece> (piece), _1, _2));
160                 }
161
162                 if (decoder->subtitle) {
163                         decoder->subtitle->ImageStart.connect (bind (&Player::image_subtitle_start, this, weak_ptr<Piece> (piece), _1));
164                         decoder->subtitle->TextStart.connect (bind (&Player::text_subtitle_start, this, weak_ptr<Piece> (piece), _1));
165                         decoder->subtitle->Stop.connect (bind (&Player::subtitle_stop, this, weak_ptr<Piece> (piece), _1));
166                 }
167         }
168
169         _stream_states.clear ();
170         BOOST_FOREACH (shared_ptr<Piece> i, _pieces) {
171                 if (i->content->audio) {
172                         BOOST_FOREACH (AudioStreamPtr j, i->content->audio->streams()) {
173                                 _stream_states[j] = StreamState (i, i->content->position ());
174                         }
175                 }
176         }
177
178         _black = Empty (_film->content(), _film->length(), bind(&Content::video, _1));
179         _silent = Empty (_film->content(), _film->length(), bind(&Content::audio, _1));
180
181         _last_video_time = DCPTime ();
182         _last_video_eyes = EYES_BOTH;
183         _last_audio_time = DCPTime ();
184         _have_valid_pieces = true;
185 }
186
187 void
188 Player::playlist_content_changed (weak_ptr<Content> w, int property, bool frequent)
189 {
190         shared_ptr<Content> c = w.lock ();
191         if (!c) {
192                 return;
193         }
194
195         if (
196                 property == ContentProperty::POSITION ||
197                 property == ContentProperty::LENGTH ||
198                 property == ContentProperty::TRIM_START ||
199                 property == ContentProperty::TRIM_END ||
200                 property == ContentProperty::PATH ||
201                 property == VideoContentProperty::FRAME_TYPE ||
202                 property == DCPContentProperty::NEEDS_ASSETS ||
203                 property == DCPContentProperty::NEEDS_KDM ||
204                 property == SubtitleContentProperty::COLOUR ||
205                 property == SubtitleContentProperty::EFFECT ||
206                 property == SubtitleContentProperty::EFFECT_COLOUR ||
207                 property == FFmpegContentProperty::SUBTITLE_STREAM ||
208                 property == FFmpegContentProperty::FILTERS ||
209                 property == VideoContentProperty::COLOUR_CONVERSION
210                 ) {
211
212                 _have_valid_pieces = false;
213                 Changed (frequent);
214
215         } else if (
216                 property == SubtitleContentProperty::LINE_SPACING ||
217                 property == SubtitleContentProperty::OUTLINE_WIDTH ||
218                 property == SubtitleContentProperty::Y_SCALE ||
219                 property == SubtitleContentProperty::FADE_IN ||
220                 property == SubtitleContentProperty::FADE_OUT ||
221                 property == ContentProperty::VIDEO_FRAME_RATE ||
222                 property == SubtitleContentProperty::USE ||
223                 property == SubtitleContentProperty::X_OFFSET ||
224                 property == SubtitleContentProperty::Y_OFFSET ||
225                 property == SubtitleContentProperty::X_SCALE ||
226                 property == SubtitleContentProperty::FONTS ||
227                 property == VideoContentProperty::CROP ||
228                 property == VideoContentProperty::SCALE ||
229                 property == VideoContentProperty::FADE_IN ||
230                 property == VideoContentProperty::FADE_OUT
231                 ) {
232
233                 Changed (frequent);
234         }
235 }
236
237 void
238 Player::set_video_container_size (dcp::Size s)
239 {
240         if (s == _video_container_size) {
241                 return;
242         }
243
244         _video_container_size = s;
245
246         _black_image.reset (new Image (AV_PIX_FMT_RGB24, _video_container_size, true));
247         _black_image->make_black ();
248
249         Changed (false);
250 }
251
252 void
253 Player::playlist_changed ()
254 {
255         _have_valid_pieces = false;
256         Changed (false);
257 }
258
259 void
260 Player::film_changed (Film::Property p)
261 {
262         /* Here we should notice Film properties that affect our output, and
263            alert listeners that our output now would be different to how it was
264            last time we were run.
265         */
266
267         if (p == Film::CONTAINER) {
268                 Changed (false);
269         } else if (p == Film::VIDEO_FRAME_RATE) {
270                 /* Pieces contain a FrameRateChange which contains the DCP frame rate,
271                    so we need new pieces here.
272                 */
273                 _have_valid_pieces = false;
274                 Changed (false);
275         } else if (p == Film::AUDIO_PROCESSOR) {
276                 if (_film->audio_processor ()) {
277                         _audio_processor = _film->audio_processor()->clone (_film->audio_frame_rate ());
278                 }
279         }
280 }
281
282 list<PositionImage>
283 Player::transform_image_subtitles (list<ImageSubtitle> subs) const
284 {
285         list<PositionImage> all;
286
287         for (list<ImageSubtitle>::const_iterator i = subs.begin(); i != subs.end(); ++i) {
288                 if (!i->image) {
289                         continue;
290                 }
291
292                 /* We will scale the subtitle up to fit _video_container_size */
293                 dcp::Size scaled_size (i->rectangle.width * _video_container_size.width, i->rectangle.height * _video_container_size.height);
294
295                 /* Then we need a corrective translation, consisting of two parts:
296                  *
297                  * 1.  that which is the result of the scaling of the subtitle by _video_container_size; this will be
298                  *     rect.x * _video_container_size.width and rect.y * _video_container_size.height.
299                  *
300                  * 2.  that to shift the origin of the scale by subtitle_scale to the centre of the subtitle; this will be
301                  *     (width_before_subtitle_scale * (1 - subtitle_x_scale) / 2) and
302                  *     (height_before_subtitle_scale * (1 - subtitle_y_scale) / 2).
303                  *
304                  * Combining these two translations gives these expressions.
305                  */
306
307                 all.push_back (
308                         PositionImage (
309                                 i->image->scale (
310                                         scaled_size,
311                                         dcp::YUV_TO_RGB_REC601,
312                                         i->image->pixel_format (),
313                                         true,
314                                         _fast
315                                         ),
316                                 Position<int> (
317                                         lrint (_video_container_size.width * i->rectangle.x),
318                                         lrint (_video_container_size.height * i->rectangle.y)
319                                         )
320                                 )
321                         );
322         }
323
324         return all;
325 }
326
327 shared_ptr<PlayerVideo>
328 Player::black_player_video_frame (Eyes eyes) const
329 {
330         return shared_ptr<PlayerVideo> (
331                 new PlayerVideo (
332                         shared_ptr<const ImageProxy> (new RawImageProxy (_black_image)),
333                         Crop (),
334                         optional<double> (),
335                         _video_container_size,
336                         _video_container_size,
337                         eyes,
338                         PART_WHOLE,
339                         PresetColourConversion::all().front().conversion
340                 )
341         );
342 }
343
344 Frame
345 Player::dcp_to_content_video (shared_ptr<const Piece> piece, DCPTime t) const
346 {
347         DCPTime s = t - piece->content->position ();
348         s = min (piece->content->length_after_trim(), s);
349         s = max (DCPTime(), s + DCPTime (piece->content->trim_start(), piece->frc));
350
351         /* It might seem more logical here to convert s to a ContentTime (using the FrameRateChange)
352            then convert that ContentTime to frames at the content's rate.  However this fails for
353            situations like content at 29.9978733fps, DCP at 30fps.  The accuracy of the Time type is not
354            enough to distinguish between the two with low values of time (e.g. 3200 in Time units).
355
356            Instead we convert the DCPTime using the DCP video rate then account for any skip/repeat.
357         */
358         return s.frames_floor (piece->frc.dcp) / piece->frc.factor ();
359 }
360
361 DCPTime
362 Player::content_video_to_dcp (shared_ptr<const Piece> piece, Frame f) const
363 {
364         /* See comment in dcp_to_content_video */
365         DCPTime const d = DCPTime::from_frames (f * piece->frc.factor(), piece->frc.dcp) - DCPTime(piece->content->trim_start(), piece->frc);
366         return d + piece->content->position();
367 }
368
369 Frame
370 Player::dcp_to_resampled_audio (shared_ptr<const Piece> piece, DCPTime t) const
371 {
372         DCPTime s = t - piece->content->position ();
373         s = min (piece->content->length_after_trim(), s);
374         /* See notes in dcp_to_content_video */
375         return max (DCPTime (), DCPTime (piece->content->trim_start (), piece->frc) + s).frames_floor (_film->audio_frame_rate ());
376 }
377
378 DCPTime
379 Player::resampled_audio_to_dcp (shared_ptr<const Piece> piece, Frame f) const
380 {
381         /* See comment in dcp_to_content_video */
382         return DCPTime::from_frames (f, _film->audio_frame_rate())
383                 - DCPTime (piece->content->trim_start(), piece->frc)
384                 + piece->content->position();
385 }
386
387 ContentTime
388 Player::dcp_to_content_time (shared_ptr<const Piece> piece, DCPTime t) const
389 {
390         DCPTime s = t - piece->content->position ();
391         s = min (piece->content->length_after_trim(), s);
392         return max (ContentTime (), ContentTime (s, piece->frc) + piece->content->trim_start());
393 }
394
395 DCPTime
396 Player::content_time_to_dcp (shared_ptr<const Piece> piece, ContentTime t) const
397 {
398         return max (DCPTime (), DCPTime (t - piece->content->trim_start(), piece->frc) + piece->content->position());
399 }
400
401 list<shared_ptr<Font> >
402 Player::get_subtitle_fonts ()
403 {
404         if (!_have_valid_pieces) {
405                 setup_pieces ();
406         }
407
408         list<shared_ptr<Font> > fonts;
409         BOOST_FOREACH (shared_ptr<Piece>& p, _pieces) {
410                 if (p->content->subtitle) {
411                         /* XXX: things may go wrong if there are duplicate font IDs
412                            with different font files.
413                         */
414                         list<shared_ptr<Font> > f = p->content->subtitle->fonts ();
415                         copy (f.begin(), f.end(), back_inserter (fonts));
416                 }
417         }
418
419         return fonts;
420 }
421
422 /** Set this player never to produce any video data */
423 void
424 Player::set_ignore_video ()
425 {
426         _ignore_video = true;
427 }
428
429 void
430 Player::set_ignore_subtitle ()
431 {
432         _ignore_subtitle = true;
433 }
434
435 /** Set whether or not this player should always burn text subtitles into the image,
436  *  regardless of the content settings.
437  *  @param burn true to always burn subtitles, false to obey content settings.
438  */
439 void
440 Player::set_always_burn_subtitles (bool burn)
441 {
442         _always_burn_subtitles = burn;
443 }
444
445 /** Sets up the player to be faster, possibly at the expense of quality */
446 void
447 Player::set_fast ()
448 {
449         _fast = true;
450         _have_valid_pieces = false;
451 }
452
453 void
454 Player::set_play_referenced ()
455 {
456         _play_referenced = true;
457         _have_valid_pieces = false;
458 }
459
460 list<ReferencedReelAsset>
461 Player::get_reel_assets ()
462 {
463         list<ReferencedReelAsset> a;
464
465         BOOST_FOREACH (shared_ptr<Content> i, _playlist->content ()) {
466                 shared_ptr<DCPContent> j = dynamic_pointer_cast<DCPContent> (i);
467                 if (!j) {
468                         continue;
469                 }
470
471                 scoped_ptr<DCPDecoder> decoder;
472                 try {
473                         decoder.reset (new DCPDecoder (j, _film->log(), false));
474                 } catch (...) {
475                         return a;
476                 }
477
478                 int64_t offset = 0;
479                 BOOST_FOREACH (shared_ptr<dcp::Reel> k, decoder->reels()) {
480
481                         DCPOMATIC_ASSERT (j->video_frame_rate ());
482                         double const cfr = j->video_frame_rate().get();
483                         Frame const trim_start = j->trim_start().frames_round (cfr);
484                         Frame const trim_end = j->trim_end().frames_round (cfr);
485                         int const ffr = _film->video_frame_rate ();
486
487                         DCPTime const from = i->position() + DCPTime::from_frames (offset, _film->video_frame_rate());
488                         if (j->reference_video ()) {
489                                 shared_ptr<dcp::ReelAsset> ra = k->main_picture ();
490                                 DCPOMATIC_ASSERT (ra);
491                                 ra->set_entry_point (ra->entry_point() + trim_start);
492                                 ra->set_duration (ra->duration() - trim_start - trim_end);
493                                 a.push_back (
494                                         ReferencedReelAsset (ra, DCPTimePeriod (from, from + DCPTime::from_frames (ra->duration(), ffr)))
495                                         );
496                         }
497
498                         if (j->reference_audio ()) {
499                                 shared_ptr<dcp::ReelAsset> ra = k->main_sound ();
500                                 DCPOMATIC_ASSERT (ra);
501                                 ra->set_entry_point (ra->entry_point() + trim_start);
502                                 ra->set_duration (ra->duration() - trim_start - trim_end);
503                                 a.push_back (
504                                         ReferencedReelAsset (ra, DCPTimePeriod (from, from + DCPTime::from_frames (ra->duration(), ffr)))
505                                         );
506                         }
507
508                         if (j->reference_subtitle ()) {
509                                 shared_ptr<dcp::ReelAsset> ra = k->main_subtitle ();
510                                 DCPOMATIC_ASSERT (ra);
511                                 ra->set_entry_point (ra->entry_point() + trim_start);
512                                 ra->set_duration (ra->duration() - trim_start - trim_end);
513                                 a.push_back (
514                                         ReferencedReelAsset (ra, DCPTimePeriod (from, from + DCPTime::from_frames (ra->duration(), ffr)))
515                                         );
516                         }
517
518                         /* Assume that main picture duration is the length of the reel */
519                         offset += k->main_picture()->duration ();
520                 }
521         }
522
523         return a;
524 }
525
526 bool
527 Player::pass ()
528 {
529         if (!_have_valid_pieces) {
530                 setup_pieces ();
531         }
532
533         if (_playlist->length() == DCPTime()) {
534                 /* Special case of an empty Film; just give one black frame */
535                 emit_video (black_player_video_frame(EYES_BOTH), DCPTime());
536                 return true;
537         }
538
539         /* Find the decoder or empty which is farthest behind where we are and make it emit some data */
540
541         shared_ptr<Piece> earliest_content;
542         optional<DCPTime> earliest_time;
543
544         BOOST_FOREACH (shared_ptr<Piece> i, _pieces) {
545                 if (i->done) {
546                         continue;
547                 }
548
549                 DCPTime const t = content_time_to_dcp (i, i->decoder->position());
550                 if (t > i->content->end()) {
551                         i->done = true;
552                 } else {
553
554                         /* Given two choices at the same time, pick the one with a subtitle so we see it before
555                            the video.
556                         */
557                         if (!earliest_time || t < *earliest_time || (t == *earliest_time && i->decoder->subtitle)) {
558                                 earliest_time = t;
559                                 earliest_content = i;
560                         }
561                 }
562         }
563
564         bool done = false;
565
566         enum {
567                 NONE,
568                 CONTENT,
569                 BLACK,
570                 SILENT
571         } which = NONE;
572
573         if (earliest_content) {
574                 which = CONTENT;
575         }
576
577         if (!_black.done() && (!earliest_time || _black.position() < *earliest_time)) {
578                 earliest_time = _black.position ();
579                 which = BLACK;
580         }
581
582         if (!_silent.done() && (!earliest_time || _silent.position() < *earliest_time)) {
583                 earliest_time = _silent.position ();
584                 which = SILENT;
585         }
586
587         switch (which) {
588         case CONTENT:
589                 earliest_content->done = earliest_content->decoder->pass ();
590                 break;
591         case BLACK:
592                 emit_video (black_player_video_frame(EYES_BOTH), _black.position());
593                 _black.set_position (_black.position() + one_video_frame());
594                 break;
595         case SILENT:
596         {
597                 DCPTimePeriod period (_silent.period_at_position());
598                 if (_last_audio_time) {
599                         /* Sometimes the thing that happened last finishes fractionally before
600                            this silence.  Bodge the start time of the silence to fix it.  I'm
601                            not sure if this is the right solution --- maybe the last thing should
602                            be padded `forward' rather than this thing padding `back'.
603                         */
604                         period.from = min(period.from, *_last_audio_time);
605                 }
606                 if (period.duration() > one_video_frame()) {
607                         period.to = period.from + one_video_frame();
608                 }
609                 fill_audio (period);
610                 _silent.set_position (period.to);
611                 break;
612         }
613         case NONE:
614                 done = true;
615                 break;
616         }
617
618         /* Emit any audio that is ready */
619
620         /* Work out the time before which the audio is definitely all here.  This is the earliest last_push_end of one
621            of our streams, or the position of the _silent.
622         */
623         DCPTime pull_to = _film->length ();
624         for (map<AudioStreamPtr, StreamState>::const_iterator i = _stream_states.begin(); i != _stream_states.end(); ++i) {
625                 if (!i->second.piece->done && i->second.last_push_end < pull_to) {
626                         pull_to = i->second.last_push_end;
627                 }
628         }
629         if (!_silent.done() && _silent.position() < pull_to) {
630                 pull_to = _silent.position();
631         }
632
633         list<pair<shared_ptr<AudioBuffers>, DCPTime> > audio = _audio_merger.pull (pull_to);
634         for (list<pair<shared_ptr<AudioBuffers>, DCPTime> >::iterator i = audio.begin(); i != audio.end(); ++i) {
635                 if (_last_audio_time && i->second < *_last_audio_time) {
636                         /* This new data comes before the last we emitted (or the last seek); discard it */
637                         pair<shared_ptr<AudioBuffers>, DCPTime> cut = discard_audio (i->first, i->second, *_last_audio_time);
638                         if (!cut.first) {
639                                 continue;
640                         }
641                         *i = cut;
642                 } else if (_last_audio_time && i->second > *_last_audio_time) {
643                         /* There's a gap between this data and the last we emitted; fill with silence */
644                         fill_audio (DCPTimePeriod (*_last_audio_time, i->second));
645                 }
646
647                 emit_audio (i->first, i->second);
648         }
649
650         if (done) {
651                 _shuffler->flush ();
652         }
653         return done;
654 }
655
656 optional<PositionImage>
657 Player::subtitles_for_frame (DCPTime time) const
658 {
659         list<PositionImage> subtitles;
660
661         int const vfr = _film->video_frame_rate();
662
663         BOOST_FOREACH (PlayerSubtitles i, _active_subtitles.get_burnt (DCPTimePeriod(time, time + DCPTime::from_frames(1, vfr)), _always_burn_subtitles)) {
664
665                 /* Image subtitles */
666                 list<PositionImage> c = transform_image_subtitles (i.image);
667                 copy (c.begin(), c.end(), back_inserter (subtitles));
668
669                 /* Text subtitles (rendered to an image) */
670                 if (!i.text.empty ()) {
671                         list<PositionImage> s = render_subtitles (i.text, i.fonts, _video_container_size, time, vfr);
672                         copy (s.begin(), s.end(), back_inserter (subtitles));
673                 }
674         }
675
676         if (subtitles.empty ()) {
677                 return optional<PositionImage> ();
678         }
679
680         return merge (subtitles);
681 }
682
683 void
684 Player::video (weak_ptr<Piece> wp, ContentVideo video)
685 {
686         shared_ptr<Piece> piece = wp.lock ();
687         if (!piece) {
688                 return;
689         }
690
691         FrameRateChange frc(piece->content->active_video_frame_rate(), _film->video_frame_rate());
692         if (frc.skip && (video.frame % 2) == 1) {
693                 return;
694         }
695
696         /* Time of the first frame we will emit */
697         DCPTime const time = content_video_to_dcp (piece, video.frame);
698
699         /* Discard if it's outside the content's period or if it's before the last accurate seek */
700         if (
701                 time < piece->content->position() ||
702                 time >= piece->content->end() ||
703                 (_last_video_time && time < *_last_video_time)) {
704                 return;
705         }
706
707         /* Fill gaps that we discover now that we have some video which needs to be emitted */
708
709         if (_last_video_time) {
710                 DCPTime fill_from = max (*_last_video_time, piece->content->position());
711                 LastVideoMap::const_iterator last = _last_video.find (wp);
712                 if (_film->three_d()) {
713                         DCPTime j = fill_from;
714                         Eyes eyes = _last_video_eyes.get_value_or(EYES_LEFT);
715                         if (eyes == EYES_BOTH) {
716                                 eyes = EYES_LEFT;
717                         }
718                         while (j < time || eyes != video.eyes) {
719                                 if (last != _last_video.end()) {
720                                         shared_ptr<PlayerVideo> copy = last->second->shallow_copy();
721                                         copy->set_eyes (eyes);
722                                         emit_video (copy, j);
723                                 } else {
724                                         emit_video (black_player_video_frame(eyes), j);
725                                 }
726                                 if (eyes == EYES_RIGHT) {
727                                         j += one_video_frame();
728                                 }
729                                 eyes = increment_eyes (eyes);
730                         }
731                 } else {
732                         for (DCPTime j = fill_from; j < time; j += one_video_frame()) {
733                                 if (last != _last_video.end()) {
734                                         emit_video (last->second, j);
735                                 } else {
736                                         emit_video (black_player_video_frame(EYES_BOTH), j);
737                                 }
738                         }
739                 }
740         }
741
742         _last_video[wp].reset (
743                 new PlayerVideo (
744                         video.image,
745                         piece->content->video->crop (),
746                         piece->content->video->fade (video.frame),
747                         piece->content->video->scale().size (
748                                 piece->content->video, _video_container_size, _film->frame_size ()
749                                 ),
750                         _video_container_size,
751                         video.eyes,
752                         video.part,
753                         piece->content->video->colour_conversion ()
754                         )
755                 );
756
757         DCPTime t = time;
758         for (int i = 0; i < frc.repeat; ++i) {
759                 emit_video (_last_video[wp], t);
760                 t += one_video_frame ();
761         }
762 }
763
764 void
765 Player::audio (weak_ptr<Piece> wp, AudioStreamPtr stream, ContentAudio content_audio)
766 {
767         DCPOMATIC_ASSERT (content_audio.audio->frames() > 0);
768
769         shared_ptr<Piece> piece = wp.lock ();
770         if (!piece) {
771                 return;
772         }
773
774         shared_ptr<AudioContent> content = piece->content->audio;
775         DCPOMATIC_ASSERT (content);
776
777         /* Compute time in the DCP */
778         DCPTime time = resampled_audio_to_dcp (piece, content_audio.frame);
779         /* And the end of this block in the DCP */
780         DCPTime end = time + DCPTime::from_frames(content_audio.audio->frames(), content->resampled_frame_rate());
781
782         /* Remove anything that comes before the start or after the end of the content */
783         if (time < piece->content->position()) {
784                 pair<shared_ptr<AudioBuffers>, DCPTime> cut = discard_audio (content_audio.audio, time, piece->content->position());
785                 if (!cut.first) {
786                         /* This audio is entirely discarded */
787                         return;
788                 }
789                 content_audio.audio = cut.first;
790                 time = cut.second;
791         } else if (time > piece->content->end()) {
792                 /* Discard it all */
793                 return;
794         } else if (end > piece->content->end()) {
795                 Frame const remaining_frames = DCPTime(piece->content->end() - time).frames_round(_film->audio_frame_rate());
796                 if (remaining_frames == 0) {
797                         return;
798                 }
799                 shared_ptr<AudioBuffers> cut (new AudioBuffers (content_audio.audio->channels(), remaining_frames));
800                 cut->copy_from (content_audio.audio.get(), remaining_frames, 0, 0);
801                 content_audio.audio = cut;
802         }
803
804         DCPOMATIC_ASSERT (content_audio.audio->frames() > 0);
805
806         /* Gain */
807
808         if (content->gain() != 0) {
809                 shared_ptr<AudioBuffers> gain (new AudioBuffers (content_audio.audio));
810                 gain->apply_gain (content->gain ());
811                 content_audio.audio = gain;
812         }
813
814         /* Remap */
815
816         content_audio.audio = remap (content_audio.audio, _film->audio_channels(), stream->mapping());
817
818         /* Process */
819
820         if (_audio_processor) {
821                 content_audio.audio = _audio_processor->run (content_audio.audio, _film->audio_channels ());
822         }
823
824         /* Push */
825
826         _audio_merger.push (content_audio.audio, time);
827         DCPOMATIC_ASSERT (_stream_states.find (stream) != _stream_states.end ());
828         _stream_states[stream].last_push_end = time + DCPTime::from_frames (content_audio.audio->frames(), _film->audio_frame_rate());
829 }
830
831 void
832 Player::image_subtitle_start (weak_ptr<Piece> wp, ContentImageSubtitle subtitle)
833 {
834         shared_ptr<Piece> piece = wp.lock ();
835         if (!piece) {
836                 return;
837         }
838
839         /* Apply content's subtitle offsets */
840         subtitle.sub.rectangle.x += piece->content->subtitle->x_offset ();
841         subtitle.sub.rectangle.y += piece->content->subtitle->y_offset ();
842
843         /* Apply content's subtitle scale */
844         subtitle.sub.rectangle.width *= piece->content->subtitle->x_scale ();
845         subtitle.sub.rectangle.height *= piece->content->subtitle->y_scale ();
846
847         /* Apply a corrective translation to keep the subtitle centred after that scale */
848         subtitle.sub.rectangle.x -= subtitle.sub.rectangle.width * (piece->content->subtitle->x_scale() - 1);
849         subtitle.sub.rectangle.y -= subtitle.sub.rectangle.height * (piece->content->subtitle->y_scale() - 1);
850
851         PlayerSubtitles ps;
852         ps.image.push_back (subtitle.sub);
853         DCPTime from (content_time_to_dcp (piece, subtitle.from()));
854
855         _active_subtitles.add_from (wp, ps, from);
856 }
857
858 void
859 Player::text_subtitle_start (weak_ptr<Piece> wp, ContentTextSubtitle subtitle)
860 {
861         shared_ptr<Piece> piece = wp.lock ();
862         if (!piece) {
863                 return;
864         }
865
866         PlayerSubtitles ps;
867         DCPTime const from (content_time_to_dcp (piece, subtitle.from()));
868
869         BOOST_FOREACH (dcp::SubtitleString s, subtitle.subs) {
870                 s.set_h_position (s.h_position() + piece->content->subtitle->x_offset ());
871                 s.set_v_position (s.v_position() + piece->content->subtitle->y_offset ());
872                 float const xs = piece->content->subtitle->x_scale();
873                 float const ys = piece->content->subtitle->y_scale();
874                 float size = s.size();
875
876                 /* Adjust size to express the common part of the scaling;
877                    e.g. if xs = ys = 0.5 we scale size by 2.
878                 */
879                 if (xs > 1e-5 && ys > 1e-5) {
880                         size *= 1 / min (1 / xs, 1 / ys);
881                 }
882                 s.set_size (size);
883
884                 /* Then express aspect ratio changes */
885                 if (fabs (1.0 - xs / ys) > dcp::ASPECT_ADJUST_EPSILON) {
886                         s.set_aspect_adjust (xs / ys);
887                 }
888
889                 s.set_in (dcp::Time(from.seconds(), 1000));
890                 ps.text.push_back (SubtitleString (s, piece->content->subtitle->outline_width()));
891                 ps.add_fonts (piece->content->subtitle->fonts ());
892         }
893
894         _active_subtitles.add_from (wp, ps, from);
895 }
896
897 void
898 Player::subtitle_stop (weak_ptr<Piece> wp, ContentTime to)
899 {
900         if (!_active_subtitles.have (wp)) {
901                 return;
902         }
903
904         shared_ptr<Piece> piece = wp.lock ();
905         if (!piece) {
906                 return;
907         }
908
909         DCPTime const dcp_to = content_time_to_dcp (piece, to);
910
911         pair<PlayerSubtitles, DCPTime> from = _active_subtitles.add_to (wp, dcp_to);
912
913         if (piece->content->subtitle->use() && !_always_burn_subtitles && !piece->content->subtitle->burn()) {
914                 Subtitle (from.first, DCPTimePeriod (from.second, dcp_to));
915         }
916 }
917
918 void
919 Player::seek (DCPTime time, bool accurate)
920 {
921         if (!_have_valid_pieces) {
922                 setup_pieces ();
923         }
924
925         if (_shuffler) {
926                 _shuffler->clear ();
927         }
928
929         if (_audio_processor) {
930                 _audio_processor->flush ();
931         }
932
933         _audio_merger.clear ();
934         _active_subtitles.clear ();
935
936         BOOST_FOREACH (shared_ptr<Piece> i, _pieces) {
937                 if (time < i->content->position()) {
938                         /* Before; seek to 0 */
939                         i->decoder->seek (ContentTime(), accurate);
940                         i->done = false;
941                 } else if (i->content->position() <= time && time < i->content->end()) {
942                         /* During; seek to position */
943                         i->decoder->seek (dcp_to_content_time (i, time), accurate);
944                         i->done = false;
945                 } else {
946                         /* After; this piece is done */
947                         i->done = true;
948                 }
949         }
950
951         if (accurate) {
952                 _last_video_time = time;
953                 _last_video_eyes = EYES_LEFT;
954                 _last_audio_time = time;
955         } else {
956                 _last_video_time = optional<DCPTime>();
957                 _last_video_eyes = optional<Eyes>();
958                 _last_audio_time = optional<DCPTime>();
959         }
960
961         _black.set_position (time);
962         _silent.set_position (time);
963
964         _last_video.clear ();
965 }
966
967 void
968 Player::emit_video (shared_ptr<PlayerVideo> pv, DCPTime time)
969 {
970         optional<PositionImage> subtitles = subtitles_for_frame (time);
971         if (subtitles) {
972                 pv->set_subtitle (subtitles.get ());
973         }
974
975         Video (pv, time);
976
977         if (pv->eyes() == EYES_BOTH || pv->eyes() == EYES_RIGHT) {
978                 _last_video_time = time + one_video_frame();
979                 _active_subtitles.clear_before (time);
980         }
981         _last_video_eyes = increment_eyes (pv->eyes());
982 }
983
984 void
985 Player::emit_audio (shared_ptr<AudioBuffers> data, DCPTime time)
986 {
987         /* This audio must follow on from the previous */
988         DCPOMATIC_ASSERT (!_last_audio_time || time == *_last_audio_time);
989         Audio (data, time);
990         _last_audio_time = time + DCPTime::from_frames (data->frames(), _film->audio_frame_rate());
991 }
992
993 void
994 Player::fill_audio (DCPTimePeriod period)
995 {
996         if (period.from == period.to) {
997                 return;
998         }
999
1000         DCPOMATIC_ASSERT (period.from < period.to);
1001
1002         DCPTime t = period.from;
1003         while (t < period.to) {
1004                 DCPTime block = min (DCPTime::from_seconds (0.5), period.to - t);
1005                 Frame const samples = block.frames_round(_film->audio_frame_rate());
1006                 if (samples) {
1007                         shared_ptr<AudioBuffers> silence (new AudioBuffers (_film->audio_channels(), samples));
1008                         silence->make_silent ();
1009                         emit_audio (silence, t);
1010                 }
1011                 t += block;
1012         }
1013 }
1014
1015 DCPTime
1016 Player::one_video_frame () const
1017 {
1018         return DCPTime::from_frames (1, _film->video_frame_rate ());
1019 }
1020
1021 pair<shared_ptr<AudioBuffers>, DCPTime>
1022 Player::discard_audio (shared_ptr<const AudioBuffers> audio, DCPTime time, DCPTime discard_to) const
1023 {
1024         DCPTime const discard_time = discard_to - time;
1025         Frame const discard_frames = discard_time.frames_round(_film->audio_frame_rate());
1026         Frame remaining_frames = audio->frames() - discard_frames;
1027         if (remaining_frames <= 0) {
1028                 return make_pair(shared_ptr<AudioBuffers>(), DCPTime());
1029         }
1030         shared_ptr<AudioBuffers> cut (new AudioBuffers (audio->channels(), remaining_frames));
1031         cut->copy_from (audio.get(), remaining_frames, discard_frames, 0);
1032         return make_pair(cut, time + discard_time);
1033 }
1034
1035 void
1036 Player::set_dcp_decode_reduction (optional<int> reduction)
1037 {
1038         if (reduction == _dcp_decode_reduction) {
1039                 return;
1040         }
1041
1042         _dcp_decode_reduction = reduction;
1043         _have_valid_pieces = false;
1044         Changed (false);
1045 }