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