]> git.sesse.net Git - casparcg/blob - modules/screen/consumer/screen_consumer.cpp
b992cfb69f12773d79f1be9f959fcd14d1110201
[casparcg] / modules / screen / consumer / screen_consumer.cpp
1 /*
2 * Copyright (c) 2011 Sveriges Television AB <info@casparcg.com>
3 *
4 * This file is part of CasparCG (www.casparcg.com).
5 *
6 * CasparCG 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 3 of the License, or
9 * (at your option) any later version.
10 *
11 * CasparCG 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.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with CasparCG. If not, see <http://www.gnu.org/licenses/>.
18 *
19 * Author: Robert Nagy, ronag89@gmail.com
20 */
21
22 #include "screen_consumer.h"
23
24 #include <GL/glew.h>
25 #include <SFML/Window.hpp>
26
27 #include <common/diagnostics/graph.h>
28 #include <common/gl/gl_check.h>
29 #include <common/log.h>
30 #include <common/memory.h>
31 #include <common/array.h>
32 #include <common/memshfl.h>
33 #include <common/memcpy.h>
34 #include <common/utf.h>
35 #include <common/prec_timer.h>
36 #include <common/future.h>
37 #include <common/timer.h>
38 #include <common/param.h>
39 #include <common/os/general_protection_fault.h>
40 #include <common/scope_exit.h>
41
42 //#include <windows.h>
43
44 #include <ffmpeg/producer/filter/filter.h>
45 #include <ffmpeg/producer/util/util.h>
46
47 #include <core/video_format.h>
48 #include <core/frame/frame.h>
49 #include <core/consumer/frame_consumer.h>
50 #include <core/interaction/interaction_sink.h>
51 #include <core/help/help_sink.h>
52 #include <core/help/help_repository.h>
53
54 #include <boost/circular_buffer.hpp>
55 #include <boost/lexical_cast.hpp>
56 #include <boost/property_tree/ptree.hpp>
57 #include <boost/thread.hpp>
58 #include <boost/algorithm/string.hpp>
59
60 #include <tbb/atomic.h>
61 #include <tbb/concurrent_queue.h>
62 #include <tbb/parallel_for.h>
63
64 #include <asmlib.h>
65
66 #include <algorithm>
67 #include <vector>
68
69 #if defined(_MSC_VER)
70 #pragma warning (push)
71 #pragma warning (disable : 4244)
72 #endif
73 extern "C"
74 {
75         #define __STDC_CONSTANT_MACROS
76         #define __STDC_LIMIT_MACROS
77         #include <libavcodec/avcodec.h>
78         #include <libavutil/imgutils.h>
79 }
80 #if defined(_MSC_VER)
81 #pragma warning (pop)
82 #endif
83
84 namespace caspar { namespace screen {
85
86 enum class stretch
87 {
88         none,
89         uniform,
90         fill,
91         uniform_to_fill
92 };
93
94 struct configuration
95 {
96         enum class aspect_ratio
97         {
98                 aspect_4_3 = 0,
99                 aspect_16_9,
100                 aspect_invalid,
101         };
102
103         std::wstring    name                            = L"Screen consumer";
104         int                             screen_index            = 0;
105         screen::stretch stretch                         = screen::stretch::fill;
106         bool                    windowed                        = true;
107         bool                    auto_deinterlace        = true;
108         bool                    key_only                        = false;
109         aspect_ratio    aspect                          = aspect_ratio::aspect_invalid;
110         bool                    vsync                           = false;
111         bool                    interactive                     = true;
112         bool                    borderless                      = false;
113 };
114
115 struct screen_consumer : boost::noncopyable
116 {
117         const configuration                                                                     config_;
118         core::video_format_desc                                                         format_desc_;
119         int                                                                                                     channel_index_;
120
121         GLuint                                                                                          texture_                = 0;
122         std::vector<GLuint>                                                                     pbos_                   = std::vector<GLuint> { 0, 0 };
123
124         float                                                                                           width_;
125         float                                                                                           height_;
126         int                                                                                                     screen_x_;
127         int                                                                                                     screen_y_;
128         int                                                                                                     screen_width_   = format_desc_.width;
129         int                                                                                                     screen_height_  = format_desc_.height;
130         int                                                                                                     square_width_   = format_desc_.square_width;
131         int                                                                                                     square_height_  = format_desc_.square_height;
132
133         sf::Window                                                                                      window_;
134         tbb::atomic<bool>                                                                       polling_event_;
135         std::int64_t                                                                            pts_;
136
137         spl::shared_ptr<diagnostics::graph>                                     graph_;
138         caspar::timer                                                                           perf_timer_;
139         caspar::timer                                                                           tick_timer_;
140
141         caspar::prec_timer                                                                      wait_timer_;
142
143         tbb::concurrent_bounded_queue<core::const_frame>        frame_buffer_;
144         core::interaction_sink*                                                         sink_;
145
146         boost::thread                                                                           thread_;
147         tbb::atomic<bool>                                                                       is_running_;
148         tbb::atomic<int64_t>                                                            current_presentation_age_;
149
150         ffmpeg::filter                                                                          filter_;
151 public:
152         screen_consumer(
153                         const configuration& config,
154                         const core::video_format_desc& format_desc,
155                         int channel_index,
156                         core::interaction_sink* sink)
157                 : config_(config)
158                 , format_desc_(format_desc)
159                 , channel_index_(channel_index)
160                 , pts_(0)
161                 , sink_(sink)
162                 , filter_([&]() -> ffmpeg::filter
163                 {
164                         const auto sample_aspect_ratio =
165                                 boost::rational<int>(
166                                         format_desc.square_width,
167                                         format_desc.square_height) /
168                                 boost::rational<int>(
169                                         format_desc.width,
170                                         format_desc.height);
171
172                         return ffmpeg::filter(
173                                 format_desc.width,
174                                 format_desc.height,
175                                 boost::rational<int>(format_desc.duration, format_desc.time_scale),
176                                 boost::rational<int>(format_desc.time_scale, format_desc.duration),
177                                 sample_aspect_ratio,
178                                 AV_PIX_FMT_BGRA,
179                                 { AV_PIX_FMT_BGRA },
180                                 format_desc.field_mode == core::field_mode::progressive || !config.auto_deinterlace ? "" : "format=pix_fmts=gbrp,YADIF=1:-1");
181                 }())
182         {
183                 if (format_desc_.format == core::video_format::ntsc && config_.aspect == configuration::aspect_ratio::aspect_4_3)
184                 {
185                         // Use default values which are 4:3.
186                 }
187                 else
188                 {
189                         if (config_.aspect == configuration::aspect_ratio::aspect_16_9)
190                                 square_width_ = (format_desc.height*16)/9;
191                         else if (config_.aspect == configuration::aspect_ratio::aspect_4_3)
192                                 square_width_ = (format_desc.height*4)/3;
193                 }
194
195                 frame_buffer_.set_capacity(1);
196
197                 graph_->set_color("tick-time", diagnostics::color(0.0f, 0.6f, 0.9f));
198                 graph_->set_color("frame-time", diagnostics::color(0.1f, 1.0f, 0.1f));
199                 graph_->set_color("dropped-frame", diagnostics::color(0.3f, 0.6f, 0.3f));
200                 graph_->set_text(print());
201                 diagnostics::register_graph(graph_);
202
203                 /*DISPLAY_DEVICE d_device = {sizeof(d_device), 0};
204                 std::vector<DISPLAY_DEVICE> displayDevices;
205                 for(int n = 0; EnumDisplayDevices(NULL, n, &d_device, NULL); ++n)
206                         displayDevices.push_back(d_device);
207
208                 if(config_.screen_index >= displayDevices.size())
209                         CASPAR_LOG(warning) << print() << L" Invalid screen-index: " << config_.screen_index;
210
211                 DEVMODE devmode = {};
212                 if(!EnumDisplaySettings(displayDevices[config_.screen_index].DeviceName, ENUM_CURRENT_SETTINGS, &devmode))
213                         CASPAR_LOG(warning) << print() << L" Could not find display settings for screen-index: " << config_.screen_index;
214
215                 screen_x_               = devmode.dmPosition.x;
216                 screen_y_               = devmode.dmPosition.y;
217                 screen_width_   = config_.windowed ? square_width_ : devmode.dmPelsWidth;
218                 screen_height_  = config_.windowed ? square_height_ : devmode.dmPelsHeight;*/
219                 screen_x_               = 0;
220                 screen_y_               = 0;
221                 screen_width_   = square_width_;
222                 screen_height_  = square_height_;
223
224                 polling_event_ = false;
225                 is_running_ = true;
226                 current_presentation_age_ = 0;
227                 thread_ = boost::thread([this]{run();});
228         }
229
230         ~screen_consumer()
231         {
232                 is_running_ = false;
233                 frame_buffer_.try_push(core::const_frame::empty());
234                 thread_.join();
235         }
236
237         void init()
238         {
239                 auto window_style = config_.borderless
240                         ? sf::Style::None
241                         : (config_.windowed
242                                 ? sf::Style::Resize | sf::Style::Close
243                                 : sf::Style::Fullscreen);
244                 window_.create(sf::VideoMode(screen_width_, screen_height_, 32), u8(print()), window_style);
245                 window_.setMouseCursorVisible(config_.interactive);
246                 window_.setPosition(sf::Vector2i(screen_x_, screen_y_));
247                 window_.setSize(sf::Vector2u(screen_width_, screen_height_));
248                 window_.setActive();
249
250                 if(!GLEW_VERSION_2_1 && glewInit() != GLEW_OK)
251                         CASPAR_THROW_EXCEPTION(gl::ogl_exception() << msg_info("Failed to initialize GLEW."));
252
253                 if(!GLEW_VERSION_2_1)
254                         CASPAR_THROW_EXCEPTION(not_supported() << msg_info("Missing OpenGL 2.1 support."));
255
256                 GL(glEnable(GL_TEXTURE_2D));
257                 GL(glDisable(GL_DEPTH_TEST));
258                 GL(glClearColor(0.0, 0.0, 0.0, 0.0));
259                 GL(glViewport(0, 0, format_desc_.width, format_desc_.height));
260                 GL(glLoadIdentity());
261
262                 calculate_aspect();
263
264                 GL(glGenTextures(1, &texture_));
265                 GL(glBindTexture(GL_TEXTURE_2D, texture_));
266                 GL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
267                 GL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
268                 GL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP));
269                 GL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP));
270                 GL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA8, format_desc_.width, format_desc_.height, 0, GL_BGRA, GL_UNSIGNED_BYTE, 0));
271                 GL(glBindTexture(GL_TEXTURE_2D, 0));
272
273                 GL(glGenBuffers(2, pbos_.data()));
274
275                 glBindBufferARB(GL_PIXEL_UNPACK_BUFFER_ARB, pbos_[0]);
276                 glBufferDataARB(GL_PIXEL_UNPACK_BUFFER_ARB, format_desc_.size, 0, GL_STREAM_DRAW_ARB);
277                 glBindBufferARB(GL_PIXEL_UNPACK_BUFFER_ARB, pbos_[1]);
278                 glBufferDataARB(GL_PIXEL_UNPACK_BUFFER_ARB, format_desc_.size, 0, GL_STREAM_DRAW_ARB);
279                 glBindBufferARB(GL_PIXEL_UNPACK_BUFFER_ARB, 0);
280
281                 window_.setVerticalSyncEnabled(config_.vsync);
282
283                 if (config_.vsync)
284                 {
285                         CASPAR_LOG(info) << print() << " Enabled vsync.";
286                 }
287         }
288
289         void uninit()
290         {
291                 if(texture_)
292                         glDeleteTextures(1, &texture_);
293
294                 for (auto& pbo : pbos_)
295                 {
296                         if(pbo)
297                                 glDeleteBuffers(1, &pbo);
298                 }
299         }
300
301         void run()
302         {
303                 ensure_gpf_handler_installed_for_thread("screen-consumer-thread");
304
305                 try
306                 {
307                         init();
308
309                         while(is_running_)
310                         {
311                                 try
312                                 {
313                                         auto poll_event = [this](sf::Event& e)
314                                         {
315                                                 polling_event_ = true;
316                                                 CASPAR_SCOPE_EXIT
317                                                 {
318                                                         polling_event_ = false;
319                                                 };
320                                                 return window_.pollEvent(e);
321                                         };
322
323                                         sf::Event e;
324                                         while(poll_event(e))
325                                         {
326                                                 if (e.type == sf::Event::Resized)
327                                                         calculate_aspect();
328                                                 else if (e.type == sf::Event::Closed)
329                                                         is_running_ = false;
330                                                 else if (config_.interactive && sink_)
331                                                 {
332                                                         switch (e.type)
333                                                         {
334                                                         case sf::Event::MouseMoved:
335                                                                 {
336                                                                         auto& mouse_move = e.mouseMove;
337                                                                         sink_->on_interaction(spl::make_shared<core::mouse_move_event>(
338                                                                                         1,
339                                                                                         static_cast<double>(mouse_move.x) / screen_width_,
340                                                                                         static_cast<double>(mouse_move.y) / screen_height_));
341                                                                 }
342                                                                 break;
343                                                         case sf::Event::MouseButtonPressed:
344                                                         case sf::Event::MouseButtonReleased:
345                                                                 {
346                                                                         auto& mouse_button = e.mouseButton;
347                                                                         sink_->on_interaction(spl::make_shared<core::mouse_button_event>(
348                                                                                         1,
349                                                                                         static_cast<double>(mouse_button.x) / screen_width_,
350                                                                                         static_cast<double>(mouse_button.y) / screen_height_,
351                                                                                         static_cast<int>(mouse_button.button),
352                                                                                         e.type == sf::Event::MouseButtonPressed));
353                                                                 }
354                                                                 break;
355                                                         case sf::Event::MouseWheelMoved:
356                                                                 {
357                                                                         auto& wheel_moved = e.mouseWheel;
358                                                                         sink_->on_interaction(spl::make_shared<core::mouse_wheel_event>(
359                                                                                         1,
360                                                                                         static_cast<double>(wheel_moved.x) / screen_width_,
361                                                                                         static_cast<double>(wheel_moved.y) / screen_height_,
362                                                                                         wheel_moved.delta));
363                                                                 }
364                                                                 break;
365                                                         }
366                                                 }
367                                         }
368
369                                         core::const_frame frame;
370                                         frame_buffer_.pop(frame);
371
372                                         render_and_draw_frame(frame);
373
374                                         /*perf_timer_.restart();
375                                         render(frame);
376                                         graph_->set_value("frame-time", perf_timer_.elapsed()*format_desc_.fps*0.5);
377
378                                         window_.Display();*/
379
380                                         current_presentation_age_ = frame.get_age_millis();
381                                         graph_->set_value("tick-time", tick_timer_.elapsed()*format_desc_.fps*0.5);
382                                         tick_timer_.restart();
383                                 }
384                                 catch(...)
385                                 {
386                                         CASPAR_LOG_CURRENT_EXCEPTION();
387                                         is_running_ = false;
388                                 }
389                         }
390
391                         uninit();
392                 }
393                 catch(...)
394                 {
395                         CASPAR_LOG_CURRENT_EXCEPTION();
396                 }
397         }
398
399         void try_sleep_almost_until_vblank()
400         {
401                 static const double THRESHOLD = 0.003;
402                 double threshold = config_.vsync ? THRESHOLD : 0.0;
403
404                 auto frame_time = 1.0 / (format_desc_.fps * format_desc_.field_count);
405
406                 wait_timer_.tick(frame_time - threshold);
407         }
408
409         void wait_for_vblank_and_display()
410         {
411                 try_sleep_almost_until_vblank();
412                 window_.display();
413                 // Make sure that the next tick measures the duration from this point in time.
414                 wait_timer_.tick(0.0);
415         }
416
417         spl::shared_ptr<AVFrame> get_av_frame()
418         {
419                 auto av_frame = ffmpeg::create_frame();
420
421                 av_frame->linesize[0]           = format_desc_.width*4;
422                 av_frame->format                        = PIX_FMT_BGRA;
423                 av_frame->width                         = format_desc_.width;
424                 av_frame->height                        = format_desc_.height;
425                 av_frame->interlaced_frame      = format_desc_.field_mode != core::field_mode::progressive;
426                 av_frame->top_field_first       = format_desc_.field_mode == core::field_mode::upper ? 1 : 0;
427                 av_frame->pts                           = pts_++;
428
429                 return av_frame;
430         }
431
432         void render_and_draw_frame(core::const_frame input_frame)
433         {
434                 if(static_cast<size_t>(input_frame.image_data().size()) != format_desc_.size)
435                         return;
436
437                 if(screen_width_ == 0 && screen_height_ == 0)
438                         return;
439
440                 perf_timer_.restart();
441                 auto av_frame = get_av_frame();
442                 av_frame->data[0] = const_cast<uint8_t*>(input_frame.image_data().begin());
443
444                 filter_.push(av_frame);
445                 auto frame = filter_.poll();
446
447                 if (!frame)
448                         return;
449
450                 if (!filter_.is_double_rate())
451                 {
452                         render(spl::make_shared_ptr(frame));
453                         graph_->set_value("frame-time", perf_timer_.elapsed() * format_desc_.fps * 0.5);
454
455                         wait_for_vblank_and_display(); // progressive frame
456                 }
457                 else
458                 {
459                         render(spl::make_shared_ptr(frame));
460                         double perf_elapsed = perf_timer_.elapsed();
461
462                         wait_for_vblank_and_display(); // field1
463
464                         perf_timer_.restart();
465                         frame = filter_.poll();
466                         render(spl::make_shared_ptr(frame));
467                         perf_elapsed += perf_timer_.elapsed();
468                         graph_->set_value("frame-time", perf_elapsed * format_desc_.fps * 0.5);
469
470                         wait_for_vblank_and_display(); // field2
471                 }
472         }
473
474         void render(spl::shared_ptr<AVFrame> av_frame)
475         {
476                 CASPAR_LOG_CALL(trace) << "screen_consumer::render() <- " << print();
477                 GL(glBindTexture(GL_TEXTURE_2D, texture_));
478
479                 GL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, pbos_[0]));
480                 GL(glTexSubImage2D(GL_TEXTURE_2D, 0, 0, 0, format_desc_.width, format_desc_.height, GL_BGRA, GL_UNSIGNED_BYTE, 0));
481
482                 GL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, pbos_[1]));
483                 GL(glBufferData(GL_PIXEL_UNPACK_BUFFER, format_desc_.size, 0, GL_STREAM_DRAW));
484
485                 auto ptr = reinterpret_cast<char*>(GL2(glMapBuffer(GL_PIXEL_UNPACK_BUFFER, GL_WRITE_ONLY)));
486                 if(ptr)
487                 {
488                         if(config_.key_only)
489                         {
490                                 tbb::parallel_for(tbb::blocked_range<int>(0, format_desc_.height), [&](const tbb::blocked_range<int>& r)
491                                 {
492                                         for(int n = r.begin(); n != r.end(); ++n)
493                                                 aligned_memshfl(ptr+n*format_desc_.width*4, av_frame->data[0]+n*av_frame->linesize[0], format_desc_.width*4, 0x0F0F0F0F, 0x0B0B0B0B, 0x07070707, 0x03030303);
494                                 });
495                         }
496                         else
497                         {
498                                 fast_memcpy(ptr, av_frame->data[0], format_desc_.size);
499                         }
500
501                         GL(glUnmapBuffer(GL_PIXEL_UNPACK_BUFFER)); // release the mapped buffer
502                 }
503
504                 GL(glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0));
505
506                 GL(glClear(GL_COLOR_BUFFER_BIT));
507                 glBegin(GL_QUADS);
508                                 glTexCoord2f(0.0f,        1.0f);        glVertex2f(-width_, -height_);
509                                 glTexCoord2f(1.0f,        1.0f);        glVertex2f( width_, -height_);
510                                 glTexCoord2f(1.0f,        0.0f);        glVertex2f( width_,  height_);
511                                 glTexCoord2f(0.0f,        0.0f);        glVertex2f(-width_,  height_);
512                 glEnd();
513
514                 GL(glBindTexture(GL_TEXTURE_2D, 0));
515
516                 std::rotate(pbos_.begin(), pbos_.begin() + 1, pbos_.end());
517         }
518
519
520         std::future<bool> send(core::const_frame frame)
521         {
522                 if(!frame_buffer_.try_push(frame) && !polling_event_)
523                         graph_->set_tag(diagnostics::tag_severity::WARNING, "dropped-frame");
524
525                 return make_ready_future(is_running_.load());
526         }
527
528         std::wstring channel_and_format() const
529         {
530                 return L"[" + boost::lexical_cast<std::wstring>(channel_index_) + L"|" + format_desc_.name + L"]";
531         }
532
533         std::wstring print() const
534         {
535                 return config_.name + L" " + channel_and_format();
536         }
537
538         void calculate_aspect()
539         {
540                 if(config_.windowed)
541                 {
542                         screen_height_ = window_.getSize().y;
543                         screen_width_ = window_.getSize().x;
544                 }
545
546                 GL(glViewport(0, 0, screen_width_, screen_height_));
547
548                 std::pair<float, float> target_ratio = None();
549                 if (config_.stretch == screen::stretch::fill)
550                         target_ratio = Fill();
551                 else if (config_.stretch == screen::stretch::uniform)
552                         target_ratio = Uniform();
553                 else if (config_.stretch == screen::stretch::uniform_to_fill)
554                         target_ratio = UniformToFill();
555
556                 width_ = target_ratio.first;
557                 height_ = target_ratio.second;
558         }
559
560         std::pair<float, float> None()
561         {
562                 float width = static_cast<float>(square_width_)/static_cast<float>(screen_width_);
563                 float height = static_cast<float>(square_height_)/static_cast<float>(screen_height_);
564
565                 return std::make_pair(width, height);
566         }
567
568         std::pair<float, float> Uniform()
569         {
570                 float aspect = static_cast<float>(square_width_)/static_cast<float>(square_height_);
571                 float width = std::min(1.0f, static_cast<float>(screen_height_)*aspect/static_cast<float>(screen_width_));
572                 float height = static_cast<float>(screen_width_*width)/static_cast<float>(screen_height_*aspect);
573
574                 return std::make_pair(width, height);
575         }
576
577         std::pair<float, float> Fill()
578         {
579                 return std::make_pair(1.0f, 1.0f);
580         }
581
582         std::pair<float, float> UniformToFill()
583         {
584                 float wr = static_cast<float>(square_width_)/static_cast<float>(screen_width_);
585                 float hr = static_cast<float>(square_height_)/static_cast<float>(screen_height_);
586                 float r_inv = 1.0f/std::min(wr, hr);
587
588                 float width = wr*r_inv;
589                 float height = hr*r_inv;
590
591                 return std::make_pair(width, height);
592         }
593 };
594
595
596 struct screen_consumer_proxy : public core::frame_consumer
597 {
598         core::monitor::subject                          monitor_subject_;
599         const configuration                                     config_;
600         std::unique_ptr<screen_consumer>        consumer_;
601         core::interaction_sink*                         sink_;
602
603 public:
604
605         screen_consumer_proxy(const configuration& config, core::interaction_sink* sink)
606                 : config_(config)
607                 , sink_(sink)
608         {
609         }
610
611         // frame_consumer
612
613         void initialize(const core::video_format_desc& format_desc, const core::audio_channel_layout&, int channel_index) override
614         {
615                 consumer_.reset();
616                 consumer_.reset(new screen_consumer(config_, format_desc, channel_index, sink_));
617         }
618
619         int64_t presentation_frame_age_millis() const override
620         {
621                 return consumer_ ? static_cast<int64_t>(consumer_->current_presentation_age_) : 0;
622         }
623
624         std::future<bool> send(core::const_frame frame) override
625         {
626                 return consumer_->send(frame);
627         }
628
629         std::wstring print() const override
630         {
631                 return consumer_ ? consumer_->print() : L"[screen_consumer]";
632         }
633
634         std::wstring name() const override
635         {
636                 return L"screen";
637         }
638
639         boost::property_tree::wptree info() const override
640         {
641                 boost::property_tree::wptree info;
642                 info.add(L"type", L"screen");
643                 info.add(L"key-only", config_.key_only);
644                 info.add(L"windowed", config_.windowed);
645                 info.add(L"auto-deinterlace", config_.auto_deinterlace);
646                 info.add(L"vsync", config_.vsync);
647                 return info;
648         }
649
650         bool has_synchronization_clock() const override
651         {
652                 return false;
653         }
654
655         int buffer_depth() const override
656         {
657                 return 1;
658         }
659
660         int index() const override
661         {
662                 return 600 + (config_.key_only ? 10 : 0) + config_.screen_index;
663         }
664
665         core::monitor::subject& monitor_output()
666         {
667                 return monitor_subject_;
668         }
669 };
670
671 void describe_consumer(core::help_sink& sink, const core::help_repository& repo)
672 {
673         sink.short_description(L"Displays the contents of a channel on screen using OpenGL.");
674         sink.syntax(
675                         L"SCREEN "
676                         L"{[screen_index:int]|1} "
677                         L"{[fullscreen:FULLSCREEN]} "
678                         L"{[borderless:BORDERLESS]} "
679                         L"{[key_only:KEY_ONLY]} "
680                         L"{[non_interactive:NON_INTERACTIVE]} "
681                         L"{[no_auto_deinterlace:NO_AUTO_DEINTERLACE]} "
682                         L"{NAME [name:string]}");
683         sink.para()->text(L"Displays the contents of a channel on screen using OpenGL.");
684         sink.definitions()
685                 ->item(L"screen_index", L"Determines which screen the channel should be displayed on. Defaults to 1.")
686                 ->item(L"fullscreen", L"If specified opens the window in fullscreen.")
687                 ->item(L"borderless", L"Makes the window appear without any window decorations.")
688                 ->item(L"key_only", L"Only displays the alpha channel of the video channel if specified.")
689                 ->item(L"non_interactive", L"If specified does not send mouse input to producers on the video channel.")
690                 ->item(L"no_auto_deinterlace", L"If the video mode of the channel is an interlaced mode, specifying this will turn of deinterlacing.")
691                 ->item(L"name", L"Optionally specifies a name of the window to show.");
692         sink.para()->text(L"Examples:");
693         sink.example(L">> ADD 1 SCREEN", L"opens a screen consumer on the default screen.");
694         sink.example(L">> ADD 1 SCREEN 2", L"opens a screen consumer on the screen 2.");
695         sink.example(L">> ADD 1 SCREEN 1 FULLSCREEN", L"opens a screen consumer in fullscreen on screen 1.");
696         sink.example(L">> ADD 1 SCREEN 1 BORDERLESS", L"opens a screen consumer without borders/window decorations on screen 1.");
697 }
698
699 spl::shared_ptr<core::frame_consumer> create_consumer(
700                 const std::vector<std::wstring>& params, core::interaction_sink* sink, std::vector<spl::shared_ptr<core::video_channel>> channels)
701 {
702         if (params.size() < 1 || !boost::iequals(params.at(0), L"SCREEN"))
703                 return core::frame_consumer::empty();
704
705         configuration config;
706
707         if (params.size() > 1)
708                 config.screen_index = boost::lexical_cast<int>(params.at(1));
709
710         config.windowed                 = !contains_param(L"FULLSCREEN", params);
711         config.key_only                 =  contains_param(L"KEY_ONLY", params);
712         config.interactive              = !contains_param(L"NON_INTERACTIVE", params);
713         config.auto_deinterlace = !contains_param(L"NO_AUTO_DEINTERLACE", params);
714         config.borderless               =  contains_param(L"BORDERLESS", params);
715
716         if (contains_param(L"NAME", params))
717                 config.name = get_param(L"NAME", params);
718
719         return spl::make_shared<screen_consumer_proxy>(config, sink);
720 }
721
722 spl::shared_ptr<core::frame_consumer> create_preconfigured_consumer(
723                 const boost::property_tree::wptree& ptree, core::interaction_sink* sink, std::vector<spl::shared_ptr<core::video_channel>> channels)
724 {
725         configuration config;
726         config.name                             = ptree.get(L"name",                            config.name);
727         config.screen_index             = ptree.get(L"device",                          config.screen_index + 1) - 1;
728         config.windowed                 = ptree.get(L"windowed",                        config.windowed);
729         config.key_only                 = ptree.get(L"key-only",                        config.key_only);
730         config.auto_deinterlace = ptree.get(L"auto-deinterlace",        config.auto_deinterlace);
731         config.vsync                    = ptree.get(L"vsync",                           config.vsync);
732         config.interactive              = ptree.get(L"interactive",                     config.interactive);
733         config.borderless               = ptree.get(L"borderless",                      config.borderless);
734
735         auto stretch_str = ptree.get(L"stretch", L"default");
736         if(stretch_str == L"uniform")
737                 config.stretch = screen::stretch::uniform;
738         else if(stretch_str == L"uniform_to_fill")
739                 config.stretch = screen::stretch::uniform_to_fill;
740
741         auto aspect_str = ptree.get(L"aspect-ratio", L"default");
742         if(aspect_str == L"16:9")
743                 config.aspect = configuration::aspect_ratio::aspect_16_9;
744         else if(aspect_str == L"4:3")
745                 config.aspect = configuration::aspect_ratio::aspect_4_3;
746
747         return spl::make_shared<screen_consumer_proxy>(config, sink);
748 }
749
750 }}