1 /* GStreamer Video Overlay Interface
2 * Copyright (C) 2003 Ronald Bultje <rbultje@ronald.bitfreak.net>
3 * Copyright (C) 2003 Julien Moutte <julien@moutte.net>
4 * Copyright (C) 2011 Tim-Philipp Müller <tim@centricular.net>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library 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 GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
22 #ifndef __GST_VIDEO_OVERLAY_H__
23 #define __GST_VIDEO_OVERLAY_H__
29 #define GST_TYPE_VIDEO_OVERLAY \
30 (gst_video_overlay_get_type ())
31 #define GST_VIDEO_OVERLAY(obj) \
32 (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_VIDEO_OVERLAY, GstVideoOverlay))
33 #define GST_IS_VIDEO_OVERLAY(obj) \
34 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_VIDEO_OVERLAY))
35 #define GST_VIDEO_OVERLAY_GET_INTERFACE(inst) \
36 (G_TYPE_INSTANCE_GET_INTERFACE ((inst), GST_TYPE_VIDEO_OVERLAY, GstVideoOverlayInterface))
41 * Opaque #GstVideoOverlay interface structure
43 typedef struct _GstVideoOverlay GstVideoOverlay;
44 typedef struct _GstVideoOverlayInterface GstVideoOverlayInterface;
47 * GstVideoOverlayInterface:
48 * @iface: parent interface type.
49 * @expose: virtual method to handle expose events
50 * @handle_events: virtual method to handle events
51 * @set_render_rectangle: virtual method to set the render rectangle
52 * @set_window_handle: virtual method to configure the window handle
54 * #GstVideoOverlay interface
56 struct _GstVideoOverlayInterface {
59 /* virtual functions */
60 void (*expose) (GstVideoOverlay *overlay);
62 void (*handle_events) (GstVideoOverlay *overlay, gboolean handle_events);
64 void (*set_render_rectangle) (GstVideoOverlay *overlay,
66 gint width, gint height);
68 void (*set_window_handle) (GstVideoOverlay *overlay, guintptr handle);
70 void (*set_wl_window_wl_surface_id) (GstVideoOverlay * overlay, gint wl_surface_id);
72 void (*set_display_roi_area) (GstVideoOverlay *overlay,
74 gint width, gint height);
76 void (*set_video_roi_area) (GstVideoOverlay *overlay,
77 gdouble x_scale, gdouble y_scale,
78 gdouble w_scale, gdouble h_scale);
81 GType gst_video_overlay_get_type (void);
83 /* virtual function wrappers */
85 gboolean gst_video_overlay_set_render_rectangle (GstVideoOverlay * overlay,
91 void gst_video_overlay_expose (GstVideoOverlay * overlay);
93 void gst_video_overlay_handle_events (GstVideoOverlay * overlay,
94 gboolean handle_events);
96 void gst_video_overlay_set_window_handle (GstVideoOverlay * overlay,
99 /* public methods to dispatch bus messages */
100 void gst_video_overlay_got_window_handle (GstVideoOverlay * overlay,
103 void gst_video_overlay_prepare_window_handle (GstVideoOverlay * overlay);
105 gboolean gst_is_video_overlay_prepare_window_handle_message (GstMessage * msg);
107 void gst_video_overlay_set_wl_window_wl_surface_id (GstVideoOverlay * overlay,
110 gboolean gst_video_overlay_set_display_roi_area (GstVideoOverlay * overlay,
112 gint width, gint height);
113 gboolean gst_video_overlay_set_video_roi_area (GstVideoOverlay * overlay,
114 gdouble x_scale, gdouble y_scale,
115 gdouble w_scale, gdouble h_scale);
119 #endif /* __GST_VIDEO_OVERLAY_H__ */