src/lib/film_state.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 /** @file src/film_state.cc
  21  *  @brief The state of a Film.  This is separate from Film so that
  22  *  state can easily be copied and kept around for reference
  23  *  by long-running jobs.  This avoids the jobs getting confused
  24  *  by the user changing Film settings during their run.
  25  */
  26
  27 #include <fstream>
  28 #include <string>
  29 #include <iomanip>
  30 #include <sstream>
  31 #include <boost/filesystem.hpp>
  32 #include <boost/date_time.hpp>
  33 #include <boost/algorithm/string.hpp>
  34 #include "film_state.h"
  35 #include "scaler.h"
  36 #include "filter.h"
  37 #include "format.h"
  38 #include "dcp_content_type.h"
  39 #include "util.h"
  40 #include "exceptions.h"
  41 #include "options.h"
  42 #include "decoder.h"
  43 #include "decoder_factory.h"
  44
  45 using namespace std;
  46 using namespace boost;
  47
  48 /** Write state to our `metadata' file */
  49 void
  50 FilmState::write_metadata () const
  51 {
  52         filesystem::create_directories (directory());
  53
  54         string const m = file ("metadata");
  55         ofstream f (m.c_str ());
  56         if (!f.good ()) {
  57                 throw CreateFileError (m);
  58         }
  59
  60         /* User stuff */
  61         f << "name " << _name << "\n";
  62         f << "use_dci_name " << _use_dci_name << "\n";
  63         f << "content " << _content << "\n";
  64         if (_dcp_content_type) {
  65                 f << "dcp_content_type " << _dcp_content_type->pretty_name () << "\n";
  66         }
  67         if (_format) {
  68                 f << "format " << _format->as_metadata () << "\n";
  69         }
  70         f << "left_crop " << _crop.left << "\n";
  71         f << "right_crop " << _crop.right << "\n";
  72         f << "top_crop " << _crop.top << "\n";
  73         f << "bottom_crop " << _crop.bottom << "\n";
  74         for (vector<Filter const *>::const_iterator i = _filters.begin(); i != _filters.end(); ++i) {
  75                 f << "filter " << (*i)->id () << "\n";
  76         }
  77         f << "scaler " << _scaler->id () << "\n";
  78         f << "dcp_frames " << _dcp_frames << "\n";
  79
  80         f << "dcp_trim_action ";
  81         switch (_dcp_trim_action) {
  82         case CUT:
  83                 f << "cut\n";
  84                 break;
  85         case BLACK_OUT:
  86                 f << "black_out\n";
  87                 break;
  88         }
  89
  90         f << "dcp_ab " << (_dcp_ab ? "1" : "0") << "\n";
  91         f << "selected_audio_stream " << _audio_stream << "\n";
  92         f << "audio_gain " << _audio_gain << "\n";
  93         f << "audio_delay " << _audio_delay << "\n";
  94         f << "still_duration " << _still_duration << "\n";
  95         f << "selected_subtitle_stream " << _subtitle_stream << "\n";
  96         f << "with_subtitles " << _with_subtitles << "\n";
  97         f << "subtitle_offset " << _subtitle_offset << "\n";
  98         f << "subtitle_scale " << _subtitle_scale << "\n";
  99         f << "audio_language " << _audio_language << "\n";
 100         f << "subtitle_language " << _subtitle_language << "\n";
 101         f << "territory " << _territory << "\n";
 102         f << "rating " << _rating << "\n";
 103         f << "studio " << _studio << "\n";
 104         f << "facility " << _facility << "\n";
 105         f << "package_type " << _package_type << "\n";
 106
 107         /* Cached stuff; this is information about our content; we could
 108            look it up each time, but that's slow.
 109         */
 110         for (vector<int>::const_iterator i = _thumbs.begin(); i != _thumbs.end(); ++i) {
 111                 f << "thumb " << *i << "\n";
 112         }
 113         f << "width " << _size.width << "\n";
 114         f << "height " << _size.height << "\n";
 115         f << "length " << _length << "\n";
 116         f << "audio_sample_rate " << _audio_sample_rate << "\n";
 117         f << "content_digest " << _content_digest << "\n";
 118         f << "has_subtitles " << _has_subtitles << "\n";
 119
 120         for (vector<AudioStream>::const_iterator i = _audio_streams.begin(); i != _audio_streams.end(); ++i) {
 121                 f << "audio_stream " << i->to_string () << "\n";
 122         }
 123
 124         for (vector<SubtitleStream>::const_iterator i = _subtitle_streams.begin(); i != _subtitle_streams.end(); ++i) {
 125                 f << "subtitle_stream " << i->to_string () << "\n";
 126         }
 127
 128         f << "frames_per_second " << _frames_per_second << "\n";
 129
 130         _dirty = false;
 131 }
 132
 133 /** Read state from our metadata file */
 134 void
 135 FilmState::read_metadata ()
 136 {
 137         ifstream f (file("metadata").c_str());
 138         multimap<string, string> kv = read_key_value (f);
 139         for (multimap<string, string>::const_iterator i = kv.begin(); i != kv.end(); ++i) {
 140                 string const k = i->first;
 141                 string const v = i->second;
 142
 143                 /* User-specified stuff */
 144                 if (k == "name") {
 145                         _name = v;
 146                 } else if (k == "use_dci_name") {
 147                         _use_dci_name = (v == "1");
 148                 } else if (k == "content") {
 149                         _content = v;
 150                 } else if (k == "dcp_content_type") {
 151                         _dcp_content_type = DCPContentType::from_pretty_name (v);
 152                 } else if (k == "format") {
 153                         _format = Format::from_metadata (v);
 154                 } else if (k == "left_crop") {
 155                         _crop.left = atoi (v.c_str ());
 156                 } else if (k == "right_crop") {
 157                         _crop.right = atoi (v.c_str ());
 158                 } else if (k == "top_crop") {
 159                         _crop.top = atoi (v.c_str ());
 160                 } else if (k == "bottom_crop") {
 161                         _crop.bottom = atoi (v.c_str ());
 162                 } else if (k == "filter") {
 163                         _filters.push_back (Filter::from_id (v));
 164                 } else if (k == "scaler") {
 165                         _scaler = Scaler::from_id (v);
 166                 } else if (k == "dcp_frames") {
 167                         _dcp_frames = atoi (v.c_str ());
 168                 } else if (k == "dcp_trim_action") {
 169                         if (v == "cut") {
 170                                 _dcp_trim_action = CUT;
 171                         } else if (v == "black_out") {
 172                                 _dcp_trim_action = BLACK_OUT;
 173                         }
 174                 } else if (k == "dcp_ab") {
 175                         _dcp_ab = (v == "1");
 176                 } else if (k == "selected_audio_stream") {
 177                         _audio_stream = atoi (v.c_str ());
 178                 } else if (k == "audio_gain") {
 179                         _audio_gain = atof (v.c_str ());
 180                 } else if (k == "audio_delay") {
 181                         _audio_delay = atoi (v.c_str ());
 182                 } else if (k == "still_duration") {
 183                         _still_duration = atoi (v.c_str ());
 184                 } else if (k == "selected_subtitle_stream") {
 185                         _subtitle_stream = atoi (v.c_str ());
 186                 } else if (k == "with_subtitles") {
 187                         _with_subtitles = (v == "1");
 188                 } else if (k == "subtitle_offset") {
 189                         _subtitle_offset = atoi (v.c_str ());
 190                 } else if (k == "subtitle_scale") {
 191                         _subtitle_scale = atof (v.c_str ());
 192                 } else if (k == "audio_language") {
 193                         _audio_language = v;
 194                 } else if (k == "subtitle_language") {
 195                         _subtitle_language = v;
 196                 } else if (k == "territory") {
 197                         _territory = v;
 198                 } else if (k == "rating") {
 199                         _rating = v;
 200                 } else if (k == "studio") {
 201                         _studio = v;
 202                 } else if (k == "facility") {
 203                         _facility = v;
 204                 } else if (k == "package_type") {
 205                         _package_type = v;
 206                 }
 207
 208                 /* Cached stuff */
 209                 if (k == "thumb") {
 210                         int const n = atoi (v.c_str ());
 211                         /* Only add it to the list if it still exists */
 212                         if (filesystem::exists (thumb_file_for_frame (n))) {
 213                                 _thumbs.push_back (n);
 214                         }
 215                 } else if (k == "width") {
 216                         _size.width = atoi (v.c_str ());
 217                 } else if (k == "height") {
 218                         _size.height = atoi (v.c_str ());
 219                 } else if (k == "length") {
 220                         _length = atof (v.c_str ());
 221                 } else if (k == "audio_sample_rate") {
 222                         _audio_sample_rate = atoi (v.c_str ());
 223                 } else if (k == "content_digest") {
 224                         _content_digest = v;
 225                 } else if (k == "has_subtitles") {
 226                         _has_subtitles = (v == "1");
 227                 } else if (k == "audio_stream") {
 228                         _audio_streams.push_back (AudioStream (v));
 229                 } else if (k == "subtitle_stream") {
 230                         _subtitle_streams.push_back (SubtitleStream (v));
 231                 } else if (k == "frames_per_second") {
 232                         _frames_per_second = atof (v.c_str ());
 233                 }
 234         }
 235
 236         _dirty = false;
 237 }
 238
 239 /** @param n A thumb index.
 240  *  @return The path to the thumb's image file.
 241  */
 242 string
 243 FilmState::thumb_file (int n) const
 244 {
 245         return thumb_file_for_frame (thumb_frame (n));
 246 }
 247
 248 /** @param n A frame index within the Film.
 249  *  @return The path to the thumb's image file for this frame;
 250  *  we assume that it exists.
 251  */
 252 string
 253 FilmState::thumb_file_for_frame (int n) const
 254 {
 255         return thumb_base_for_frame(n) + ".png";
 256 }
 257
 258 string
 259 FilmState::thumb_base (int n) const
 260 {
 261         return thumb_base_for_frame (thumb_frame (n));
 262 }
 263
 264 string
 265 FilmState::thumb_base_for_frame (int n) const
 266 {
 267         stringstream s;
 268         s.width (8);
 269         s << setfill('0') << n;
 270
 271         filesystem::path p;
 272         p /= dir ("thumbs");
 273         p /= s.str ();
 274
 275         return p.string ();
 276 }
 277
 278
 279 /** @param n A thumb index.
 280  *  @return The frame within the Film that it is for.
 281  */
 282 int
 283 FilmState::thumb_frame (int n) const
 284 {
 285         assert (n < int (_thumbs.size ()));
 286         return _thumbs[n];
 287 }
 288
 289 Size
 290 FilmState::cropped_size (Size s) const
 291 {
 292         s.width -= _crop.left + _crop.right;
 293         s.height -= _crop.top + _crop.bottom;
 294         return s;
 295 }
 296
 297 /** Given a directory name, return its full path within the Film's directory.
 298  *  The directory (and its parents) will be created if they do not exist.
 299  */
 300 string
 301 FilmState::dir (string d) const
 302 {
 303         filesystem::path p;
 304         p /= _directory;
 305         p /= d;
 306         filesystem::create_directories (p);
 307         return p.string ();
 308 }
 309
 310 /** Given a file or directory name, return its full path within the Film's directory */
 311 string
 312 FilmState::file (string f) const
 313 {
 314         filesystem::path p;
 315         p /= _directory;
 316         p /= f;
 317         return p.string ();
 318 }
 319
 320 /** @return full path of the content (actual video) file
 321  *  of the Film.
 322  */
 323 string
 324 FilmState::content_path () const
 325 {
 326         if (filesystem::path(_content).has_root_directory ()) {
 327                 return _content;
 328         }
 329
 330         return file (_content);
 331 }
 332
 333 ContentType
 334 FilmState::content_type () const
 335 {
 336 #if BOOST_FILESYSTEM_VERSION == 3
 337         string ext = filesystem::path(_content).extension().string();
 338 #else
 339         string ext = filesystem::path(_content).extension();
 340 #endif
 341
 342         transform (ext.begin(), ext.end(), ext.begin(), ::tolower);
 343
 344         if (ext == ".tif" || ext == ".tiff" || ext == ".jpg" || ext == ".jpeg" || ext == ".png") {
 345                 return STILL;
 346         }
 347
 348         return VIDEO;
 349 }
 350
 351 /** @return The sampling rate that we will resample the audio to */
 352 int
 353 FilmState::target_audio_sample_rate () const
 354 {
 355         /* Resample to a DCI-approved sample rate */
 356         double t = dcp_audio_sample_rate (_audio_sample_rate);
 357
 358         /* Compensate for the fact that video will be rounded to the
 359            nearest integer number of frames per second.
 360         */
 361         if (rint (_frames_per_second) != _frames_per_second) {
 362                 t *= _frames_per_second / rint (_frames_per_second);
 363         }
 364
 365         return rint (t);
 366 }
 367
 368 int
 369 FilmState::dcp_length () const
 370 {
 371         if (_dcp_frames) {
 372                 return _dcp_frames;
 373         }
 374
 375         return _length;
 376 }
 377
 378 /** @return a DCI-compliant name for a DCP of this film */
 379 string
 380 FilmState::dci_name () const
 381 {
 382         stringstream d;
 383
 384         string fixed_name = to_upper_copy (_name);
 385         for (size_t i = 0; i < fixed_name.length(); ++i) {
 386                 if (fixed_name[i] == ' ') {
 387                         fixed_name[i] = '-';
 388                 }
 389         }
 390
 391         /* Spec is that the name part should be maximum 14 characters, as I understand it */
 392         if (fixed_name.length() > 14) {
 393                 fixed_name = fixed_name.substr (0, 14);
 394         }
 395
 396         d << fixed_name << "_";
 397
 398         if (_dcp_content_type) {
 399                 d << _dcp_content_type->dci_name() << "_";
 400         }
 401
 402         if (_format) {
 403                 d << _format->dci_name() << "_";
 404         }
 405
 406         if (!_audio_language.empty ()) {
 407                 d << _audio_language;
 408                 if (!_subtitle_language.empty() && _with_subtitles) {
 409                         d << "-" << _subtitle_language;
 410                 } else {
 411                         d << "-XX";
 412                 }
 413
 414                 d << "_";
 415         }
 416
 417         if (!_territory.empty ()) {
 418                 d << _territory;
 419                 if (!_rating.empty ()) {
 420                         d << "-" << _rating;
 421                 }
 422                 d << "_";
 423         }
 424
 425         switch (_audio_streams[_audio_stream].channels()) {
 426         case 1:
 427                 d << "10_";
 428                 break;
 429         case 2:
 430                 d << "20_";
 431                 break;
 432         case 6:
 433                 d << "51_";
 434                 break;
 435         case 8:
 436                 d << "71_";
 437                 break;
 438         }
 439
 440         d << "2K_";
 441
 442         if (!_studio.empty ()) {
 443                 d << _studio << "_";
 444         }
 445
 446         gregorian::date today = gregorian::day_clock::local_day ();
 447         d << gregorian::to_iso_string (today) << "_";
 448
 449         if (!_facility.empty ()) {
 450                 d << _facility << "_";
 451         }
 452
 453         if (!_package_type.empty ()) {
 454                 d << _package_type;
 455         }
 456
 457         return d.str ();
 458 }
 459
 460 /** @return name to give the DCP */
 461 string
 462 FilmState::dcp_name () const
 463 {
 464         if (_use_dci_name) {
 465                 return dci_name ();
 466         }
 467
 468         return _name;
 469 }
 470
 471
 472 void
 473 FilmState::set_directory (string d)
 474 {
 475         _directory = d;
 476         _dirty = true;
 477 }
 478
 479 void
 480 FilmState::set_name (string n)
 481 {
 482         _name = n;
 483         signal_changed (NAME);
 484 }
 485
 486 void
 487 FilmState::set_use_dci_name (bool u)
 488 {
 489         _use_dci_name = u;
 490         signal_changed (USE_DCI_NAME);
 491 }
 492
 493 void
 494 FilmState::set_content (string c)
 495 {
 496         string check = _directory;
 497
 498 #if BOOST_FILESYSTEM_VERSION == 3
 499         filesystem::path slash ("/");
 500         string platform_slash = slash.make_preferred().string ();
 501 #else
 502 #ifdef DVDOMATIC_WINDOWS
 503         string platform_slash = "\\";
 504 #else
 505         string platform_slash = "/";
 506 #endif
 507 #endif
 508
 509         if (!ends_with (check, platform_slash)) {
 510                 check += platform_slash;
 511         }
 512
 513         if (filesystem::path(c).has_root_directory () && starts_with (c, check)) {
 514                 c = c.substr (_directory.length() + 1);
 515         }
 516
 517         if (c == _content) {
 518                 return;
 519         }
 520
 521         /* Create a temporary decoder so that we can get information
 522            about the content.
 523         */
 524
 525         shared_ptr<FilmState> s = state_copy ();
 526         s->_content = c;
 527         shared_ptr<Options> o (new Options ("", "", ""));
 528         o->out_size = Size (1024, 1024);
 529
 530         shared_ptr<Decoder> d = decoder_factory (s, o, 0, 0);
 531
 532         set_size (d->native_size ());
 533         set_frames_per_second (d->frames_per_second ());
 534         set_audio_sample_rate (d->audio_sample_rate ());
 535         set_has_subtitles (d->has_subtitles ());
 536         set_audio_streams (d->audio_streams ());
 537         set_subtitle_streams (d->subtitle_streams ());
 538         set_audio_stream (audio_streams().empty() ? -1 : 0);
 539         set_subtitle_stream (subtitle_streams().empty() ? -1 : 0);
 540
 541         _content = c;
 542         signal_changed (CONTENT);
 543
 544         set_content_digest (md5_digest (content_path ()));
 545 }
 546
 547 void
 548 FilmState::set_dcp_content_type (DCPContentType const * t)
 549 {
 550         _dcp_content_type = t;
 551         signal_changed (DCP_CONTENT_TYPE);
 552 }
 553
 554 void
 555 FilmState::set_format (Format const * f)
 556 {
 557         _format = f;
 558         signal_changed (FORMAT);
 559 }
 560
 561 void
 562 FilmState::set_crop (Crop c)
 563 {
 564         _crop = c;
 565         signal_changed (CROP);
 566 }
 567
 568 void
 569 FilmState::set_left_crop (int c)
 570 {
 571         if (_crop.left == c) {
 572                 return;
 573         }
 574
 575         _crop.left = c;
 576         signal_changed (CROP);
 577 }
 578
 579 void
 580 FilmState::set_right_crop (int c)
 581 {
 582         if (_crop.right == c) {
 583                 return;
 584         }
 585
 586         _crop.right = c;
 587         signal_changed (CROP);
 588 }
 589
 590 void
 591 FilmState::set_top_crop (int c)
 592 {
 593         if (_crop.top == c) {
 594                 return;
 595         }
 596
 597         _crop.top = c;
 598         signal_changed (CROP);
 599 }
 600
 601 void
 602 FilmState::set_bottom_crop (int c)
 603 {
 604         if (_crop.bottom == c) {
 605                 return;
 606         }
 607
 608         _crop.bottom = c;
 609         signal_changed (CROP);
 610 }
 611
 612 void
 613 FilmState::set_filters (vector<Filter const *> f)
 614 {
 615         _filters = f;
 616         signal_changed (FILTERS);
 617 }
 618
 619 void
 620 FilmState::set_scaler (Scaler const * s)
 621 {
 622         _scaler = s;
 623         signal_changed (SCALER);
 624 }
 625
 626 void
 627 FilmState::set_dcp_frames (int f)
 628 {
 629         _dcp_frames = f;
 630         signal_changed (DCP_FRAMES);
 631 }
 632
 633 void
 634 FilmState::set_dcp_trim_action (TrimAction a)
 635 {
 636         _dcp_trim_action = a;
 637         signal_changed (DCP_TRIM_ACTION);
 638 }
 639
 640 void
 641 FilmState::set_dcp_ab (bool a)
 642 {
 643         _dcp_ab = a;
 644         signal_changed (DCP_AB);
 645 }
 646
 647 void
 648 FilmState::set_audio_stream (int s)
 649 {
 650         _audio_stream = s;
 651         signal_changed (AUDIO_STREAM);
 652 }
 653
 654 void
 655 FilmState::set_audio_gain (float g)
 656 {
 657         _audio_gain = g;
 658         signal_changed (AUDIO_GAIN);
 659 }
 660
 661 void
 662 FilmState::set_audio_delay (int d)
 663 {
 664         _audio_delay = d;
 665         signal_changed (AUDIO_DELAY);
 666 }
 667
 668 void
 669 FilmState::set_still_duration (int d)
 670 {
 671         _still_duration = d;
 672         signal_changed (STILL_DURATION);
 673 }
 674
 675 void
 676 FilmState::set_subtitle_stream (int s)
 677 {
 678         _subtitle_stream = s;
 679         signal_changed (SUBTITLE_STREAM);
 680 }
 681
 682 void
 683 FilmState::set_with_subtitles (bool w)
 684 {
 685         _with_subtitles = w;
 686         signal_changed (WITH_SUBTITLES);
 687 }
 688
 689 void
 690 FilmState::set_subtitle_offset (int o)
 691 {
 692         _subtitle_offset = o;
 693         signal_changed (SUBTITLE_OFFSET);
 694 }
 695
 696 void
 697 FilmState::set_subtitle_scale (float s)
 698 {
 699         _subtitle_scale = s;
 700         signal_changed (SUBTITLE_SCALE);
 701 }
 702
 703 void
 704 FilmState::set_audio_language (string l)
 705 {
 706         _audio_language = l;
 707         signal_changed (DCI_METADATA);
 708 }
 709
 710 void
 711 FilmState::set_subtitle_language (string l)
 712 {
 713         _subtitle_language = l;
 714         signal_changed (DCI_METADATA);
 715 }
 716
 717 void
 718 FilmState::set_territory (string t)
 719 {
 720         _territory = t;
 721         signal_changed (DCI_METADATA);
 722 }
 723
 724 void
 725 FilmState::set_rating (string r)
 726 {
 727         _rating = r;
 728         signal_changed (DCI_METADATA);
 729 }
 730
 731 void
 732 FilmState::set_studio (string s)
 733 {
 734         _studio = s;
 735         signal_changed (DCI_METADATA);
 736 }
 737
 738 void
 739 FilmState::set_facility (string f)
 740 {
 741         _facility = f;
 742         signal_changed (DCI_METADATA);
 743 }
 744
 745 void
 746 FilmState::set_package_type (string p)
 747 {
 748         _package_type = p;
 749         signal_changed (DCI_METADATA);
 750 }
 751
 752 void
 753 FilmState::set_thumbs (vector<int> t)
 754 {
 755         _thumbs = t;
 756         signal_changed (THUMBS);
 757 }
 758
 759 void
 760 FilmState::set_size (Size s)
 761 {
 762         _size = s;
 763         signal_changed (SIZE);
 764 }
 765
 766 void
 767 FilmState::set_length (int l)
 768 {
 769         _length = l;
 770         signal_changed (LENGTH);
 771 }
 772
 773 void
 774 FilmState::set_audio_sample_rate (int r)
 775 {
 776         _audio_sample_rate = r;
 777         signal_changed (AUDIO_SAMPLE_RATE);
 778 }
 779
 780 void
 781 FilmState::set_content_digest (string d)
 782 {
 783         _content_digest = d;
 784         _dirty = true;
 785 }
 786
 787 void
 788 FilmState::set_has_subtitles (bool s)
 789 {
 790         _has_subtitles = s;
 791         signal_changed (HAS_SUBTITLES);
 792 }
 793
 794 void
 795 FilmState::set_audio_streams (vector<AudioStream> s)
 796 {
 797         _audio_streams = s;
 798         _dirty = true;
 799 }
 800
 801 void
 802 FilmState::set_subtitle_streams (vector<SubtitleStream> s)
 803 {
 804         _subtitle_streams = s;
 805         _dirty = true;
 806 }
 807
 808 void
 809 FilmState::set_frames_per_second (float f)
 810 {
 811         _frames_per_second = f;
 812         signal_changed (FRAMES_PER_SECOND);
 813 }
 814
 815 void
 816 FilmState::signal_changed (Property p)
 817 {
 818         _dirty = true;
 819         Changed (p);
 820 }
 821
 822 shared_ptr<FilmState>
 823 FilmState::state_copy () const
 824 {
 825         return shared_ptr<FilmState> (new FilmState (*this));
 826 }
 827
 828 int
 829 FilmState::audio_channels () const
 830 {
 831         if (_audio_stream == -1) {
 832                 return 0;
 833         }
 834
 835         return _audio_streams[_audio_stream].channels ();
 836 }