/*
- Copyright (C) 2012-2013 Carl Hetherington <cth@carlh.net>
+ Copyright (C) 2012-2015 Carl Hetherington <cth@carlh.net>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
*/
/** @file src/decoder.h
- * @brief Parent class for decoders of content.
+ * @brief Decoder class.
*/
#ifndef DCPOMATIC_DECODER_H
#define DCPOMATIC_DECODER_H
+#include "types.h"
+#include "dcpomatic_time.h"
#include <boost/shared_ptr.hpp>
#include <boost/weak_ptr.hpp>
#include <boost/utility.hpp>
-#include "types.h"
-#include "dcpomatic_time.h"
-class Film;
class Decoded;
/** @class Decoder.
class Decoder : public boost::noncopyable
{
public:
- Decoder (boost::shared_ptr<const Film>);
virtual ~Decoder () {}
- /** Seek so that the next peek() will yield the next thing
- * (video/sound frame, subtitle etc.) at or after the requested
- * time. Pass accurate = true to try harder to get close to
- * the request.
- */
- virtual void seek (ContentTime time, bool accurate);
-
- boost::shared_ptr<Decoded> peek ();
+protected:
- /* Consume the last peek()ed thing so that it won't be returned
- * from the next peek().
+ /** Seek so that the next pass() will yield the next thing
+ * (video/sound frame, subtitle etc.) at or after the requested
+ * time. Pass accurate = true to try harder to ensure that, at worst,
+ * the next thing we yield comes before `time'. This may entail
+ * seeking some way before `time' to be on the safe side.
+ * Alternatively, if seeking is 100% accurate for this decoder,
+ * it may seek to just the right spot.
*/
- void consume ();
+ virtual void seek (ContentTime time, bool accurate) = 0;
-protected:
-
- /** Perform one decode pass of the content, which may or may not
- * result in a complete quantum (Decoded object) of decoded stuff
- * being added to _pending.
- * @return true if the decoder is done (i.e. no more data will be
- * produced by any future calls to pass() without a seek() first).
- */
- virtual bool pass () = 0;
- virtual void flush () {};
+ enum PassReason {
+ PASS_REASON_VIDEO,
+ PASS_REASON_AUDIO,
+ PASS_REASON_SUBTITLE
+ };
- /** The Film that we are decoding in */
- boost::weak_ptr<const Film> _film;
-
- std::list<boost::shared_ptr<Decoded> > _pending;
- bool _done;
+ virtual bool pass (PassReason reason) = 0;
};
#endif