2 Copyright (C) 2012-2015 Carl Hetherington <cth@carlh.net>
4 This file is part of DCP-o-matic.
6 DCP-o-matic is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 DCP-o-matic is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with DCP-o-matic. If not, see <http://www.gnu.org/licenses/>.
21 /** @file src/decoder.h
22 * @brief Decoder class.
25 #ifndef DCPOMATIC_DECODER_H
26 #define DCPOMATIC_DECODER_H
29 #include "dcpomatic_time.h"
30 #include <boost/utility.hpp>
35 class SubtitleDecoder;
39 * @brief Parent class for decoders of content.
41 class Decoder : public boost::noncopyable
44 virtual ~Decoder () {}
46 boost::shared_ptr<VideoDecoder> video;
47 boost::shared_ptr<AudioDecoder> audio;
48 boost::shared_ptr<SubtitleDecoder> subtitle;
56 /** @return true if this decoder has already returned all its data and will give no more */
57 virtual bool pass (PassReason, bool accurate) = 0;
59 /** Ensure that any future get() calls return data that reflect
60 * changes in our content's settings.
62 virtual void reset () {}
64 void maybe_seek (boost::optional<ContentTime> position, ContentTime time, bool accurate);
67 /** Seek so that the next pass() will yield the next thing
68 * (video/sound frame, subtitle etc.) at or after the requested
69 * time. Pass accurate = true to try harder to ensure that, at worst,
70 * the next thing we yield comes before `time'. This may entail
71 * seeking some way before `time' to be on the safe side.
72 * Alternatively, if seeking is 100% accurate for this decoder,
73 * it may seek to just the right spot.
75 virtual void seek (ContentTime time, bool accurate) = 0;