X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fmxf.h;h=19d4a9567b62485ae7585f913f439b645b6c5a5f;hb=2da55dbe6da21975612584365db17db2ae9935b8;hp=f8be98446f4516ba8d1166bca5be7a965a65c94b;hpb=de32e9958d71ed16ebf1e5f8b2a9cf244c62d8c6;p=libdcp.git

diff --git a/src/mxf.h b/src/mxf.h
index f8be9844..19d4a956 100644
--- a/src/mxf.h
+++ b/src/mxf.h
@@ -1,54 +1,80 @@
 /*
-    Copyright (C) 2012-2014 Carl Hetherington <cth@carlh.net>
+    Copyright (C) 2012-2021 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/mxf.h
+ *  @brief MXF class
+ */
+
+
 #ifndef LIBDCP_MXF_H
 #define LIBDCP_MXF_H
 
+
 #include "asset.h"
 #include "key.h"
 #include "metadata.h"
-
+#include "dcp_assert.h"
 #include <boost/signals2.hpp>
 
+
 namespace ASDCP {
 	class AESDecContext;
-	class WriterInfo;
+	struct WriterInfo;
 }
 
+
 /* Undefine some stuff that the OS X 10.5 SDK defines */
 #undef Key
 #undef set_key
 
+
 namespace dcp
 {
 
+
 class MXFMetadata;
 class PictureAssetWriter;
 
+
 /** @class MXF
- *  @brief Parent for classes which represent MXF files.
+ *  @brief Parent for classes which represent MXF files
  */
 class MXF
 {
 public:
-	MXF ();
-	virtual ~MXF ();
+	MXF (Standard standard);
+	virtual ~MXF () {}
 
 	/** @return true if the data is encrypted */
 	bool encrypted () const {
@@ -67,13 +93,30 @@ public:
 		return _key_id;
 	}
 
-	void set_key (Key);
+	/** Set the (private) key that will be used to encrypt or decrypt this MXF's content
+	 *  This is the top-secret key that is distributed (itself encrypted) to cinemas
+	 *  via Key Delivery Messages (KDMs)
+	 *  @param key Key to use
+	 */
+	virtual void set_key (Key);
 
 	/** @return encryption/decryption key, if one has been set */
 	boost::optional<Key> key () const {
 		return _key;
 	}
 
+	/** Set the context ID to be used when encrypting.
+	 *  @param id New ID.
+	 */
+	void set_context_id (std::string id) {
+		_context_id = id;
+	}
+
+	/** @return context ID used when encrypting; this starts off as a random value */
+	std::string context_id () const {
+		return _context_id;
+	}
+
 	/** Set the metadata that is written to the MXF file.
 	 *  @param m Metadata.
 	 */
@@ -86,25 +129,39 @@ public:
 		return _metadata;
 	}
 
+	Standard standard () const {
+		DCP_ASSERT (_standard);
+		return *_standard;
+	}
+
 protected:
 	template <class P, class Q>
-	friend void start (PictureAssetWriter* writer, boost::shared_ptr<P> state, Standard standard, Q* mxf, uint8_t* data, int size);
+	friend void start (PictureAssetWriter* writer, std::shared_ptr<P> state, Q* mxf, uint8_t const * data, int size);
+
+	MXF ();
 
+	/** Read an ASDCP::WriterInfo struct, extracting things for our
+	 *  member variables.
+	 *  @return AssetUUID of the MXF
+	 */
 	std::string read_writer_info (ASDCP::WriterInfo const &);
-	/** Fill in a ADSCP::WriteInfo struct.
-	 *  @param w struct to fill in.
-	 *  @param standard INTEROP or SMPTE.
+
+	/** Fill in a ASDCP::WriteInfo struct.
+	 *  @param w struct to fill in
 	 */
-	void fill_writer_info (ASDCP::WriterInfo* w, std::string id, Standard standard) const;
+	void fill_writer_info (ASDCP::WriterInfo* w, std::string id) const;
 
-	ASDCP::AESDecContext* _decryption_context;
 	/** ID of the key used for encryption/decryption, if there is one */
 	boost::optional<std::string> _key_id;
 	/** Key used for encryption/decryption, if there is one */
 	boost::optional<Key> _key;
+	std::string _context_id;
 	MXFMetadata _metadata;
+	boost::optional<Standard> _standard;
 };
 
+
 }
 
+
 #endif