Report progress with done/total rather than a float.

[libdcp.git] / src / util.h

diff --git a/src/util.h b/src/util.h
index feee7af0f08352783fd8c5e9b3fe33bea997c525..551eed071eb158b9455136a2aed903a0961ed28c 100644 (file)
--- a/src/util.h
+++ b/src/util.h
@@ -1,5 +1,5 @@
 /*
-    Copyright (C) 2012-2014 Carl Hetherington <cth@carlh.net>
+    Copyright (C) 2012-2021 Carl Hetherington <cth@carlh.net>
 
     This file is part of libdcp.
 
@@ -31,54 +31,148 @@
     files in the program, then also delete it here.
 */
 
-#ifndef LIBDCP_UTIL_H
-#define LIBDCP_UTIL_H
 
 /** @file  src/util.h
- *  @brief Utility methods.
+ *  @brief Utility methods and classes
  */
 
-#include "types.h"
-#include "data.h"
-#include <boost/shared_ptr.hpp>
-#include <boost/function.hpp>
+
+#ifndef LIBDCP_UTIL_H
+#define LIBDCP_UTIL_H
+
+
+#include "array_data.h"
+#include "local_time.h"
+#include "warnings.h"
+LIBDCP_DISABLE_WARNINGS
+#include <asdcp/KM_log.h>
+LIBDCP_ENABLE_WARNINGS
 #include <boost/filesystem.hpp>
+#include <boost/function.hpp>
 #include <boost/optional.hpp>
+#include <memory>
 #include <string>
 #include <stdint.h>
 
+
+/* windows.h defines this but we want to use it */
+#undef ERROR
+
+
+#define LIBDCP_UNUSED(x) (void)(x)
+
+
+namespace ASDCP {
+       class Dictionary;
+}
+
+
 namespace xmlpp {
        class Element;
        class Node;
 }
 
+
 namespace dcp {
 
-class ARGBImage;
+
 class CertificateChain;
 class GammaLUT;
 class OpenJPEGImage;
 
-extern bool operator== (Size const & a, Size const & b);
-extern bool operator!= (Size const & a, Size const & b);
-extern std::ostream& operator<< (std::ostream& s, Size const & a);
 
 extern std::string make_uuid ();
-extern std::string make_digest (boost::filesystem::path filename, boost::function<void (float)>);
-extern std::string content_kind_to_string (ContentKind kind);
-extern ContentKind content_kind_from_string (std::string kind);
-extern bool empty_or_white_space (std::string s);
+
+/** Create a digest for a file
+ *  @param filename File name
+ *  @param progress Optional progress reporting function, called with a number of bytes done
+ *  and a total number of bytes.
+ *  @return Digest
+ */
+extern std::string make_digest(boost::filesystem::path filename, boost::function<void (int64_t, int64_t)>);
+
+extern std::string make_digest (ArrayData data);
+
 extern bool ids_equal (std::string a, std::string b);
 extern std::string remove_urn_uuid (std::string raw);
-extern void init ();
 
+/** Set up various bits that the library needs.  Should be called once
+ *  by client applications.
+ *
+ *  @param resources_directory Path to a directory containing the tags and xsd
+ *  directories from the source code; if none is specified libdcp will look
+ *  in the directory given by LIBDCP_RESOURCES or based on where the current
+ *  executable is.
+ */
+extern void init (boost::optional<boost::filesystem::path> resources_directory = boost::optional<boost::filesystem::path>());
+
+/** Decode a base64 string.  The base64 decode routine in KM_util.cpp
+ *  gives different values to both this and the command-line base64
+ *  for some inputs.  Not sure why.
+ *
+ *  @param in base64-encoded string
+ *  @param out Output buffer
+ *  @param out_length Length of output buffer
+ *  @return Number of characters written to the output buffer
+ */
 extern int base64_decode (std::string const & in, unsigned char* out, int out_length);
+
 extern boost::optional<boost::filesystem::path> relative_to_root (boost::filesystem::path root, boost::filesystem::path file);
-extern FILE * fopen_boost (boost::filesystem::path, std::string);
-extern std::string file_to_string (boost::filesystem::path, uintmax_t max_length = 65536);
+
+extern std::string file_to_string (boost::filesystem::path, uintmax_t max_length = 1048576);
+
+/** @param key RSA private key in PEM format (optionally with -----BEGIN... / -----END...)
+ *  @return SHA1 fingerprint of key
+ */
 extern std::string private_key_fingerprint (std::string key);
 extern xmlpp::Node* find_child (xmlpp::Node const * node, std::string name);
+extern std::string openjpeg_version();
+extern std::string spaces (int n);
+extern void indent (xmlpp::Element* element, int initial);
+
+/** @return true if the day represented by \ref a is less than or
+ *  equal to the one represented by \ref b, ignoring the time parts
+ */
+extern bool day_less_than_or_equal (LocalTime a, LocalTime b);
+
+/** @return true if the day represented by \ref a is greater than or
+ *  equal to the one represented by \ref b, ignoring the time parts
+ */
+extern bool day_greater_than_or_equal (LocalTime a, LocalTime b);
+
+/** Try quite hard to find a string which starts with \ref base and is
+ *  not in \ref existing
+ */
+extern std::string unique_string (std::vector<std::string> existing, std::string base);
+
+extern ASDCP::Dictionary const* asdcp_smpte_dict;
+
+extern boost::filesystem::path directory_containing_executable ();
+extern boost::filesystem::path resources_directory ();
+
+
+class ASDCPErrorSuspender
+{
+public:
+       ASDCPErrorSuspender();
+       ~ASDCPErrorSuspender();
+
+private:
+       Kumu::LogEntryList _log;
+       Kumu::ILogSink& _old;
+       Kumu::EntryListLogSink* _sink;
+};
 
+
+template <class From, class To>
+void
+add_to_container(To& container, From source)
+{
+       std::copy(source.begin(), source.end(), std::back_inserter(container));
 }
 
+
+}
+
+
 #endif