1 /* GStreamer
2 * Copyright (C) 2006 David A. Schleef <ds@schleef.org>
3 * Copyright (C) 2007,2009 Sebastian Dröge <sebastian.droege@collabora.co.uk>
4 *
5 * gstvideoparse.c:
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
16 *
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
20 * Boston, MA 02110-1301, USA.
21 */
22 /**
23 * SECTION:element-videoparse
24 * @title: videoparse
25 *
26 * Converts a byte stream into video frames.
27 *
28 * > This element is deprecated. Use #GstRawVideoParse instead.
29 */
30
31 #ifdef HAVE_CONFIG_H
32 # include "config.h"
33 #endif
34
35 /* FIXME 0.11: suppress warnings for deprecated API such as g_value_array stuff
36 * for now with newer GLib versions (>= 2.31.0) */
37 #define GLIB_DISABLE_DEPRECATION_WARNINGS
38
39 #include <gst/gst.h>
40 #include <gst/video/video.h>
41 #include "gstvideoparse.h"
42
43 static GstStaticPadTemplate static_sink_template =
44 GST_STATIC_PAD_TEMPLATE ("sink",
45 GST_PAD_SINK,
46 GST_PAD_ALWAYS,
47 GST_STATIC_CAPS_ANY);
48
49 static GstStaticPadTemplate static_src_template =
50 GST_STATIC_PAD_TEMPLATE ("src",
51 GST_PAD_SRC,
52 GST_PAD_ALWAYS,
53 GST_STATIC_CAPS ("video/x-raw")
54 );
55
56 static void gst_video_parse_set_property (GObject * object, guint prop_id,
57 const GValue * value, GParamSpec * pspec);
58 static void gst_video_parse_get_property (GObject * object, guint prop_id,
59 GValue * value, GParamSpec * pspec);
60
61 static gboolean gst_video_parse_int_valarray_from_string (const gchar *
62 str, GValue * valarray);
63 static gchar *gst_video_parse_int_valarray_to_string (GValue * valarray);
64
65 GST_DEBUG_CATEGORY_STATIC (gst_video_parse_debug);
66 #define GST_CAT_DEFAULT gst_video_parse_debug
67
68 enum
69 {
70 PROP_0,
71 PROP_FORMAT,
72 PROP_WIDTH,
73 PROP_HEIGHT,
74 PROP_PAR,
75 PROP_FRAMERATE,
76 PROP_INTERLACED,
77 PROP_TOP_FIELD_FIRST,
78 PROP_STRIDES,
79 PROP_OFFSETS,
80 PROP_FRAMESIZE
81 };
82
83 #define gst_video_parse_parent_class parent_class
84 G_DEFINE_TYPE (GstVideoParse, gst_video_parse, GST_TYPE_BIN);
85 GST_ELEMENT_REGISTER_DEFINE (videoparse, "videoparse", GST_RANK_NONE,
86 gst_video_parse_get_type ());
87
88 static void
gst_video_parse_class_init(GstVideoParseClass * klass)89 gst_video_parse_class_init (GstVideoParseClass * klass)
90 {
91 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
92 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
93
94 gobject_class->set_property = gst_video_parse_set_property;
95 gobject_class->get_property = gst_video_parse_get_property;
96
97 g_object_class_install_property (gobject_class, PROP_FORMAT,
98 g_param_spec_enum ("format", "Format", "Format of images in raw stream",
99 GST_TYPE_VIDEO_FORMAT, GST_VIDEO_FORMAT_I420,
100 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
101 g_object_class_install_property (gobject_class, PROP_WIDTH,
102 g_param_spec_int ("width", "Width", "Width of images in raw stream",
103 0, INT_MAX, 320, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
104 g_object_class_install_property (gobject_class, PROP_HEIGHT,
105 g_param_spec_int ("height", "Height", "Height of images in raw stream",
106 0, INT_MAX, 240, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
107 g_object_class_install_property (gobject_class, PROP_FRAMERATE,
108 gst_param_spec_fraction ("framerate", "Frame Rate",
109 "Frame rate of images in raw stream", 0, 1, G_MAXINT, 1, 25, 1,
110 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
111 g_object_class_install_property (gobject_class, PROP_PAR,
112 gst_param_spec_fraction ("pixel-aspect-ratio", "Pixel Aspect Ratio",
113 "Pixel aspect ratio of images in raw stream", 1, 100, 100, 1, 1, 1,
114 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
115 g_object_class_install_property (gobject_class, PROP_INTERLACED,
116 g_param_spec_boolean ("interlaced", "Interlaced flag",
117 "True if video is interlaced", FALSE,
118 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
119 g_object_class_install_property (gobject_class, PROP_TOP_FIELD_FIRST,
120 g_param_spec_boolean ("top-field-first", "Top field first",
121 "True if top field is earlier than bottom field", TRUE,
122 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
123 g_object_class_install_property (gobject_class, PROP_STRIDES,
124 g_param_spec_string ("strides", "Strides",
125 "Stride of each planes in bytes using string format: 's0,s1,s2,s3'",
126 NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
127 g_object_class_install_property (gobject_class, PROP_OFFSETS,
128 g_param_spec_string ("offsets", "Offsets",
129 "Offset of each planes in bytes using string format: 'o0,o1,o2,o3'",
130 NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
131 g_object_class_install_property (gobject_class, PROP_FRAMESIZE,
132 g_param_spec_uint ("framesize", "Framesize",
133 "Size of an image in raw stream (0: default)", 0, G_MAXUINT, 0,
134 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
135
136 gst_element_class_set_static_metadata (gstelement_class, "Video Parse",
137 "Filter/Video",
138 "Converts stream into video frames (deprecated: use rawvideoparse instead)",
139 "David Schleef <ds@schleef.org>, "
140 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
141
142 gst_element_class_add_pad_template (gstelement_class,
143 gst_static_pad_template_get (&static_sink_template));
144 gst_element_class_add_pad_template (gstelement_class,
145 gst_static_pad_template_get (&static_src_template));
146
147 GST_DEBUG_CATEGORY_INIT (gst_video_parse_debug, "videoparse", 0,
148 "videoparse element");
149 }
150
151 static void
gst_video_parse_init(GstVideoParse * vp)152 gst_video_parse_init (GstVideoParse * vp)
153 {
154 GstPad *inner_pad;
155 GstPad *ghostpad;
156
157 vp->rawvideoparse =
158 gst_element_factory_make ("rawvideoparse", "inner_rawvideoparse");
159 g_assert (vp->rawvideoparse != NULL);
160
161 gst_bin_add (GST_BIN (vp), vp->rawvideoparse);
162
163 inner_pad = gst_element_get_static_pad (vp->rawvideoparse, "sink");
164 ghostpad =
165 gst_ghost_pad_new_from_template ("sink", inner_pad,
166 gst_element_class_get_pad_template (GST_ELEMENT_GET_CLASS (vp), "sink"));
167 gst_element_add_pad (GST_ELEMENT (vp), ghostpad);
168 gst_object_unref (GST_OBJECT (inner_pad));
169
170 inner_pad = gst_element_get_static_pad (vp->rawvideoparse, "src");
171 ghostpad =
172 gst_ghost_pad_new_from_template ("src", inner_pad,
173 gst_element_class_get_pad_template (GST_ELEMENT_GET_CLASS (vp), "src"));
174 gst_element_add_pad (GST_ELEMENT (vp), ghostpad);
175 gst_object_unref (GST_OBJECT (inner_pad));
176 }
177
178 static void
gst_video_parse_set_property(GObject * object,guint prop_id,const GValue * value,GParamSpec * pspec)179 gst_video_parse_set_property (GObject * object, guint prop_id,
180 const GValue * value, GParamSpec * pspec)
181 {
182 GstVideoParse *vp = GST_VIDEO_PARSE (object);
183
184 switch (prop_id) {
185 case PROP_FORMAT:
186 g_object_set (G_OBJECT (vp->rawvideoparse), "format",
187 g_value_get_enum (value), NULL);
188 break;
189
190 case PROP_WIDTH:
191 g_object_set (G_OBJECT (vp->rawvideoparse), "width",
192 g_value_get_int (value), NULL);
193 break;
194
195 case PROP_HEIGHT:
196 g_object_set (G_OBJECT (vp->rawvideoparse), "height",
197 g_value_get_int (value), NULL);
198 break;
199
200 case PROP_FRAMERATE:
201 g_object_set (G_OBJECT (vp->rawvideoparse), "framerate",
202 gst_value_get_fraction_numerator (value),
203 gst_value_get_fraction_denominator (value), NULL);
204 break;
205
206 case PROP_PAR:
207 g_object_set (G_OBJECT (vp->rawvideoparse), "pixel-aspect-ratio",
208 gst_value_get_fraction_numerator (value),
209 gst_value_get_fraction_denominator (value), NULL);
210 break;
211
212 case PROP_INTERLACED:
213 g_object_set (G_OBJECT (vp->rawvideoparse), "interlaced",
214 g_value_get_boolean (value), NULL);
215 break;
216
217 case PROP_TOP_FIELD_FIRST:
218 g_object_set (G_OBJECT (vp->rawvideoparse), "top-field-first",
219 g_value_get_boolean (value), NULL);
220 break;
221
222 case PROP_STRIDES:{
223 GValue valarray = G_VALUE_INIT;
224
225 if (gst_video_parse_int_valarray_from_string (g_value_get_string (value),
226 &valarray)) {
227 g_object_set (G_OBJECT (vp->rawvideoparse), "plane-strides",
228 &valarray, NULL);
229 g_value_unset (&valarray);
230 } else {
231 GST_WARNING_OBJECT (vp, "failed to deserialize given strides");
232 }
233
234 break;
235 }
236
237 case PROP_OFFSETS:{
238 GValue valarray = G_VALUE_INIT;
239
240 if (gst_video_parse_int_valarray_from_string (g_value_get_string (value),
241 &valarray)) {
242 g_object_set (G_OBJECT (vp->rawvideoparse), "plane-offsets",
243 valarray, NULL);
244 g_value_unset (&valarray);
245 } else {
246 GST_WARNING_OBJECT (vp, "failed to deserialize given offsets");
247 }
248
249 break;
250 }
251
252 case PROP_FRAMESIZE:
253 g_object_set (G_OBJECT (vp->rawvideoparse), "frame-size",
254 g_value_get_uint (value), NULL);
255 break;
256
257 default:
258 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
259 break;
260 }
261 }
262
263 static void
gst_video_parse_get_property(GObject * object,guint prop_id,GValue * value,GParamSpec * pspec)264 gst_video_parse_get_property (GObject * object, guint prop_id, GValue * value,
265 GParamSpec * pspec)
266 {
267 GstVideoParse *vp = GST_VIDEO_PARSE (object);
268
269 switch (prop_id) {
270 case PROP_FORMAT:{
271 GstVideoFormat format;
272 g_object_get (G_OBJECT (vp->rawvideoparse), "format", &format, NULL);
273 g_value_set_enum (value, format);
274 break;
275 }
276
277 case PROP_WIDTH:{
278 gint width;
279 g_object_get (G_OBJECT (vp->rawvideoparse), "width", &width, NULL);
280 g_value_set_int (value, width);
281 break;
282 }
283
284 case PROP_HEIGHT:{
285 gint height;
286 g_object_get (G_OBJECT (vp->rawvideoparse), "height", &height, NULL);
287 g_value_set_int (value, height);
288 break;
289 }
290
291 case PROP_FRAMERATE:{
292 gint fps_n, fps_d;
293 g_object_get (G_OBJECT (vp->rawvideoparse), "framerate", &fps_n, &fps_d,
294 NULL);
295 gst_value_set_fraction (value, fps_n, fps_d);
296 break;
297 }
298
299 case PROP_PAR:{
300 gint par_n, par_d;
301 g_object_get (G_OBJECT (vp->rawvideoparse), "pixel-aspect-ratio", &par_n,
302 &par_d, NULL);
303 gst_value_set_fraction (value, par_n, par_d);
304 break;
305 }
306
307 case PROP_INTERLACED:{
308 gboolean interlaced;
309 g_object_get (G_OBJECT (vp->rawvideoparse), "interlaced", &interlaced,
310 NULL);
311 g_value_set_boolean (value, interlaced);
312 break;
313 }
314
315 case PROP_TOP_FIELD_FIRST:{
316 gboolean top_field_first;
317 g_object_get (G_OBJECT (vp->rawvideoparse), "top-field-first",
318 &top_field_first, NULL);
319 g_value_set_boolean (value, top_field_first);
320 break;
321 }
322
323 case PROP_STRIDES:{
324 GValue array = { 0, };
325
326 g_value_init (&array, GST_TYPE_ARRAY);
327 g_object_get_property (G_OBJECT (vp->rawvideoparse), "plane-strides",
328 &array);
329 g_value_take_string (value,
330 gst_video_parse_int_valarray_to_string (&array));
331 break;
332 }
333
334 case PROP_OFFSETS:{
335 GValue array = { 0, };
336
337 g_value_init (&array, GST_TYPE_ARRAY);
338 g_object_get_property (G_OBJECT (vp->rawvideoparse), "plane-offsets",
339 &array);
340 g_value_take_string (value,
341 gst_video_parse_int_valarray_to_string (&array));
342 break;
343 }
344
345 case PROP_FRAMESIZE:{
346 guint frame_size;
347 g_object_get (G_OBJECT (vp->rawvideoparse), "frame-size", &frame_size,
348 NULL);
349 g_value_set_uint (value, frame_size);
350 break;
351 }
352
353 default:
354 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
355 break;
356 }
357 }
358
359 static gboolean
gst_video_parse_int_valarray_from_string(const gchar * str,GValue * valarray)360 gst_video_parse_int_valarray_from_string (const gchar * str, GValue * valarray)
361 {
362 gchar **strv;
363 guint length;
364 guint i;
365 GValue gvalue = G_VALUE_INIT;
366
367 if (str == NULL)
368 return FALSE;
369
370 strv = g_strsplit (str, ",", GST_VIDEO_MAX_PLANES);
371 if (strv == NULL)
372 return FALSE;
373
374 length = g_strv_length (strv);
375 g_value_init (valarray, GST_TYPE_ARRAY);
376 g_value_init (&gvalue, G_TYPE_UINT);
377
378 for (i = 0; i < length; i++) {
379 gint64 val;
380
381 val = g_ascii_strtoll (strv[i], NULL, 10);
382 if (val < G_MININT || val > G_MAXINT) {
383 goto error;
384 }
385
386 g_value_set_uint (&gvalue, val);
387 gst_value_array_append_value (valarray, &gvalue);
388 }
389
390 g_strfreev (strv);
391 return TRUE;
392
393 error:
394 return FALSE;
395 }
396
397 static gchar *
gst_video_parse_int_valarray_to_string(GValue * valarray)398 gst_video_parse_int_valarray_to_string (GValue * valarray)
399 {
400 /* holds a 64-bit number as string, which can have max. 20 digits
401 * (with extra char for nullbyte) */
402 gchar stride_str[21];
403 gchar *str = NULL;
404 guint i;
405
406 for (i = 0; i < gst_value_array_get_size (valarray); i++) {
407 const GValue *gvalue = gst_value_array_get_value (valarray, i);
408 guint val;
409
410 val = g_value_get_int (gvalue);
411 g_snprintf (stride_str, sizeof (stride_str), "%u", val);
412
413 if (str == NULL) {
414 str = g_strdup (stride_str);
415 } else {
416 gchar *new_str = g_strdup_printf ("%s,%s", str, stride_str);
417 g_free (str);
418 str = new_str;
419 }
420 }
421
422 return str;
423 }
424