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., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, 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);
71 GType gst_video_overlay_get_type (void);
73 /* virtual function wrappers */
75 gboolean gst_video_overlay_set_render_rectangle (GstVideoOverlay * overlay,
81 void gst_video_overlay_expose (GstVideoOverlay * overlay);
83 void gst_video_overlay_handle_events (GstVideoOverlay * overlay,
84 gboolean handle_events);
86 void gst_video_overlay_set_window_handle (GstVideoOverlay * overlay,
89 /* public methods to dispatch bus messages */
90 void gst_video_overlay_got_window_handle (GstVideoOverlay * overlay,
93 void gst_video_overlay_prepare_window_handle (GstVideoOverlay * overlay);
95 gboolean gst_is_video_overlay_prepare_window_handle_message (GstMessage * msg);
99 #endif /* __GST_VIDEO_OVERLAY_H__ */