2 Copyright (C) 2012-2014 Carl Hetherington <cth@carlh.net>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 #include <boost/filesystem.hpp>
29 #include <boost/algorithm/string.hpp>
30 #include <boost/lexical_cast.hpp>
31 #include <libxml++/libxml++.h>
32 #include <libcxml/cxml.h>
33 #include <dcp/signer_chain.h>
35 #include <dcp/signer.h>
37 #include <dcp/local_time.h>
38 #include <dcp/raw_convert.h>
42 #include "job_manager.h"
43 #include "transcode_job.h"
44 #include "scp_dcp_job.h"
46 #include "exceptions.h"
47 #include "examine_content_job.h"
51 #include "ui_signaller.h"
54 #include "dcp_content_type.h"
62 using std::stringstream;
73 using boost::shared_ptr;
74 using boost::weak_ptr;
75 using boost::dynamic_pointer_cast;
76 using boost::to_upper_copy;
77 using boost::ends_with;
78 using boost::starts_with;
79 using boost::optional;
80 using boost::is_any_of;
83 using dcp::raw_convert;
84 using dcp::raw_convert;
86 #define LOG_GENERAL(...) log()->log (String::compose (__VA_ARGS__), Log::TYPE_GENERAL);
87 #define LOG_GENERAL_NC(...) log()->log (__VA_ARGS__, Log::TYPE_GENERAL);
90 * AudioMapping XML changed.
92 * Subtitle offset changed to subtitle y offset, and subtitle x offset added.
94 * Use <Scale> tag in <VideoContent> rather than <Ratio>.
98 * Bumped to 32 for 2.0 branch; some times are expressed in Times rather
101 int const Film::current_state_version = 32;
103 /** Construct a Film object in a given directory.
105 * @param dir Film directory.
108 Film::Film (boost::filesystem::path dir, bool log)
109 : _playlist (new Playlist)
110 , _use_isdcf_name (true)
111 , _dcp_content_type (Config::instance()->default_dcp_content_type ())
112 , _container (Config::instance()->default_container ())
113 , _resolution (RESOLUTION_2K)
114 , _scaler (Scaler::from_id ("bicubic"))
117 , _j2k_bandwidth (Config::instance()->default_j2k_bandwidth ())
118 , _isdcf_metadata (Config::instance()->default_isdcf_metadata ())
119 , _video_frame_rate (24)
120 , _audio_channels (6)
122 , _sequence_video (true)
124 , _state_version (current_state_version)
127 set_isdcf_date_today ();
129 _playlist->Changed.connect (bind (&Film::playlist_changed, this));
130 _playlist->ContentChanged.connect (bind (&Film::playlist_content_changed, this, _1, _2));
132 /* Make state.directory a complete path without ..s (where possible)
133 (Code swiped from Adam Bowen on stackoverflow)
136 boost::filesystem::path p (boost::filesystem::system_complete (dir));
137 boost::filesystem::path result;
138 for (boost::filesystem::path::iterator i = p.begin(); i != p.end(); ++i) {
140 if (boost::filesystem::is_symlink (result) || result.filename() == "..") {
143 result = result.parent_path ();
145 } else if (*i != ".") {
150 set_directory (result);
152 _log.reset (new FileLog (file ("log")));
154 _log.reset (new NullLog);
157 _playlist->set_sequence_video (_sequence_video);
161 Film::video_identifier () const
163 assert (container ());
166 s.imbue (std::locale::classic ());
168 s << container()->id()
169 << "_" << resolution_to_string (_resolution)
170 << "_" << _playlist->video_identifier()
171 << "_" << _video_frame_rate
172 << "_" << scaler()->id()
173 << "_" << j2k_bandwidth();
194 /** @return The path to the directory to write video frame info files to */
195 boost::filesystem::path
196 Film::info_dir () const
198 boost::filesystem::path p;
200 p /= video_identifier ();
204 boost::filesystem::path
205 Film::internal_video_mxf_dir () const
207 return dir ("video");
210 boost::filesystem::path
211 Film::internal_video_mxf_filename () const
213 return video_identifier() + ".mxf";
216 boost::filesystem::path
217 Film::video_mxf_filename () const
219 return filename_safe_name() + "_video.mxf";
222 boost::filesystem::path
223 Film::audio_mxf_filename () const
225 return filename_safe_name() + "_audio.mxf";
229 Film::filename_safe_name () const
231 string const n = name ();
233 for (size_t i = 0; i < n.length(); ++i) {
234 if (isalnum (n[i])) {
244 boost::filesystem::path
245 Film::audio_analysis_dir () const
247 return dir ("analysis");
250 /** Add suitable Jobs to the JobManager to create a DCP for this Film */
254 set_isdcf_date_today ();
256 if (dcp_name().find ("/") != string::npos) {
257 throw BadSettingError (_("name"), _("cannot contain slashes"));
260 /* It seems to make sense to auto-save metadata here, since the make DCP may last
261 a long time, and crashes/power failures are moderately likely.
265 LOG_GENERAL ("DCP-o-matic %1 git %2 using %3", dcpomatic_version, dcpomatic_git_commit, dependency_version_summary());
269 gethostname (buffer, sizeof (buffer));
270 LOG_GENERAL ("Starting to make DCP on %1", buffer);
273 ContentList cl = content ();
274 for (ContentList::const_iterator i = cl.begin(); i != cl.end(); ++i) {
275 LOG_GENERAL ("Content: %1", (*i)->technical_summary());
277 LOG_GENERAL ("DCP video rate %1 fps", video_frame_rate());
278 LOG_GENERAL ("%1 threads", Config::instance()->num_local_encoding_threads());
279 LOG_GENERAL ("J2K bandwidth %1", j2k_bandwidth());
280 #ifdef DCPOMATIC_DEBUG
281 LOG_GENERAL_NC ("DCP-o-matic built in debug mode.");
283 LOG_GENERAL_NC ("DCP-o-matic built in optimised mode.");
286 LOG_GENERAL_NC ("libdcp built in debug mode.");
288 LOG_GENERAL_NC ("libdcp built in optimised mode.");
291 #ifdef DCPOMATIC_WINDOWS
293 info.dwOSVersionInfoSize = sizeof (info);
294 GetVersionEx (&info);
295 LOG_GENERAL ("Windows version %1.%2.%3 SP %4", info.dwMajorVersion, info.dwMinorVersion, info.dwBuildNumber, info.szCSDVersion);
298 LOG_GENERAL ("CPU: %1, %2 processors", cpu_info(), boost::thread::hardware_concurrency ());
299 list<pair<string, string> > const m = mount_info ();
300 for (list<pair<string, string> >::const_iterator i = m.begin(); i != m.end(); ++i) {
301 LOG_GENERAL ("Mount: %1 %2", i->first, i->second);
304 if (container() == 0) {
305 throw MissingSettingError (_("container"));
308 if (content().empty()) {
309 throw StringError (_("You must add some content to the DCP before creating it"));
312 if (dcp_content_type() == 0) {
313 throw MissingSettingError (_("content type"));
316 if (name().empty()) {
317 throw MissingSettingError (_("name"));
320 JobManager::instance()->add (shared_ptr<Job> (new TranscodeJob (shared_from_this())));
323 /** Start a job to send our DCP to the configured TMS */
325 Film::send_dcp_to_tms ()
327 shared_ptr<Job> j (new SCPDCPJob (shared_from_this()));
328 JobManager::instance()->add (j);
331 /** Count the number of frames that have been encoded for this film.
332 * @return frame count.
335 Film::encoded_frames () const
337 if (container() == 0) {
342 for (boost::filesystem::directory_iterator i = boost::filesystem::directory_iterator (info_dir ()); i != boost::filesystem::directory_iterator(); ++i) {
344 boost::this_thread::interruption_point ();
350 shared_ptr<xmlpp::Document>
351 Film::metadata () const
353 shared_ptr<xmlpp::Document> doc (new xmlpp::Document);
354 xmlpp::Element* root = doc->create_root_node ("Metadata");
356 root->add_child("Version")->add_child_text (raw_convert<string> (current_state_version));
357 root->add_child("Name")->add_child_text (_name);
358 root->add_child("UseISDCFName")->add_child_text (_use_isdcf_name ? "1" : "0");
360 if (_dcp_content_type) {
361 root->add_child("DCPContentType")->add_child_text (_dcp_content_type->isdcf_name ());
365 root->add_child("Container")->add_child_text (_container->id ());
368 root->add_child("Resolution")->add_child_text (resolution_to_string (_resolution));
369 root->add_child("Scaler")->add_child_text (_scaler->id ());
370 root->add_child("J2KBandwidth")->add_child_text (raw_convert<string> (_j2k_bandwidth));
371 _isdcf_metadata.as_xml (root->add_child ("ISDCFMetadata"));
372 root->add_child("VideoFrameRate")->add_child_text (raw_convert<string> (_video_frame_rate));
373 root->add_child("ISDCFDate")->add_child_text (boost::gregorian::to_iso_string (_isdcf_date));
374 root->add_child("AudioChannels")->add_child_text (raw_convert<string> (_audio_channels));
375 root->add_child("ThreeD")->add_child_text (_three_d ? "1" : "0");
376 root->add_child("SequenceVideo")->add_child_text (_sequence_video ? "1" : "0");
377 root->add_child("Interop")->add_child_text (_interop ? "1" : "0");
378 root->add_child("Signed")->add_child_text (_signed ? "1" : "0");
379 root->add_child("Encrypted")->add_child_text (_encrypted ? "1" : "0");
380 root->add_child("Key")->add_child_text (_key.hex ());
381 _playlist->as_xml (root->add_child ("Playlist"));
386 /** Write state to our `metadata' file */
388 Film::write_metadata () const
390 boost::filesystem::create_directories (directory ());
391 shared_ptr<xmlpp::Document> doc = metadata ();
392 doc->write_to_file_formatted (file("metadata.xml").string ());
396 /** Read state from our metadata file.
397 * @return Notes about things that the user should know about, or empty.
400 Film::read_metadata ()
402 if (boost::filesystem::exists (file ("metadata")) && !boost::filesystem::exists (file ("metadata.xml"))) {
403 throw StringError (_("This film was created with an older version of DCP-o-matic, and unfortunately it cannot be loaded into this version. You will need to create a new Film, re-add your content and set it up again. Sorry!"));
406 cxml::Document f ("Metadata");
407 f.read_file (file ("metadata.xml"));
409 _state_version = f.number_child<int> ("Version");
410 if (_state_version > current_state_version) {
411 throw StringError (_("This film was created with a newer version of DCP-o-matic, and it cannot be loaded into this version. Sorry!"));
414 _name = f.string_child ("Name");
415 if (_state_version >= 9) {
416 _use_isdcf_name = f.bool_child ("UseISDCFName");
417 _isdcf_metadata = ISDCFMetadata (f.node_child ("ISDCFMetadata"));
418 _isdcf_date = boost::gregorian::from_undelimited_string (f.string_child ("ISDCFDate"));
420 _use_isdcf_name = f.bool_child ("UseDCIName");
421 _isdcf_metadata = ISDCFMetadata (f.node_child ("DCIMetadata"));
422 _isdcf_date = boost::gregorian::from_undelimited_string (f.string_child ("DCIDate"));
426 optional<string> c = f.optional_string_child ("DCPContentType");
428 _dcp_content_type = DCPContentType::from_isdcf_name (c.get ());
433 optional<string> c = f.optional_string_child ("Container");
435 _container = Ratio::from_id (c.get ());
439 _resolution = string_to_resolution (f.string_child ("Resolution"));
440 _scaler = Scaler::from_id (f.string_child ("Scaler"));
441 _j2k_bandwidth = f.number_child<int> ("J2KBandwidth");
442 _video_frame_rate = f.number_child<int> ("VideoFrameRate");
443 _signed = f.optional_bool_child("Signed").get_value_or (true);
444 _encrypted = f.bool_child ("Encrypted");
445 _audio_channels = f.number_child<int> ("AudioChannels");
446 _sequence_video = f.bool_child ("SequenceVideo");
447 _three_d = f.bool_child ("ThreeD");
448 _interop = f.bool_child ("Interop");
449 _key = dcp::Key (f.string_child ("Key"));
452 /* This method is the only one that can return notes (so far) */
453 _playlist->set_from_xml (shared_from_this(), f.node_child ("Playlist"), _state_version, notes);
459 /** Given a directory name, return its full path within the Film's directory.
460 * The directory (and its parents) will be created if they do not exist.
462 boost::filesystem::path
463 Film::dir (boost::filesystem::path d) const
465 boost::filesystem::path p;
469 boost::filesystem::create_directories (p);
474 /** Given a file or directory name, return its full path within the Film's directory.
475 * Any required parent directories will be created.
477 boost::filesystem::path
478 Film::file (boost::filesystem::path f) const
480 boost::filesystem::path p;
484 boost::filesystem::create_directories (p.parent_path ());
489 /** @return a ISDCF-compliant name for a DCP of this film */
491 Film::isdcf_name (bool if_created_now) const
495 string raw_name = name ();
497 /* Split the raw name up into words */
498 vector<string> words;
499 split (words, raw_name, is_any_of (" "));
503 /* Add each word to fixed_name */
504 for (vector<string>::const_iterator i = words.begin(); i != words.end(); ++i) {
507 /* First letter is always capitalised */
508 w[0] = toupper (w[0]);
510 /* Count caps in w */
512 for (size_t i = 0; i < w.size(); ++i) {
513 if (isupper (w[i])) {
518 /* If w is all caps make the rest of it lower case, otherwise
521 if (caps == w.size ()) {
522 for (size_t i = 1; i < w.size(); ++i) {
523 w[i] = tolower (w[i]);
527 for (size_t i = 0; i < w.size(); ++i) {
532 if (fixed_name.length() > 14) {
533 fixed_name = fixed_name.substr (0, 14);
538 if (dcp_content_type()) {
539 d << "_" << dcp_content_type()->isdcf_name();
540 d << "-" << isdcf_metadata().content_version;
543 ISDCFMetadata const dm = isdcf_metadata ();
545 if (dm.temp_version) {
549 if (dm.pre_release) {
557 if (!dm.chain.empty ()) {
558 d << "-" << dm.chain;
565 if (dm.two_d_version_of_three_d) {
569 if (!dm.mastered_luminance.empty ()) {
570 d << "-" << dm.mastered_luminance;
573 if (video_frame_rate() != 24) {
574 d << "-" << video_frame_rate();
578 d << "_" << container()->isdcf_name();
581 /* XXX: this only works for content which has been scaled to a given ratio,
582 and uses the first bit of content only.
585 /* The standard says we don't do this for trailers, for some strange reason */
586 if (dcp_content_type() && dcp_content_type()->libdcp_kind() != dcp::TRAILER) {
587 ContentList cl = content ();
588 Ratio const * content_ratio = 0;
589 for (ContentList::const_iterator i = cl.begin(); i != cl.end(); ++i) {
590 shared_ptr<VideoContent> vc = dynamic_pointer_cast<VideoContent> (*i);
591 if (vc && (content_ratio == 0 || vc->scale().ratio() != content_ratio)) {
592 content_ratio = vc->scale().ratio();
596 if (content_ratio && content_ratio != container()) {
597 d << "-" << content_ratio->isdcf_name();
601 if (!dm.audio_language.empty ()) {
602 d << "_" << dm.audio_language;
603 if (!dm.subtitle_language.empty()) {
604 d << "-" << dm.subtitle_language;
610 if (!dm.territory.empty ()) {
611 d << "_" << dm.territory;
612 if (!dm.rating.empty ()) {
613 d << "-" << dm.rating;
617 switch (audio_channels ()) {
640 d << "_" << resolution_to_string (_resolution);
642 if (!dm.studio.empty ()) {
643 d << "_" << dm.studio;
646 if (if_created_now) {
647 d << "_" << boost::gregorian::to_iso_string (boost::gregorian::day_clock::local_day ());
649 d << "_" << boost::gregorian::to_iso_string (_isdcf_date);
652 if (!dm.facility.empty ()) {
653 d << "_" << dm.facility;
666 if (!dm.package_type.empty ()) {
667 d << "_" << dm.package_type;
673 /** @return name to give the DCP */
675 Film::dcp_name (bool if_created_now) const
677 if (use_isdcf_name()) {
678 return isdcf_name (if_created_now);
686 Film::set_directory (boost::filesystem::path d)
693 Film::set_name (string n)
696 signal_changed (NAME);
700 Film::set_use_isdcf_name (bool u)
703 signal_changed (USE_ISDCF_NAME);
707 Film::set_dcp_content_type (DCPContentType const * t)
709 _dcp_content_type = t;
710 signal_changed (DCP_CONTENT_TYPE);
714 Film::set_container (Ratio const * c)
717 signal_changed (CONTAINER);
721 Film::set_resolution (Resolution r)
724 signal_changed (RESOLUTION);
728 Film::set_scaler (Scaler const * s)
731 signal_changed (SCALER);
735 Film::set_j2k_bandwidth (int b)
738 signal_changed (J2K_BANDWIDTH);
742 Film::set_isdcf_metadata (ISDCFMetadata m)
745 signal_changed (ISDCF_METADATA);
749 Film::set_video_frame_rate (int f)
751 _video_frame_rate = f;
752 signal_changed (VIDEO_FRAME_RATE);
756 Film::set_audio_channels (int c)
759 signal_changed (AUDIO_CHANNELS);
763 Film::set_three_d (bool t)
766 signal_changed (THREE_D);
770 Film::set_interop (bool i)
773 signal_changed (INTEROP);
777 Film::signal_changed (Property p)
783 set_video_frame_rate (_playlist->best_dcp_frame_rate ());
785 case Film::VIDEO_FRAME_RATE:
786 case Film::SEQUENCE_VIDEO:
787 _playlist->maybe_sequence_video ();
794 ui_signaller->emit (boost::bind (boost::ref (Changed), p));
799 Film::set_isdcf_date_today ()
801 _isdcf_date = boost::gregorian::day_clock::local_day ();
804 boost::filesystem::path
805 Film::info_path (int f, Eyes e) const
807 boost::filesystem::path p;
812 s << setfill('0') << f;
814 if (e == EYES_LEFT) {
816 } else if (e == EYES_RIGHT) {
824 /* info_dir() will already have added any initial bit of the path,
825 so don't call file() on this.
830 boost::filesystem::path
831 Film::j2c_path (int f, Eyes e, bool t) const
833 boost::filesystem::path p;
835 p /= video_identifier ();
839 s << setfill('0') << f;
841 if (e == EYES_LEFT) {
843 } else if (e == EYES_RIGHT) {
857 /** Find all the DCPs in our directory that can be dcp::DCP::read() and return details of their CPLs */
861 vector<CPLSummary> out;
863 boost::filesystem::path const dir = directory ();
864 for (boost::filesystem::directory_iterator i = boost::filesystem::directory_iterator(dir); i != boost::filesystem::directory_iterator(); ++i) {
866 boost::filesystem::is_directory (*i) &&
867 i->path().leaf() != "j2c" && i->path().leaf() != "video" && i->path().leaf() != "info" && i->path().leaf() != "analysis"
875 i->path().leaf().string(),
876 dcp.cpls().front()->id(),
877 dcp.cpls().front()->annotation_text(),
878 dcp.cpls().front()->file()
891 Film::make_player () const
893 return shared_ptr<Player> (new Player (shared_from_this (), _playlist));
897 Film::set_signed (bool s)
900 signal_changed (SIGNED);
904 Film::set_encrypted (bool e)
907 signal_changed (ENCRYPTED);
911 Film::playlist () const
917 Film::content () const
919 return _playlist->content ();
923 Film::examine_and_add_content (shared_ptr<Content> c)
925 if (dynamic_pointer_cast<FFmpegContent> (c)) {
926 run_ffprobe (c->path(0), file ("ffprobe.log"), _log);
929 shared_ptr<Job> j (new ExamineContentJob (shared_from_this(), c));
930 j->Finished.connect (bind (&Film::maybe_add_content, this, boost::weak_ptr<Job> (j), boost::weak_ptr<Content> (c)));
931 JobManager::instance()->add (j);
935 Film::maybe_add_content (weak_ptr<Job> j, weak_ptr<Content> c)
937 shared_ptr<Job> job = j.lock ();
938 if (!job || !job->finished_ok ()) {
942 shared_ptr<Content> content = c.lock ();
944 add_content (content);
949 Film::add_content (shared_ptr<Content> c)
951 /* Add video content after any existing content */
952 if (dynamic_pointer_cast<VideoContent> (c)) {
953 c->set_position (_playlist->video_end ());
960 Film::remove_content (shared_ptr<Content> c)
962 _playlist->remove (c);
966 Film::move_content_earlier (shared_ptr<Content> c)
968 _playlist->move_earlier (c);
972 Film::move_content_later (shared_ptr<Content> c)
974 _playlist->move_later (c);
978 Film::length () const
980 return _playlist->length ();
984 Film::best_video_frame_rate () const
986 return _playlist->best_dcp_frame_rate ();
990 Film::active_frame_rate_change (DCPTime t) const
992 return _playlist->active_frame_rate_change (t, video_frame_rate ());
996 Film::playlist_content_changed (boost::weak_ptr<Content> c, int p)
998 if (p == VideoContentProperty::VIDEO_FRAME_RATE) {
999 set_video_frame_rate (_playlist->best_dcp_frame_rate ());
1003 ui_signaller->emit (boost::bind (boost::ref (ContentChanged), c, p));
1008 Film::playlist_changed ()
1010 signal_changed (CONTENT);
1014 Film::audio_frame_rate () const
1021 Film::set_sequence_video (bool s)
1023 _sequence_video = s;
1024 _playlist->set_sequence_video (s);
1025 signal_changed (SEQUENCE_VIDEO);
1028 /** @return Size of the largest possible image in whatever resolution we are using */
1030 Film::full_frame () const
1032 switch (_resolution) {
1034 return dcp::Size (2048, 1080);
1036 return dcp::Size (4096, 2160);
1040 return dcp::Size ();
1043 /** @return Size of the frame */
1045 Film::frame_size () const
1047 return fit_ratio_within (container()->ratio(), full_frame ());
1052 shared_ptr<dcp::Certificate> target,
1053 boost::filesystem::path cpl_file,
1054 dcp::LocalTime from,
1055 dcp::LocalTime until,
1056 dcp::Formulation formulation
1059 shared_ptr<const dcp::CPL> cpl (new dcp::CPL (cpl_file));
1060 return dcp::DecryptedKDM (
1061 cpl, from, until, "DCP-o-matic", cpl->content_title_text(), dcp::LocalTime().as_string()
1062 ).encrypt (make_signer(), target, formulation);
1065 list<dcp::EncryptedKDM>
1067 list<shared_ptr<Screen> > screens,
1068 boost::filesystem::path dcp,
1069 dcp::LocalTime from,
1070 dcp::LocalTime until,
1071 dcp::Formulation formulation
1074 list<dcp::EncryptedKDM> kdms;
1076 for (list<shared_ptr<Screen> >::iterator i = screens.begin(); i != screens.end(); ++i) {
1077 kdms.push_back (make_kdm ((*i)->certificate, dcp, from, until, formulation));
1083 /** @return The approximate disk space required to encode a DCP of this film with the
1084 * current settings, in bytes.
1087 Film::required_disk_space () const
1089 return uint64_t (j2k_bandwidth() / 8) * length().seconds();
1092 /** This method checks the disk that the Film is on and tries to decide whether or not
1093 * there will be enough space to make a DCP for it. If so, true is returned; if not,
1094 * false is returned and required and availabe are filled in with the amount of disk space
1095 * required and available respectively (in Gb).
1097 * Note: the decision made by this method isn't, of course, 100% reliable.
1100 Film::should_be_enough_disk_space (double& required, double& available) const
1102 boost::filesystem::space_info s = boost::filesystem::space (internal_video_mxf_dir ());
1103 required = double (required_disk_space ()) / 1073741824.0f;
1104 available = double (s.available) / 1073741824.0f;
1105 return (available - required) > 1;