Fix missing version string when Popen communicate returns byte strings.
[libdcp.git] / src / cpl.h
index 5dd2c37bf342f7e75b5599e7162033db64c97fe0..bcc1f06bd9ebb81bc4acc420ca7b2bac9c6c345f 100644 (file)
--- a/src/cpl.h
+++ b/src/cpl.h
-#include <stdint.h>
+/*
+    Copyright (C) 2014 Carl Hetherington <cth@carlh.net>
+
+    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.
+
+    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 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 "types.h"
+#include "certificate.h"
+#include "key.h"
+#include "asset.h"
+#include "metadata.h"
 #include <boost/shared_ptr.hpp>
-#include "xml.h"
-
-namespace libdcp {
-
-class MainPicture : public XMLNode
-{
-public:
-       MainPicture () {}
-       MainPicture (xmlpp::Node const * node);
-
-       std::string id;
-       std::string annotation_text;
-       Fraction edit_rate;
-       int64_t intrinsic_duration;
-       int64_t entry_point;
-       int64_t duration;
-       Fraction frame_rate;
-       Fraction screen_aspect_ratio;
-};
-
-class MainSound : public XMLNode
-{
-public:
-       MainSound () {}
-       MainSound (xmlpp::Node const * node);
-
-       std::string id;
-       std::string annotation_text;
-       Fraction edit_rate;
-       int64_t intrinsic_duration;
-       int64_t entry_point;
-       int64_t duration;
-};
-
-class MainSubtitle : public XMLNode
-{
-public:
-       MainSubtitle () {}
-       MainSubtitle (xmlpp::Node const * node);
-
-       std::string id;
-       std::string annotation_text;
-       Fraction edit_rate;
-       int64_t intrinsic_duration;
-       int64_t entry_point;
-       int64_t duration;
-};
-
-class CPLAssetList : public XMLNode
-{
-public:
-       CPLAssetList () {}
-       CPLAssetList (xmlpp::Node const * node);
-
-       boost::shared_ptr<MainPicture> main_picture;
-       boost::shared_ptr<MainSound> main_sound;
-       boost::shared_ptr<MainSubtitle> main_subtitle;
-};
-
-class Reel : public XMLNode
-{
-public:
-       Reel () {}
-       Reel (xmlpp::Node const * node);
-
-       std::string id;
-       boost::shared_ptr<CPLAssetList> asset_list;
-};
-
-class ContentVersion : public XMLNode
-{
-public:
-       ContentVersion () {}
-       ContentVersion (xmlpp::Node const * node);
-
-       std::string id;
-       std::string label_text;
-};
-
-class CPL : public XMLFile
+#include <boost/function.hpp>
+#include <boost/optional.hpp>
+#include <boost/filesystem.hpp>
+#include <list>
+
+namespace dcp {
+
+class ReelAsset;
+class Reel;
+class XMLMetadata;
+class MXFMetadata;
+class CertificateChain;
+class DecryptedKDM;
+
+/** @class CPL
+ *  @brief A Composition Playlist.
+ */
+class CPL : public Asset
 {
 public:
-       CPL (std::string file);
-
-       std::string id;
-       std::string annotation_text;
-       std::string issue_date;
-       std::string creator;
-       std::string content_title_text;
-       ContentKind content_kind;
-       boost::shared_ptr<ContentVersion> content_version;
-       std::list<boost::shared_ptr<Reel> > reels;
+       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 (boost::shared_ptr<Reel> reel);
+       void add (DecryptedKDM const &);
+
+       /** @return contents of the &lt;AnnotationText&gt; node */
+       std::string annotation_text () const {
+               return _metadata.annotation_text;
+       }
+
+       void set_annotation_text (std::string at) {
+               _metadata.annotation_text = at;
+       }
+
+       /** @return contents of the &lt;ContentTitleText&gt; node */
+       std::string content_title_text () const {
+               return _content_title_text;
+       }
+
+       void set_content_title_text (std::string ct) {
+               _content_title_text = ct;
+       }
+
+       /** @return contents of the &lt;Id&gt; node within &lt;ContentVersion&gt; */
+       void set_content_version_id (std::string id) {
+               _content_version_id = id;
+       }
+
+       /** @return contents of the &lt;LabelText&gt; node within &lt;ContentVersion&gt; */
+       void set_content_version_label_text (std::string text) {
+               _content_version_label_text = text;
+       }
+
+       /** @return the type of the content, used by media servers
+        *  to categorise things (e.g. feature, trailer, etc.)
+        */
+       ContentKind content_kind () const {
+               return _content_kind;
+       }
+
+       /** @return the reels in this CPL */
+       std::list<boost::shared_ptr<Reel> > reels () const {
+               return _reels;
+       }
+
+       /** @return the ReelAssets in this CPL in all reels.
+        */
+       std::list<boost::shared_ptr<const ReelAsset> > reel_assets () const;
+
+       bool encrypted () const;
+
+       void set_metadata (XMLMetadata m) {
+               _metadata = m;
+       }
+
+       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;
+
+       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;
+
+private:
+       /** &lt;Issuer&gt;, &lt;Creator&gt;, &lt;IssueDate&gt; and &lt;AnnotationText&gt.
+        *  These are grouped because they occur together in a few places.
+        */
+       XMLMetadata _metadata;
+       std::string _content_title_text;            ///< &lt;ContentTitleText&gt;
+       ContentKind _content_kind;                  ///< &lt;ContentKind&gt;
+       std::string _content_version_id;            ///< &lt;Id&gt; in &lt;ContentVersion&gt;
+       std::string _content_version_label_text;    ///< &lt;LabelText&gt; in &lt;ContentVersion&gt;
+       std::list<boost::shared_ptr<Reel> > _reels;
+
+       /** Standard of CPL that was read in */
+       boost::optional<Standard> _standard;
 };
 
 }
 
+#endif