/*
- Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
+ Copyright (C) 2014-2020 Carl Hetherington <cth@carlh.net>
- This program is free software; you can redistribute it and/or modify
+ This file is part of libdcp.
+
+ libdcp is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
- This program is distributed in the hope that it will be useful,
+ libdcp is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with libdcp. If not, see <http://www.gnu.org/licenses/>.
+
+ In addition, as a special exception, the copyright holders give
+ permission to link the code of portions of this program with the
+ OpenSSL library under certain conditions as described in each
+ individual source file, and distribute linked combinations
+ including the two.
+ You must obey the GNU General Public License in all respects
+ for all of the code used other than OpenSSL. If you modify
+ file(s) with this exception, you may extend this exception to your
+ version of the file(s), but you are not obligated to do so. If you
+ do not wish to do so, delete this exception statement from your
+ version. If you delete this exception statement from all source
+ files in the program, then also delete it here.
*/
+
+/** @file src/cpl.h
+ * @brief CPL class.
+ */
+
+
#ifndef LIBDCP_CPL_H
#define LIBDCP_CPL_H
-#include <list>
-#include <boost/shared_ptr.hpp>
+
+#include "asset.h"
+#include "certificate.h"
+#include "key.h"
+#include "language_tag.h"
+#include "types.h"
+#include <boost/filesystem.hpp>
#include <boost/function.hpp>
-#include <boost/date_time/posix_time/posix_time.hpp>
#include <boost/optional.hpp>
-#include <libxml++/libxml++.h>
-#include "types.h"
-#include "certificates.h"
+#include <boost/shared_ptr.hpp>
+#include <list>
+#include <vector>
-namespace libdcp {
-namespace parse {
- class AssetMap;
- class AssetMapAsset;
-}
-
-class Asset;
+namespace dcp {
+
+
+class ReelMXF;
class Reel;
-class XMLMetadata;
class MXFMetadata;
-class Encryption;
-class KDM;
-
-/** @brief A CPL within a DCP */
-class CPL
+class CertificateChain;
+class DecryptedKDM;
+
+
+/** @class CPL
+ * @brief A Composition Playlist.
+ */
+class CPL : public Asset
{
public:
- CPL (std::string directory, std::string name, ContentKind content_kind, int length, int frames_per_second);
- CPL (std::string directory, std::string file, std::list<PathAssetMap> asset_maps, bool require_mxfs = true);
+ CPL (std::string annotation_text, ContentKind content_kind);
+ explicit CPL (boost::filesystem::path file);
+
+ bool equals (
+ boost::shared_ptr<const Asset> other,
+ EqualityOptions options,
+ NoteHandler note
+ ) const;
- void add_reel (boost::shared_ptr<Reel> reel);
-
- /** @return the length in frames */
- int length () const {
- return _length;
+ void add (boost::shared_ptr<Reel> reel);
+ void add (DecryptedKDM const &);
+
+ /** @return the reels in this CPL */
+ std::list<boost::shared_ptr<Reel> > reels () const {
+ return _reels;
+ }
+
+ /** @return the ReelMXFs in this CPL in all reels */
+ std::list<boost::shared_ptr<const ReelMXF> > reel_mxfs () const;
+ std::list<boost::shared_ptr<ReelMXF> > reel_mxfs ();
+
+ bool encrypted () const;
+
+ void write_xml (
+ boost::filesystem::path file,
+ Standard standard,
+ boost::shared_ptr<const CertificateChain>
+ ) const;
+
+ void resolve_refs (std::list<boost::shared_ptr<Asset> >);
+
+ int64_t duration () const;
+
+ void set_issuer (std::string issuer) {
+ _issuer = issuer;
+ }
+
+ void set_creator (std::string creator) {
+ _creator = creator;
+ }
+
+ void set_issue_date (std::string issue_date) {
+ _issue_date = issue_date;
+ }
+
+ /** @return contents of the <AnnotationText> node */
+ std::string annotation_text () const {
+ return _annotation_text;
+ }
+
+ void set_annotation_text (std::string at) {
+ _annotation_text = at;
+ }
+
+ /** @return contents of the <ContentTitleText> node */
+ std::string content_title_text () const {
+ return _content_title_text;
+ }
+
+ void set_content_title_text (std::string ct) {
+ _content_title_text = ct;
}
/** @return the type of the content, used by media servers
return _content_kind;
}
- std::list<boost::shared_ptr<Reel> > reels () const {
- return _reels;
+ ContentVersion content_version () const;
+
+ std::vector<ContentVersion> content_versions () const {
+ return _content_versions;
}
- /** @return the CPL's name, as will be presented on projector
- * media servers and theatre management systems.
- */
- std::string name () const {
- return _name;
+ void set_content_version (ContentVersion v) {
+ _content_versions.clear ();
+ _content_versions.push_back (v);
}
- /** @return the number of frames per second */
- int frames_per_second () const {
- return _fps;
+ void set_content_versions (std::vector<ContentVersion> v);
+
+ std::vector<Rating> ratings () const {
+ return _ratings;
}
- std::list<boost::shared_ptr<const Asset> > assets () const;
+ void set_ratings (std::vector<Rating> r) {
+ _ratings = r;
+ }
- bool encrypted () const;
+ boost::optional<std::string> full_content_title_text () const {
+ return _full_content_title_text;
+ }
- std::string id () const {
- return _id;
- }
-
- bool equals (CPL const & other, EqualityOptions options, boost::function<void (NoteType, std::string)> note) const;
-
- void write_xml (bool, XMLMetadata const &, boost::shared_ptr<Encryption>) const;
- void write_to_assetmap (xmlpp::Node *) const;
- void write_to_pkl (xmlpp::Node *) const;
-
- /** Make a KDM for this CPL.
- * @param certificates
- * @param signer_key
- * @param recipient_cert The certificate of the projector that this KDM is targeted at. This will contain the
- * projector's public key (P) which is used to encrypt the content keys.
- * @param from Time that the KDM should be valid from.
- * @param until Time that the KDM should be valid until.
- * @param interop true to generate an interop KDM, false for SMPTE.
- */
- boost::shared_ptr<xmlpp::Document> make_kdm (
- CertificateChain const & certificates,
- std::string const & signer_key,
- boost::shared_ptr<const Certificate> recipient_cert,
- boost::posix_time::ptime from,
- boost::posix_time::ptime until,
- bool interop,
- MXFMetadata const &,
- XMLMetadata const &
- ) const;
+ void set_full_content_title_text (std::string t) {
+ _full_content_title_text = t;
+ }
+
+ boost::optional<std::string> full_content_title_text_language () const {
+ return _full_content_title_text_language;
+ }
+
+ void set_full_content_title_text_language (dcp::LanguageTag l) {
+ _full_content_title_text_language = l.to_string();
+ }
+
+ boost::optional<std::string> release_territory () const {
+ return _release_territory;
+ }
+
+ void set_release_territory (dcp::LanguageTag::RegionSubtag t) {
+ _release_territory = t.subtag();
+ }
+
+ boost::optional<int> version_number () const {
+ return _version_number;
+ }
+
+ void set_version_number (int v);
+
+ boost::optional<Status> status () const {
+ return _status;
+ }
+
+ void set_status (Status s) {
+ _status = s;
+ }
+
+ boost::optional<std::string> chain () const {
+ return _chain;
+ }
+
+ void set_chain (std::string c) {
+ _chain = c;
+ }
+
+ boost::optional<std::string> distributor () const {
+ return _distributor;
+ }
+
+ void set_distributor (std::string d) {
+ _distributor = d;
+ }
+
+ boost::optional<std::string> facility () const {
+ return _facility;
+ }
+
+ void set_facility (std::string f) {
+ _facility = f;
+ }
+
+ boost::optional<Luminance> luminance () const {
+ return _luminance;
+ }
+
+ void set_luminance (Luminance l) {
+ _luminance = l;
+ }
+
+ boost::optional<std::string> main_sound_configuration () const {
+ return _main_sound_configuration;
+ }
+
+ void set_main_sound_configuration (std::string c) {
+ _main_sound_configuration = c;
+ }
+
+ boost::optional<int> main_sound_sample_rate () const {
+ return _main_sound_sample_rate;
+ }
+
+ void set_main_sound_sample_rate (int r) {
+ _main_sound_sample_rate = r;
+ }
+
+ boost::optional<dcp::Size> main_picture_stored_area () const {
+ return _main_picture_stored_area;
+ }
+
+ void set_main_picture_stored_area (dcp::Size s) {
+ _main_picture_stored_area = s;
+ }
+
+ boost::optional<dcp::Size> main_picture_active_area () const {
+ return _main_picture_active_area;
+ }
+
+ void set_main_picture_active_area (dcp::Size s) {
+ _main_picture_active_area = s;
+ }
+
+ std::vector<std::string> additional_subtitle_languages () const {
+ return _additional_subtitle_languages;
+ }
+
+ void set_additional_subtitle_languages (std::vector<dcp::LanguageTag> const& lang);
+
+ boost::optional<Standard> standard () const {
+ return _standard;
+ }
+
+ static std::string static_pkl_type (Standard standard);
+
+protected:
+ /** @return type string for PKLs for this asset */
+ std::string pkl_type (Standard standard) const;
- void add_kdm (KDM const &);
-
private:
- std::pair<std::string, boost::shared_ptr<const parse::AssetMapAsset> > asset_from_id (std::list<PathAssetMap>, std::string id) const;
-
- std::string _directory;
- /** the name of the DCP */
- std::string _name;
- /** the content kind of the CPL */
- ContentKind _content_kind;
- /** length in frames */
- mutable int _length;
- /** frames per second */
- int _fps;
- /** reels */
+ void maybe_write_composition_metadata_asset (xmlpp::Element* node) const;
+ void read_composition_metadata_asset (cxml::ConstNodePtr node);
+
+ std::string _issuer;
+ std::string _creator;
+ std::string _issue_date;
+ std::string _annotation_text;
+ std::string _content_title_text; ///< <ContentTitleText>
+ ContentKind _content_kind; ///< <ContentKind>
+ std::vector<ContentVersion> _content_versions;
+ std::vector<Rating> _ratings;
+ /** Human-readable name of the composition, without any metadata (i.e. no -FTR-EN-XX- etc.) */
+ boost::optional<std::string> _full_content_title_text;
+ boost::optional<std::string> _full_content_title_text_language;
+ /** This is stored and returned as a string so that we can tolerate non-RFC-5646 strings,
+ * but must be set as a dcp::LanguageTag to try to ensure that we create compliant output.
+ */
+ boost::optional<std::string> _release_territory;
+ boost::optional<int> _version_number;
+ boost::optional<Status> _status;
+ boost::optional<std::string> _chain;
+ boost::optional<std::string> _distributor;
+ boost::optional<std::string> _facility;
+ boost::optional<Luminance> _luminance;
+ boost::optional<std::string> _main_sound_configuration;
+ boost::optional<int> _main_sound_sample_rate;
+ boost::optional<dcp::Size> _main_picture_stored_area;
+ boost::optional<dcp::Size> _main_picture_active_area;
+ /* See note for _release_territory above */
+ std::vector<std::string> _additional_subtitle_languages;
+
std::list<boost::shared_ptr<Reel> > _reels;
- /** our UUID */
- std::string _id;
- /** a SHA1 digest of our XML */
- mutable std::string _digest;
+ /** Standard of CPL that was read in */
+ boost::optional<Standard> _standard;
};
+
}
+
#endif