X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fmono_picture_asset.h;h=505d3c20923a9f2292308d2847ddab8e2846ad93;hb=6f28eb4948be29bb0c273e93bbb161d14e8e071f;hp=5b36bc33b5b0f463b12d8464374ec569a256184b;hpb=a68b877d96a9e9f366f27752e071bc0e895e9dc7;p=libdcp.git

diff --git a/src/mono_picture_asset.h b/src/mono_picture_asset.h
index 5b36bc33..505d3c20 100644
--- a/src/mono_picture_asset.h
+++ b/src/mono_picture_asset.h
@@ -1,34 +1,58 @@
 /*
-    Copyright (C) 2012-2015 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/mono_picture_asset.cc
+ *  @brief MonoPictureAsset class
+ */
+
+
 #ifndef LIBDCP_MONO_PICTURE_ASSET_H
 #define LIBDCP_MONO_PICTURE_ASSET_H
 
+
 #include "picture_asset.h"
+#include "mono_picture_asset_reader.h"
+
 
 namespace dcp {
 
+
 class MonoPictureAssetWriter;
-class MonoPictureAssetReader;
+
 
 /** @class MonoPictureAsset
- *  @brief A 2D (monoscopic) picture asset.
+ *  @brief A 2D (monoscopic) picture asset
  */
 class MonoPictureAsset : public PictureAsset
 {
@@ -36,19 +60,24 @@ public:
 	/** Create a MonoPictureAsset by reading a file.
 	 *  @param file Asset file to read.
 	 */
-	MonoPictureAsset (boost::filesystem::path file);
+	explicit MonoPictureAsset (boost::filesystem::path file);
 
 	/** Create a MonoPictureAsset with a given edit rate.
 	 *  @param edit_rate Edit rate (i.e. frame rate) in frames per second.
+	 *  @param standard DCP standard (INTEROP or SMPTE).
 	 */
-	MonoPictureAsset (Fraction edit_rate);
+	explicit MonoPictureAsset (Fraction edit_rate, Standard standard);
 
-	/** Start a progressive write to a MonoPictureAsset */
-	boost::shared_ptr<PictureAssetWriter> start_write (boost::filesystem::path, Standard standard, bool);
-	boost::shared_ptr<MonoPictureAssetReader> start_read () const;
+	/** Start a progressive write to a MonoPictureAsset.
+	 *  @path file File to write to.
+	 *  @path overwrite true to overwrite an existing file; for use when continuing a write which
+	 *  previously failed.  If in doubt, use false here.
+	 */
+	std::shared_ptr<PictureAssetWriter> start_write (boost::filesystem::path file, bool overwrite);
+	std::shared_ptr<MonoPictureAssetReader> start_read () const;
 
 	bool equals (
-		boost::shared_ptr<const Asset> other,
+		std::shared_ptr<const Asset> other,
 		EqualityOptions opt,
 		NoteHandler note
 		) const;
@@ -57,6 +86,8 @@ private:
 	std::string cpl_node_name () const;
 };
 
+
 }
 
+
 #endif