#pragma once\r
\r
#include <common/memory/safe_ptr.h>\r
-#include <common/object.h>\r
-\r
-#include "../producer/frame/basic_frame.h"\r
-#include "../producer/frame/frame_factory.h"\r
\r
#include <boost/noncopyable.hpp>\r
\r
#include <functional>\r
-#include <ostream>\r
#include <string>\r
+#include <vector>\r
+#include <stdint.h>\r
+#include <numeric>\r
\r
-namespace caspar { namespace core {\r
+namespace caspar { \r
+ \r
+class executor;\r
+ \r
+namespace core {\r
\r
-class frame_producer : public object, boost::noncopyable\r
+class basic_frame;\r
+struct frame_factory;\r
+\r
+struct frame_producer : boost::noncopyable\r
{\r
public:\r
+ enum hints\r
+ {\r
+ NO_HINT = 0,\r
+ ALPHA_HINT = 1\r
+ };\r
+\r
virtual ~frame_producer(){} \r
\r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- /// \fn virtual basic_frame :::receive() = 0;\r
- ///\r
- /// \brief Renders a frame.\r
- /// \r
- /// \note This function is run in through the tbb task_schedular and shall be *non blocking*.\r
- ///\r
- /// \return The frame. \r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- virtual safe_ptr<basic_frame> receive() = 0;\r
-\r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- /// \fn virtual std::shared_ptr<frame_producer> :::get_following_producer() const\r
- ///\r
- /// \brief Gets the producer which will replace the current producer on EOF. \r
- ///\r
- /// \return The following producer, or nullptr if there is no following producer. \r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- virtual safe_ptr<frame_producer> get_following_producer() const {return frame_producer::empty();} // nothrow\r
- \r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- /// \fn virtual void :::set_leading_producer(const std::shared_ptr<frame_producer>& producer)\r
- ///\r
- /// \brief Sets the producer which was run before the current producer. \r
- ///\r
- /// \param producer The leading producer.\r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- virtual void set_leading_producer(const safe_ptr<frame_producer>& /*producer*/) {} // nothrow\r
- \r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- /// \fn virtual void :::set_frame_factory(const safe_ptr<frame_factory>& frame_factory) = 0;\r
- ///\r
- /// \brief Sets the frame frame_factory used to create frames. \r
- ///\r
- /// \param frame_factory The frame frame_factory. \r
- ////////////////////////////////////////////////////////////////////////////////////////////////////\r
- virtual void set_frame_factory(const safe_ptr<frame_factory>& frame_factory) = 0;\r
+ virtual std::wstring print() const = 0; // nothrow\r
\r
virtual void param(const std::wstring&){}\r
- \r
- static const safe_ptr<frame_producer>& empty() // nothrow\r
- {\r
- struct empty_frame_producer : public frame_producer\r
- {\r
- virtual safe_ptr<basic_frame> receive(){return basic_frame::empty();}\r
- virtual void set_frame_factory(const safe_ptr<frame_factory>&){}\r
- virtual void set_parent(const object* parent) {}\r
- virtual std::wstring print() const { return L"empty";}\r
- };\r
- static safe_ptr<frame_producer> producer = make_safe<empty_frame_producer>();\r
- return producer;\r
- }\r
-};\r
\r
-inline std::wostream& operator<<(std::wostream& out, const frame_producer& producer)\r
-{\r
- out << producer.print().c_str();\r
- return out;\r
-}\r
+ virtual safe_ptr<frame_producer> get_following_producer() const {return frame_producer::empty();} // nothrow\r
+ virtual void set_leading_producer(const safe_ptr<frame_producer>&) {} // nothrow\r
+ \r
+ virtual int64_t nb_frames() const {return std::numeric_limits<int>::max();}\r
+ \r
+ virtual safe_ptr<basic_frame> receive(int hints) = 0;\r
+ virtual safe_ptr<core::basic_frame> last_frame() const = 0;\r
\r
-inline std::wostream& operator<<(std::wostream& out, const safe_ptr<const frame_producer>& producer)\r
-{\r
- out << producer->print().c_str();\r
- return out;\r
-}\r
+ static const safe_ptr<frame_producer>& empty(); // nothrow\r
+};\r
\r
-typedef std::function<safe_ptr<core::frame_producer>(const std::vector<std::wstring>&)> producer_factory_t;\r
+safe_ptr<basic_frame> receive_and_follow(safe_ptr<frame_producer>& producer, int hints);\r
\r
-void register_producer_factory(const producer_factory_t& factory);\r
-safe_ptr<core::frame_producer> create_producer(const std::vector<std::wstring>& params);\r
+typedef std::function<safe_ptr<core::frame_producer>(const safe_ptr<frame_factory>&, const std::vector<std::wstring>&)> producer_factory_t;\r
+void register_producer_factory(const producer_factory_t& factory); // Not thread-safe.\r
+safe_ptr<core::frame_producer> create_producer(const safe_ptr<frame_factory>&, const std::vector<std::wstring>& params);\r
\r
+safe_ptr<core::frame_producer> create_destroy_producer_proxy(executor& destroy_context, const safe_ptr<frame_producer>& producer);\r
\r
}}\r