2 Copyright (C) 2013-2016 Carl Hetherington <cth@carlh.net>
4 This file is part of DCP-o-matic.
6 DCP-o-matic is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 DCP-o-matic is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with DCP-o-matic. If not, see <http://www.gnu.org/licenses/>.
21 #ifndef DCPOMATIC_PLAYLIST_H
22 #define DCPOMATIC_PLAYLIST_H
25 #include "frame_rate_change.h"
26 #include <libcxml/cxml.h>
27 #include <boost/shared_ptr.hpp>
28 #include <boost/signals2.hpp>
35 bool operator() (boost::shared_ptr<Content> a, boost::shared_ptr<Content> b);
39 * @brief A set of Content objects with knowledge of how they should be arranged into
42 class Playlist : public boost::noncopyable
48 void as_xml (xmlpp::Node *, bool with_content_paths);
49 void set_from_xml (boost::shared_ptr<const Film>, cxml::ConstNodePtr, int, std::list<std::string> &);
51 void add (boost::shared_ptr<Content>);
52 void remove (boost::shared_ptr<Content>);
53 void remove (ContentList);
54 void move_earlier (boost::shared_ptr<Content>);
55 void move_later (boost::shared_ptr<Content>);
57 ContentList content () const;
58 bool video_content_at (DCPTime time) const;
60 std::string video_identifier () const;
62 DCPTime length () const;
63 boost::optional<DCPTime> start () const;
64 int64_t required_disk_space (int j2k_bandwidth, int audio_channels, int audio_frame_rate) const;
66 int best_video_frame_rate () const;
67 DCPTime video_end () const;
68 DCPTime subtitle_end () const;
69 FrameRateChange active_frame_rate_change (DCPTime, int dcp_frame_rate) const;
70 std::string content_summary (DCPTimePeriod period) const;
72 void set_sequence (bool);
73 void maybe_sequence ();
75 void repeat (ContentList, int);
77 /** Emitted when content has been added to or removed from the playlist; implies OrderChanged */
78 mutable boost::signals2::signal<void ()> Changed;
79 mutable boost::signals2::signal<void ()> OrderChanged;
80 /** Emitted when something about a piece of our content has changed;
81 * these emissions include when the position of the content changes.
82 * Third parameter is true if signals are currently being emitted frequently.
84 mutable boost::signals2::signal<void (boost::weak_ptr<Content>, int, bool)> ContentChanged;
87 void content_changed (boost::weak_ptr<Content>, int, bool);
90 /** List of content. Kept sorted in position order. */
94 std::list<boost::signals2::connection> _content_connections;