2 Copyright (C) 2014-2018 Carl Hetherington <cth@carlh.net>
4 This file is part of DCP-o-matic.
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.
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.
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/>.
21 /** @file test/player_test.cc
22 * @brief Test Player class.
23 * @ingroup selfcontained
27 #include "lib/ffmpeg_content.h"
28 #include "lib/dcp_content_type.h"
29 #include "lib/ratio.h"
30 #include "lib/audio_buffers.h"
31 #include "lib/player.h"
32 #include "lib/video_content.h"
33 #include "lib/image_content.h"
34 #include "lib/text_subtitle_content.h"
35 #include "lib/content_factory.h"
36 #include "lib/dcp_content.h"
37 #include "lib/subtitle_content.h"
38 #include "lib/butler.h"
39 #include "lib/compose.hpp"
41 #include <boost/test/unit_test.hpp>
47 using boost::shared_ptr;
49 using boost::optional;
51 static shared_ptr<AudioBuffers> accumulated;
54 accumulate (shared_ptr<AudioBuffers> audio, DCPTime)
56 BOOST_REQUIRE (accumulated);
57 accumulated->append (audio);
60 /** Check that the Player correctly generates silence when used with a silent FFmpegContent */
61 BOOST_AUTO_TEST_CASE (player_silence_padding_test)
63 shared_ptr<Film> film = new_test_film ("player_silence_padding_test");
64 film->set_name ("player_silence_padding_test");
65 shared_ptr<FFmpegContent> c (new FFmpegContent (film, "test/data/test.mp4"));
66 film->set_container (Ratio::from_id ("185"));
67 film->set_audio_channels (6);
69 film->examine_and_add_content (c);
72 accumulated.reset (new AudioBuffers (film->audio_channels(), 0));
74 shared_ptr<Player> player (new Player (film, film->playlist ()));
75 player->Audio.connect (bind (&accumulate, _1, _2));
76 while (!player->pass ()) {}
77 BOOST_REQUIRE (accumulated->frames() >= 48000);
78 BOOST_CHECK_EQUAL (accumulated->channels(), film->audio_channels ());
80 for (int i = 0; i < 48000; ++i) {
81 for (int c = 0; c < accumulated->channels(); ++c) {
82 BOOST_CHECK_EQUAL (accumulated->data()[c][i], 0);
87 /* Test insertion of black frames between separate bits of video content */
88 BOOST_AUTO_TEST_CASE (player_black_fill_test)
90 shared_ptr<Film> film = new_test_film ("black_fill_test");
91 film->set_dcp_content_type (DCPContentType::from_isdcf_name ("FTR"));
92 film->set_name ("black_fill_test");
93 film->set_container (Ratio::from_id ("185"));
94 film->set_sequence (false);
95 shared_ptr<ImageContent> contentA (new ImageContent (film, "test/data/simple_testcard_640x480.png"));
96 shared_ptr<ImageContent> contentB (new ImageContent (film, "test/data/simple_testcard_640x480.png"));
98 film->examine_and_add_content (contentA);
99 film->examine_and_add_content (contentB);
102 contentA->video->set_scale (VideoContentScale (Ratio::from_id ("185")));
103 contentA->video->set_length (3);
104 contentA->set_position (DCPTime::from_frames (2, film->video_frame_rate ()));
105 contentB->video->set_scale (VideoContentScale (Ratio::from_id ("185")));
106 contentB->video->set_length (1);
107 contentB->set_position (DCPTime::from_frames (7, film->video_frame_rate ()));
113 boost::filesystem::path ref;
116 ref /= "black_fill_test";
118 boost::filesystem::path check;
121 check /= "black_fill_test";
122 check /= film->dcp_name();
124 check_dcp (ref.string(), check.string());
127 /** Check behaviour with an awkward playlist whose data does not end on a video frame start */
128 BOOST_AUTO_TEST_CASE (player_subframe_test)
130 shared_ptr<Film> film = new_test_film ("reels_test7");
131 film->set_name ("reels_test7");
132 film->set_container (Ratio::from_id ("185"));
133 film->set_dcp_content_type (DCPContentType::from_isdcf_name ("TST"));
134 shared_ptr<Content> A = content_factory(film, "test/data/flat_red.png").front();
135 film->examine_and_add_content (A);
136 BOOST_REQUIRE (!wait_for_jobs ());
137 shared_ptr<Content> B = content_factory(film, "test/data/awkward_length.wav").front();
138 film->examine_and_add_content (B);
139 BOOST_REQUIRE (!wait_for_jobs ());
140 film->set_video_frame_rate (24);
141 A->video->set_length (3 * 24);
143 BOOST_CHECK (A->full_length() == DCPTime::from_frames(3 * 24, 24));
144 BOOST_CHECK (B->full_length() == DCPTime(289920));
145 /* Length should be rounded up from B's length to the next video frame */
146 BOOST_CHECK (film->length() == DCPTime::from_frames(3 * 24 + 1, 24));
148 shared_ptr<Player> player (new Player (film, film->playlist ()));
149 player->setup_pieces ();
150 BOOST_REQUIRE_EQUAL (player->_black._periods.size(), 1);
151 BOOST_CHECK (player->_black._periods.front() == DCPTimePeriod(DCPTime::from_frames(3 * 24, 24), DCPTime::from_frames(3 * 24 + 1, 24)));
152 BOOST_REQUIRE_EQUAL (player->_silent._periods.size(), 1);
153 BOOST_CHECK (player->_silent._periods.front() == DCPTimePeriod(DCPTime(289920), DCPTime::from_frames(3 * 24 + 1, 24)));
156 static Frame video_frames;
157 static Frame audio_frames;
160 video (shared_ptr<PlayerVideo>, DCPTime)
166 audio (shared_ptr<AudioBuffers> audio, DCPTime)
168 audio_frames += audio->frames();
171 /** Check with a video-only file that the video and audio emissions happen more-or-less together */
172 BOOST_AUTO_TEST_CASE (player_interleave_test)
174 shared_ptr<Film> film = new_test_film ("ffmpeg_transcoder_basic_test_subs");
175 film->set_name ("ffmpeg_transcoder_basic_test");
176 film->set_container (Ratio::from_id ("185"));
177 film->set_audio_channels (6);
179 shared_ptr<FFmpegContent> c (new FFmpegContent (film, "test/data/test.mp4"));
180 film->examine_and_add_content (c);
181 BOOST_REQUIRE (!wait_for_jobs ());
183 shared_ptr<TextSubtitleContent> s (new TextSubtitleContent (film, "test/data/subrip.srt"));
184 film->examine_and_add_content (s);
185 BOOST_REQUIRE (!wait_for_jobs ());
187 shared_ptr<Player> player (new Player(film, film->playlist()));
188 player->Video.connect (bind (&video, _1, _2));
189 player->Audio.connect (bind (&audio, _1, _2));
190 video_frames = audio_frames = 0;
191 while (!player->pass ()) {
192 BOOST_CHECK (abs(video_frames - (audio_frames / 2000)) < 8);
197 note_handler (dcp::NoteType, std::string)
202 /** Test some seeks towards the start of a DCP with awkward subtitles; see mantis #1085
203 * and a number of others. I thought this was a player seek bug but in fact it was
204 * caused by the subtitle starting just after the start of the video frame and hence
207 BOOST_AUTO_TEST_CASE (player_seek_test)
209 shared_ptr<Film> film (new Film (optional<boost::filesystem::path>()));
210 shared_ptr<DCPContent> dcp (new DCPContent (film, private_data / "awkward_subs"));
211 film->examine_and_add_content (dcp, true);
212 BOOST_REQUIRE (!wait_for_jobs ());
213 dcp->subtitle->set_use (true);
215 shared_ptr<Player> player (new Player (film, film->playlist()));
217 player->set_always_burn_subtitles (true);
218 player->set_play_referenced ();
220 shared_ptr<Butler> butler (new Butler (player, film->log(), AudioMapping(), 2));
221 butler->disable_audio();
223 for (int i = 0; i < 10; ++i) {
224 DCPTime t = DCPTime::from_frames (i, 24);
225 butler->seek (t, true);
226 pair<shared_ptr<PlayerVideo>, DCPTime> video = butler->get_video();
227 BOOST_CHECK_EQUAL(video.second.get(), t.get());
228 write_image(video.first->image(note_handler, PlayerVideo::always_rgb, false, true), String::compose("build/test/player_seek_test_%1.png", i), "RGB");
229 check_image(String::compose("test/data/player_seek_test_%1.png", i), String::compose("build/test/player_seek_test_%1.png", i));