2 * copyright (c) 2010 Sveriges Television AB <info@casparcg.com>
\r
4 * This file is part of CasparCG.
\r
6 * CasparCG is free software: you can redistribute it and/or modify
\r
7 * it under the terms of the GNU General Public License as published by
\r
8 * the Free Software Foundation, either version 3 of the License, or
\r
9 * (at your option) any later version.
\r
11 * CasparCG is distributed in the hope that it will be useful,
\r
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
14 * GNU General Public License for more details.
\r
16 * You should have received a copy of the GNU General Public License
\r
17 * along with CasparCG. If not, see <http://www.gnu.org/licenses/>.
\r
22 #include "../processor/write_frame.h"
\r
23 #include "../processor/frame_processor_device.h"
\r
25 #include <boost/noncopyable.hpp>
\r
29 namespace caspar { namespace core {
\r
31 class frame_producer : boost::noncopyable
\r
34 virtual ~frame_producer(){}
\r
36 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
37 /// \fn virtual gpu_frame_ptr :::receive() = 0;
\r
39 /// \brief Renders a frame.
\r
41 /// \note This function is run in through the tbb task_schedular and shall be *non blocking*.
\r
43 /// \return The frame.
\r
44 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
45 virtual gpu_frame_ptr receive() = 0;
\r
47 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
48 /// \fn virtual std::shared_ptr<frame_producer> :::get_following_producer() const
\r
50 /// \brief Gets the producer which will replace the current producer on EOF.
\r
52 /// \return The following producer, or nullptr if there is no following producer.
\r
53 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
54 virtual std::shared_ptr<frame_producer> get_following_producer() const { return nullptr; }
\r
56 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
57 /// \fn virtual void :::set_leading_producer(const std::shared_ptr<frame_producer>& producer)
\r
59 /// \brief Sets the producer which was run before the current producer.
\r
61 /// \param producer The leading producer.
\r
62 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
63 virtual void set_leading_producer(const std::shared_ptr<frame_producer>& /*producer*/) {}
\r
65 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
66 /// \fn virtual void :::initialize(const frame_processor_device_ptr& frame_processor) = 0;
\r
68 /// \brief Provides the frame frame_processor used to create frames and initializes the producer.
\r
70 /// \param frame_processor The frame frame_processor.
\r
71 ////////////////////////////////////////////////////////////////////////////////////////////////////
\r
72 virtual void initialize(const frame_processor_device_ptr& frame_processor) = 0;
\r
74 virtual std::wstring print() const { return L"Unknown frame_producer.";}
\r
76 typedef std::shared_ptr<frame_producer> frame_producer_ptr;
\r
78 inline std::wostream& operator<<(std::wostream& out, const frame_producer& producer)
\r
80 out << producer.print().c_str();
\r