2 Copyright (C) 2014-2019 Carl Hetherington <cth@carlh.net>
4 This file is part of libdcp.
6 libdcp 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 libdcp 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 libdcp. If not, see <http://www.gnu.org/licenses/>.
19 In addition, as a special exception, the copyright holders give
20 permission to link the code of portions of this program with the
21 OpenSSL library under certain conditions as described in each
22 individual source file, and distribute linked combinations
25 You must obey the GNU General Public License in all respects
26 for all of the code used other than OpenSSL. If you modify
27 file(s) with this exception, you may extend this exception to your
28 version of the file(s), but you are not obligated to do so. If you
29 do not wish to do so, delete this exception statement from your
30 version. If you delete this exception statement from all source
31 files in the program, then also delete it here.
42 #include "certificate.h"
45 #include <boost/shared_ptr.hpp>
46 #include <boost/function.hpp>
47 #include <boost/optional.hpp>
48 #include <boost/filesystem.hpp>
56 class CertificateChain;
60 * @brief A Composition Playlist.
62 class CPL : public Asset
65 CPL (std::string annotation_text, ContentKind content_kind);
66 explicit CPL (boost::filesystem::path file);
69 boost::shared_ptr<const Asset> other,
70 EqualityOptions options,
74 void add (boost::shared_ptr<Reel> reel);
75 void add (DecryptedKDM const &);
77 /** @return contents of the <AnnotationText> node */
78 std::string annotation_text () const {
79 return _annotation_text;
82 void set_issuer (std::string issuer) {
86 void set_creator (std::string creator) {
90 void set_issue_date (std::string issue_date) {
91 _issue_date = issue_date;
94 void set_annotation_text (std::string at) {
95 _annotation_text = at;
98 /** @return contents of the <ContentTitleText> node */
99 std::string content_title_text () const {
100 return _content_title_text;
103 void set_content_title_text (std::string ct) {
104 _content_title_text = ct;
107 /** @return contents of the <Id> node within <ContentVersion> */
108 void set_content_version_id (std::string id) {
109 _content_version_id = id;
112 /** @return contents of the <LabelText> node within <ContentVersion> */
113 void set_content_version_label_text (std::string text) {
114 _content_version_label_text = text;
117 /** @return the type of the content, used by media servers
118 * to categorise things (e.g. feature, trailer, etc.)
120 ContentKind content_kind () const {
121 return _content_kind;
124 /** @return the reels in this CPL */
125 std::list<boost::shared_ptr<Reel> > reels () const {
129 /** @return the ReelMXFs in this CPL in all reels.
131 std::list<boost::shared_ptr<const ReelMXF> > reel_mxfs () const;
132 std::list<boost::shared_ptr<ReelMXF> > reel_mxfs ();
134 bool encrypted () const;
137 boost::filesystem::path file,
139 boost::shared_ptr<const CertificateChain>
142 void resolve_refs (std::list<boost::shared_ptr<Asset> >);
144 int64_t duration () const;
146 boost::optional<Standard> standard () const {
150 std::list<Rating> ratings () const {
154 void set_ratings (std::list<Rating> r) {
158 std::string content_version_label_text () const {
159 return _content_version_label_text;
162 static std::string static_pkl_type (Standard standard);
165 /** @return type string for PKLs for this asset */
166 std::string pkl_type (Standard standard) const;
170 std::string _creator;
171 std::string _issue_date;
172 std::string _annotation_text;
173 std::string _content_title_text; ///< <ContentTitleText>
174 ContentKind _content_kind; ///< <ContentKind>
175 std::string _content_version_id; ///< <Id> in <ContentVersion>
176 std::string _content_version_label_text; ///< <LabelText> in <ContentVersion>
177 std::list<boost::shared_ptr<Reel> > _reels;
178 std::list<Rating> _ratings;
180 /** Standard of CPL that was read in */
181 boost::optional<Standard> _standard;