X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fexceptions.h;h=78d0943e6eac7b6d5b683abd6ee8d156f0dc5089;hb=dd672d926e3b88cbe42b0778fda397d9e858b592;hp=2688ee86000666ee419580a61fc44feacd888a9e;hpb=0fee90e0af6fc8dec76450b75d1648d325cc57ca;p=libdcp.git diff --git a/src/exceptions.h b/src/exceptions.h index 2688ee86..78d0943e 100644 --- a/src/exceptions.h +++ b/src/exceptions.h @@ -1,5 +1,5 @@ /* - Copyright (C) 2012-2014 Carl Hetherington + Copyright (C) 2012-2021 Carl Hetherington This file is part of libdcp. @@ -31,18 +31,24 @@ files in the program, then also delete it here. */ + +/** @file src/exceptions.h + * @brief Exceptions thrown by libdcp + */ + + #ifndef LIBDCP_EXCEPTIONS_H #define LIBDCP_EXCEPTIONS_H + #include +#include -/** @file src/exceptions.h - * @brief Exceptions thrown by libdcp. - */ namespace dcp { + /** @class FileError * @brief An exception related to a file */ @@ -68,6 +74,7 @@ private: int _number; }; + /** @class MXFFileError * @brief An exception related to an MXF file */ @@ -79,6 +86,7 @@ public: {} }; + /** @class MiscError * @brief A miscellaneous exception */ @@ -90,34 +98,65 @@ public: {} }; -/** @class DCPReadError - * @brief A DCP read exception + +/** @class ReadError + * @brief Any error that occurs when reading data from a DCP */ -class DCPReadError : public std::runtime_error +class ReadError : public std::runtime_error { public: - explicit DCPReadError (std::string message) - : std::runtime_error (message) + explicit ReadError (std::string message) + : std::runtime_error(message) + , _message(message) {} + + ReadError (std::string message, std::string detail); + + ~ReadError() throw () {} + + std::string message () const { + return _message; + } + + boost::optional detail () const { + return _detail; + } + +private: + std::string _message; + boost::optional _detail; }; -/** @class MissingAssetError - * @brief An error of a missing asset. + +/** @class J2KDecompressionError + * @brief An error that occurs during decompression of JPEG2000 data */ -class MissingAssetError : public DCPReadError +class J2KDecompressionError : public ReadError +{ +public: + explicit J2KDecompressionError (std::string message) + : ReadError (message) + {} +}; + + +class BadContentKindError : public ReadError { public: - enum AssetType { - MAIN_PICTURE, //< main picture is missing - MAIN_SOUND, //< main sound is missing - MAIN_SUBTITLE, //< main subtitle is missing - UNKNOWN //< something is missing but we don't know what - }; + BadContentKindError (std::string content_kind); +}; - MissingAssetError (boost::filesystem::path, AssetType = UNKNOWN); - ~MissingAssetError () throw () {} + +/** @class MissingAssetmapError + * @brief Thrown when no ASSETMAP was found when trying to read a DCP + */ +class MissingAssetmapError : public ReadError +{ +public: + explicit MissingAssetmapError (boost::filesystem::path dir); }; + /** @class XMLError * @brief An XML error */ @@ -129,6 +168,7 @@ public: {} }; + /** @class UnresolvedRefError * @brief An exception caused by a reference (by UUID) to something which is not known */ @@ -138,8 +178,9 @@ public: explicit UnresolvedRefError (std::string id); }; + /** @class TimeFormatError - * @brief A an error with a string passed to LocalTime. + * @brief A an error with a string passed to LocalTime */ class TimeFormatError : public std::runtime_error { @@ -147,9 +188,10 @@ public: explicit TimeFormatError (std::string bad_time); }; + /** @class NotEncryptedError * @brief An error raised when creating a DecryptedKDM object for assets that are not - * encrypted. + * encrypted */ class NotEncryptedError : public std::runtime_error { @@ -158,8 +200,9 @@ public: ~NotEncryptedError () throw () {} }; + /** @class ProgrammingError - * @brief An exception thrown when a DCP_ASSERT fails; something that should not happen. + * @brief An exception thrown when a DCP_ASSERT fails; something that should not happen */ class ProgrammingError : public std::runtime_error { @@ -167,18 +210,114 @@ public: ProgrammingError (std::string file, int line); }; -class MismatchedStandardError : public DCPReadError + +class KDMDecryptionError : public std::runtime_error { public: - MismatchedStandardError (); + KDMDecryptionError (std::string message, int cipher_length, int modulus_dmax); }; -class KDMDecryptionError : public std::runtime_error + +class KDMFormatError : public std::runtime_error { public: - KDMDecryptionError (std::string message); + KDMFormatError (std::string message); }; + +class CertificateChainError : public std::runtime_error +{ +public: + CertificateChainError (std::string message); +}; + + +class MissingSubtitleImageError : public std::runtime_error +{ +public: + MissingSubtitleImageError (std::string id); +}; + + +class BadKDMDateError : public std::runtime_error +{ +public: + BadKDMDateError (bool starts_too_early); + + bool starts_too_early () const { + return _starts_too_early; + } + +private: + bool _starts_too_early; +}; + + +class StartCompressionError : public std::runtime_error +{ +public: + explicit StartCompressionError (boost::optional code = boost::optional()); + ~StartCompressionError () throw () {} + + boost::optional code () const { + return _code; + } + +private: + boost::optional _code; +}; + + +class CombineError : public std::runtime_error +{ +public: + explicit CombineError (std::string message); +}; + + +class LanguageTagError : public std::runtime_error +{ +public: + LanguageTagError (std::string message); +}; + + +class BadSettingError : public std::runtime_error +{ +public: + BadSettingError (std::string message); +}; + + +class DuplicateIdError : public std::runtime_error +{ +public: + DuplicateIdError (std::string message); +}; + + +class MainSoundConfigurationError : public std::runtime_error +{ +public: + MainSoundConfigurationError (std::string s); +}; + + +class UnknownChannelIdError : public std::runtime_error +{ +public: + UnknownChannelIdError (std::string s); +}; + + +class NoReelsError : public std::runtime_error +{ +public: + NoReelsError (); +}; + + } + #endif