update for allocation query changes
[platform/upstream/gstreamer.git] / sys / v4l2 / gstv4l2src.c
1 /* GStreamer
2  *
3  * Copyright (C) 2001-2002 Ronald Bultje <rbultje@ronald.bitfreak.net>
4  *               2006 Edgard Lima <edgard.lima@indt.org.br>
5  *
6  * gstv4l2src.c: Video4Linux2 source element
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Library General Public
10  * License as published by the Free Software Foundation; either
11  * version 2 of the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Library General Public License for more details.
17  *
18  * You should have received a copy of the GNU Library General Public
19  * License along with this library; if not, write to the
20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21  * Boston, MA 02111-1307, USA.
22  */
23
24 /**
25  * SECTION:element-v4l2src
26  *
27  * v4l2src can be used to capture video from v4l2 devices, like webcams and tv
28  * cards.
29  *
30  * <refsect2>
31  * <title>Example launch lines</title>
32  * |[
33  * gst-launch v4l2src ! xvimagesink
34  * ]| This pipeline shows the video captured from /dev/video0 tv card and for
35  * webcams.
36  * |[
37  * gst-launch v4l2src ! jpegdec ! xvimagesink
38  * ]| This pipeline shows the video captured from a webcam that delivers jpeg
39  * images.
40  * </refsect2>
41  */
42
43 #ifdef HAVE_CONFIG_H
44 #include <config.h>
45 #endif
46
47 #undef HAVE_XVIDEO
48
49 #include <string.h>
50 #include <sys/time.h>
51 #include <unistd.h>
52
53 #include "gst/video/gstvideometa.h"
54 #include "gst/video/gstvideopool.h"
55
56 #include "gstv4l2src.h"
57
58 #include "gstv4l2colorbalance.h"
59 #include "gstv4l2tuner.h"
60 #ifdef HAVE_XVIDEO
61 #include "gstv4l2xoverlay.h"
62 #endif
63 #include "gstv4l2vidorient.h"
64
65 #include "gst/gst-i18n-plugin.h"
66
67 GST_DEBUG_CATEGORY (v4l2src_debug);
68 #define GST_CAT_DEFAULT v4l2src_debug
69
70 #define PROP_DEF_ALWAYS_COPY        TRUE
71 #define PROP_DEF_DECIMATE           1
72
73 #define DEFAULT_PROP_DEVICE   "/dev/video0"
74
75 enum
76 {
77   PROP_0,
78   V4L2_STD_OBJECT_PROPS,
79   PROP_ALWAYS_COPY,
80   PROP_DECIMATE
81 };
82
83 GST_IMPLEMENT_V4L2_COLOR_BALANCE_METHODS (GstV4l2Src, gst_v4l2src);
84 GST_IMPLEMENT_V4L2_TUNER_METHODS (GstV4l2Src, gst_v4l2src);
85 #ifdef HAVE_XVIDEO
86 GST_IMPLEMENT_V4L2_XOVERLAY_METHODS (GstV4l2Src, gst_v4l2src);
87 #endif
88 GST_IMPLEMENT_V4L2_VIDORIENT_METHODS (GstV4l2Src, gst_v4l2src);
89
90 static void gst_v4l2src_uri_handler_init (gpointer g_iface,
91     gpointer iface_data);
92
93 #define gst_v4l2src_parent_class parent_class
94 G_DEFINE_TYPE_WITH_CODE (GstV4l2Src, gst_v4l2src, GST_TYPE_PUSH_SRC,
95     G_IMPLEMENT_INTERFACE (GST_TYPE_URI_HANDLER, gst_v4l2src_uri_handler_init);
96     G_IMPLEMENT_INTERFACE (GST_TYPE_TUNER, gst_v4l2src_tuner_interface_init);
97 #ifdef HAVE_XVIDEO
98     /* FIXME: does GstXOverlay for v4l2src make sense in a GStreamer context? */
99     G_IMPLEMENT_INTERFACE (GST_TYPE_X_OVERLAY,
100         gst_v4l2src_xoverlay_interface_init);
101 #endif
102     G_IMPLEMENT_INTERFACE (GST_TYPE_COLOR_BALANCE,
103         gst_v4l2src_color_balance_interface_init);
104     G_IMPLEMENT_INTERFACE (GST_TYPE_VIDEO_ORIENTATION,
105         gst_v4l2src_video_orientation_interface_init));
106
107 static void gst_v4l2src_dispose (GObject * object);
108 static void gst_v4l2src_finalize (GstV4l2Src * v4l2src);
109
110 /* element methods */
111 static GstStateChangeReturn gst_v4l2src_change_state (GstElement * element,
112     GstStateChange transition);
113
114 /* basesrc methods */
115 static gboolean gst_v4l2src_start (GstBaseSrc * src);
116 static gboolean gst_v4l2src_unlock (GstBaseSrc * src);
117 static gboolean gst_v4l2src_unlock_stop (GstBaseSrc * src);
118 static gboolean gst_v4l2src_stop (GstBaseSrc * src);
119 static gboolean gst_v4l2src_set_caps (GstBaseSrc * src, GstCaps * caps);
120 static GstCaps *gst_v4l2src_get_caps (GstBaseSrc * src, GstCaps * filter);
121 static gboolean gst_v4l2src_query (GstBaseSrc * bsrc, GstQuery * query);
122 static gboolean gst_v4l2src_decide_allocation (GstBaseSrc * src,
123     GstQuery * query);
124 static GstFlowReturn gst_v4l2src_fill (GstPushSrc * src, GstBuffer * out);
125 static GstCaps *gst_v4l2src_fixate (GstBaseSrc * basesrc, GstCaps * caps);
126 static gboolean gst_v4l2src_negotiate (GstBaseSrc * basesrc);
127
128 static void gst_v4l2src_set_property (GObject * object, guint prop_id,
129     const GValue * value, GParamSpec * pspec);
130 static void gst_v4l2src_get_property (GObject * object, guint prop_id,
131     GValue * value, GParamSpec * pspec);
132
133 static void
134 gst_v4l2src_class_init (GstV4l2SrcClass * klass)
135 {
136   GObjectClass *gobject_class;
137   GstElementClass *element_class;
138   GstBaseSrcClass *basesrc_class;
139   GstPushSrcClass *pushsrc_class;
140
141   gobject_class = G_OBJECT_CLASS (klass);
142   element_class = GST_ELEMENT_CLASS (klass);
143   basesrc_class = GST_BASE_SRC_CLASS (klass);
144   pushsrc_class = GST_PUSH_SRC_CLASS (klass);
145
146   gobject_class->dispose = gst_v4l2src_dispose;
147   gobject_class->finalize = (GObjectFinalizeFunc) gst_v4l2src_finalize;
148   gobject_class->set_property = gst_v4l2src_set_property;
149   gobject_class->get_property = gst_v4l2src_get_property;
150
151   element_class->change_state = gst_v4l2src_change_state;
152
153   gst_v4l2_object_install_properties_helper (gobject_class,
154       DEFAULT_PROP_DEVICE);
155   g_object_class_install_property (gobject_class, PROP_ALWAYS_COPY,
156       g_param_spec_boolean ("always-copy", "Always Copy",
157           "If the buffer will or not be used directly from mmap",
158           PROP_DEF_ALWAYS_COPY, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
159   /**
160    * GstV4l2Src:decimate
161    *
162    * Only use every nth frame
163    *
164    * Since: 0.10.26
165    */
166   g_object_class_install_property (gobject_class, PROP_DECIMATE,
167       g_param_spec_int ("decimate", "Decimate",
168           "Only use every nth frame", 1, G_MAXINT,
169           PROP_DEF_DECIMATE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
170
171   gst_element_class_set_details_simple (element_class,
172       "Video (video4linux2) Source", "Source/Video",
173       "Reads frames from a Video4Linux2 device",
174       "Edgard Lima <edgard.lima@indt.org.br>, "
175       "Stefan Kost <ensonic@users.sf.net>");
176
177   gst_element_class_add_pad_template
178       (element_class,
179       gst_pad_template_new ("src", GST_PAD_SRC, GST_PAD_ALWAYS,
180           gst_v4l2_object_get_all_caps ()));
181
182   basesrc_class->get_caps = GST_DEBUG_FUNCPTR (gst_v4l2src_get_caps);
183   basesrc_class->set_caps = GST_DEBUG_FUNCPTR (gst_v4l2src_set_caps);
184   basesrc_class->start = GST_DEBUG_FUNCPTR (gst_v4l2src_start);
185   basesrc_class->unlock = GST_DEBUG_FUNCPTR (gst_v4l2src_unlock);
186   basesrc_class->unlock_stop = GST_DEBUG_FUNCPTR (gst_v4l2src_unlock_stop);
187   basesrc_class->stop = GST_DEBUG_FUNCPTR (gst_v4l2src_stop);
188   basesrc_class->query = GST_DEBUG_FUNCPTR (gst_v4l2src_query);
189   basesrc_class->fixate = GST_DEBUG_FUNCPTR (gst_v4l2src_fixate);
190   basesrc_class->negotiate = GST_DEBUG_FUNCPTR (gst_v4l2src_negotiate);
191   basesrc_class->decide_allocation =
192       GST_DEBUG_FUNCPTR (gst_v4l2src_decide_allocation);
193
194   pushsrc_class->fill = GST_DEBUG_FUNCPTR (gst_v4l2src_fill);
195
196   klass->v4l2_class_devices = NULL;
197
198   GST_DEBUG_CATEGORY_INIT (v4l2src_debug, "v4l2src", 0, "V4L2 source element");
199 }
200
201 static void
202 gst_v4l2src_init (GstV4l2Src * v4l2src)
203 {
204   /* fixme: give an update_fps_function */
205   v4l2src->v4l2object = gst_v4l2_object_new (GST_ELEMENT (v4l2src),
206       V4L2_BUF_TYPE_VIDEO_CAPTURE, DEFAULT_PROP_DEVICE,
207       gst_v4l2_get_input, gst_v4l2_set_input, NULL);
208
209   v4l2src->v4l2object->always_copy = PROP_DEF_ALWAYS_COPY;
210   v4l2src->decimate = PROP_DEF_DECIMATE;
211
212   gst_base_src_set_format (GST_BASE_SRC (v4l2src), GST_FORMAT_TIME);
213   gst_base_src_set_live (GST_BASE_SRC (v4l2src), TRUE);
214 }
215
216 static void
217 gst_v4l2src_dispose (GObject * object)
218 {
219   GstV4l2Src *v4l2src = GST_V4L2SRC (object);
220
221   if (v4l2src->probed_caps) {
222     gst_caps_unref (v4l2src->probed_caps);
223   }
224
225   G_OBJECT_CLASS (parent_class)->dispose (object);
226 }
227
228
229 static void
230 gst_v4l2src_finalize (GstV4l2Src * v4l2src)
231 {
232   gst_v4l2_object_destroy (v4l2src->v4l2object);
233
234   G_OBJECT_CLASS (parent_class)->finalize ((GObject *) (v4l2src));
235 }
236
237
238 static void
239 gst_v4l2src_set_property (GObject * object,
240     guint prop_id, const GValue * value, GParamSpec * pspec)
241 {
242   GstV4l2Src *v4l2src = GST_V4L2SRC (object);
243
244   if (!gst_v4l2_object_set_property_helper (v4l2src->v4l2object,
245           prop_id, value, pspec)) {
246     switch (prop_id) {
247       case PROP_ALWAYS_COPY:
248         v4l2src->v4l2object->always_copy = g_value_get_boolean (value);
249         break;
250       case PROP_DECIMATE:
251         v4l2src->decimate = g_value_get_int (value);
252         break;
253       default:
254         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
255         break;
256     }
257   }
258 }
259
260 static void
261 gst_v4l2src_get_property (GObject * object,
262     guint prop_id, GValue * value, GParamSpec * pspec)
263 {
264   GstV4l2Src *v4l2src = GST_V4L2SRC (object);
265
266   if (!gst_v4l2_object_get_property_helper (v4l2src->v4l2object,
267           prop_id, value, pspec)) {
268     switch (prop_id) {
269       case PROP_ALWAYS_COPY:
270         g_value_set_boolean (value, v4l2src->v4l2object->always_copy);
271         break;
272       case PROP_DECIMATE:
273         g_value_set_int (value, v4l2src->decimate);
274         break;
275       default:
276         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
277         break;
278     }
279   }
280 }
281
282 /* this function is a bit of a last resort */
283 static GstCaps *
284 gst_v4l2src_fixate (GstBaseSrc * basesrc, GstCaps * caps)
285 {
286   GstStructure *structure;
287   gint i;
288
289   GST_DEBUG_OBJECT (basesrc, "fixating caps %" GST_PTR_FORMAT, caps);
290
291   caps = gst_caps_make_writable (caps);
292
293   for (i = 0; i < gst_caps_get_size (caps); ++i) {
294     structure = gst_caps_get_structure (caps, i);
295
296     /* We are fixating to a resonable 320x200 resolution
297        and the maximum framerate resolution for that size */
298     gst_structure_fixate_field_nearest_int (structure, "width", 320);
299     gst_structure_fixate_field_nearest_int (structure, "height", 200);
300     gst_structure_fixate_field_nearest_fraction (structure, "framerate",
301         G_MAXINT, 1);
302     gst_structure_fixate_field (structure, "format");
303   }
304
305   GST_DEBUG_OBJECT (basesrc, "fixated caps %" GST_PTR_FORMAT, caps);
306
307   caps = GST_BASE_SRC_CLASS (parent_class)->fixate (basesrc, caps);
308
309   return caps;
310 }
311
312
313 static gboolean
314 gst_v4l2src_negotiate (GstBaseSrc * basesrc)
315 {
316   GstCaps *thiscaps;
317   GstCaps *caps = NULL;
318   GstCaps *peercaps = NULL;
319   gboolean result = FALSE;
320
321   /* first see what is possible on our source pad */
322   thiscaps = gst_pad_query_caps (GST_BASE_SRC_PAD (basesrc), NULL);
323   GST_DEBUG_OBJECT (basesrc, "caps of src: %" GST_PTR_FORMAT, thiscaps);
324   LOG_CAPS (basesrc, thiscaps);
325
326   /* nothing or anything is allowed, we're done */
327   if (thiscaps == NULL || gst_caps_is_any (thiscaps))
328     goto no_nego_needed;
329
330   /* get the peer caps */
331   peercaps = gst_pad_peer_query_caps (GST_BASE_SRC_PAD (basesrc), thiscaps);
332   GST_DEBUG_OBJECT (basesrc, "caps of peer: %" GST_PTR_FORMAT, peercaps);
333   LOG_CAPS (basesrc, peercaps);
334   if (peercaps && !gst_caps_is_any (peercaps)) {
335     GstCaps *icaps = NULL;
336     int i;
337
338     /* Prefer the first caps we are compatible with that the peer proposed */
339     for (i = 0; i < gst_caps_get_size (peercaps); i++) {
340       /* get intersection */
341       GstCaps *ipcaps = gst_caps_copy_nth (peercaps, i);
342
343       GST_DEBUG_OBJECT (basesrc, "peer: %" GST_PTR_FORMAT, ipcaps);
344       LOG_CAPS (basesrc, ipcaps);
345
346       icaps = gst_caps_intersect (thiscaps, ipcaps);
347       gst_caps_unref (ipcaps);
348
349       if (!gst_caps_is_empty (icaps))
350         break;
351
352       gst_caps_unref (icaps);
353       icaps = NULL;
354     }
355
356     GST_DEBUG_OBJECT (basesrc, "intersect: %" GST_PTR_FORMAT, icaps);
357     LOG_CAPS (basesrc, icaps);
358     if (icaps) {
359       /* If there are multiple intersections pick the one with the smallest
360        * resolution strictly bigger then the first peer caps */
361       if (gst_caps_get_size (icaps) > 1) {
362         GstStructure *s = gst_caps_get_structure (peercaps, 0);
363         int best = 0;
364         int twidth, theight;
365         int width = G_MAXINT, height = G_MAXINT;
366
367         if (gst_structure_get_int (s, "width", &twidth)
368             && gst_structure_get_int (s, "height", &theight)) {
369
370           /* Walk the structure backwards to get the first entry of the
371            * smallest resolution bigger (or equal to) the preferred resolution)
372            */
373           for (i = gst_caps_get_size (icaps) - 1; i >= 0; i--) {
374             GstStructure *is = gst_caps_get_structure (icaps, i);
375             int w, h;
376
377             if (gst_structure_get_int (is, "width", &w)
378                 && gst_structure_get_int (is, "height", &h)) {
379               if (w >= twidth && w <= width && h >= theight && h <= height) {
380                 width = w;
381                 height = h;
382                 best = i;
383               }
384             }
385           }
386         }
387
388         caps = gst_caps_copy_nth (icaps, best);
389         gst_caps_unref (icaps);
390       } else {
391         caps = icaps;
392       }
393     }
394     gst_caps_unref (thiscaps);
395   } else {
396     /* no peer or peer have ANY caps, work with our own caps then */
397     caps = thiscaps;
398   }
399   if (peercaps)
400     gst_caps_unref (peercaps);
401   if (caps) {
402     caps = gst_caps_truncate (caps);
403
404     /* now fixate */
405     if (!gst_caps_is_empty (caps)) {
406       caps = gst_v4l2src_fixate (basesrc, caps);
407       GST_DEBUG_OBJECT (basesrc, "fixated to: %" GST_PTR_FORMAT, caps);
408       LOG_CAPS (basesrc, caps);
409
410       if (gst_caps_is_any (caps)) {
411         /* hmm, still anything, so element can do anything and
412          * nego is not needed */
413         result = TRUE;
414       } else if (gst_caps_is_fixed (caps)) {
415         /* yay, fixed caps, use those then */
416         result = gst_base_src_set_caps (basesrc, caps);
417       }
418     }
419     gst_caps_unref (caps);
420   }
421   return result;
422
423 no_nego_needed:
424   {
425     GST_DEBUG_OBJECT (basesrc, "no negotiation needed");
426     if (thiscaps)
427       gst_caps_unref (thiscaps);
428     return TRUE;
429   }
430 }
431
432 static GstCaps *
433 gst_v4l2src_get_caps (GstBaseSrc * src, GstCaps * filter)
434 {
435   GstV4l2Src *v4l2src;
436   GstV4l2Object *obj;
437   GstCaps *ret;
438   GSList *walk;
439   GSList *formats;
440
441   v4l2src = GST_V4L2SRC (src);
442   obj = v4l2src->v4l2object;
443
444   if (!GST_V4L2_IS_OPEN (obj)) {
445     /* FIXME: copy? */
446     return
447         gst_caps_copy (gst_pad_get_pad_template_caps (GST_BASE_SRC_PAD
448             (v4l2src)));
449   }
450
451   if (v4l2src->probed_caps)
452     return gst_caps_ref (v4l2src->probed_caps);
453
454   formats = gst_v4l2_object_get_format_list (obj);
455
456   ret = gst_caps_new_empty ();
457
458   for (walk = formats; walk; walk = walk->next) {
459     struct v4l2_fmtdesc *format;
460     GstStructure *template;
461
462     format = (struct v4l2_fmtdesc *) walk->data;
463
464     template = gst_v4l2_object_v4l2fourcc_to_structure (format->pixelformat);
465
466     if (template) {
467       GstCaps *tmp;
468
469       tmp =
470           gst_v4l2_object_probe_caps_for_format (obj,
471           format->pixelformat, template);
472       if (tmp)
473         gst_caps_append (ret, tmp);
474
475       gst_structure_free (template);
476     } else {
477       GST_DEBUG_OBJECT (v4l2src, "unknown format %u", format->pixelformat);
478     }
479   }
480
481   v4l2src->probed_caps = gst_caps_ref (ret);
482
483   GST_INFO_OBJECT (v4l2src, "probed caps: %" GST_PTR_FORMAT, ret);
484
485   return ret;
486 }
487
488 static gboolean
489 gst_v4l2src_set_caps (GstBaseSrc * src, GstCaps * caps)
490 {
491   GstV4l2Src *v4l2src;
492   GstV4l2Object *obj;
493
494   v4l2src = GST_V4L2SRC (src);
495   obj = v4l2src->v4l2object;
496
497   /* make sure we stop capturing and dealloc buffers */
498   if (!gst_v4l2_object_stop (obj))
499     return FALSE;
500
501   if (!gst_v4l2_object_set_format (obj, caps))
502     /* error already posted */
503     return FALSE;
504
505   return TRUE;
506 }
507
508 static gboolean
509 gst_v4l2src_decide_allocation (GstBaseSrc * bsrc, GstQuery * query)
510 {
511   GstV4l2Src *src;
512   GstV4l2Object *obj;
513   GstBufferPool *pool;
514   guint size, min, max;
515   gboolean update;
516
517   src = GST_V4L2SRC (bsrc);
518   obj = src->v4l2object;
519
520   if (gst_query_get_n_allocation_pools (query) > 0) {
521     gst_query_parse_nth_allocation_pool (query, 0, &pool, &size, &min, &max);
522     update = TRUE;
523   } else {
524     pool = NULL;
525     min = max = 0;
526     size = 0;
527     update = FALSE;
528   }
529
530   GST_DEBUG_OBJECT (src, "allocation: size:%u min:%u max:%u pool:%"
531       GST_PTR_FORMAT, size, min, max, pool);
532
533   if (min != 0) {
534     /* if there is a min-buffers suggestion, use it. We add 1 because we need 1
535      * buffer extra to capture while the other two buffers are downstream */
536     min += 1;
537   } else {
538     min = 2;
539   }
540
541   /* select a pool */
542   switch (obj->mode) {
543     case GST_V4L2_IO_RW:
544       if (pool == NULL) {
545         /* no downstream pool, use our own then */
546         GST_DEBUG_OBJECT (src,
547             "read/write mode: no downstream pool, using our own");
548         pool = GST_BUFFER_POOL_CAST (obj->pool);
549         size = obj->sizeimage;
550       } else {
551         /* in READ/WRITE mode, prefer a downstream pool because our own pool
552          * doesn't help much, we have to write to it as well */
553         GST_DEBUG_OBJECT (src, "read/write mode: using downstream pool");
554         /* use the bigest size, when we use our own pool we can't really do any
555          * other size than what the hardware gives us but for downstream pools
556          * we can try */
557         size = MAX (size, obj->sizeimage);
558       }
559       break;
560     case GST_V4L2_IO_MMAP:
561     case GST_V4L2_IO_USERPTR:
562       /* in streaming mode, prefer our own pool */
563       pool = GST_BUFFER_POOL_CAST (obj->pool);
564       size = obj->sizeimage;
565       GST_DEBUG_OBJECT (src,
566           "streaming mode: using our own pool %" GST_PTR_FORMAT, pool);
567       break;
568     case GST_V4L2_IO_AUTO:
569     default:
570       GST_WARNING_OBJECT (src, "unhandled mode");
571       break;
572   }
573
574   if (pool) {
575     GstStructure *config;
576     const GstCaps *caps;
577
578     config = gst_buffer_pool_get_config (pool);
579     gst_buffer_pool_config_get (config, &caps, NULL, NULL, NULL, NULL, NULL,
580         NULL);
581     gst_buffer_pool_config_set (config, caps, size, min, max, 0, 0, 0);
582
583     /* if downstream supports video metadata, add this to the pool config */
584     if (gst_query_has_allocation_meta (query, GST_VIDEO_META_API_TYPE))
585       gst_buffer_pool_config_add_option (config,
586           GST_BUFFER_POOL_OPTION_VIDEO_META);
587
588     gst_buffer_pool_set_config (pool, config);
589   }
590
591   if (update)
592     gst_query_set_nth_allocation_pool (query, 0, pool, size, min, max);
593   else
594     gst_query_add_allocation_pool (query, pool, size, min, max);
595
596   return TRUE;
597 }
598
599 static gboolean
600 gst_v4l2src_query (GstBaseSrc * bsrc, GstQuery * query)
601 {
602   GstV4l2Src *src;
603   GstV4l2Object *obj;
604   gboolean res = FALSE;
605
606   src = GST_V4L2SRC (bsrc);
607   obj = src->v4l2object;
608
609   switch (GST_QUERY_TYPE (query)) {
610     case GST_QUERY_LATENCY:{
611       GstClockTime min_latency, max_latency;
612       guint32 fps_n, fps_d;
613
614       /* device must be open */
615       if (!GST_V4L2_IS_OPEN (obj)) {
616         GST_WARNING_OBJECT (src,
617             "Can't give latency since device isn't open !");
618         goto done;
619       }
620
621       fps_n = GST_V4L2_FPS_N (obj);
622       fps_d = GST_V4L2_FPS_D (obj);
623
624       /* we must have a framerate */
625       if (fps_n <= 0 || fps_d <= 0) {
626         GST_WARNING_OBJECT (src,
627             "Can't give latency since framerate isn't fixated !");
628         goto done;
629       }
630
631       /* min latency is the time to capture one frame */
632       min_latency = gst_util_uint64_scale_int (GST_SECOND, fps_d, fps_n);
633
634       /* max latency is total duration of the frame buffer */
635       max_latency =
636           GST_V4L2_BUFFER_POOL_CAST (obj->pool)->max_buffers * min_latency;
637
638       GST_DEBUG_OBJECT (bsrc,
639           "report latency min %" GST_TIME_FORMAT " max %" GST_TIME_FORMAT,
640           GST_TIME_ARGS (min_latency), GST_TIME_ARGS (max_latency));
641
642       /* we are always live, the min latency is 1 frame and the max latency is
643        * the complete buffer of frames. */
644       gst_query_set_latency (query, TRUE, min_latency, max_latency);
645
646       res = TRUE;
647       break;
648     }
649     default:
650       res = GST_BASE_SRC_CLASS (parent_class)->query (bsrc, query);
651       break;
652   }
653
654 done:
655
656   return res;
657 }
658
659 /* start and stop are not symmetric -- start will open the device, but not start
660  * capture. it's setcaps that will start capture, which is called via basesrc's
661  * negotiate method. stop will both stop capture and close the device.
662  */
663 static gboolean
664 gst_v4l2src_start (GstBaseSrc * src)
665 {
666   GstV4l2Src *v4l2src = GST_V4L2SRC (src);
667
668   v4l2src->offset = 0;
669
670   /* activate settings for first frame */
671   v4l2src->ctrl_time = 0;
672   gst_object_sync_values (GST_OBJECT (src), v4l2src->ctrl_time);
673
674   return TRUE;
675 }
676
677 static gboolean
678 gst_v4l2src_unlock (GstBaseSrc * src)
679 {
680   GstV4l2Src *v4l2src = GST_V4L2SRC (src);
681   return gst_v4l2_object_unlock (v4l2src->v4l2object);
682 }
683
684 static gboolean
685 gst_v4l2src_unlock_stop (GstBaseSrc * src)
686 {
687   GstV4l2Src *v4l2src = GST_V4L2SRC (src);
688   return gst_v4l2_object_unlock_stop (v4l2src->v4l2object);
689 }
690
691 static gboolean
692 gst_v4l2src_stop (GstBaseSrc * src)
693 {
694   GstV4l2Src *v4l2src = GST_V4L2SRC (src);
695   GstV4l2Object *obj = v4l2src->v4l2object;
696
697   if (GST_V4L2_IS_ACTIVE (obj)) {
698     if (!gst_v4l2_object_stop (obj))
699       return FALSE;
700   }
701   return TRUE;
702 }
703
704 static GstStateChangeReturn
705 gst_v4l2src_change_state (GstElement * element, GstStateChange transition)
706 {
707   GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
708   GstV4l2Src *v4l2src = GST_V4L2SRC (element);
709   GstV4l2Object *obj = v4l2src->v4l2object;
710
711   switch (transition) {
712     case GST_STATE_CHANGE_NULL_TO_READY:
713       /* open the device */
714       if (!gst_v4l2_object_open (obj))
715         return GST_STATE_CHANGE_FAILURE;
716       break;
717     default:
718       break;
719   }
720
721   ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
722
723   switch (transition) {
724     case GST_STATE_CHANGE_READY_TO_NULL:
725       /* close the device */
726       if (!gst_v4l2_object_close (obj))
727         return GST_STATE_CHANGE_FAILURE;
728
729       if (v4l2src->probed_caps) {
730         gst_caps_unref (v4l2src->probed_caps);
731         v4l2src->probed_caps = NULL;
732       }
733       break;
734     default:
735       break;
736   }
737
738   return ret;
739 }
740
741 static GstFlowReturn
742 gst_v4l2src_fill (GstPushSrc * src, GstBuffer * buf)
743 {
744   GstV4l2Src *v4l2src = GST_V4L2SRC (src);
745   GstV4l2Object *obj = v4l2src->v4l2object;
746   GstFlowReturn ret;
747   GstClock *clock;
748   GstClockTime timestamp, duration;
749
750 #if 0
751   int i;
752   /* decimate, just capture and throw away frames */
753   for (i = 0; i < v4l2src->decimate - 1; i++) {
754     ret = gst_v4l2_buffer_pool_process (obj, buf);
755     if (ret != GST_FLOW_OK) {
756       return ret;
757     }
758     gst_buffer_unref (*buf);
759   }
760 #endif
761
762   ret =
763       gst_v4l2_buffer_pool_process (GST_V4L2_BUFFER_POOL_CAST (obj->pool), buf);
764
765   if (G_UNLIKELY (ret != GST_FLOW_OK))
766     goto error;
767
768   /* set buffer metadata */
769   GST_BUFFER_OFFSET (buf) = v4l2src->offset++;
770   GST_BUFFER_OFFSET_END (buf) = v4l2src->offset;
771
772   /* timestamps, LOCK to get clock and base time. */
773   /* FIXME: element clock and base_time is rarely changing */
774   GST_OBJECT_LOCK (v4l2src);
775   if ((clock = GST_ELEMENT_CLOCK (v4l2src))) {
776     /* we have a clock, get base time and ref clock */
777     timestamp = GST_ELEMENT (v4l2src)->base_time;
778     gst_object_ref (clock);
779   } else {
780     /* no clock, can't set timestamps */
781     timestamp = GST_CLOCK_TIME_NONE;
782   }
783   GST_OBJECT_UNLOCK (v4l2src);
784
785   duration = obj->duration;
786
787   if (G_LIKELY (clock)) {
788     /* the time now is the time of the clock minus the base time */
789     timestamp = gst_clock_get_time (clock) - timestamp;
790     gst_object_unref (clock);
791
792     /* if we have a framerate adjust timestamp for frame latency */
793     if (GST_CLOCK_TIME_IS_VALID (duration)) {
794       if (timestamp > duration)
795         timestamp -= duration;
796       else
797         timestamp = 0;
798     }
799   }
800
801   /* activate settings for next frame */
802   if (GST_CLOCK_TIME_IS_VALID (duration)) {
803     v4l2src->ctrl_time += duration;
804   } else {
805     /* this is not very good (as it should be the next timestamp),
806      * still good enough for linear fades (as long as it is not -1)
807      */
808     v4l2src->ctrl_time = timestamp;
809   }
810   gst_object_sync_values (GST_OBJECT (src), v4l2src->ctrl_time);
811   GST_INFO_OBJECT (src, "sync to %" GST_TIME_FORMAT,
812       GST_TIME_ARGS (v4l2src->ctrl_time));
813
814   /* FIXME: use the timestamp from the buffer itself! */
815   GST_BUFFER_TIMESTAMP (buf) = timestamp;
816   GST_BUFFER_DURATION (buf) = duration;
817
818   return ret;
819
820   /* ERROR */
821 error:
822   {
823     GST_ERROR_OBJECT (src, "error processing buffer");
824     return ret;
825   }
826 }
827
828
829 /* GstURIHandler interface */
830 static GstURIType
831 gst_v4l2src_uri_get_type (GType type)
832 {
833   return GST_URI_SRC;
834 }
835
836 static const gchar *const *
837 gst_v4l2src_uri_get_protocols (GType type)
838 {
839   static const gchar *protocols[] = { "v4l2", NULL };
840
841   return protocols;
842 }
843
844 static gchar *
845 gst_v4l2src_uri_get_uri (GstURIHandler * handler)
846 {
847   GstV4l2Src *v4l2src = GST_V4L2SRC (handler);
848
849   if (v4l2src->v4l2object->videodev != NULL) {
850     return g_strdup_printf ("v4l2://%s", v4l2src->v4l2object->videodev);
851   }
852
853   return g_strdup ("v4l2://");
854 }
855
856 static gboolean
857 gst_v4l2src_uri_set_uri (GstURIHandler * handler, const gchar * uri,
858     GError ** error)
859 {
860   GstV4l2Src *v4l2src = GST_V4L2SRC (handler);
861   const gchar *device = DEFAULT_PROP_DEVICE;
862
863   if (strcmp (uri, "v4l2://") != 0) {
864     device = uri + 7;
865   }
866   g_object_set (v4l2src, "device", device, NULL);
867
868   return TRUE;
869 }
870
871
872 static void
873 gst_v4l2src_uri_handler_init (gpointer g_iface, gpointer iface_data)
874 {
875   GstURIHandlerInterface *iface = (GstURIHandlerInterface *) g_iface;
876
877   iface->get_type = gst_v4l2src_uri_get_type;
878   iface->get_protocols = gst_v4l2src_uri_get_protocols;
879   iface->get_uri = gst_v4l2src_uri_get_uri;
880   iface->set_uri = gst_v4l2src_uri_set_uri;
881 }