Write metadata on new film to go with the directory that is created.
[dcpomatic.git] / src / lib / film.cc
1 /*
2     Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
3
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.
8
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.
13
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.
17
18 */
19
20 #include <stdexcept>
21 #include <iostream>
22 #include <algorithm>
23 #include <fstream>
24 #include <cstdlib>
25 #include <sstream>
26 #include <iomanip>
27 #include <unistd.h>
28 #include <boost/filesystem.hpp>
29 #include <boost/algorithm/string.hpp>
30 #include <boost/lexical_cast.hpp>
31 #include <boost/date_time.hpp>
32 #include "film.h"
33 #include "format.h"
34 #include "job.h"
35 #include "filter.h"
36 #include "transcoder.h"
37 #include "util.h"
38 #include "job_manager.h"
39 #include "ab_transcode_job.h"
40 #include "transcode_job.h"
41 #include "scp_dcp_job.h"
42 #include "log.h"
43 #include "options.h"
44 #include "exceptions.h"
45 #include "examine_content_job.h"
46 #include "scaler.h"
47 #include "decoder_factory.h"
48 #include "config.h"
49 #include "version.h"
50 #include "ui_signaller.h"
51 #include "video_decoder.h"
52 #include "audio_decoder.h"
53 #include "sndfile_decoder.h"
54 #include "analyse_audio_job.h"
55
56 #include "i18n.h"
57
58 using std::string;
59 using std::stringstream;
60 using std::multimap;
61 using std::pair;
62 using std::map;
63 using std::vector;
64 using std::ifstream;
65 using std::ofstream;
66 using std::setfill;
67 using std::min;
68 using std::make_pair;
69 using std::endl;
70 using boost::shared_ptr;
71 using boost::lexical_cast;
72 using boost::to_upper_copy;
73 using boost::ends_with;
74 using boost::starts_with;
75 using boost::optional;
76 using libdcp::Size;
77
78 int const Film::state_version = 4;
79
80 /** Construct a Film object in a given directory, reading any metadata
81  *  file that exists in that directory.  An exception will be thrown if
82  *  must_exist is true and the specified directory does not exist.
83  *
84  *  @param d Film directory.
85  *  @param must_exist true to throw an exception if does not exist.
86  */
87
88 Film::Film (string d, bool must_exist)
89         : _use_dci_name (true)
90         , _trust_content_header (true)
91         , _dcp_content_type (0)
92         , _format (0)
93         , _scaler (Scaler::from_id ("bicubic"))
94         , _trim_start (0)
95         , _trim_end (0)
96         , _trim_type (CPL)
97         , _dcp_ab (false)
98         , _use_content_audio (true)
99         , _audio_gain (0)
100         , _audio_delay (0)
101         , _still_duration (10)
102         , _with_subtitles (false)
103         , _subtitle_offset (0)
104         , _subtitle_scale (1)
105         , _colour_lut (0)
106         , _j2k_bandwidth (200000000)
107         , _dci_metadata (Config::instance()->default_dci_metadata ())
108         , _dcp_frame_rate (0)
109         , _source_frame_rate (0)
110         , _dirty (false)
111 {
112         set_dci_date_today ();
113         
114         /* Make state.directory a complete path without ..s (where possible)
115            (Code swiped from Adam Bowen on stackoverflow)
116         */
117         
118         boost::filesystem::path p (boost::filesystem::system_complete (d));
119         boost::filesystem::path result;
120         for (boost::filesystem::path::iterator i = p.begin(); i != p.end(); ++i) {
121                 if (*i == "..") {
122                         if (boost::filesystem::is_symlink (result) || result.filename() == "..") {
123                                 result /= *i;
124                         } else {
125                                 result = result.parent_path ();
126                         }
127                 } else if (*i != ".") {
128                         result /= *i;
129                 }
130         }
131
132         set_directory (result.string ());
133         
134         if (!boost::filesystem::exists (directory())) {
135                 if (must_exist) {
136                         throw OpenFileError (directory());
137                 } else {
138                         boost::filesystem::create_directory (directory());
139                 }
140         }
141
142         _sndfile_stream = SndfileStream::create ();
143         
144         if (must_exist) {
145                 read_metadata ();
146         } else {
147                 write_metadata ();
148         }
149
150         _log.reset (new FileLog (file ("log")));
151 }
152
153 Film::Film (Film const & o)
154         : boost::enable_shared_from_this<Film> (o)
155         /* note: the copied film shares the original's log */
156         , _log               (o._log)
157         , _directory         (o._directory)
158         , _name              (o._name)
159         , _use_dci_name      (o._use_dci_name)
160         , _content           (o._content)
161         , _trust_content_header (o._trust_content_header)
162         , _dcp_content_type  (o._dcp_content_type)
163         , _format            (o._format)
164         , _crop              (o._crop)
165         , _filters           (o._filters)
166         , _scaler            (o._scaler)
167         , _trim_start        (o._trim_start)
168         , _trim_end          (o._trim_end)
169         , _trim_type         (o._trim_type)
170         , _dcp_ab            (o._dcp_ab)
171         , _content_audio_stream (o._content_audio_stream)
172         , _external_audio    (o._external_audio)
173         , _use_content_audio (o._use_content_audio)
174         , _audio_gain        (o._audio_gain)
175         , _audio_delay       (o._audio_delay)
176         , _still_duration    (o._still_duration)
177         , _subtitle_stream   (o._subtitle_stream)
178         , _with_subtitles    (o._with_subtitles)
179         , _subtitle_offset   (o._subtitle_offset)
180         , _subtitle_scale    (o._subtitle_scale)
181         , _colour_lut        (o._colour_lut)
182         , _j2k_bandwidth     (o._j2k_bandwidth)
183         , _dci_metadata      (o._dci_metadata)
184         , _dci_date          (o._dci_date)
185         , _dcp_frame_rate    (o._dcp_frame_rate)
186         , _size              (o._size)
187         , _length            (o._length)
188         , _content_digest    (o._content_digest)
189         , _content_audio_streams (o._content_audio_streams)
190         , _sndfile_stream    (o._sndfile_stream)
191         , _subtitle_streams  (o._subtitle_streams)
192         , _source_frame_rate (o._source_frame_rate)
193         , _dirty             (o._dirty)
194 {
195         
196 }
197
198 Film::~Film ()
199 {
200
201 }
202
203 string
204 Film::video_state_identifier () const
205 {
206         assert (format ());
207
208         pair<string, string> f = Filter::ffmpeg_strings (filters());
209
210         stringstream s;
211         s << format()->id()
212           << "_" << content_digest()
213           << "_" << crop().left << "_" << crop().right << "_" << crop().top << "_" << crop().bottom
214           << "_" << _dcp_frame_rate
215           << "_" << f.first << "_" << f.second
216           << "_" << scaler()->id()
217           << "_" << j2k_bandwidth()
218           << "_" << boost::lexical_cast<int> (colour_lut());
219
220         if (dcp_ab()) {
221                 pair<string, string> fa = Filter::ffmpeg_strings (Config::instance()->reference_filters());
222                 s << "ab_" << Config::instance()->reference_scaler()->id() << "_" << fa.first << "_" << fa.second;
223         }
224
225         return s.str ();
226 }
227           
228 /** @return The path to the directory to write video frame info files to */
229 string
230 Film::info_dir () const
231 {
232         boost::filesystem::path p;
233         p /= "info";
234         p /= video_state_identifier ();
235         return dir (p.string());
236 }
237
238 string
239 Film::internal_video_mxf_dir () const
240 {
241         boost::filesystem::path p;
242         return dir ("video");
243 }
244
245 string
246 Film::internal_video_mxf_filename () const
247 {
248         return video_state_identifier() + ".mxf";
249 }
250
251 string
252 Film::dcp_video_mxf_filename () const
253 {
254         return filename_safe_name() + "_video.mxf";
255 }
256
257 string
258 Film::dcp_audio_mxf_filename () const
259 {
260         return filename_safe_name() + "_audio.mxf";
261 }
262
263 string
264 Film::filename_safe_name () const
265 {
266         string const n = name ();
267         string o;
268         for (size_t i = 0; i < n.length(); ++i) {
269                 if (isalnum (n[i])) {
270                         o += n[i];
271                 } else {
272                         o += "_";
273                 }
274         }
275
276         return o;
277 }
278
279 string
280 Film::audio_analysis_path () const
281 {
282         boost::filesystem::path p;
283         p /= "analysis";
284         p /= content_digest();
285         return file (p.string ());
286 }
287
288 /** Add suitable Jobs to the JobManager to create a DCP for this Film */
289 void
290 Film::make_dcp ()
291 {
292         set_dci_date_today ();
293         
294         if (dcp_name().find ("/") != string::npos) {
295                 throw BadSettingError (_("name"), _("cannot contain slashes"));
296         }
297         
298         log()->log (String::compose ("DVD-o-matic %1 git %2 using %3", dvdomatic_version, dvdomatic_git_commit, dependency_version_summary()));
299
300         {
301                 char buffer[128];
302                 gethostname (buffer, sizeof (buffer));
303                 log()->log (String::compose ("Starting to make DCP on %1", buffer));
304         }
305         
306         log()->log (String::compose ("Content is %1; type %2", content_path(), (content_type() == STILL ? _("still") : _("video"))));
307         if (length()) {
308                 log()->log (String::compose ("Content length %1", length().get()));
309         }
310         log()->log (String::compose ("Content digest %1", content_digest()));
311         log()->log (String::compose ("Content at %1 fps, DCP at %2 fps", source_frame_rate(), dcp_frame_rate()));
312         log()->log (String::compose ("%1 threads", Config::instance()->num_local_encoding_threads()));
313         log()->log (String::compose ("J2K bandwidth %1", j2k_bandwidth()));
314 #ifdef DVDOMATIC_DEBUG
315         log()->log ("DVD-o-matic built in debug mode.");
316 #else
317         log()->log ("DVD-o-matic built in optimised mode.");
318 #endif
319 #ifdef LIBDCP_DEBUG
320         log()->log ("libdcp built in debug mode.");
321 #else
322         log()->log ("libdcp built in optimised mode.");
323 #endif
324         pair<string, int> const c = cpu_info ();
325         log()->log (String::compose ("CPU: %1, %2 processors", c.first, c.second));
326         
327         if (format() == 0) {
328                 throw MissingSettingError (_("format"));
329         }
330
331         if (content().empty ()) {
332                 throw MissingSettingError (_("content"));
333         }
334
335         if (dcp_content_type() == 0) {
336                 throw MissingSettingError (_("content type"));
337         }
338
339         if (name().empty()) {
340                 throw MissingSettingError (_("name"));
341         }
342
343         DecodeOptions od;
344         od.decode_subtitles = with_subtitles ();
345
346         shared_ptr<Job> r;
347
348         if (dcp_ab()) {
349                 r = JobManager::instance()->add (shared_ptr<Job> (new ABTranscodeJob (shared_from_this(), od)));
350         } else {
351                 r = JobManager::instance()->add (shared_ptr<Job> (new TranscodeJob (shared_from_this(), od)));
352         }
353 }
354
355 /** Start a job to analyse the audio of our content file */
356 void
357 Film::analyse_audio ()
358 {
359         if (_analyse_audio_job) {
360                 return;
361         }
362
363         _analyse_audio_job.reset (new AnalyseAudioJob (shared_from_this()));
364         _analyse_audio_job->Finished.connect (bind (&Film::analyse_audio_finished, this));
365         JobManager::instance()->add (_analyse_audio_job);
366 }
367
368 /** Start a job to examine our content file */
369 void
370 Film::examine_content ()
371 {
372         if (_examine_content_job) {
373                 return;
374         }
375
376         _examine_content_job.reset (new ExamineContentJob (shared_from_this()));
377         _examine_content_job->Finished.connect (bind (&Film::examine_content_finished, this));
378         JobManager::instance()->add (_examine_content_job);
379 }
380
381 void
382 Film::analyse_audio_finished ()
383 {
384         ensure_ui_thread ();
385
386         if (_analyse_audio_job->finished_ok ()) {
387                 AudioAnalysisSucceeded ();
388         }
389         
390         _analyse_audio_job.reset ();
391 }
392
393 void
394 Film::examine_content_finished ()
395 {
396         _examine_content_job.reset ();
397 }
398
399 /** Start a job to send our DCP to the configured TMS */
400 void
401 Film::send_dcp_to_tms ()
402 {
403         shared_ptr<Job> j (new SCPDCPJob (shared_from_this()));
404         JobManager::instance()->add (j);
405 }
406
407 /** Count the number of frames that have been encoded for this film.
408  *  @return frame count.
409  */
410 int
411 Film::encoded_frames () const
412 {
413         if (format() == 0) {
414                 return 0;
415         }
416
417         int N = 0;
418         for (boost::filesystem::directory_iterator i = boost::filesystem::directory_iterator (info_dir ()); i != boost::filesystem::directory_iterator(); ++i) {
419                 ++N;
420                 boost::this_thread::interruption_point ();
421         }
422
423         return N;
424 }
425
426 /** Write state to our `metadata' file */
427 void
428 Film::write_metadata () const
429 {
430         boost::mutex::scoped_lock lm (_state_mutex);
431
432         boost::filesystem::create_directories (directory());
433
434         string const m = file ("metadata");
435         ofstream f (m.c_str ());
436         if (!f.good ()) {
437                 throw CreateFileError (m);
438         }
439
440         f << "version " << state_version << endl;
441
442         /* User stuff */
443         f << "name " << _name << endl;
444         f << "use_dci_name " << _use_dci_name << endl;
445         f << "content " << _content << endl;
446         f << "trust_content_header " << (_trust_content_header ? "1" : "0") << endl;
447         if (_dcp_content_type) {
448                 f << "dcp_content_type " << _dcp_content_type->dci_name () << endl;
449         }
450         if (_format) {
451                 f << "format " << _format->as_metadata () << endl;
452         }
453         f << "left_crop " << _crop.left << endl;
454         f << "right_crop " << _crop.right << endl;
455         f << "top_crop " << _crop.top << endl;
456         f << "bottom_crop " << _crop.bottom << endl;
457         for (vector<Filter const *>::const_iterator i = _filters.begin(); i != _filters.end(); ++i) {
458                 f << "filter " << (*i)->id () << endl;
459         }
460         f << "scaler " << _scaler->id () << endl;
461         f << "trim_start " << _trim_start << endl;
462         f << "trim_end " << _trim_end << endl;
463         switch (_trim_type) {
464         case CPL:
465                 f << "trim_type cpl\n";
466                 break;
467         case ENCODE:
468                 f << "trim_type encode\n";
469                 break;
470         }
471         f << "dcp_ab " << (_dcp_ab ? "1" : "0") << endl;
472         if (_content_audio_stream) {
473                 f << "selected_content_audio_stream " << _content_audio_stream->to_string() << endl;
474         }
475         for (vector<string>::const_iterator i = _external_audio.begin(); i != _external_audio.end(); ++i) {
476                 f << "external_audio " << *i << endl;
477         }
478         f << "use_content_audio " << (_use_content_audio ? "1" : "0") << endl;
479         f << "audio_gain " << _audio_gain << endl;
480         f << "audio_delay " << _audio_delay << endl;
481         f << "still_duration " << _still_duration << endl;
482         if (_subtitle_stream) {
483                 f << "selected_subtitle_stream " << _subtitle_stream->to_string() << endl;
484         }
485         f << "with_subtitles " << _with_subtitles << endl;
486         f << "subtitle_offset " << _subtitle_offset << endl;
487         f << "subtitle_scale " << _subtitle_scale << endl;
488         f << "colour_lut " << _colour_lut << endl;
489         f << "j2k_bandwidth " << _j2k_bandwidth << endl;
490         _dci_metadata.write (f);
491         f << "dci_date " << boost::gregorian::to_iso_string (_dci_date) << endl;
492         f << "dcp_frame_rate " << _dcp_frame_rate << endl;
493         f << "width " << _size.width << endl;
494         f << "height " << _size.height << endl;
495         f << "length " << _length.get_value_or(0) << endl;
496         f << "content_digest " << _content_digest << endl;
497
498         for (vector<shared_ptr<AudioStream> >::const_iterator i = _content_audio_streams.begin(); i != _content_audio_streams.end(); ++i) {
499                 f << "content_audio_stream " << (*i)->to_string () << endl;
500         }
501
502         f << "external_audio_stream " << _sndfile_stream->to_string() << endl;
503
504         for (vector<shared_ptr<SubtitleStream> >::const_iterator i = _subtitle_streams.begin(); i != _subtitle_streams.end(); ++i) {
505                 f << "subtitle_stream " << (*i)->to_string () << endl;
506         }
507
508         f << "source_frame_rate " << _source_frame_rate << endl;
509         
510         _dirty = false;
511 }
512
513 /** Read state from our metadata file */
514 void
515 Film::read_metadata ()
516 {
517         boost::mutex::scoped_lock lm (_state_mutex);
518
519         _external_audio.clear ();
520         _content_audio_streams.clear ();
521         _subtitle_streams.clear ();
522
523         boost::optional<int> version;
524
525         /* Backward compatibility things */
526         boost::optional<int> audio_sample_rate;
527         boost::optional<int> audio_stream_index;
528         boost::optional<int> subtitle_stream_index;
529
530         ifstream f (file ("metadata").c_str());
531         if (!f.good()) {
532                 throw OpenFileError (file ("metadata"));
533         }
534         
535         multimap<string, string> kv = read_key_value (f);
536
537         /* We need version before anything else */
538         multimap<string, string>::iterator v = kv.find ("version");
539         if (v != kv.end ()) {
540                 version = atoi (v->second.c_str());
541         }
542         
543         for (multimap<string, string>::const_iterator i = kv.begin(); i != kv.end(); ++i) {
544                 string const k = i->first;
545                 string const v = i->second;
546
547                 if (k == "audio_sample_rate") {
548                         audio_sample_rate = atoi (v.c_str());
549                 }
550
551                 /* User-specified stuff */
552                 if (k == "name") {
553                         _name = v;
554                 } else if (k == "use_dci_name") {
555                         _use_dci_name = (v == "1");
556                 } else if (k == "content") {
557                         _content = v;
558                 } else if (k == "trust_content_header") {
559                         _trust_content_header = (v == "1");
560                 } else if (k == "dcp_content_type") {
561                         if (version < 3) {
562                                 _dcp_content_type = DCPContentType::from_pretty_name (v);
563                         } else {
564                                 _dcp_content_type = DCPContentType::from_dci_name (v);
565                         }
566                 } else if (k == "format") {
567                         _format = Format::from_metadata (v);
568                 } else if (k == "left_crop") {
569                         _crop.left = atoi (v.c_str ());
570                 } else if (k == "right_crop") {
571                         _crop.right = atoi (v.c_str ());
572                 } else if (k == "top_crop") {
573                         _crop.top = atoi (v.c_str ());
574                 } else if (k == "bottom_crop") {
575                         _crop.bottom = atoi (v.c_str ());
576                 } else if (k == "filter") {
577                         _filters.push_back (Filter::from_id (v));
578                 } else if (k == "scaler") {
579                         _scaler = Scaler::from_id (v);
580                 } else if ( ((!version || version < 2) && k == "dcp_trim_start") || k == "trim_start") {
581                         _trim_start = atoi (v.c_str ());
582                 } else if ( ((!version || version < 2) && k == "dcp_trim_end") || k == "trim_end") {
583                         _trim_end = atoi (v.c_str ());
584                 } else if (k == "trim_type") {
585                         if (v == "cpl") {
586                                 _trim_type = CPL;
587                         } else if (v == "encode") {
588                                 _trim_type = ENCODE;
589                         }
590                 } else if (k == "dcp_ab") {
591                         _dcp_ab = (v == "1");
592                 } else if (k == "selected_content_audio_stream" || (!version && k == "selected_audio_stream")) {
593                         if (!version) {
594                                 audio_stream_index = atoi (v.c_str ());
595                         } else {
596                                 _content_audio_stream = audio_stream_factory (v, version);
597                         }
598                 } else if (k == "external_audio") {
599                         _external_audio.push_back (v);
600                 } else if (k == "use_content_audio") {
601                         _use_content_audio = (v == "1");
602                 } else if (k == "audio_gain") {
603                         _audio_gain = atof (v.c_str ());
604                 } else if (k == "audio_delay") {
605                         _audio_delay = atoi (v.c_str ());
606                 } else if (k == "still_duration") {
607                         _still_duration = atoi (v.c_str ());
608                 } else if (k == "selected_subtitle_stream") {
609                         if (!version) {
610                                 subtitle_stream_index = atoi (v.c_str ());
611                         } else {
612                                 _subtitle_stream = subtitle_stream_factory (v, version);
613                         }
614                 } else if (k == "with_subtitles") {
615                         _with_subtitles = (v == "1");
616                 } else if (k == "subtitle_offset") {
617                         _subtitle_offset = atoi (v.c_str ());
618                 } else if (k == "subtitle_scale") {
619                         _subtitle_scale = atof (v.c_str ());
620                 } else if (k == "colour_lut") {
621                         _colour_lut = atoi (v.c_str ());
622                 } else if (k == "j2k_bandwidth") {
623                         _j2k_bandwidth = atoi (v.c_str ());
624                 } else if (k == "dci_date") {
625                         _dci_date = boost::gregorian::from_undelimited_string (v);
626                 } else if (k == "dcp_frame_rate") {
627                         _dcp_frame_rate = atoi (v.c_str ());
628                 }
629
630                 _dci_metadata.read (k, v);
631                 
632                 /* Cached stuff */
633                 if (k == "width") {
634                         _size.width = atoi (v.c_str ());
635                 } else if (k == "height") {
636                         _size.height = atoi (v.c_str ());
637                 } else if (k == "length") {
638                         int const vv = atoi (v.c_str ());
639                         if (vv) {
640                                 _length = vv;
641                         }
642                 } else if (k == "content_digest") {
643                         _content_digest = v;
644                 } else if (k == "content_audio_stream" || (!version && k == "audio_stream")) {
645                         _content_audio_streams.push_back (audio_stream_factory (v, version));
646                 } else if (k == "external_audio_stream") {
647                         _sndfile_stream = audio_stream_factory (v, version);
648                 } else if (k == "subtitle_stream") {
649                         _subtitle_streams.push_back (subtitle_stream_factory (v, version));
650                 } else if (k == "source_frame_rate") {
651                         _source_frame_rate = atof (v.c_str ());
652                 } else if (version < 4 && k == "frames_per_second") {
653                         _source_frame_rate = atof (v.c_str ());
654                         /* Fill in what would have been used for DCP frame rate by the older version */
655                         _dcp_frame_rate = best_dcp_frame_rate (_source_frame_rate);
656                 }
657         }
658
659         if (!version) {
660                 if (audio_sample_rate) {
661                         /* version < 1 didn't specify sample rate in the audio streams, so fill it in here */
662                         for (vector<shared_ptr<AudioStream> >::iterator i = _content_audio_streams.begin(); i != _content_audio_streams.end(); ++i) {
663                                 (*i)->set_sample_rate (audio_sample_rate.get());
664                         }
665                 }
666
667                 /* also the selected stream was specified as an index */
668                 if (audio_stream_index && audio_stream_index.get() >= 0 && audio_stream_index.get() < (int) _content_audio_streams.size()) {
669                         _content_audio_stream = _content_audio_streams[audio_stream_index.get()];
670                 }
671
672                 /* similarly the subtitle */
673                 if (subtitle_stream_index && subtitle_stream_index.get() >= 0 && subtitle_stream_index.get() < (int) _subtitle_streams.size()) {
674                         _subtitle_stream = _subtitle_streams[subtitle_stream_index.get()];
675                 }
676         }
677                 
678         _dirty = false;
679 }
680
681 libdcp::Size
682 Film::cropped_size (libdcp::Size s) const
683 {
684         boost::mutex::scoped_lock lm (_state_mutex);
685         s.width -= _crop.left + _crop.right;
686         s.height -= _crop.top + _crop.bottom;
687         return s;
688 }
689
690 /** Given a directory name, return its full path within the Film's directory.
691  *  The directory (and its parents) will be created if they do not exist.
692  */
693 string
694 Film::dir (string d) const
695 {
696         boost::mutex::scoped_lock lm (_directory_mutex);
697         
698         boost::filesystem::path p;
699         p /= _directory;
700         p /= d;
701         
702         boost::filesystem::create_directories (p);
703         
704         return p.string ();
705 }
706
707 /** Given a file or directory name, return its full path within the Film's directory.
708  *  _directory_mutex must not be locked on entry.
709  *  Any required parent directories will be created.
710  */
711 string
712 Film::file (string f) const
713 {
714         boost::mutex::scoped_lock lm (_directory_mutex);
715
716         boost::filesystem::path p;
717         p /= _directory;
718         p /= f;
719
720         boost::filesystem::create_directories (p.parent_path ());
721         
722         return p.string ();
723 }
724
725 /** @return full path of the content (actual video) file
726  *  of the Film.
727  */
728 string
729 Film::content_path () const
730 {
731         boost::mutex::scoped_lock lm (_state_mutex);
732         if (boost::filesystem::path(_content).has_root_directory ()) {
733                 return _content;
734         }
735
736         return file (_content);
737 }
738
739 ContentType
740 Film::content_type () const
741 {
742         if (boost::filesystem::is_directory (_content)) {
743                 /* Directory of images, we assume */
744                 return VIDEO;
745         }
746
747         if (still_image_file (_content)) {
748                 return STILL;
749         }
750
751         return VIDEO;
752 }
753
754 /** @return The sampling rate that we will resample the audio to */
755 int
756 Film::target_audio_sample_rate () const
757 {
758         if (!audio_stream()) {
759                 return 0;
760         }
761         
762         /* Resample to a DCI-approved sample rate */
763         double t = dcp_audio_sample_rate (audio_stream()->sample_rate());
764
765         FrameRateConversion frc (source_frame_rate(), dcp_frame_rate());
766
767         /* Compensate if the DCP is being run at a different frame rate
768            to the source; that is, if the video is run such that it will
769            look different in the DCP compared to the source (slower or faster).
770            skip/repeat doesn't come into effect here.
771         */
772
773         if (frc.change_speed) {
774                 t *= source_frame_rate() * frc.factor() / dcp_frame_rate();
775         }
776
777         return rint (t);
778 }
779
780 int
781 Film::still_duration_in_frames () const
782 {
783         return still_duration() * source_frame_rate();
784 }
785
786 /** @return a DCI-compliant name for a DCP of this film */
787 string
788 Film::dci_name (bool if_created_now) const
789 {
790         stringstream d;
791
792         string fixed_name = to_upper_copy (name());
793         for (size_t i = 0; i < fixed_name.length(); ++i) {
794                 if (fixed_name[i] == ' ') {
795                         fixed_name[i] = '-';
796                 }
797         }
798
799         /* Spec is that the name part should be maximum 14 characters, as I understand it */
800         if (fixed_name.length() > 14) {
801                 fixed_name = fixed_name.substr (0, 14);
802         }
803
804         d << fixed_name;
805
806         if (dcp_content_type()) {
807                 d << "_" << dcp_content_type()->dci_name();
808         }
809
810         if (format()) {
811                 d << "_" << format()->dci_name();
812         }
813
814         DCIMetadata const dm = dci_metadata ();
815
816         if (!dm.audio_language.empty ()) {
817                 d << "_" << dm.audio_language;
818                 if (!dm.subtitle_language.empty()) {
819                         d << "-" << dm.subtitle_language;
820                 } else {
821                         d << "-XX";
822                 }
823         }
824
825         if (!dm.territory.empty ()) {
826                 d << "_" << dm.territory;
827                 if (!dm.rating.empty ()) {
828                         d << "-" << dm.rating;
829                 }
830         }
831
832         switch (audio_channels()) {
833         case 1:
834                 d << "_10";
835                 break;
836         case 2:
837                 d << "_20";
838                 break;
839         case 6:
840                 d << "_51";
841                 break;
842         case 8:
843                 d << "_71";
844                 break;
845         }
846
847         d << "_2K";
848
849         if (!dm.studio.empty ()) {
850                 d << "_" << dm.studio;
851         }
852
853         if (if_created_now) {
854                 d << "_" << boost::gregorian::to_iso_string (boost::gregorian::day_clock::local_day ());
855         } else {
856                 d << "_" << boost::gregorian::to_iso_string (_dci_date);
857         }
858
859         if (!dm.facility.empty ()) {
860                 d << "_" << dm.facility;
861         }
862
863         if (!dm.package_type.empty ()) {
864                 d << "_" << dm.package_type;
865         }
866
867         return d.str ();
868 }
869
870 /** @return name to give the DCP */
871 string
872 Film::dcp_name (bool if_created_now) const
873 {
874         if (use_dci_name()) {
875                 return dci_name (if_created_now);
876         }
877
878         return name();
879 }
880
881
882 void
883 Film::set_directory (string d)
884 {
885         boost::mutex::scoped_lock lm (_state_mutex);
886         _directory = d;
887         _dirty = true;
888 }
889
890 void
891 Film::set_name (string n)
892 {
893         {
894                 boost::mutex::scoped_lock lm (_state_mutex);
895                 _name = n;
896         }
897         signal_changed (NAME);
898 }
899
900 void
901 Film::set_use_dci_name (bool u)
902 {
903         {
904                 boost::mutex::scoped_lock lm (_state_mutex);
905                 _use_dci_name = u;
906         }
907         signal_changed (USE_DCI_NAME);
908 }
909
910 void
911 Film::set_content (string c)
912 {
913         string check = directory ();
914
915         boost::filesystem::path slash ("/");
916         string platform_slash = slash.make_preferred().string ();
917
918         if (!ends_with (check, platform_slash)) {
919                 check += platform_slash;
920         }
921         
922         if (boost::filesystem::path(c).has_root_directory () && starts_with (c, check)) {
923                 c = c.substr (_directory.length() + 1);
924         }
925
926         string old_content;
927         
928         {
929                 boost::mutex::scoped_lock lm (_state_mutex);
930                 if (c == _content) {
931                         return;
932                 }
933
934                 old_content = _content;
935                 _content = c;
936         }
937
938         /* Reset streams here in case the new content doesn't have one or the other */
939         _content_audio_stream = shared_ptr<AudioStream> ();
940         _subtitle_stream = shared_ptr<SubtitleStream> ();
941
942         /* Start off using content audio */
943         set_use_content_audio (true);
944
945         /* Create a temporary decoder so that we can get information
946            about the content.
947         */
948
949         try {
950                 Decoders d = decoder_factory (shared_from_this(), DecodeOptions());
951                 
952                 set_size (d.video->native_size ());
953                 set_source_frame_rate (d.video->frames_per_second ());
954                 set_dcp_frame_rate (best_dcp_frame_rate (source_frame_rate ()));
955                 set_subtitle_streams (d.video->subtitle_streams ());
956                 if (d.audio) {
957                         set_content_audio_streams (d.audio->audio_streams ());
958                 }
959
960                 {
961                         boost::mutex::scoped_lock lm (_state_mutex);
962                         _content = c;
963                 }
964                 
965                 signal_changed (CONTENT);
966                 
967                 /* Start off with the first audio and subtitle streams */
968                 if (d.audio && !d.audio->audio_streams().empty()) {
969                         set_content_audio_stream (d.audio->audio_streams().front());
970                 }
971                 
972                 if (!d.video->subtitle_streams().empty()) {
973                         set_subtitle_stream (d.video->subtitle_streams().front());
974                 }
975                 
976                 examine_content ();
977
978         } catch (...) {
979
980                 boost::mutex::scoped_lock lm (_state_mutex);
981                 _content = old_content;
982                 throw;
983
984         }
985
986         /* Default format */
987         switch (content_type()) {
988         case STILL:
989                 set_format (Format::from_id ("var-185"));
990                 break;
991         case VIDEO:
992                 set_format (Format::from_id ("185"));
993                 break;
994         }
995
996         /* Still image DCPs must use external audio */
997         if (content_type() == STILL) {
998                 set_use_content_audio (false);
999         }
1000 }
1001
1002 void
1003 Film::set_trust_content_header (bool t)
1004 {
1005         {
1006                 boost::mutex::scoped_lock lm (_state_mutex);
1007                 _trust_content_header = t;
1008         }
1009         
1010         signal_changed (TRUST_CONTENT_HEADER);
1011
1012         if (!_trust_content_header && !content().empty()) {
1013                 /* We just said that we don't trust the content's header */
1014                 examine_content ();
1015         }
1016 }
1017                
1018 void
1019 Film::set_dcp_content_type (DCPContentType const * t)
1020 {
1021         {
1022                 boost::mutex::scoped_lock lm (_state_mutex);
1023                 _dcp_content_type = t;
1024         }
1025         signal_changed (DCP_CONTENT_TYPE);
1026 }
1027
1028 void
1029 Film::set_format (Format const * f)
1030 {
1031         {
1032                 boost::mutex::scoped_lock lm (_state_mutex);
1033                 _format = f;
1034         }
1035         signal_changed (FORMAT);
1036 }
1037
1038 void
1039 Film::set_crop (Crop c)
1040 {
1041         {
1042                 boost::mutex::scoped_lock lm (_state_mutex);
1043                 _crop = c;
1044         }
1045         signal_changed (CROP);
1046 }
1047
1048 void
1049 Film::set_left_crop (int c)
1050 {
1051         {
1052                 boost::mutex::scoped_lock lm (_state_mutex);
1053                 
1054                 if (_crop.left == c) {
1055                         return;
1056                 }
1057                 
1058                 _crop.left = c;
1059         }
1060         signal_changed (CROP);
1061 }
1062
1063 void
1064 Film::set_right_crop (int c)
1065 {
1066         {
1067                 boost::mutex::scoped_lock lm (_state_mutex);
1068                 if (_crop.right == c) {
1069                         return;
1070                 }
1071                 
1072                 _crop.right = c;
1073         }
1074         signal_changed (CROP);
1075 }
1076
1077 void
1078 Film::set_top_crop (int c)
1079 {
1080         {
1081                 boost::mutex::scoped_lock lm (_state_mutex);
1082                 if (_crop.top == c) {
1083                         return;
1084                 }
1085                 
1086                 _crop.top = c;
1087         }
1088         signal_changed (CROP);
1089 }
1090
1091 void
1092 Film::set_bottom_crop (int c)
1093 {
1094         {
1095                 boost::mutex::scoped_lock lm (_state_mutex);
1096                 if (_crop.bottom == c) {
1097                         return;
1098                 }
1099                 
1100                 _crop.bottom = c;
1101         }
1102         signal_changed (CROP);
1103 }
1104
1105 void
1106 Film::set_filters (vector<Filter const *> f)
1107 {
1108         {
1109                 boost::mutex::scoped_lock lm (_state_mutex);
1110                 _filters = f;
1111         }
1112         signal_changed (FILTERS);
1113 }
1114
1115 void
1116 Film::set_scaler (Scaler const * s)
1117 {
1118         {
1119                 boost::mutex::scoped_lock lm (_state_mutex);
1120                 _scaler = s;
1121         }
1122         signal_changed (SCALER);
1123 }
1124
1125 void
1126 Film::set_trim_start (int t)
1127 {
1128         {
1129                 boost::mutex::scoped_lock lm (_state_mutex);
1130                 _trim_start = t;
1131         }
1132         signal_changed (TRIM_START);
1133 }
1134
1135 void
1136 Film::set_trim_end (int t)
1137 {
1138         {
1139                 boost::mutex::scoped_lock lm (_state_mutex);
1140                 _trim_end = t;
1141         }
1142         signal_changed (TRIM_END);
1143 }
1144
1145 void
1146 Film::set_trim_type (TrimType t)
1147 {
1148         {
1149                 boost::mutex::scoped_lock lm (_state_mutex);
1150                 _trim_type = t;
1151         }
1152         signal_changed (TRIM_TYPE);
1153 }
1154
1155 void
1156 Film::set_dcp_ab (bool a)
1157 {
1158         {
1159                 boost::mutex::scoped_lock lm (_state_mutex);
1160                 _dcp_ab = a;
1161         }
1162         signal_changed (DCP_AB);
1163 }
1164
1165 void
1166 Film::set_content_audio_stream (shared_ptr<AudioStream> s)
1167 {
1168         {
1169                 boost::mutex::scoped_lock lm (_state_mutex);
1170                 _content_audio_stream = s;
1171         }
1172         signal_changed (CONTENT_AUDIO_STREAM);
1173 }
1174
1175 void
1176 Film::set_external_audio (vector<string> a)
1177 {
1178         {
1179                 boost::mutex::scoped_lock lm (_state_mutex);
1180                 _external_audio = a;
1181         }
1182
1183         shared_ptr<SndfileDecoder> decoder (new SndfileDecoder (shared_from_this(), DecodeOptions()));
1184         if (decoder->audio_stream()) {
1185                 _sndfile_stream = decoder->audio_stream ();
1186         }
1187         
1188         signal_changed (EXTERNAL_AUDIO);
1189 }
1190
1191 void
1192 Film::set_use_content_audio (bool e)
1193 {
1194         {
1195                 boost::mutex::scoped_lock lm (_state_mutex);
1196                 _use_content_audio = e;
1197         }
1198
1199         signal_changed (USE_CONTENT_AUDIO);
1200 }
1201
1202 void
1203 Film::set_audio_gain (float g)
1204 {
1205         {
1206                 boost::mutex::scoped_lock lm (_state_mutex);
1207                 _audio_gain = g;
1208         }
1209         signal_changed (AUDIO_GAIN);
1210 }
1211
1212 void
1213 Film::set_audio_delay (int d)
1214 {
1215         {
1216                 boost::mutex::scoped_lock lm (_state_mutex);
1217                 _audio_delay = d;
1218         }
1219         signal_changed (AUDIO_DELAY);
1220 }
1221
1222 void
1223 Film::set_still_duration (int d)
1224 {
1225         {
1226                 boost::mutex::scoped_lock lm (_state_mutex);
1227                 _still_duration = d;
1228         }
1229         signal_changed (STILL_DURATION);
1230 }
1231
1232 void
1233 Film::set_subtitle_stream (shared_ptr<SubtitleStream> s)
1234 {
1235         {
1236                 boost::mutex::scoped_lock lm (_state_mutex);
1237                 _subtitle_stream = s;
1238         }
1239         signal_changed (SUBTITLE_STREAM);
1240 }
1241
1242 void
1243 Film::set_with_subtitles (bool w)
1244 {
1245         {
1246                 boost::mutex::scoped_lock lm (_state_mutex);
1247                 _with_subtitles = w;
1248         }
1249         signal_changed (WITH_SUBTITLES);
1250 }
1251
1252 void
1253 Film::set_subtitle_offset (int o)
1254 {
1255         {
1256                 boost::mutex::scoped_lock lm (_state_mutex);
1257                 _subtitle_offset = o;
1258         }
1259         signal_changed (SUBTITLE_OFFSET);
1260 }
1261
1262 void
1263 Film::set_subtitle_scale (float s)
1264 {
1265         {
1266                 boost::mutex::scoped_lock lm (_state_mutex);
1267                 _subtitle_scale = s;
1268         }
1269         signal_changed (SUBTITLE_SCALE);
1270 }
1271
1272 void
1273 Film::set_colour_lut (int i)
1274 {
1275         {
1276                 boost::mutex::scoped_lock lm (_state_mutex);
1277                 _colour_lut = i;
1278         }
1279         signal_changed (COLOUR_LUT);
1280 }
1281
1282 void
1283 Film::set_j2k_bandwidth (int b)
1284 {
1285         {
1286                 boost::mutex::scoped_lock lm (_state_mutex);
1287                 _j2k_bandwidth = b;
1288         }
1289         signal_changed (J2K_BANDWIDTH);
1290 }
1291
1292 void
1293 Film::set_dci_metadata (DCIMetadata m)
1294 {
1295         {
1296                 boost::mutex::scoped_lock lm (_state_mutex);
1297                 _dci_metadata = m;
1298         }
1299         signal_changed (DCI_METADATA);
1300 }
1301
1302
1303 void
1304 Film::set_dcp_frame_rate (int f)
1305 {
1306         {
1307                 boost::mutex::scoped_lock lm (_state_mutex);
1308                 _dcp_frame_rate = f;
1309         }
1310         signal_changed (DCP_FRAME_RATE);
1311 }
1312
1313 void
1314 Film::set_size (libdcp::Size s)
1315 {
1316         {
1317                 boost::mutex::scoped_lock lm (_state_mutex);
1318                 _size = s;
1319         }
1320         signal_changed (SIZE);
1321 }
1322
1323 void
1324 Film::set_length (SourceFrame l)
1325 {
1326         {
1327                 boost::mutex::scoped_lock lm (_state_mutex);
1328                 _length = l;
1329         }
1330         signal_changed (LENGTH);
1331 }
1332
1333 void
1334 Film::unset_length ()
1335 {
1336         {
1337                 boost::mutex::scoped_lock lm (_state_mutex);
1338                 _length = boost::none;
1339         }
1340         signal_changed (LENGTH);
1341 }
1342
1343 void
1344 Film::set_content_digest (string d)
1345 {
1346         {
1347                 boost::mutex::scoped_lock lm (_state_mutex);
1348                 _content_digest = d;
1349         }
1350         _dirty = true;
1351 }
1352
1353 void
1354 Film::set_content_audio_streams (vector<shared_ptr<AudioStream> > s)
1355 {
1356         {
1357                 boost::mutex::scoped_lock lm (_state_mutex);
1358                 _content_audio_streams = s;
1359         }
1360         signal_changed (CONTENT_AUDIO_STREAMS);
1361 }
1362
1363 void
1364 Film::set_subtitle_streams (vector<shared_ptr<SubtitleStream> > s)
1365 {
1366         {
1367                 boost::mutex::scoped_lock lm (_state_mutex);
1368                 _subtitle_streams = s;
1369         }
1370         signal_changed (SUBTITLE_STREAMS);
1371 }
1372
1373 void
1374 Film::set_source_frame_rate (float f)
1375 {
1376         {
1377                 boost::mutex::scoped_lock lm (_state_mutex);
1378                 _source_frame_rate = f;
1379         }
1380         signal_changed (SOURCE_FRAME_RATE);
1381 }
1382         
1383 void
1384 Film::signal_changed (Property p)
1385 {
1386         {
1387                 boost::mutex::scoped_lock lm (_state_mutex);
1388                 _dirty = true;
1389         }
1390
1391         if (ui_signaller) {
1392                 ui_signaller->emit (boost::bind (boost::ref (Changed), p));
1393         }
1394 }
1395
1396 int
1397 Film::audio_channels () const
1398 {
1399         shared_ptr<AudioStream> s = audio_stream ();
1400         if (!s) {
1401                 return 0;
1402         }
1403
1404         return s->channels ();
1405 }
1406
1407 void
1408 Film::set_dci_date_today ()
1409 {
1410         _dci_date = boost::gregorian::day_clock::local_day ();
1411 }
1412
1413 boost::shared_ptr<AudioStream>
1414 Film::audio_stream () const
1415 {
1416         if (use_content_audio()) {
1417                 return _content_audio_stream;
1418         }
1419
1420         return _sndfile_stream;
1421 }
1422
1423 string
1424 Film::info_path (int f) const
1425 {
1426         boost::filesystem::path p;
1427         p /= info_dir ();
1428
1429         stringstream s;
1430         s.width (8);
1431         s << setfill('0') << f << ".md5";
1432
1433         p /= s.str();
1434
1435         /* info_dir() will already have added any initial bit of the path,
1436            so don't call file() on this.
1437         */
1438         return p.string ();
1439 }
1440
1441 string
1442 Film::j2c_path (int f, bool t) const
1443 {
1444         boost::filesystem::path p;
1445         p /= "j2c";
1446         p /= video_state_identifier ();
1447
1448         stringstream s;
1449         s.width (8);
1450         s << setfill('0') << f << ".j2c";
1451
1452         if (t) {
1453                 s << ".tmp";
1454         }
1455
1456         p /= s.str();
1457         return file (p.string ());
1458 }
1459
1460 /** Make an educated guess as to whether we have a complete DCP
1461  *  or not.
1462  *  @return true if we do.
1463  */
1464
1465 bool
1466 Film::have_dcp () const
1467 {
1468         try {
1469                 libdcp::DCP dcp (dir (dcp_name()));
1470                 dcp.read ();
1471         } catch (...) {
1472                 return false;
1473         }
1474
1475         return true;
1476 }
1477
1478 bool
1479 Film::has_audio () const
1480 {
1481         if (use_content_audio()) {
1482                 return audio_stream();
1483         }
1484
1485         vector<string> const e = external_audio ();
1486         for (vector<string>::const_iterator i = e.begin(); i != e.end(); ++i) {
1487                 if (!i->empty ()) {
1488                         return true;
1489                 }
1490         }
1491
1492         return false;
1493 }
1494