3 * Copyright (C) 2015 Matthew Waters <matthew@centricular.com>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
18 * Boston, MA 02110-1301, USA.
22 * SECTION:gstgtkglsink
30 #include "gstgtkglsink.h"
32 GST_DEBUG_CATEGORY (gst_debug_gtk_gl_sink);
33 #define GST_CAT_DEFAULT gst_debug_gtk_gl_sink
35 #define DEFAULT_FORCE_ASPECT_RATIO TRUE
36 #define DEFAULT_PAR_N 0
37 #define DEFAULT_PAR_D 1
38 #define DEFAULT_IGNORE_ALPHA TRUE
40 static void gst_gtk_gl_sink_finalize (GObject * object);
41 static void gst_gtk_gl_sink_set_property (GObject * object, guint prop_id,
42 const GValue * value, GParamSpec * param_spec);
43 static void gst_gtk_gl_sink_get_property (GObject * object, guint prop_id,
44 GValue * value, GParamSpec * param_spec);
46 static gboolean gst_gtk_gl_sink_stop (GstBaseSink * bsink);
48 static gboolean gst_gtk_gl_sink_query (GstBaseSink * bsink, GstQuery * query);
50 static GstStateChangeReturn
51 gst_gtk_gl_sink_change_state (GstElement * element, GstStateChange transition);
53 static void gst_gtk_gl_sink_get_times (GstBaseSink * bsink, GstBuffer * buf,
54 GstClockTime * start, GstClockTime * end);
55 static gboolean gst_gtk_gl_sink_set_caps (GstBaseSink * bsink, GstCaps * caps);
56 static GstFlowReturn gst_gtk_gl_sink_show_frame (GstVideoSink * bsink,
58 static gboolean gst_gtk_gl_sink_propose_allocation (GstBaseSink * bsink,
61 static GstStaticPadTemplate gst_gtk_gl_sink_template =
62 GST_STATIC_PAD_TEMPLATE ("sink",
65 GST_STATIC_CAPS (GST_VIDEO_CAPS_MAKE_WITH_FEATURES
66 (GST_CAPS_FEATURE_MEMORY_GL_MEMORY, "RGBA")));
72 PROP_FORCE_ASPECT_RATIO,
73 PROP_PIXEL_ASPECT_RATIO,
83 #define gst_gtk_gl_sink_parent_class parent_class
84 G_DEFINE_TYPE_WITH_CODE (GstGtkGLSink, gst_gtk_gl_sink,
85 GST_TYPE_VIDEO_SINK, GST_DEBUG_CATEGORY_INIT (gst_debug_gtk_gl_sink,
86 "gtkglsink", 0, "Gtk Video Sink"));
89 gst_gtk_gl_sink_class_init (GstGtkGLSinkClass * klass)
91 GObjectClass *gobject_class;
92 GstElementClass *gstelement_class;
93 GstBaseSinkClass *gstbasesink_class;
94 GstVideoSinkClass *gstvideosink_class;
96 gobject_class = (GObjectClass *) klass;
97 gstelement_class = (GstElementClass *) klass;
98 gstbasesink_class = (GstBaseSinkClass *) klass;
99 gstvideosink_class = (GstVideoSinkClass *) klass;
101 gobject_class->set_property = gst_gtk_gl_sink_set_property;
102 gobject_class->get_property = gst_gtk_gl_sink_get_property;
104 gst_element_class_set_metadata (gstelement_class, "Gtk Video Sink",
105 "Sink/Video", "A video sink that renders to a GtkWidget",
106 "Matthew Waters <matthew@centricular.com>");
108 g_object_class_install_property (gobject_class, PROP_WIDGET,
109 g_param_spec_object ("widget", "Gtk Widget",
110 "The GtkWidget to place in the widget heirachy",
111 GTK_TYPE_WIDGET, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
113 g_object_class_install_property (gobject_class, PROP_FORCE_ASPECT_RATIO,
114 g_param_spec_boolean ("force-aspect-ratio",
115 "Force aspect ratio",
116 "When enabled, scaling will respect original aspect ratio",
117 DEFAULT_FORCE_ASPECT_RATIO,
118 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
120 g_object_class_install_property (gobject_class, PROP_PIXEL_ASPECT_RATIO,
121 gst_param_spec_fraction ("pixel-aspect-ratio", "Pixel Aspect Ratio",
122 "The pixel aspect ratio of the device", DEFAULT_PAR_N, DEFAULT_PAR_D,
123 G_MAXINT, 1, 1, 1, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
125 g_object_class_install_property (gobject_class, PROP_IGNORE_ALPHA,
126 g_param_spec_boolean ("ignore-alpha", "Ignore Alpha",
127 "When enabled, alpha will be ignored and converted to black",
128 DEFAULT_IGNORE_ALPHA, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
130 gst_element_class_add_pad_template (gstelement_class,
131 gst_static_pad_template_get (&gst_gtk_gl_sink_template));
133 gobject_class->finalize = gst_gtk_gl_sink_finalize;
135 gstelement_class->change_state = gst_gtk_gl_sink_change_state;
136 gstbasesink_class->query = gst_gtk_gl_sink_query;
137 gstbasesink_class->set_caps = gst_gtk_gl_sink_set_caps;
138 gstbasesink_class->get_times = gst_gtk_gl_sink_get_times;
139 gstbasesink_class->propose_allocation = gst_gtk_gl_sink_propose_allocation;
140 gstbasesink_class->stop = gst_gtk_gl_sink_stop;
142 gstvideosink_class->show_frame = gst_gtk_gl_sink_show_frame;
146 gst_gtk_gl_sink_init (GstGtkGLSink * gtk_sink)
148 gtk_sink->force_aspect_ratio = DEFAULT_FORCE_ASPECT_RATIO;
149 gtk_sink->par_n = DEFAULT_PAR_N;
150 gtk_sink->par_d = DEFAULT_PAR_D;
151 gtk_sink->ignore_alpha = DEFAULT_IGNORE_ALPHA;
155 gst_gtk_gl_sink_finalize (GObject * object)
157 GstGtkGLSink *gtk_sink = GST_GTK_GL_SINK (object);;
159 g_object_unref (gtk_sink->widget);
161 G_OBJECT_CLASS (parent_class)->finalize (object);
164 static GtkGstGLWidget *
165 gst_gtk_gl_sink_get_widget (GstGtkGLSink * gtk_sink)
167 if (gtk_sink->widget != NULL)
168 return gtk_sink->widget;
170 /* Ensure GTK is initialized, this has no side effect if it was already
171 * initialized. Also, we do that lazily, so the application can be first */
172 if (!gtk_init_check (NULL, NULL)) {
173 GST_ERROR_OBJECT (gtk_sink, "Could not ensure GTK initialization.");
177 gtk_sink->widget = (GtkGstGLWidget *) gtk_gst_gl_widget_new ();
178 gtk_sink->bind_force_aspect_ratio =
179 g_object_bind_property (gtk_sink, "force-aspect-ratio", gtk_sink->widget,
180 "force-aspect-ratio", G_BINDING_BIDIRECTIONAL | G_BINDING_SYNC_CREATE);
181 gtk_sink->bind_pixel_aspect_ratio =
182 g_object_bind_property (gtk_sink, "pixel-aspect-ratio", gtk_sink->widget,
183 "pixel-aspect-ratio", G_BINDING_BIDIRECTIONAL | G_BINDING_SYNC_CREATE);
184 gtk_sink->bind_ignore_alpha =
185 g_object_bind_property (gtk_sink, "ignore-alpha", gtk_sink->widget,
186 "ignore-alpha", G_BINDING_BIDIRECTIONAL | G_BINDING_SYNC_CREATE);
188 /* Take the floating ref, otherwise the destruction of the container will
189 * make this widget disapear possibly before we are done. */
190 gst_object_ref_sink (gtk_sink->widget);
192 return gtk_sink->widget;
196 gst_gtk_gl_sink_get_property (GObject * object, guint prop_id,
197 GValue * value, GParamSpec * pspec)
199 GstGtkGLSink *gtk_sink;
201 gtk_sink = GST_GTK_GL_SINK (object);
205 g_value_set_object (value, gst_gtk_gl_sink_get_widget (gtk_sink));
207 case PROP_FORCE_ASPECT_RATIO:
208 g_value_set_boolean (value, gtk_sink->force_aspect_ratio);
210 case PROP_PIXEL_ASPECT_RATIO:
211 gst_value_set_fraction (value, gtk_sink->par_n, gtk_sink->par_d);
213 case PROP_IGNORE_ALPHA:
214 g_value_set_boolean (value, gtk_sink->ignore_alpha);
217 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
223 gst_gtk_gl_sink_set_property (GObject * object, guint prop_id,
224 const GValue * value, GParamSpec * pspec)
226 GstGtkGLSink *gtk_sink = GST_GTK_GL_SINK (object);
229 case PROP_FORCE_ASPECT_RATIO:
230 gtk_sink->force_aspect_ratio = g_value_get_boolean (value);
232 case PROP_PIXEL_ASPECT_RATIO:
233 gtk_sink->par_n = gst_value_get_fraction_numerator (value);
234 gtk_sink->par_d = gst_value_get_fraction_denominator (value);
236 case PROP_IGNORE_ALPHA:
237 gtk_sink->ignore_alpha = g_value_get_boolean (value);
240 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
246 gst_gtk_gl_sink_query (GstBaseSink * bsink, GstQuery * query)
248 GstGtkGLSink *gtk_sink = GST_GTK_GL_SINK (bsink);
249 gboolean res = FALSE;
251 switch (GST_QUERY_TYPE (query)) {
252 case GST_QUERY_CONTEXT:
254 const gchar *context_type;
255 GstContext *context, *old_context;
258 ret = gst_gl_handle_context_query ((GstElement *) gtk_sink, query,
259 >k_sink->display, >k_sink->gtk_context);
261 if (gtk_sink->display)
262 gst_gl_display_filter_gl_api (gtk_sink->display, GST_GL_API_OPENGL3);
264 gst_query_parse_context_type (query, &context_type);
266 if (g_strcmp0 (context_type, "gst.gl.local_context") == 0) {
269 gst_query_parse_context (query, &old_context);
272 context = gst_context_copy (old_context);
274 context = gst_context_new ("gst.gl.local_context", FALSE);
276 s = gst_context_writable_structure (context);
277 gst_structure_set (s, "context", GST_GL_TYPE_CONTEXT, gtk_sink->context,
279 gst_query_set_context (query, context);
280 gst_context_unref (context);
282 ret = gtk_sink->context != NULL;
284 GST_LOG_OBJECT (gtk_sink, "context query of type %s %i", context_type,
291 res = GST_BASE_SINK_CLASS (parent_class)->query (bsink, query);
299 gst_gtk_gl_sink_stop (GstBaseSink * bsink)
304 static GstStateChangeReturn
305 gst_gtk_gl_sink_change_state (GstElement * element, GstStateChange transition)
307 GstGtkGLSink *gtk_sink = GST_GTK_GL_SINK (element);
308 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
310 GST_DEBUG ("changing state: %s => %s",
311 gst_element_state_get_name (GST_STATE_TRANSITION_CURRENT (transition)),
312 gst_element_state_get_name (GST_STATE_TRANSITION_NEXT (transition)));
314 switch (transition) {
315 case GST_STATE_CHANGE_NULL_TO_READY:
316 if (gst_gtk_gl_sink_get_widget (gtk_sink) == NULL)
317 return GST_STATE_CHANGE_FAILURE;
319 /* After this point, gtk_sink->widget will always be set */
321 if (!gtk_widget_get_parent (GTK_WIDGET (gtk_sink->widget))) {
322 GST_ERROR_OBJECT (gtk_sink,
323 "gtkglsink widget needs to be parented to work.");
324 return GST_STATE_CHANGE_FAILURE;
327 if (!gtk_gst_gl_widget_init_winsys (gtk_sink->widget))
328 return GST_STATE_CHANGE_FAILURE;
330 gtk_sink->display = gtk_gst_gl_widget_get_display (gtk_sink->widget);
331 gtk_sink->context = gtk_gst_gl_widget_get_context (gtk_sink->widget);
332 gtk_sink->gtk_context =
333 gtk_gst_gl_widget_get_gtk_context (gtk_sink->widget);
335 if (!gtk_sink->display || !gtk_sink->context || !gtk_sink->gtk_context)
336 return GST_STATE_CHANGE_FAILURE;
338 case GST_STATE_CHANGE_READY_TO_PAUSED:
340 case GST_STATE_CHANGE_PAUSED_TO_PLAYING:
346 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
347 if (ret == GST_STATE_CHANGE_FAILURE)
350 switch (transition) {
351 case GST_STATE_CHANGE_PLAYING_TO_PAUSED:
353 case GST_STATE_CHANGE_PAUSED_TO_READY:
354 gtk_gst_gl_widget_set_buffer (gtk_sink->widget, NULL);
356 case GST_STATE_CHANGE_READY_TO_NULL:
357 if (gtk_sink->display) {
358 gst_object_unref (gtk_sink->display);
359 gtk_sink->display = NULL;
362 if (gtk_sink->context) {
363 gst_object_unref (gtk_sink->context);
364 gtk_sink->context = NULL;
367 if (gtk_sink->gtk_context) {
368 gst_object_unref (gtk_sink->gtk_context);
369 gtk_sink->gtk_context = NULL;
380 gst_gtk_gl_sink_get_times (GstBaseSink * bsink, GstBuffer * buf,
381 GstClockTime * start, GstClockTime * end)
383 GstGtkGLSink *gtk_sink;
385 gtk_sink = GST_GTK_GL_SINK (bsink);
387 if (GST_BUFFER_TIMESTAMP_IS_VALID (buf)) {
388 *start = GST_BUFFER_TIMESTAMP (buf);
389 if (GST_BUFFER_DURATION_IS_VALID (buf))
390 *end = *start + GST_BUFFER_DURATION (buf);
392 if (GST_VIDEO_INFO_FPS_N (>k_sink->v_info) > 0) {
394 gst_util_uint64_scale_int (GST_SECOND,
395 GST_VIDEO_INFO_FPS_D (>k_sink->v_info),
396 GST_VIDEO_INFO_FPS_N (>k_sink->v_info));
403 gst_gtk_gl_sink_set_caps (GstBaseSink * bsink, GstCaps * caps)
405 GstGtkGLSink *gtk_sink = GST_GTK_GL_SINK (bsink);
407 GST_DEBUG ("set caps with %" GST_PTR_FORMAT, caps);
409 if (!gst_video_info_from_caps (>k_sink->v_info, caps))
412 if (!gtk_gst_gl_widget_set_caps (gtk_sink->widget, caps))
419 gst_gtk_gl_sink_show_frame (GstVideoSink * vsink, GstBuffer * buf)
421 GstGtkGLSink *gtk_sink;
423 GST_TRACE ("rendering buffer:%p", buf);
425 gtk_sink = GST_GTK_GL_SINK (vsink);
427 gtk_gst_gl_widget_set_buffer (gtk_sink->widget, buf);
433 gst_gtk_gl_sink_propose_allocation (GstBaseSink * bsink, GstQuery * query)
435 GstGtkGLSink *gtk_sink = GST_GTK_GL_SINK (bsink);
437 GstStructure *config;
442 if (!gtk_sink->display || !gtk_sink->context)
445 gst_query_parse_allocation (query, &caps, &need_pool);
450 if ((pool = gtk_sink->pool))
451 gst_object_ref (pool);
456 /* we had a pool, check caps */
457 GST_DEBUG_OBJECT (gtk_sink, "check existing pool caps");
458 config = gst_buffer_pool_get_config (pool);
459 gst_buffer_pool_config_get_params (config, &pcaps, &size, NULL, NULL);
461 if (!gst_caps_is_equal (caps, pcaps)) {
462 GST_DEBUG_OBJECT (gtk_sink, "pool has different caps");
463 /* different caps, we can't use this pool */
464 gst_object_unref (pool);
467 gst_structure_free (config);
470 if (pool == NULL && need_pool) {
473 if (!gst_video_info_from_caps (&info, caps))
476 GST_DEBUG_OBJECT (gtk_sink, "create new pool");
477 pool = gst_gl_buffer_pool_new (gtk_sink->context);
479 /* the normal size of a frame */
482 config = gst_buffer_pool_get_config (pool);
483 gst_buffer_pool_config_set_params (config, caps, size, 0, 0);
484 if (!gst_buffer_pool_set_config (pool, config))
487 /* we need at least 2 buffer because we hold on to the last one */
489 gst_query_add_allocation_pool (query, pool, size, 2, 0);
490 gst_object_unref (pool);
493 /* we also support various metadata */
494 gst_query_add_allocation_meta (query, GST_VIDEO_META_API_TYPE, 0);
496 if (gtk_sink->context->gl_vtable->FenceSync)
497 gst_query_add_allocation_meta (query, GST_GL_SYNC_META_API_TYPE, 0);
504 GST_DEBUG_OBJECT (bsink, "no caps specified");
509 GST_DEBUG_OBJECT (bsink, "invalid caps specified");
514 GST_DEBUG_OBJECT (bsink, "failed setting config");