1 /* GStreamer Wayland video sink
3 * Copyright (C) 2011 Intel Corporation
4 * Copyright (C) 2011 Sreerenj Balachandran <sreerenj.balachandran@intel.com>
5 * Copyright (C) 2012 Wim Taymans <wim.taymans@gmail.com>
6 * Copyright (C) 2014 Collabora Ltd.
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the Free
20 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 * Boston, MA 02110-1301 USA.
25 * SECTION:element-waylandsink
27 * The waylandsink is creating its own window and render the decoded video frames to that.
28 * Setup the Wayland environment as described in
29 * <ulink url="http://wayland.freedesktop.org/building.html">Wayland</ulink> home page.
30 * The current implementaion is based on weston compositor.
33 * <title>Example pipelines</title>
35 * gst-launch -v videotestsrc ! waylandsink
36 * ]| test the video rendering in wayland
44 #include "gstwaylandsink.h"
45 #include "wlvideoformat.h"
46 #include "waylandpool.h"
48 #include <gst/wayland/wayland.h>
49 #include <gst/video/videooverlay.h>
65 GST_DEBUG_CATEGORY (gstwayland_debug);
66 #define GST_CAT_DEFAULT gstwayland_debug
68 #if G_BYTE_ORDER == G_BIG_ENDIAN
69 #define CAPS "{xRGB, ARGB}"
71 #define CAPS "{BGRx, BGRA}"
74 static GstStaticPadTemplate sink_template = GST_STATIC_PAD_TEMPLATE ("sink",
77 GST_STATIC_CAPS (GST_VIDEO_CAPS_MAKE (CAPS))
80 static void gst_wayland_sink_get_property (GObject * object,
81 guint prop_id, GValue * value, GParamSpec * pspec);
82 static void gst_wayland_sink_set_property (GObject * object,
83 guint prop_id, const GValue * value, GParamSpec * pspec);
84 static void gst_wayland_sink_finalize (GObject * object);
86 static GstStateChangeReturn gst_wayland_sink_change_state (GstElement * element,
87 GstStateChange transition);
89 static GstCaps *gst_wayland_sink_get_caps (GstBaseSink * bsink,
91 static gboolean gst_wayland_sink_set_caps (GstBaseSink * bsink, GstCaps * caps);
92 static gboolean gst_wayland_sink_preroll (GstBaseSink * bsink,
95 gst_wayland_sink_propose_allocation (GstBaseSink * bsink, GstQuery * query);
96 static gboolean gst_wayland_sink_render (GstBaseSink * bsink,
99 /* VideoOverlay interface */
100 static void gst_wayland_sink_videooverlay_init (GstVideoOverlayInterface *
102 static void gst_wayland_sink_set_window_handle (GstVideoOverlay * overlay,
104 static void gst_wayland_sink_expose (GstVideoOverlay * overlay);
106 /* WaylandVideo interface */
107 static void gst_wayland_sink_waylandvideo_init (GstWaylandVideoInterface *
109 static void gst_wayland_sink_set_surface_size (GstWaylandVideo * video,
111 static void gst_wayland_sink_pause_rendering (GstWaylandVideo * video);
112 static void gst_wayland_sink_resume_rendering (GstWaylandVideo * video);
114 #define gst_wayland_sink_parent_class parent_class
115 G_DEFINE_TYPE_WITH_CODE (GstWaylandSink, gst_wayland_sink, GST_TYPE_VIDEO_SINK,
116 G_IMPLEMENT_INTERFACE (GST_TYPE_VIDEO_OVERLAY,
117 gst_wayland_sink_videooverlay_init)
118 G_IMPLEMENT_INTERFACE (GST_TYPE_WAYLAND_VIDEO,
119 gst_wayland_sink_waylandvideo_init));
122 gst_wayland_sink_class_init (GstWaylandSinkClass * klass)
124 GObjectClass *gobject_class;
125 GstElementClass *gstelement_class;
126 GstBaseSinkClass *gstbasesink_class;
128 gobject_class = (GObjectClass *) klass;
129 gstelement_class = (GstElementClass *) klass;
130 gstbasesink_class = (GstBaseSinkClass *) klass;
132 gobject_class->set_property = gst_wayland_sink_set_property;
133 gobject_class->get_property = gst_wayland_sink_get_property;
134 gobject_class->finalize = GST_DEBUG_FUNCPTR (gst_wayland_sink_finalize);
136 gst_element_class_add_pad_template (gstelement_class,
137 gst_static_pad_template_get (&sink_template));
139 gst_element_class_set_static_metadata (gstelement_class,
140 "wayland video sink", "Sink/Video",
141 "Output to wayland surface",
142 "Sreerenj Balachandran <sreerenj.balachandran@intel.com>");
144 gstelement_class->change_state =
145 GST_DEBUG_FUNCPTR (gst_wayland_sink_change_state);
147 gstbasesink_class->get_caps = GST_DEBUG_FUNCPTR (gst_wayland_sink_get_caps);
148 gstbasesink_class->set_caps = GST_DEBUG_FUNCPTR (gst_wayland_sink_set_caps);
149 gstbasesink_class->preroll = GST_DEBUG_FUNCPTR (gst_wayland_sink_preroll);
150 gstbasesink_class->propose_allocation =
151 GST_DEBUG_FUNCPTR (gst_wayland_sink_propose_allocation);
152 gstbasesink_class->render = GST_DEBUG_FUNCPTR (gst_wayland_sink_render);
154 g_object_class_install_property (gobject_class, PROP_DISPLAY,
155 g_param_spec_string ("display", "Wayland Display name", "Wayland "
156 "display name to connect to, if not supplied with GstVideoOverlay",
157 NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
161 gst_wayland_sink_init (GstWaylandSink * sink)
163 g_cond_init (&sink->render_cond);
167 gst_wayland_sink_get_property (GObject * object,
168 guint prop_id, GValue * value, GParamSpec * pspec)
170 GstWaylandSink *sink = GST_WAYLAND_SINK (object);
174 g_value_set_string (value, sink->display_name);
177 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
183 gst_wayland_sink_set_property (GObject * object,
184 guint prop_id, const GValue * value, GParamSpec * pspec)
186 GstWaylandSink *sink = GST_WAYLAND_SINK (object);
190 sink->display_name = g_value_dup_string (value);
193 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
199 gst_wayland_sink_finalize (GObject * object)
201 GstWaylandSink *sink = GST_WAYLAND_SINK (object);
203 GST_DEBUG_OBJECT (sink, "Finalizing the sink..");
206 /* see comment about this call in gst_wayland_sink_change_state() */
207 gst_wayland_compositor_release_all_buffers (GST_WAYLAND_BUFFER_POOL
209 g_object_unref (sink->display);
212 g_object_unref (sink->window);
214 gst_object_unref (sink->pool);
216 if (sink->display_name)
217 g_free (sink->display_name);
219 g_cond_clear (&sink->render_cond);
221 G_OBJECT_CLASS (parent_class)->finalize (object);
224 static GstStateChangeReturn
225 gst_wayland_sink_change_state (GstElement * element, GstStateChange transition)
227 GstWaylandSink *sink = GST_WAYLAND_SINK (element);
228 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
230 switch (transition) {
231 case GST_STATE_CHANGE_READY_TO_PAUSED:
233 gst_video_overlay_prepare_window_handle (GST_VIDEO_OVERLAY (sink));
239 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
240 if (ret == GST_STATE_CHANGE_FAILURE)
243 switch (transition) {
244 case GST_STATE_CHANGE_PAUSED_TO_READY:
245 if (gst_wl_window_is_toplevel (sink->window)) {
246 /* Force all buffers to return to the pool, regardless of
247 * whether the compositor has released them or not. We are
248 * going to kill the display, so we need to return all buffers
249 * to be destroyed before this happens.
250 * Note that this is done here instead of the pool destructor
251 * because the buffers hold a reference to the pool. Also,
252 * the buffers can only be unref'ed from the display's event loop
253 * and the pool holds a reference to the display. If we drop
254 * our references here, when the compositor releases the buffers,
255 * they will be unref'ed from the event loop thread, which will
256 * unref the pool and therefore the display, which will try to
257 * stop the thread from within itself and cause a deadlock.
259 gst_wayland_compositor_release_all_buffers (GST_WAYLAND_BUFFER_POOL
261 g_clear_object (&sink->window);
262 g_clear_object (&sink->display);
263 g_clear_object (&sink->pool);
274 gst_wayland_sink_get_caps (GstBaseSink * bsink, GstCaps * filter)
276 GstWaylandSink *sink;
280 sink = GST_WAYLAND_SINK (bsink);
282 caps = gst_pad_get_pad_template_caps (GST_VIDEO_SINK_PAD (sink));
284 /* If we don't have a window yet, it will
285 * be created using the upstream size.
286 * Otherwise, we should tell upstream exactly
287 * what size we want. We don't resize ourselves. */
289 caps = gst_caps_make_writable (caps);
290 gst_wl_window_get_size (sink->window, &width, &height);
291 gst_caps_set_simple (caps, "width", G_TYPE_INT, width,
292 "height", G_TYPE_INT, height, NULL);
296 GstCaps *intersection;
299 gst_caps_intersect_full (filter, caps, GST_CAPS_INTERSECT_FIRST);
300 gst_caps_unref (caps);
307 gst_wayland_sink_set_caps (GstBaseSink * bsink, GstCaps * caps)
309 GstWaylandSink *sink;
310 GstBufferPool *newpool;
312 GError *error = NULL;
313 enum wl_shm_format format;
316 GstStructure *structure;
317 static GstAllocationParams params = { 0, 0, 0, 15, };
319 sink = GST_WAYLAND_SINK (bsink);
320 GST_OBJECT_LOCK (sink);
322 GST_DEBUG_OBJECT (sink, "set caps %" GST_PTR_FORMAT, caps);
324 /* extract info from caps */
325 if (!gst_video_info_from_caps (&info, caps))
328 format = gst_video_format_to_wayland_format (GST_VIDEO_INFO_FORMAT (&info));
332 /* store the video size */
333 sink->video_width = info.width;
334 sink->video_height = info.height;
336 /* create the output window if needed */
337 if (!sink->window || sink->video_width != sink->window->width ||
338 sink->video_height != sink->window->height) {
341 sink->display = gst_wl_display_new (sink->display_name, &error);
343 if (sink->display == NULL)
346 g_clear_object (&sink->window);
347 sink->window = gst_wl_window_new_toplevel (sink->display, sink->video_width,
351 /* verify we support the requested format */
352 formats = sink->display->formats;
353 for (i = 0; i < formats->len; i++) {
354 if (g_array_index (formats, uint32_t, i) == format)
358 if (i >= formats->len)
359 goto unsupported_format;
361 /* create a new pool for the new configuration */
362 newpool = gst_wayland_buffer_pool_new (sink->display);
366 structure = gst_buffer_pool_get_config (newpool);
367 gst_buffer_pool_config_set_params (structure, caps, info.size, 2, 0);
368 gst_buffer_pool_config_set_allocator (structure, NULL, ¶ms);
369 if (!gst_buffer_pool_set_config (newpool, structure))
372 gst_object_replace ((GstObject **) & sink->pool, (GstObject *) newpool);
373 gst_object_unref (newpool);
375 sink->negotiated = TRUE;
376 GST_OBJECT_UNLOCK (sink);
381 GST_DEBUG_OBJECT (sink,
382 "Could not locate image format from caps %" GST_PTR_FORMAT, caps);
387 GST_ELEMENT_ERROR (sink, RESOURCE, OPEN_READ_WRITE,
388 ("Could not initialise Wayland output"),
389 ("Failed to create GstWlDisplay: '%s'", error->message));
390 g_error_free (error);
395 GST_DEBUG_OBJECT (sink, "Format %s is not available on the display",
396 gst_wayland_format_to_string (format));
401 GST_DEBUG_OBJECT (sink, "Failed to create new pool");
406 GST_DEBUG_OBJECT (bsink, "failed setting config");
411 GST_OBJECT_UNLOCK (sink);
417 gst_wayland_sink_propose_allocation (GstBaseSink * bsink, GstQuery * query)
419 GstWaylandSink *sink = GST_WAYLAND_SINK (bsink);
420 GstBufferPool *pool = NULL;
421 GstStructure *config;
426 gst_query_parse_allocation (query, &caps, &need_pool);
432 pool = gst_object_ref (sink->pool);
437 /* we had a pool, check caps */
438 config = gst_buffer_pool_get_config (pool);
439 gst_buffer_pool_config_get_params (config, &pcaps, &size, NULL, NULL);
441 if (!gst_caps_is_equal (caps, pcaps)) {
442 /* different caps, we can't use this pool */
443 gst_object_unref (pool);
446 gst_structure_free (config);
449 if (pool == NULL && need_pool) {
452 if (!gst_video_info_from_caps (&info, caps))
455 GST_DEBUG_OBJECT (sink, "create new pool");
456 pool = gst_wayland_buffer_pool_new (sink->display);
458 /* the normal size of a frame */
461 config = gst_buffer_pool_get_config (pool);
462 gst_buffer_pool_config_set_params (config, caps, size, 2, 0);
463 if (!gst_buffer_pool_set_config (pool, config))
467 gst_query_add_allocation_pool (query, pool, size, 2, 0);
468 gst_object_unref (pool);
476 GST_DEBUG_OBJECT (bsink, "no caps specified");
481 GST_DEBUG_OBJECT (bsink, "invalid caps specified");
486 GST_DEBUG_OBJECT (bsink, "failed setting config");
487 gst_object_unref (pool);
493 gst_wayland_sink_preroll (GstBaseSink * bsink, GstBuffer * buffer)
495 GST_DEBUG_OBJECT (bsink, "preroll buffer %p", buffer);
496 return gst_wayland_sink_render (bsink, buffer);
500 frame_redraw_callback (void *data, struct wl_callback *callback, uint32_t time)
502 GstWaylandSink *sink = data;
504 GST_LOG ("frame_redraw_cb");
506 g_atomic_int_set (&sink->redraw_pending, FALSE);
507 wl_callback_destroy (callback);
510 static const struct wl_callback_listener frame_callback_listener = {
511 frame_redraw_callback
515 gst_wayland_sink_render (GstBaseSink * bsink, GstBuffer * buffer)
517 GstWaylandSink *sink = GST_WAYLAND_SINK (bsink);
518 GstVideoRectangle src, dst, res;
519 GstBuffer *to_render;
521 GstFlowReturn ret = GST_FLOW_OK;
522 struct wl_surface *surface;
523 struct wl_callback *callback;
525 GST_OBJECT_LOCK (sink);
527 GST_LOG_OBJECT (sink, "render buffer %p", buffer);
529 /* surface is resizing - drop buffers until finished */
530 if (sink->drawing_frozen || !sink->negotiated)
533 /* drop buffers until we get a frame callback */
534 if (g_atomic_int_get (&sink->redraw_pending) == TRUE)
537 meta = gst_buffer_get_wl_meta (buffer);
539 if (meta && meta->pool->display == sink->display) {
540 GST_LOG_OBJECT (sink, "buffer %p from our pool, writing directly", buffer);
544 GST_LOG_OBJECT (sink, "buffer %p not from our pool, copying", buffer);
549 if (!gst_buffer_pool_set_active (sink->pool, TRUE))
550 goto activate_failed;
552 ret = gst_buffer_pool_acquire_buffer (sink->pool, &to_render, NULL);
553 if (ret != GST_FLOW_OK)
556 gst_buffer_map (buffer, &src, GST_MAP_READ);
557 gst_buffer_fill (to_render, 0, src.data, src.size);
558 gst_buffer_unmap (buffer, &src);
560 meta = gst_buffer_get_wl_meta (to_render);
563 src.w = sink->video_width;
564 src.h = sink->video_height;
565 dst.w = sink->window->width;
566 dst.h = sink->window->height;
568 gst_video_sink_center_rect (src, dst, &res, FALSE);
570 surface = gst_wl_window_get_wl_surface (sink->window);
572 /* Here we essentially add a reference to the buffer. This represents
573 * the fact that the compositor is using the buffer and it should
574 * not return back to the pool and be reused until the compositor
575 * releases it. The release is handled internally in the pool */
576 gst_wayland_compositor_acquire_buffer (meta->pool, to_render);
578 g_atomic_int_set (&sink->redraw_pending, TRUE);
580 wl_surface_attach (surface, meta->wbuffer, 0, 0);
581 wl_surface_damage (surface, 0, 0, res.w, res.h);
582 callback = wl_surface_frame (surface);
583 wl_callback_add_listener (callback, &frame_callback_listener, sink);
584 wl_surface_commit (surface);
585 wl_display_flush (sink->display->display);
587 /* notify _resume_rendering() in case it's waiting */
588 g_cond_broadcast (&sink->render_cond);
590 if (buffer != to_render)
591 gst_buffer_unref (to_render);
596 GST_WARNING_OBJECT (sink, "could not create image");
601 GST_ELEMENT_ERROR (sink, RESOURCE, WRITE,
602 ("Internal error: can't allocate images"),
603 ("We don't have a bufferpool negotiated"));
604 ret = GST_FLOW_ERROR;
609 GST_ERROR_OBJECT (sink, "failed to activate bufferpool.");
610 ret = GST_FLOW_ERROR;
615 GST_OBJECT_UNLOCK (sink);
621 gst_wayland_sink_videooverlay_init (GstVideoOverlayInterface * iface)
623 iface->set_window_handle = gst_wayland_sink_set_window_handle;
624 iface->expose = gst_wayland_sink_expose;
628 gst_wayland_sink_set_window_handle (GstVideoOverlay * overlay, guintptr handle)
630 GstWaylandSink *sink = GST_WAYLAND_SINK (overlay);
631 GstWaylandWindowHandle *whandle = (GstWaylandWindowHandle *) handle;
632 GError *error = NULL;
635 g_return_if_fail (sink != NULL);
637 GST_DEBUG_OBJECT (sink, "Setting window handle %" GST_PTR_FORMAT,
640 if (GST_STATE (sink) > GST_STATE_READY)
641 gst_wayland_sink_pause_rendering (GST_WAYLAND_VIDEO (sink));
643 g_clear_object (&sink->window);
644 g_clear_object (&sink->display);
648 gst_wl_display_new_existing (whandle->display, FALSE, &error);
650 GST_ELEMENT_WARNING (sink, RESOURCE, OPEN_READ_WRITE,
651 ("Could not set window handle"),
652 ("Failed to use the external wayland display: '%s'", error->message));
653 g_error_free (error);
655 sink->window = gst_wl_window_new_from_surface (sink->display,
656 whandle->surface, whandle->width, whandle->height);
659 /* reconfigure to force creation of new window in set_caps */
660 sink->negotiated = FALSE;
661 peer = gst_pad_get_peer (GST_VIDEO_SINK_PAD (sink));
663 gst_pad_send_event (peer, gst_event_new_reconfigure ());
664 gst_object_unref (peer);
668 if (GST_STATE (sink) > GST_STATE_READY)
669 gst_wayland_sink_resume_rendering (GST_WAYLAND_VIDEO (sink));
673 gst_wayland_sink_expose (GstVideoOverlay * overlay)
675 GstWaylandSink *sink = GST_WAYLAND_SINK (overlay);
676 g_return_if_fail (sink != NULL);
680 gst_wayland_sink_waylandvideo_init (GstWaylandVideoInterface * iface)
682 iface->set_surface_size = gst_wayland_sink_set_surface_size;
683 iface->pause_rendering = gst_wayland_sink_pause_rendering;
684 iface->resume_rendering = gst_wayland_sink_resume_rendering;
688 gst_wayland_sink_set_surface_size (GstWaylandVideo * video, gint w, gint h)
690 GstWaylandSink *sink = GST_WAYLAND_SINK (video);
693 g_return_if_fail (sink != NULL);
694 g_return_if_fail (sink->window != NULL);
696 GST_OBJECT_LOCK (sink);
698 GST_OBJECT_UNLOCK (sink);
699 GST_WARNING_OBJECT (sink,
700 "set_surface_size called without window, ignoring");
704 gst_wl_window_set_size (sink->window, w, h);
705 sink->negotiated = FALSE;
706 GST_OBJECT_UNLOCK (sink);
708 /* upstream must change video size because we can't resize ourselves.
709 * This can be removed when we move to wl_viewport */
710 if (GST_STATE (sink) > GST_STATE_READY) {
711 peer = gst_pad_get_peer (GST_VIDEO_SINK_PAD (sink));
713 gst_pad_send_event (peer, gst_event_new_reconfigure ());
714 gst_object_unref (peer);
720 gst_wayland_sink_pause_rendering (GstWaylandVideo * video)
722 GstWaylandSink *sink = GST_WAYLAND_SINK (video);
723 g_return_if_fail (sink != NULL);
725 GST_OBJECT_LOCK (sink);
726 sink->drawing_frozen = TRUE;
727 GST_OBJECT_UNLOCK (sink);
731 gst_wayland_sink_resume_rendering (GstWaylandVideo * video)
733 GstWaylandSink *sink = GST_WAYLAND_SINK (video);
734 g_return_if_fail (sink != NULL);
736 GST_OBJECT_LOCK (sink);
737 sink->drawing_frozen = FALSE;
738 g_cond_wait (&sink->render_cond, GST_OBJECT_GET_LOCK (sink));
739 GST_OBJECT_UNLOCK (sink);
743 plugin_init (GstPlugin * plugin)
745 GST_DEBUG_CATEGORY_INIT (gstwayland_debug, "waylandsink", 0,
746 " wayland video sink");
748 return gst_element_register (plugin, "waylandsink", GST_RANK_MARGINAL,
749 GST_TYPE_WAYLAND_SINK);
752 GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
755 "Wayland Video Sink", plugin_init, VERSION, "LGPL", GST_PACKAGE_NAME,