/* Copyright (C) 2012-2021 Carl Hetherington This file is part of DCP-o-matic. DCP-o-matic 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. DCP-o-matic 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 DCP-o-matic. If not, see . */ /** @file src/decoder.h * @brief Decoder class. */ #ifndef DCPOMATIC_DECODER_H #define DCPOMATIC_DECODER_H #include "dcpomatic_time.h" #include "film.h" #include "weak_film.h" #include class AtmosDecoder; class AudioDecoder; class Decoded; class DecoderPart; class TextDecoder; class VideoDecoder; /** @class Decoder. * @brief Parent class for decoders of content. */ class Decoder : public WeakConstFilm { public: Decoder (std::weak_ptr film); virtual ~Decoder () {} Decoder (Decoder const&) = delete; Decoder& operator= (Decoder const&) = delete; std::shared_ptr video; std::shared_ptr audio; std::list> text; std::shared_ptr atmos; std::shared_ptr only_text () const; class PassResult { public: enum class Type { OK, ///< there was no error and more data may be emitted on the next pass() FINISHED, ///< this decoder will emit no more data unless a seek() happens ERROR, ///< some survivable error occurred; output may not be correct }; static PassResult ok() { return { Type::OK }; } static PassResult finished() { return { Type::FINISHED }; } static PassResult error(std::string message) { return { Type::ERROR, message }; }; bool is_ok() const { return _type == Type::OK; } bool is_finished() const { return _type == Type::FINISHED; } bool is_error() const { return _type == Type::ERROR; } std::string error_message() const { DCPOMATIC_ASSERT(is_error()); return _error_message; } private: PassResult(Type type) : _type(type) {} PassResult(Type type, std::string error_message) : _type(type) , _error_message(error_message) {} Type _type; std::string _error_message; }; /** Do some decoding and perhaps emit video, audio or subtitle data */ virtual PassResult pass() = 0; virtual void seek (dcpomatic::ContentTime time, bool accurate); virtual dcpomatic::ContentTime position () const; }; #endif