1 /*
2  * Copyright (C) 2014 Collabora Ltd.
3  *     Author: Nicolas Dufresne <nicolas.dufresne@collabora.co.uk>
4  *
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.
9  *
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.
14  *
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.
19  *
20  */
21 
22 #ifndef __V4L2_UTILS_H__
23 #define __V4L2_UTILS_H__
24 
25 #include <gst/gst.h>
26 
27 G_BEGIN_DECLS
28 
29 #define GST_V4L2_ERROR_INIT { NULL, NULL }
30 #define GST_V4L2_ERROR(v4l2err,domain,code,msg,dbg) \
31 {\
32   if (v4l2err) { \
33     gchar *_msg = _gst_element_error_printf msg; \
34     v4l2err->error = g_error_new_literal (GST_##domain##_ERROR, \
35         GST_##domain##_ERROR_##code, _msg); \
36     g_free (_msg); \
37     v4l2err->dbg_message = _gst_element_error_printf dbg; \
38     v4l2err->file = __FILE__; \
39     v4l2err->func = GST_FUNCTION; \
40     v4l2err->line = __LINE__; \
41   } \
42 }
43 
44 /**
45  * GST_V4L2_IS_M2M:
46  * @_dcaps: The device capabilities
47  *
48  * Checks if the device caps represent an M2M device. Note that modern M2M
49  * devices uses V4L2_CAP_VIDEO_M2M* flag, but legacy uses to set both CAPTURE
50  * and OUTPUT flags instead.
51  *
52  * Returns: %TRUE if this is a M2M device.
53  */
54 #define GST_V4L2_IS_M2M(_dcaps) \
55   (((_dcaps) & (V4L2_CAP_VIDEO_M2M | V4L2_CAP_VIDEO_M2M_MPLANE)) ||\
56             (((_dcaps) & \
57                     (V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_VIDEO_CAPTURE_MPLANE)) && \
58                 ((_dcaps) & \
59                     (V4L2_CAP_VIDEO_OUTPUT | V4L2_CAP_VIDEO_OUTPUT_MPLANE))))
60 
61 
62 typedef struct _GstV4l2Iterator GstV4l2Iterator;
63 typedef struct _GstV4l2Error GstV4l2Error;
64 
65 struct _GstV4l2Iterator
66 {
67     const gchar *device_path;
68     const gchar *device_name;
69     const gchar *sys_path;
70 };
71 
72 struct _GstV4l2Error
73 {
74     GError *error;
75     gchar *dbg_message;
76     const gchar *file;
77     const gchar *func;
78     gint line;
79 };
80 
81 GstV4l2Iterator *  gst_v4l2_iterator_new (void);
82 gboolean           gst_v4l2_iterator_next (GstV4l2Iterator *it);
83 void               gst_v4l2_iterator_free (GstV4l2Iterator *it);
84 
85 const gchar *      gst_v4l2_iterator_get_device_path (GstV4l2Iterator *it);
86 const gchar *      gst_v4l2_iterator_get_device_name (GstV4l2Iterator *it);
87 const gchar *      gst_v4l2_iterator_get_sys_path (GstV4l2Iterator *it);
88 
89 void               gst_v4l2_clear_error (GstV4l2Error *error);
90 void               gst_v4l2_error (gpointer element, GstV4l2Error *error);
91 
92 G_END_DECLS
93 
94 #endif /* __V4L2_UTILS_H__ */
95 
96 
97