2 Copyright (C) 2012-2015 Carl Hetherington <cth@carlh.net>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 #include "compose.hpp"
25 #include "dcp_video.h"
26 #include "dcp_content_type.h"
27 #include "audio_mapping.h"
31 #include "audio_buffers.h"
32 #include "md5_digester.h"
37 #include "reel_writer.h"
39 #include <boost/foreach.hpp>
46 #define LOG_GENERAL(...) _film->log()->log (String::compose (__VA_ARGS__), LogEntry::TYPE_GENERAL);
47 #define LOG_GENERAL_NC(...) _film->log()->log (__VA_ARGS__, LogEntry::TYPE_GENERAL);
48 #define LOG_DEBUG_ENCODE(...) _film->log()->log (String::compose (__VA_ARGS__), LogEntry::TYPE_DEBUG_ENCODE);
49 #define LOG_TIMING(...) _film->log()->log (String::compose (__VA_ARGS__), LogEntry::TYPE_TIMING);
50 #define LOG_WARNING_NC(...) _film->log()->log (__VA_ARGS__, LogEntry::TYPE_WARNING);
51 #define LOG_WARNING(...) _film->log()->log (String::compose (__VA_ARGS__), LogEntry::TYPE_WARNING);
52 #define LOG_ERROR(...) _film->log()->log (String::compose (__VA_ARGS__), LogEntry::TYPE_ERROR);
54 /* OS X strikes again */
62 using boost::shared_ptr;
63 using boost::weak_ptr;
64 using boost::dynamic_pointer_cast;
66 Writer::Writer (shared_ptr<const Film> film, weak_ptr<Job> j)
71 , _queued_full_in_memory (0)
72 , _maximum_frames_in_memory (0)
78 /* Remove any old DCP */
79 boost::filesystem::remove_all (_film->dir (_film->dcp_name ()));
81 shared_ptr<Job> job = _job.lock ();
82 DCPOMATIC_ASSERT (job);
84 BOOST_FOREACH (DCPTimePeriod p, _film->reels ()) {
85 _reels.push_back (ReelWriter (film, p, job));
88 /* We can keep track of the current audio and subtitle reels easily because audio
89 and subs arrive to the Writer in sequence. This is not so for video.
91 _audio_reel = _reels.begin ();
92 _subtitle_reel = _reels.begin ();
94 /* Check that the signer is OK if we need one */
95 if (_film->is_signed() && !Config::instance()->signer_chain()->valid ()) {
96 throw InvalidSignerError ();
99 job->sub (_("Encoding image data"));
105 _thread = new boost::thread (boost::bind (&Writer::thread, this));
110 terminate_thread (false);
113 /** Pass a video frame to the writer for writing to disk at some point.
114 * This method can be called with frames out of order.
115 * @param encoded JPEG2000-encoded data.
116 * @param frame Frame index within the DCP.
117 * @param eyes Eyes that this frame image is for.
120 Writer::write (Data encoded, Frame frame, Eyes eyes)
122 boost::mutex::scoped_lock lock (_state_mutex);
124 while (_queued_full_in_memory > _maximum_frames_in_memory) {
125 /* The queue is too big; wait until that is sorted out */
126 _full_condition.wait (lock);
130 qi.type = QueueItem::FULL;
131 qi.encoded = encoded;
132 qi.reel = video_reel (frame);
133 qi.frame = frame - _reels[qi.reel].start ();
135 if (_film->three_d() && eyes == EYES_BOTH) {
136 /* 2D material in a 3D DCP; fake the 3D */
138 _queue.push_back (qi);
139 ++_queued_full_in_memory;
140 qi.eyes = EYES_RIGHT;
141 _queue.push_back (qi);
142 ++_queued_full_in_memory;
145 _queue.push_back (qi);
146 ++_queued_full_in_memory;
149 /* Now there's something to do: wake anything wait()ing on _empty_condition */
150 _empty_condition.notify_all ();
153 /** Repeat the last frame that was written to a reel as a new frame.
154 * @param frame Frame index within the DCP of the new (repeated) frame.
155 * @param eyes Eyes that this repeated frame image is for.
158 Writer::repeat (Frame frame, Eyes eyes)
160 boost::mutex::scoped_lock lock (_state_mutex);
162 while (_queued_full_in_memory > _maximum_frames_in_memory) {
163 /* The queue is too big; wait until that is sorted out */
164 _full_condition.wait (lock);
168 qi.type = QueueItem::REPEAT;
169 qi.reel = video_reel (frame);
170 qi.frame = frame - _reels[qi.reel].start ();
171 if (_film->three_d() && eyes == EYES_BOTH) {
173 _queue.push_back (qi);
174 qi.eyes = EYES_RIGHT;
175 _queue.push_back (qi);
178 _queue.push_back (qi);
181 /* Now there's something to do: wake anything wait()ing on _empty_condition */
182 _empty_condition.notify_all ();
186 Writer::fake_write (Frame frame, Eyes eyes)
188 boost::mutex::scoped_lock lock (_state_mutex);
190 while (_queued_full_in_memory > _maximum_frames_in_memory) {
191 /* The queue is too big; wait until that is sorted out */
192 _full_condition.wait (lock);
195 size_t const reel = video_reel (frame);
196 Frame const reel_frame = frame - _reels[reel].start ();
198 FILE* file = fopen_boost (_film->info_file(_reels[reel].period()), "rb");
200 throw ReadFileError (_film->info_file(_reels[reel].period()));
202 dcp::FrameInfo info = _reels[reel].read_frame_info (file, reel_frame, eyes);
206 qi.type = QueueItem::FAKE;
209 qi.frame = reel_frame;
210 if (_film->three_d() && eyes == EYES_BOTH) {
212 _queue.push_back (qi);
213 qi.eyes = EYES_RIGHT;
214 _queue.push_back (qi);
217 _queue.push_back (qi);
220 /* Now there's something to do: wake anything wait()ing on _empty_condition */
221 _empty_condition.notify_all ();
224 /** Write one video frame's worth of audio frames to the DCP.
225 * @param audio Audio data or 0 if there is no audio to be written here (i.e. it is referenced).
226 * This method is not thread safe.
229 Writer::write (shared_ptr<const AudioBuffers> audio)
231 if (_audio_reel == _reels.end ()) {
232 /* This audio is off the end of the last reel; ignore it */
236 _audio_reel->write (audio);
238 /* written is in video frames, not audio frames */
239 if (_audio_reel->total_written_audio_frames() >= _audio_reel->period().duration().frames_floor (_film->video_frame_rate())) {
244 /** This must be called from Writer::thread() with an appropriate lock held */
246 Writer::have_sequenced_image_at_queue_head ()
248 if (_queue.empty ()) {
254 QueueItem const & f = _queue.front();
255 ReelWriter const & reel = _reels[f.reel];
257 /* The queue should contain only EYES_LEFT/EYES_RIGHT pairs or EYES_BOTH */
259 if (f.eyes == EYES_BOTH) {
261 return f.frame == (reel.last_written_video_frame() + 1);
266 if (reel.last_written_eyes() == EYES_LEFT && f.frame == reel.last_written_video_frame() && f.eyes == EYES_RIGHT) {
270 if (reel.last_written_eyes() == EYES_RIGHT && f.frame == (reel.last_written_video_frame() + 1) && f.eyes == EYES_LEFT) {
283 boost::mutex::scoped_lock lock (_state_mutex);
287 if (_finish || _queued_full_in_memory > _maximum_frames_in_memory || have_sequenced_image_at_queue_head ()) {
288 /* We've got something to do: go and do it */
292 /* Nothing to do: wait until something happens which may indicate that we do */
293 LOG_TIMING (N_("writer-sleep queue=%1"), _queue.size());
294 _empty_condition.wait (lock);
295 LOG_TIMING (N_("writer-wake queue=%1"), _queue.size());
298 if (_finish && _queue.empty()) {
302 /* We stop here if we have been asked to finish, and if either the queue
303 is empty or we do not have a sequenced image at its head (if this is the
304 case we will never terminate as no new frames will be sent once
307 if (_finish && (!have_sequenced_image_at_queue_head() || _queue.empty())) {
308 /* (Hopefully temporarily) log anything that was not written */
309 if (!_queue.empty() && !have_sequenced_image_at_queue_head()) {
310 LOG_WARNING (N_("Finishing writer with a left-over queue of %1:"), _queue.size());
311 for (list<QueueItem>::const_iterator i = _queue.begin(); i != _queue.end(); ++i) {
312 if (i->type == QueueItem::FULL) {
313 LOG_WARNING (N_("- type FULL, frame %1, eyes %2"), i->frame, i->eyes);
315 LOG_WARNING (N_("- type FAKE, size %1, frame %2, eyes %3"), i->size, i->frame, i->eyes);
322 /* Write any frames that we can write; i.e. those that are in sequence. */
323 while (have_sequenced_image_at_queue_head ()) {
324 QueueItem qi = _queue.front ();
326 if (qi.type == QueueItem::FULL && qi.encoded) {
327 --_queued_full_in_memory;
332 ReelWriter& reel = _reels[qi.reel];
335 case QueueItem::FULL:
336 LOG_DEBUG_ENCODE (N_("Writer FULL-writes %1 (%2)"), qi.frame, qi.eyes);
338 qi.encoded = Data (_film->j2c_path (qi.reel, qi.frame, qi.eyes, false));
340 reel.write (qi.encoded, qi.frame, qi.eyes);
343 case QueueItem::FAKE:
344 LOG_DEBUG_ENCODE (N_("Writer FAKE-writes %1"), qi.frame);
345 reel.fake_write (qi.frame, qi.eyes, qi.size);
348 case QueueItem::REPEAT:
349 LOG_DEBUG_ENCODE (N_("Writer REPEAT-writes %1"), qi.frame);
350 reel.repeat_write (qi.frame, qi.eyes);
357 shared_ptr<Job> job = _job.lock ();
358 DCPOMATIC_ASSERT (job);
359 int64_t total = _film->length().frames_round (_film->video_frame_rate ());
360 if (_film->three_d ()) {
361 /* _full_written and so on are incremented for each eye, so we need to double the total
362 frames to get the correct progress.
367 job->set_progress (float (_full_written + _fake_written + _repeat_written) / total);
371 while (_queued_full_in_memory > _maximum_frames_in_memory) {
372 /* Too many frames in memory which can't yet be written to the stream.
373 Write some FULL frames to disk.
376 /* Find one from the back of the queue */
378 list<QueueItem>::reverse_iterator i = _queue.rbegin ();
379 while (i != _queue.rend() && (i->type != QueueItem::FULL || !i->encoded)) {
383 DCPOMATIC_ASSERT (i != _queue.rend());
387 /* i is valid here, even though we don't hold a lock on the mutex,
388 since list iterators are unaffected by insertion and only this
389 thread could erase the last item in the list.
392 LOG_GENERAL ("Writer full; pushes %1 to disk", i->frame);
394 i->encoded->write_via_temp (
395 _film->j2c_path (i->reel, i->frame, i->eyes, true),
396 _film->j2c_path (i->reel, i->frame, i->eyes, false)
401 --_queued_full_in_memory;
404 /* The queue has probably just gone down a bit; notify anything wait()ing on _full_condition */
405 _full_condition.notify_all ();
414 Writer::terminate_thread (bool can_throw)
416 boost::mutex::scoped_lock lock (_state_mutex);
422 _empty_condition.notify_all ();
423 _full_condition.notify_all ();
426 DCPOMATIC_ASSERT (_thread->joinable ());
443 terminate_thread (true);
445 BOOST_FOREACH (ReelWriter& i, _reels) {
449 dcp::DCP dcp (_film->dir (_film->dcp_name()));
451 shared_ptr<dcp::CPL> cpl (
454 _film->dcp_content_type()->libdcp_kind ()
460 BOOST_FOREACH (ReelWriter& i, _reels) {
462 cpl->add (i.create_reel (_reel_assets, _fonts));
464 shared_ptr<Job> job = _job.lock ();
465 DCPOMATIC_ASSERT (job);
466 i.calculate_digests (job);
469 dcp::XMLMetadata meta;
470 meta.creator = Config::instance()->dcp_creator ();
471 if (meta.creator.empty ()) {
472 meta.creator = String::compose ("DCP-o-matic %1 %2", dcpomatic_version, dcpomatic_git_commit);
474 meta.issuer = Config::instance()->dcp_issuer ();
475 if (meta.issuer.empty ()) {
476 meta.issuer = String::compose ("DCP-o-matic %1 %2", dcpomatic_version, dcpomatic_git_commit);
478 meta.set_issue_date_now ();
480 cpl->set_metadata (meta);
482 shared_ptr<const dcp::CertificateChain> signer;
483 if (_film->is_signed ()) {
484 signer = Config::instance()->signer_chain ();
485 /* We did check earlier, but check again here to be on the safe side */
486 if (!signer->valid ()) {
487 throw InvalidSignerError ();
491 dcp.write_xml (_film->interop () ? dcp::INTEROP : dcp::SMPTE, meta, signer);
494 N_("Wrote %1 FULL, %2 FAKE, %3 REPEAT, %4 pushed to disk"), _full_written, _fake_written, _repeat_written, _pushed_to_disk
498 /** @param frame Frame index within the whole DCP.
499 * @return true if we can fake-write this frame.
502 Writer::can_fake_write (Frame frame) const
504 /* We have to do a proper write of the first frame so that we can set up the JPEG2000
505 parameters in the asset writer.
508 ReelWriter const & reel = _reels[video_reel(frame)];
510 /* Make frame relative to the start of the reel */
511 frame -= reel.start ();
512 return (frame != 0 && frame < reel.first_nonexistant_frame());
516 Writer::write (PlayerSubtitles subs)
518 if (subs.text.empty ()) {
522 if (_subtitle_reel->period().to < subs.from) {
526 _subtitle_reel->write (subs);
530 Writer::write (list<shared_ptr<Font> > fonts)
532 /* Just keep a list of fonts and we'll deal with them in ::finish */
533 copy (fonts.begin (), fonts.end (), back_inserter (_fonts));
537 operator< (QueueItem const & a, QueueItem const & b)
539 if (a.reel != b.reel) {
540 return a.reel < b.reel;
543 if (a.frame != b.frame) {
544 return a.frame < b.frame;
547 return static_cast<int> (a.eyes) < static_cast<int> (b.eyes);
551 operator== (QueueItem const & a, QueueItem const & b)
553 return a.reel == b.reel && a.frame == b.frame && a.eyes == b.eyes;
557 Writer::set_encoder_threads (int threads)
559 _maximum_frames_in_memory = lrint (threads * 1.1);
563 Writer::write (ReferencedReelAsset asset)
565 _reel_assets.push_back (asset);
569 Writer::video_reel (int frame) const
571 DCPTime t = DCPTime::from_frames (frame, _film->video_frame_rate ());
573 while (i < _reels.size() && !_reels[i].period().contains (t)) {
577 DCPOMATIC_ASSERT (i < _reels.size ());