1 /* GStreamer Video Overlay interface
95  * As #playbin and #playsink implement the video overlay interface and proxy
149  *    GstVideoOverlay *overlay;
152  *    overlay = GST_VIDEO_OVERLAY (GST_MESSAGE_SRC (message));
153  *    gst_video_overlay_set_window_handle (overlay, video_window_handle);
332  * @overlay: a #GstVideoOverlay to set the window on.
335  * This will call the video overlay's set_window_handle method. You
336  * should use this method to tell to an overlay to display video output to a
338  * tell the overlay to stop using that window and create an internal one.
341 gst_video_overlay_set_window_handle (GstVideoOverlay * overlay, guintptr handle)  in gst_video_overlay_set_window_handle()  argument
345   g_return_if_fail (overlay != NULL);  in gst_video_overlay_set_window_handle()
346   g_return_if_fail (GST_IS_VIDEO_OVERLAY (overlay));  in gst_video_overlay_set_window_handle()
348   iface = GST_VIDEO_OVERLAY_GET_INTERFACE (overlay);  in gst_video_overlay_set_window_handle()
351     iface->set_window_handle (overlay, handle);  in gst_video_overlay_set_window_handle()
357  * @overlay: a #GstVideoOverlay which got a window
362  * This function should only be used by video overlay plugin developers.
365 gst_video_overlay_got_window_handle (GstVideoOverlay * overlay, guintptr handle)  in gst_video_overlay_got_window_handle()  argument
370   g_return_if_fail (overlay != NULL);  in gst_video_overlay_got_window_handle()
371   g_return_if_fail (GST_IS_VIDEO_OVERLAY (overlay));  in gst_video_overlay_got_window_handle()
373   GST_LOG_OBJECT (GST_OBJECT (overlay), "window_handle = %p", (gpointer)  in gst_video_overlay_got_window_handle()
377   msg = gst_message_new_element (GST_OBJECT (overlay), s);  in gst_video_overlay_got_window_handle()
378   gst_element_post_message (GST_ELEMENT (overlay), msg);  in gst_video_overlay_got_window_handle()
383  * @overlay: a #GstVideoOverlay which does not yet have an Window handle set
390  * This function should only be used by video overlay plugin developers.
393 gst_video_overlay_prepare_window_handle (GstVideoOverlay * overlay)  in gst_video_overlay_prepare_window_handle()  argument
398   g_return_if_fail (overlay != NULL);  in gst_video_overlay_prepare_window_handle()
399   g_return_if_fail (GST_IS_VIDEO_OVERLAY (overlay));  in gst_video_overlay_prepare_window_handle()
401   GST_LOG_OBJECT (GST_OBJECT (overlay), "prepare window handle");  in gst_video_overlay_prepare_window_handle()
403   msg = gst_message_new_element (GST_OBJECT (overlay), s);  in gst_video_overlay_prepare_window_handle()
404   gst_element_post_message (GST_ELEMENT (overlay), msg);  in gst_video_overlay_prepare_window_handle()
409  * @overlay: a #GstVideoOverlay to expose.
411  * Tell an overlay that it has been exposed. This will redraw the current frame
415 gst_video_overlay_expose (GstVideoOverlay * overlay)  in gst_video_overlay_expose()  argument
419   g_return_if_fail (overlay != NULL);  in gst_video_overlay_expose()
420   g_return_if_fail (GST_IS_VIDEO_OVERLAY (overlay));  in gst_video_overlay_expose()
422   iface = GST_VIDEO_OVERLAY_GET_INTERFACE (overlay);  in gst_video_overlay_expose()
425     iface->expose (overlay);  in gst_video_overlay_expose()
431  * @overlay: a #GstVideoOverlay to expose.
434  * Tell an overlay that it should handle events from the window system. These
441 gst_video_overlay_handle_events (GstVideoOverlay * overlay,  in gst_video_overlay_handle_events()  argument
446   g_return_if_fail (overlay != NULL);  in gst_video_overlay_handle_events()
447   g_return_if_fail (GST_IS_VIDEO_OVERLAY (overlay));  in gst_video_overlay_handle_events()
449   iface = GST_VIDEO_OVERLAY_GET_INTERFACE (overlay);  in gst_video_overlay_handle_events()
452     iface->handle_events (overlay, handle_events);  in gst_video_overlay_handle_events()
458  * @overlay: a #GstVideoOverlay
466  * the video will fill the area of the window set as the overlay to 100%.
472  * This method is needed for non fullscreen video overlay in UI toolkits that
478 gst_video_overlay_set_render_rectangle (GstVideoOverlay * overlay,  in gst_video_overlay_set_render_rectangle()  argument
483   g_return_val_if_fail (overlay != NULL, FALSE);  in gst_video_overlay_set_render_rectangle()
484   g_return_val_if_fail (GST_IS_VIDEO_OVERLAY (overlay), FALSE);  in gst_video_overlay_set_render_rectangle()
488   iface = GST_VIDEO_OVERLAY_GET_INTERFACE (overlay);  in gst_video_overlay_set_render_rectangle()
491     iface->set_render_rectangle (overlay, x, y, width, height);  in gst_video_overlay_set_render_rectangle()