3 * Copyright (C) 2001-2002 Ronald Bultje <rbultje@ronald.bitfreak.net>
4 * 2006 Edgard Lima <edgard.lima@indt.org.br>
6 * gstv4l2object.c: base class for V4L2 elements
8 * This library is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU Library General Public License as published
10 * by the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version. This library is distributed in the hope
12 * that it will be useful, but WITHOUT ANY WARRANTY; without even the
13 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
14 * PURPOSE. See the GNU Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
32 #include <gudev/gudev.h>
35 #include "v4l2_calls.h"
36 #include "gstv4l2tuner.h"
38 #include "gstv4l2xoverlay.h"
40 #include "gstv4l2colorbalance.h"
42 #include "gst/gst-i18n-plugin.h"
44 /* videodev2.h is not versioned and we can't easily check for the presence
45 * of enum values at compile time, but the V4L2_CAP_VIDEO_OUTPUT_OVERLAY define
46 * was added in the same commit as V4L2_FIELD_INTERLACED_{TB,BT} (b2787845) */
47 #ifndef V4L2_CAP_VIDEO_OUTPUT_OVERLAY
48 #define V4L2_FIELD_INTERLACED_TB 8
49 #define V4L2_FIELD_INTERLACED_BT 9
52 GST_DEBUG_CATEGORY_EXTERN (v4l2_debug);
53 #define GST_CAT_DEFAULT v4l2_debug
56 #define DEFAULT_PROP_DEVICE_NAME NULL
57 #define DEFAULT_PROP_DEVICE_FD -1
58 #define DEFAULT_PROP_FLAGS 0
59 #define DEFAULT_PROP_NORM NULL
60 #define DEFAULT_PROP_CHANNEL NULL
61 #define DEFAULT_PROP_FREQUENCY 0
66 V4L2_STD_OBJECT_PROPS,
69 G_LOCK_DEFINE_STATIC (probe_lock);
72 gst_v4l2_probe_get_properties (GstPropertyProbe * probe)
74 GObjectClass *klass = G_OBJECT_GET_CLASS (probe);
75 static GList *list = NULL;
80 list = g_list_append (NULL, g_object_class_find_property (klass, "device"));
83 G_UNLOCK (probe_lock);
88 static gboolean init = FALSE;
89 static GList *devices = NULL;
93 gst_v4l2_class_probe_devices_with_udev (GstElementClass * klass, gboolean check,
94 GList ** klass_devices)
96 GUdevClient *client = NULL;
101 gchar *device = devices->data;
102 devices = g_list_remove (devices, device);
106 GST_INFO ("Enumerating video4linux devices from udev");
107 client = g_udev_client_new (NULL);
109 GST_WARNING ("Failed to initialize gudev client");
113 item = g_udev_client_query_by_subsystem (client, "video4linux");
115 GUdevDevice *device = item->data;
116 gchar *devnode = g_strdup (g_udev_device_get_device_file (device));
117 gint api = g_udev_device_get_property_as_int (device, "ID_V4L_VERSION");
118 GST_INFO ("Found new device: %s, API: %d", devnode, api);
119 /* Append v4l2 devices only. If api is 0 probably v4l_id has
120 been stripped out of the current udev installation, append
124 ("Couldn't retrieve ID_V4L_VERSION, silly udev installation?");
126 if ((api == 2 || api == 0)) {
127 devices = g_list_append (devices, devnode);
131 g_object_unref (device);
140 g_object_unref (client);
143 *klass_devices = devices;
147 #endif /* HAVE_GUDEV */
150 gst_v4l2_class_probe_devices (GstElementClass * klass, gboolean check,
151 GList ** klass_devices)
154 const gchar *dev_base[] = { "/dev/video", "/dev/v4l2/video", NULL };
158 gchar *device = devices->data;
159 devices = g_list_remove (devices, device);
164 * detect /dev entries
166 for (n = 0; n < 64; n++) {
167 for (base = 0; dev_base[base] != NULL; base++) {
169 gchar *device = g_strdup_printf ("%s%d",
174 * does the /dev/ entry exist at all?
176 if (stat (device, &s) == 0) {
178 * yes: is a device attached?
180 if (S_ISCHR (s.st_mode)) {
182 if ((fd = open (device, O_RDWR | O_NONBLOCK)) > 0 || errno == EBUSY) {
186 devices = g_list_append (devices, device);
197 *klass_devices = devices;
203 gst_v4l2_probe_probe_property (GstPropertyProbe * probe,
204 guint prop_id, const GParamSpec * pspec, GList ** klass_devices)
206 GstElementClass *klass = GST_ELEMENT_GET_CLASS (probe);
211 if (!gst_v4l2_class_probe_devices_with_udev (klass, FALSE, klass_devices))
212 gst_v4l2_class_probe_devices (klass, FALSE, klass_devices);
213 #else /* !HAVE_GUDEV */
214 gst_v4l2_class_probe_devices (klass, FALSE, klass_devices);
215 #endif /* HAVE_GUDEV */
218 G_OBJECT_WARN_INVALID_PROPERTY_ID (probe, prop_id, pspec);
224 gst_v4l2_probe_needs_probe (GstPropertyProbe * probe,
225 guint prop_id, const GParamSpec * pspec, GList ** klass_devices)
227 GstElementClass *klass = GST_ELEMENT_GET_CLASS (probe);
228 gboolean ret = FALSE;
234 !gst_v4l2_class_probe_devices_with_udev (klass, FALSE, klass_devices);
235 #else /* !HAVE_GUDEV */
236 ret = !gst_v4l2_class_probe_devices (klass, TRUE, klass_devices);
237 #endif /* HAVE_GUDEV */
240 G_OBJECT_WARN_INVALID_PROPERTY_ID (probe, prop_id, pspec);
247 gst_v4l2_class_list_devices (GstElementClass * klass, GList ** klass_devices)
250 GValue value = { 0 };
256 array = g_value_array_new (g_list_length (*klass_devices));
257 item = *klass_devices;
258 g_value_init (&value, G_TYPE_STRING);
260 gchar *device = item->data;
262 g_value_set_string (&value, device);
263 g_value_array_append (array, &value);
267 g_value_unset (&value);
273 gst_v4l2_probe_get_values (GstPropertyProbe * probe,
274 guint prop_id, const GParamSpec * pspec, GList ** klass_devices)
276 GstElementClass *klass = GST_ELEMENT_GET_CLASS (probe);
277 GValueArray *array = NULL;
281 array = gst_v4l2_class_list_devices (klass, klass_devices);
284 G_OBJECT_WARN_INVALID_PROPERTY_ID (probe, prop_id, pspec);
291 #define GST_TYPE_V4L2_DEVICE_FLAGS (gst_v4l2_device_get_type ())
293 gst_v4l2_device_get_type (void)
295 static GType v4l2_device_type = 0;
297 if (v4l2_device_type == 0) {
298 static const GFlagsValue values[] = {
299 {V4L2_CAP_VIDEO_CAPTURE, "Device supports video capture", "capture"},
300 {V4L2_CAP_VIDEO_OUTPUT, "Device supports video playback", "output"},
301 {V4L2_CAP_VIDEO_OVERLAY, "Device supports video overlay", "overlay"},
303 {V4L2_CAP_VBI_CAPTURE, "Device supports the VBI capture", "vbi-capture"},
304 {V4L2_CAP_VBI_OUTPUT, "Device supports the VBI output", "vbi-output"},
306 {V4L2_CAP_TUNER, "Device has a tuner or modulator", "tuner"},
307 {V4L2_CAP_AUDIO, "Device has audio inputs or outputs", "audio"},
313 g_flags_register_static ("GstV4l2DeviceTypeFlags", values);
316 return v4l2_device_type;
320 gst_v4l2_object_install_properties_helper (GObjectClass * gobject_class,
321 const char *default_device)
323 g_object_class_install_property (gobject_class, PROP_DEVICE,
324 g_param_spec_string ("device", "Device", "Device location",
325 default_device, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
326 g_object_class_install_property (gobject_class, PROP_DEVICE_NAME,
327 g_param_spec_string ("device-name", "Device name",
328 "Name of the device", DEFAULT_PROP_DEVICE_NAME,
329 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
330 g_object_class_install_property (gobject_class, PROP_DEVICE_FD,
331 g_param_spec_int ("device-fd", "File descriptor",
332 "File descriptor of the device", -1, G_MAXINT, DEFAULT_PROP_DEVICE_FD,
333 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
334 g_object_class_install_property (gobject_class, PROP_FLAGS,
335 g_param_spec_flags ("flags", "Flags", "Device type flags",
336 GST_TYPE_V4L2_DEVICE_FLAGS, DEFAULT_PROP_FLAGS,
337 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
340 * GstV4l2Src:brightness
342 * Picture brightness, or more precisely, the black level
346 g_object_class_install_property (gobject_class, PROP_BRIGHTNESS,
347 g_param_spec_int ("brightness", "Brightness",
348 "Picture brightness, or more precisely, the black level", G_MININT,
350 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
352 * GstV4l2Src:contrast
354 * Picture contrast or luma gain
358 g_object_class_install_property (gobject_class, PROP_CONTRAST,
359 g_param_spec_int ("contrast", "Contrast",
360 "Picture contrast or luma gain", G_MININT,
362 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
364 * GstV4l2Src:saturation
366 * Picture color saturation or chroma gain
370 g_object_class_install_property (gobject_class, PROP_SATURATION,
371 g_param_spec_int ("saturation", "Saturation",
372 "Picture color saturation or chroma gain", G_MININT,
374 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
378 * Hue or color balance
382 g_object_class_install_property (gobject_class, PROP_HUE,
383 g_param_spec_int ("hue", "Hue",
384 "Hue or color balance", G_MININT,
386 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
390 gst_v4l2_object_new (GstElement * element,
391 enum v4l2_buf_type type,
392 const char *default_device,
393 GstV4l2GetInOutFunction get_in_out_func,
394 GstV4l2SetInOutFunction set_in_out_func,
395 GstV4l2UpdateFpsFunction update_fps_func)
397 GstV4l2Object *v4l2object;
400 * some default values
402 v4l2object = g_new0 (GstV4l2Object, 1);
404 v4l2object->type = type;
405 v4l2object->formats = NULL;
407 v4l2object->element = element;
408 v4l2object->get_in_out_func = get_in_out_func;
409 v4l2object->set_in_out_func = set_in_out_func;
410 v4l2object->update_fps_func = update_fps_func;
412 v4l2object->video_fd = -1;
413 v4l2object->poll = gst_poll_new (TRUE);
414 v4l2object->buffer = NULL;
415 v4l2object->videodev = g_strdup (default_device);
417 v4l2object->norms = NULL;
418 v4l2object->channels = NULL;
419 v4l2object->colors = NULL;
421 v4l2object->xwindow_id = 0;
426 static gboolean gst_v4l2_object_clear_format_list (GstV4l2Object * v4l2object);
430 gst_v4l2_object_destroy (GstV4l2Object * v4l2object)
432 g_return_if_fail (v4l2object != NULL);
434 if (v4l2object->videodev)
435 g_free (v4l2object->videodev);
437 if (v4l2object->poll)
438 gst_poll_free (v4l2object->poll);
440 if (v4l2object->channel)
441 g_free (v4l2object->channel);
443 if (v4l2object->norm)
444 g_free (v4l2object->norm);
446 if (v4l2object->formats) {
447 gst_v4l2_object_clear_format_list (v4l2object);
455 gst_v4l2_object_clear_format_list (GstV4l2Object * v4l2object)
457 g_slist_foreach (v4l2object->formats, (GFunc) g_free, NULL);
458 g_slist_free (v4l2object->formats);
459 v4l2object->formats = NULL;
465 gst_v4l2_object_prop_to_cid (guint prop_id)
470 case PROP_BRIGHTNESS:
471 cid = V4L2_CID_BRIGHTNESS;
474 cid = V4L2_CID_CONTRAST;
476 case PROP_SATURATION:
477 cid = V4L2_CID_SATURATION;
483 GST_WARNING ("unmapped property id: %d", prop_id);
490 gst_v4l2_object_set_property_helper (GstV4l2Object * v4l2object,
491 guint prop_id, const GValue * value, GParamSpec * pspec)
495 g_free (v4l2object->videodev);
496 v4l2object->videodev = g_value_dup_string (value);
498 case PROP_BRIGHTNESS:
500 case PROP_SATURATION:
503 gint cid = gst_v4l2_object_prop_to_cid (prop_id);
506 if (GST_V4L2_IS_OPEN (v4l2object)) {
507 gst_v4l2_set_attribute (v4l2object, cid, g_value_get_int (value));
515 if (GST_V4L2_IS_OPEN (v4l2object)) {
516 GstTuner *tuner = GST_TUNER (v4l2object->element);
517 GstTunerNorm *norm = gst_tuner_find_norm_by_name (tuner,
518 (gchar *) g_value_get_string (value));
521 /* like gst_tuner_set_norm (tuner, norm)
522 without g_object_notify */
523 gst_v4l2_tuner_set_norm (v4l2object, norm);
526 g_free (v4l2object->norm);
527 v4l2object->norm = g_value_dup_string (value);
531 if (GST_V4L2_IS_OPEN (v4l2object)) {
532 GstTuner *tuner = GST_TUNER (v4l2object->element);
533 GstTunerChannel *channel = gst_tuner_find_channel_by_name (tuner,
534 (gchar *) g_value_get_string (value));
537 /* like gst_tuner_set_channel (tuner, channel)
538 without g_object_notify */
539 gst_v4l2_tuner_set_channel (v4l2object, channel);
542 g_free (v4l2object->channel);
543 v4l2object->channel = g_value_dup_string (value);
547 if (GST_V4L2_IS_OPEN (v4l2object)) {
548 GstTuner *tuner = GST_TUNER (v4l2object->element);
549 GstTunerChannel *channel = gst_tuner_get_channel (tuner);
552 GST_TUNER_CHANNEL_HAS_FLAG (channel, GST_TUNER_CHANNEL_FREQUENCY)) {
554 gst_tuner_set_frequency (tuner, channel, g_value_get_ulong (value))
555 without g_object_notify */
556 gst_v4l2_tuner_set_frequency (v4l2object, channel,
557 g_value_get_ulong (value));
560 v4l2object->frequency = g_value_get_ulong (value);
573 gst_v4l2_object_get_property_helper (GstV4l2Object * v4l2object,
574 guint prop_id, GValue * value, GParamSpec * pspec)
578 g_value_set_string (value, v4l2object->videodev);
580 case PROP_DEVICE_NAME:
582 const guchar *new = NULL;
584 if (GST_V4L2_IS_OPEN (v4l2object)) {
585 new = v4l2object->vcap.card;
586 } else if (gst_v4l2_open (v4l2object)) {
587 new = v4l2object->vcap.card;
588 gst_v4l2_close (v4l2object);
590 g_value_set_string (value, (gchar *) new);
595 if (GST_V4L2_IS_OPEN (v4l2object))
596 g_value_set_int (value, v4l2object->video_fd);
598 g_value_set_int (value, DEFAULT_PROP_DEVICE_FD);
605 if (GST_V4L2_IS_OPEN (v4l2object)) {
606 flags |= v4l2object->vcap.capabilities &
607 (V4L2_CAP_VIDEO_CAPTURE |
608 V4L2_CAP_VIDEO_OUTPUT |
609 V4L2_CAP_VIDEO_OVERLAY |
610 V4L2_CAP_VBI_CAPTURE |
611 V4L2_CAP_VBI_OUTPUT | V4L2_CAP_TUNER | V4L2_CAP_AUDIO);
613 g_value_set_flags (value, flags);
616 case PROP_BRIGHTNESS:
618 case PROP_SATURATION:
621 gint cid = gst_v4l2_object_prop_to_cid (prop_id);
624 if (GST_V4L2_IS_OPEN (v4l2object)) {
626 if (gst_v4l2_get_attribute (v4l2object, cid, &v)) {
627 g_value_set_int (value, v);
642 gst_v4l2_set_defaults (GstV4l2Object * v4l2object)
644 GstTunerNorm *norm = NULL;
645 GstTunerChannel *channel = NULL;
648 if (!GST_IS_TUNER (v4l2object->element))
651 tuner = GST_TUNER (v4l2object->element);
653 if (v4l2object->norm)
654 norm = gst_tuner_find_norm_by_name (tuner, v4l2object->norm);
656 gst_tuner_set_norm (tuner, norm);
659 GST_TUNER_NORM (gst_tuner_get_norm (GST_TUNER (v4l2object->element)));
661 g_free (v4l2object->norm);
662 v4l2object->norm = g_strdup (norm->label);
663 gst_tuner_norm_changed (tuner, norm);
667 if (v4l2object->channel)
668 channel = gst_tuner_find_channel_by_name (tuner, v4l2object->channel);
670 gst_tuner_set_channel (tuner, channel);
673 GST_TUNER_CHANNEL (gst_tuner_get_channel (GST_TUNER
674 (v4l2object->element)));
676 g_free (v4l2object->channel);
677 v4l2object->channel = g_strdup (channel->label);
678 gst_tuner_channel_changed (tuner, channel);
683 && GST_TUNER_CHANNEL_HAS_FLAG (channel, GST_TUNER_CHANNEL_FREQUENCY)) {
684 if (v4l2object->frequency != 0) {
685 gst_tuner_set_frequency (tuner, channel, v4l2object->frequency);
687 v4l2object->frequency = gst_tuner_get_frequency (tuner, channel);
688 if (v4l2object->frequency == 0) {
690 gst_tuner_set_frequency (tuner, channel, 1000);
698 gst_v4l2_object_start (GstV4l2Object * v4l2object)
700 if (gst_v4l2_open (v4l2object))
701 gst_v4l2_set_defaults (v4l2object);
706 gst_v4l2_xoverlay_start (v4l2object);
713 gst_v4l2_object_stop (GstV4l2Object * v4l2object)
716 gst_v4l2_xoverlay_stop (v4l2object);
719 if (!gst_v4l2_close (v4l2object))
722 if (v4l2object->formats) {
723 gst_v4l2_object_clear_format_list (v4l2object);
731 * common format / caps utilities:
739 static const GstV4L2FormatDesc gst_v4l2_formats[] = {
740 /* from Linux 2.6.15 videodev2.h */
741 {V4L2_PIX_FMT_RGB332, TRUE},
742 {V4L2_PIX_FMT_RGB555, TRUE},
743 {V4L2_PIX_FMT_RGB565, TRUE},
744 {V4L2_PIX_FMT_RGB555X, TRUE},
745 {V4L2_PIX_FMT_RGB565X, TRUE},
746 {V4L2_PIX_FMT_BGR24, TRUE},
747 {V4L2_PIX_FMT_RGB24, TRUE},
748 {V4L2_PIX_FMT_BGR32, TRUE},
749 {V4L2_PIX_FMT_RGB32, TRUE},
750 {V4L2_PIX_FMT_GREY, TRUE},
751 {V4L2_PIX_FMT_YVU410, TRUE},
752 {V4L2_PIX_FMT_YVU420, TRUE},
753 {V4L2_PIX_FMT_YUYV, TRUE},
754 {V4L2_PIX_FMT_UYVY, TRUE},
755 {V4L2_PIX_FMT_YUV422P, TRUE},
756 {V4L2_PIX_FMT_YUV411P, TRUE},
757 {V4L2_PIX_FMT_Y41P, TRUE},
759 /* two planes -- one Y, one Cr + Cb interleaved */
760 {V4L2_PIX_FMT_NV12, TRUE},
761 {V4L2_PIX_FMT_NV21, TRUE},
763 /* The following formats are not defined in the V4L2 specification */
764 {V4L2_PIX_FMT_YUV410, TRUE},
765 {V4L2_PIX_FMT_YUV420, TRUE},
766 {V4L2_PIX_FMT_YYUV, TRUE},
767 {V4L2_PIX_FMT_HI240, TRUE},
769 /* see http://www.siliconimaging.com/RGB%20Bayer.htm */
770 #ifdef V4L2_PIX_FMT_SBGGR8
771 {V4L2_PIX_FMT_SBGGR8, TRUE},
774 /* compressed formats */
775 {V4L2_PIX_FMT_MJPEG, TRUE},
776 {V4L2_PIX_FMT_JPEG, TRUE},
777 #ifdef V4L2_PIX_FMT_PJPG
778 {V4L2_PIX_FMT_PJPG, TRUE},
780 {V4L2_PIX_FMT_DV, TRUE},
781 {V4L2_PIX_FMT_MPEG, FALSE},
783 /* Vendor-specific formats */
784 {V4L2_PIX_FMT_WNVA, TRUE},
786 #ifdef V4L2_PIX_FMT_SN9C10X
787 {V4L2_PIX_FMT_SN9C10X, TRUE},
789 #ifdef V4L2_PIX_FMT_PWC1
790 {V4L2_PIX_FMT_PWC1, TRUE},
792 #ifdef V4L2_PIX_FMT_PWC2
793 {V4L2_PIX_FMT_PWC2, TRUE},
795 #ifdef V4L2_PIX_FMT_YVYU
796 {V4L2_PIX_FMT_YVYU, TRUE},
800 #define GST_V4L2_FORMAT_COUNT (G_N_ELEMENTS (gst_v4l2_formats))
803 static struct v4l2_fmtdesc *
804 gst_v4l2_object_get_format_from_fourcc (GstV4l2Object * v4l2object,
807 struct v4l2_fmtdesc *fmt;
813 walk = gst_v4l2_object_get_format_list (v4l2object);
815 fmt = (struct v4l2_fmtdesc *) walk->data;
816 if (fmt->pixelformat == fourcc)
818 /* special case for jpeg */
819 if (fmt->pixelformat == V4L2_PIX_FMT_MJPEG ||
820 fmt->pixelformat == V4L2_PIX_FMT_JPEG
821 #ifdef V4L2_PIX_FMT_PJPG
822 || fmt->pixelformat == V4L2_PIX_FMT_PJPG
825 if (fourcc == V4L2_PIX_FMT_JPEG || fourcc == V4L2_PIX_FMT_MJPEG
826 #ifdef V4L2_PIX_FMT_PJPG
827 || fourcc == V4L2_PIX_FMT_PJPG
833 walk = g_slist_next (walk);
841 /* complete made up ranking, the values themselves are meaningless */
842 #define YUV_BASE_RANK 1000
843 #define JPEG_BASE_RANK 500
844 #define DV_BASE_RANK 200
845 #define RGB_BASE_RANK 100
846 #define YUV_ODD_BASE_RANK 50
847 #define RGB_ODD_BASE_RANK 25
848 #define BAYER_BASE_RANK 15
849 #define S910_BASE_RANK 10
850 #define GREY_BASE_RANK 5
851 #define PWC_BASE_RANK 1
853 /* This flag is already used by libv4l2 although
854 * it was added to the Linux kernel in 2.6.32
856 #ifndef V4L2_FMT_FLAG_EMULATED
857 #define V4L2_FMT_FLAG_EMULATED 0x0002
861 gst_v4l2_object_format_get_rank (const struct v4l2_fmtdesc *fmt)
863 guint32 fourcc = fmt->pixelformat;
864 gboolean emulated = ((fmt->flags & V4L2_FMT_FLAG_EMULATED) != 0);
868 case V4L2_PIX_FMT_MJPEG:
869 #ifdef V4L2_PIX_FMT_PJPG
870 case V4L2_PIX_FMT_PJPG:
871 rank = JPEG_BASE_RANK;
874 case V4L2_PIX_FMT_JPEG:
875 rank = JPEG_BASE_RANK + 1;
877 case V4L2_PIX_FMT_MPEG: /* MPEG */
878 rank = JPEG_BASE_RANK + 2;
881 case V4L2_PIX_FMT_RGB332:
882 case V4L2_PIX_FMT_RGB555:
883 case V4L2_PIX_FMT_RGB555X:
884 case V4L2_PIX_FMT_RGB565:
885 case V4L2_PIX_FMT_RGB565X:
886 rank = RGB_ODD_BASE_RANK;
889 case V4L2_PIX_FMT_RGB24:
890 case V4L2_PIX_FMT_BGR24:
891 rank = RGB_BASE_RANK - 1;
894 case V4L2_PIX_FMT_RGB32:
895 case V4L2_PIX_FMT_BGR32:
896 rank = RGB_BASE_RANK;
899 case V4L2_PIX_FMT_GREY: /* 8 Greyscale */
900 rank = GREY_BASE_RANK;
903 case V4L2_PIX_FMT_NV12: /* 12 Y/CbCr 4:2:0 */
904 case V4L2_PIX_FMT_NV21: /* 12 Y/CrCb 4:2:0 */
905 case V4L2_PIX_FMT_YYUV: /* 16 YUV 4:2:2 */
906 case V4L2_PIX_FMT_HI240: /* 8 8-bit color */
907 rank = YUV_ODD_BASE_RANK;
910 case V4L2_PIX_FMT_YVU410: /* YVU9, 9 bits per pixel */
911 rank = YUV_BASE_RANK + 3;
913 case V4L2_PIX_FMT_YUV410: /* YUV9, 9 bits per pixel */
914 rank = YUV_BASE_RANK + 2;
916 case V4L2_PIX_FMT_YUV420: /* I420, 12 bits per pixel */
917 rank = YUV_BASE_RANK + 7;
919 case V4L2_PIX_FMT_YUYV: /* YUY2, 16 bits per pixel */
920 rank = YUV_BASE_RANK + 10;
922 case V4L2_PIX_FMT_YVU420: /* YV12, 12 bits per pixel */
923 rank = YUV_BASE_RANK + 6;
925 case V4L2_PIX_FMT_UYVY: /* UYVY, 16 bits per pixel */
926 rank = YUV_BASE_RANK + 9;
928 case V4L2_PIX_FMT_Y41P: /* Y41P, 12 bits per pixel */
929 rank = YUV_BASE_RANK + 5;
931 case V4L2_PIX_FMT_YUV411P: /* Y41B, 12 bits per pixel */
932 rank = YUV_BASE_RANK + 4;
934 case V4L2_PIX_FMT_YUV422P: /* Y42B, 16 bits per pixel */
935 rank = YUV_BASE_RANK + 8;
938 case V4L2_PIX_FMT_DV:
942 case V4L2_PIX_FMT_WNVA: /* Winnov hw compres */
946 #ifdef V4L2_PIX_FMT_SBGGR8
947 case V4L2_PIX_FMT_SBGGR8:
948 rank = BAYER_BASE_RANK;
952 #ifdef V4L2_PIX_FMT_SN9C10X
953 case V4L2_PIX_FMT_SN9C10X:
954 rank = S910_BASE_RANK;
958 #ifdef V4L2_PIX_FMT_PWC1
959 case V4L2_PIX_FMT_PWC1:
960 rank = PWC_BASE_RANK;
963 #ifdef V4L2_PIX_FMT_PWC2
964 case V4L2_PIX_FMT_PWC2:
965 rank = PWC_BASE_RANK;
974 /* All ranks are below 1<<15 so a shift by 15
975 * will a) make all non-emulated formats larger
976 * than emulated and b) will not overflow
987 format_cmp_func (gconstpointer a, gconstpointer b)
989 const struct v4l2_fmtdesc *fa = a;
990 const struct v4l2_fmtdesc *fb = b;
992 if (fa->pixelformat == fb->pixelformat)
995 return gst_v4l2_object_format_get_rank (fb) -
996 gst_v4l2_object_format_get_rank (fa);
999 /******************************************************
1000 * gst_v4l2_object_fill_format_list():
1001 * create list of supported capture formats
1002 * return value: TRUE on success, FALSE on error
1003 ******************************************************/
1005 gst_v4l2_object_fill_format_list (GstV4l2Object * v4l2object)
1008 struct v4l2_fmtdesc *format;
1010 GST_DEBUG_OBJECT (v4l2object->element, "getting src format enumerations");
1012 /* format enumeration */
1014 format = g_new0 (struct v4l2_fmtdesc, 1);
1017 format->type = v4l2object->type;
1019 if (v4l2_ioctl (v4l2object->video_fd, VIDIOC_ENUM_FMT, format) < 0) {
1020 if (errno == EINVAL) {
1022 break; /* end of enumeration */
1028 GST_LOG_OBJECT (v4l2object->element, "index: %u", format->index);
1029 GST_LOG_OBJECT (v4l2object->element, "type: %d", format->type);
1030 GST_LOG_OBJECT (v4l2object->element, "flags: %08x", format->flags);
1031 GST_LOG_OBJECT (v4l2object->element, "description: '%s'",
1032 format->description);
1033 GST_LOG_OBJECT (v4l2object->element, "pixelformat: %" GST_FOURCC_FORMAT,
1034 GST_FOURCC_ARGS (format->pixelformat));
1036 /* sort formats according to our preference; we do this, because caps
1037 * are probed in the order the formats are in the list, and the order of
1038 * formats in the final probed caps matters for things like fixation */
1039 v4l2object->formats = g_slist_insert_sorted (v4l2object->formats, format,
1040 (GCompareFunc) format_cmp_func);
1043 #ifndef GST_DISABLE_GST_DEBUG
1047 GST_INFO_OBJECT (v4l2object->element, "got %d format(s):", n);
1048 for (l = v4l2object->formats; l != NULL; l = l->next) {
1051 GST_INFO_OBJECT (v4l2object->element,
1052 " %" GST_FOURCC_FORMAT "%s", GST_FOURCC_ARGS (format->pixelformat),
1053 ((format->flags & V4L2_FMT_FLAG_EMULATED)) ? " (emulated)" : "");
1063 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, SETTINGS,
1064 (_("Failed to enumerate possible video formats device '%s' can work with"), v4l2object->videodev), ("Failed to get number %d in pixelformat enumeration for %s. (%d - %s)", n, v4l2object->videodev, errno, g_strerror (errno)));
1071 * Get the list of supported capture formats, a list of
1072 * <code>struct v4l2_fmtdesc</code>.
1075 gst_v4l2_object_get_format_list (GstV4l2Object * v4l2object)
1077 if (!v4l2object->formats)
1078 gst_v4l2_object_fill_format_list (v4l2object);
1079 return v4l2object->formats;
1084 gst_v4l2_object_v4l2fourcc_to_structure (guint32 fourcc)
1086 GstStructure *structure = NULL;
1089 case V4L2_PIX_FMT_MJPEG: /* Motion-JPEG */
1090 #ifdef V4L2_PIX_FMT_PJPG
1091 case V4L2_PIX_FMT_PJPG: /* Progressive-JPEG */
1093 case V4L2_PIX_FMT_JPEG: /* JFIF JPEG */
1094 structure = gst_structure_new ("image/jpeg", NULL);
1096 case V4L2_PIX_FMT_RGB332:
1097 case V4L2_PIX_FMT_RGB555:
1098 case V4L2_PIX_FMT_RGB555X:
1099 case V4L2_PIX_FMT_RGB565:
1100 case V4L2_PIX_FMT_RGB565X:
1101 case V4L2_PIX_FMT_RGB24:
1102 case V4L2_PIX_FMT_BGR24:
1103 case V4L2_PIX_FMT_RGB32:
1104 case V4L2_PIX_FMT_BGR32:{
1105 guint depth = 0, bpp = 0;
1107 gint endianness = 0;
1109 guint32 r_mask = 0, b_mask = 0, g_mask = 0;
1112 case V4L2_PIX_FMT_RGB332:
1114 endianness = G_BYTE_ORDER; /* 'like, whatever' */
1119 case V4L2_PIX_FMT_RGB555:
1120 case V4L2_PIX_FMT_RGB555X:
1124 fourcc == V4L2_PIX_FMT_RGB555X ? G_BIG_ENDIAN : G_LITTLE_ENDIAN;
1129 case V4L2_PIX_FMT_RGB565:
1130 case V4L2_PIX_FMT_RGB565X:
1133 fourcc == V4L2_PIX_FMT_RGB565X ? G_BIG_ENDIAN : G_LITTLE_ENDIAN;
1138 case V4L2_PIX_FMT_RGB24:
1140 endianness = G_BIG_ENDIAN;
1145 case V4L2_PIX_FMT_BGR24:
1147 endianness = G_BIG_ENDIAN;
1152 case V4L2_PIX_FMT_RGB32:
1154 endianness = G_BIG_ENDIAN;
1155 r_mask = 0xff000000;
1156 g_mask = 0x00ff0000;
1157 b_mask = 0x0000ff00;
1159 case V4L2_PIX_FMT_BGR32:
1161 endianness = G_BIG_ENDIAN;
1162 r_mask = 0x000000ff;
1163 g_mask = 0x0000ff00;
1164 b_mask = 0x00ff0000;
1167 g_assert_not_reached ();
1170 structure = gst_structure_new ("video/x-raw-rgb",
1171 "bpp", G_TYPE_INT, bpp,
1172 "depth", G_TYPE_INT, depth,
1173 "red_mask", G_TYPE_INT, r_mask,
1174 "green_mask", G_TYPE_INT, g_mask,
1175 "blue_mask", G_TYPE_INT, b_mask,
1176 "endianness", G_TYPE_INT, endianness, NULL);
1179 case V4L2_PIX_FMT_GREY: /* 8 Greyscale */
1180 structure = gst_structure_new ("video/x-raw-gray",
1181 "bpp", G_TYPE_INT, 8, NULL);
1183 case V4L2_PIX_FMT_YYUV: /* 16 YUV 4:2:2 */
1184 case V4L2_PIX_FMT_HI240: /* 8 8-bit color */
1185 /* FIXME: get correct fourccs here */
1187 case V4L2_PIX_FMT_NV12: /* 12 Y/CbCr 4:2:0 */
1188 case V4L2_PIX_FMT_NV21: /* 12 Y/CrCb 4:2:0 */
1189 case V4L2_PIX_FMT_YVU410:
1190 case V4L2_PIX_FMT_YUV410:
1191 case V4L2_PIX_FMT_YUV420: /* I420/IYUV */
1192 case V4L2_PIX_FMT_YUYV:
1193 case V4L2_PIX_FMT_YVU420:
1194 case V4L2_PIX_FMT_UYVY:
1195 case V4L2_PIX_FMT_Y41P:
1196 case V4L2_PIX_FMT_YUV422P:
1197 #ifdef V4L2_PIX_FMT_YVYU
1198 case V4L2_PIX_FMT_YVYU:
1200 case V4L2_PIX_FMT_YUV411P:{
1204 case V4L2_PIX_FMT_NV12:
1205 fcc = GST_MAKE_FOURCC ('N', 'V', '1', '2');
1207 case V4L2_PIX_FMT_NV21:
1208 fcc = GST_MAKE_FOURCC ('N', 'V', '2', '1');
1210 case V4L2_PIX_FMT_YVU410:
1211 fcc = GST_MAKE_FOURCC ('Y', 'V', 'U', '9');
1213 case V4L2_PIX_FMT_YUV410:
1214 fcc = GST_MAKE_FOURCC ('Y', 'U', 'V', '9');
1216 case V4L2_PIX_FMT_YUV420:
1217 fcc = GST_MAKE_FOURCC ('I', '4', '2', '0');
1219 case V4L2_PIX_FMT_YUYV:
1220 fcc = GST_MAKE_FOURCC ('Y', 'U', 'Y', '2');
1222 case V4L2_PIX_FMT_YVU420:
1223 fcc = GST_MAKE_FOURCC ('Y', 'V', '1', '2');
1225 case V4L2_PIX_FMT_UYVY:
1226 fcc = GST_MAKE_FOURCC ('U', 'Y', 'V', 'Y');
1228 case V4L2_PIX_FMT_Y41P:
1229 fcc = GST_MAKE_FOURCC ('Y', '4', '1', 'P');
1231 case V4L2_PIX_FMT_YUV411P:
1232 fcc = GST_MAKE_FOURCC ('Y', '4', '1', 'B');
1234 case V4L2_PIX_FMT_YUV422P:
1235 fcc = GST_MAKE_FOURCC ('Y', '4', '2', 'B');
1237 #ifdef V4L2_PIX_FMT_YVYU
1238 case V4L2_PIX_FMT_YVYU:
1239 fcc = GST_MAKE_FOURCC ('Y', 'V', 'Y', 'U');
1243 g_assert_not_reached ();
1246 structure = gst_structure_new ("video/x-raw-yuv",
1247 "format", GST_TYPE_FOURCC, fcc, NULL);
1250 case V4L2_PIX_FMT_DV:
1252 gst_structure_new ("video/x-dv", "systemstream", G_TYPE_BOOLEAN, TRUE,
1255 case V4L2_PIX_FMT_MPEG: /* MPEG */
1256 structure = gst_structure_new ("video/mpegts", NULL);
1258 case V4L2_PIX_FMT_WNVA: /* Winnov hw compres */
1260 #ifdef V4L2_PIX_FMT_SBGGR8
1261 case V4L2_PIX_FMT_SBGGR8:
1262 structure = gst_structure_new ("video/x-raw-bayer", NULL);
1265 #ifdef V4L2_PIX_FMT_SN9C10X
1266 case V4L2_PIX_FMT_SN9C10X:
1267 structure = gst_structure_new ("video/x-sonix", NULL);
1270 #ifdef V4L2_PIX_FMT_PWC1
1271 case V4L2_PIX_FMT_PWC1:
1272 structure = gst_structure_new ("video/x-pwc1", NULL);
1275 #ifdef V4L2_PIX_FMT_PWC2
1276 case V4L2_PIX_FMT_PWC2:
1277 structure = gst_structure_new ("video/x-pwc2", NULL);
1281 GST_DEBUG ("Unknown fourcc 0x%08x %" GST_FOURCC_FORMAT,
1282 fourcc, GST_FOURCC_ARGS (fourcc));
1292 gst_v4l2_object_get_all_caps (void)
1294 static GstCaps *caps = NULL;
1297 GstStructure *structure;
1301 caps = gst_caps_new_empty ();
1302 for (i = 0; i < GST_V4L2_FORMAT_COUNT; i++) {
1304 gst_v4l2_object_v4l2fourcc_to_structure (gst_v4l2_formats[i].format);
1306 if (gst_v4l2_formats[i].dimensions) {
1307 gst_structure_set (structure,
1308 "width", GST_TYPE_INT_RANGE, 1, GST_V4L2_MAX_SIZE,
1309 "height", GST_TYPE_INT_RANGE, 1, GST_V4L2_MAX_SIZE,
1310 "framerate", GST_TYPE_FRACTION_RANGE, 0, 1, 100, 1, NULL);
1312 gst_caps_append_structure (caps, structure);
1317 return gst_caps_ref (caps);
1321 /* collect data for the given caps
1322 * @caps: given input caps
1323 * @format: location for the v4l format
1324 * @w/@h: location for width and height
1325 * @fps_n/@fps_d: location for framerate
1326 * @size: location for expected size of the frame or 0 if unknown
1329 gst_v4l2_object_get_caps_info (GstV4l2Object * v4l2object, GstCaps * caps,
1330 struct v4l2_fmtdesc ** format, gint * w, gint * h,
1331 gboolean * interlaced, guint * fps_n, guint * fps_d, guint * size)
1333 GstStructure *structure;
1334 const GValue *framerate;
1336 const gchar *mimetype;
1339 /* default unknown values */
1343 structure = gst_caps_get_structure (caps, 0);
1345 mimetype = gst_structure_get_name (structure);
1347 if (strcmp (mimetype, "video/mpegts") == 0) {
1348 fourcc = V4L2_PIX_FMT_MPEG;
1354 if (!gst_structure_get_int (structure, "width", w))
1357 if (!gst_structure_get_int (structure, "height", h))
1360 if (!gst_structure_get_boolean (structure, "interlaced", interlaced))
1361 *interlaced = FALSE;
1363 framerate = gst_structure_get_value (structure, "framerate");
1367 *fps_n = gst_value_get_fraction_numerator (framerate);
1368 *fps_d = gst_value_get_fraction_denominator (framerate);
1370 if (!strcmp (mimetype, "video/x-raw-yuv")) {
1371 gst_structure_get_fourcc (structure, "format", &fourcc);
1374 case GST_MAKE_FOURCC ('I', '4', '2', '0'):
1375 case GST_MAKE_FOURCC ('I', 'Y', 'U', 'V'):
1376 fourcc = V4L2_PIX_FMT_YUV420;
1377 outsize = GST_ROUND_UP_4 (*w) * GST_ROUND_UP_2 (*h);
1378 outsize += 2 * ((GST_ROUND_UP_8 (*w) / 2) * (GST_ROUND_UP_2 (*h) / 2));
1380 case GST_MAKE_FOURCC ('Y', 'U', 'Y', '2'):
1381 fourcc = V4L2_PIX_FMT_YUYV;
1382 outsize = (GST_ROUND_UP_2 (*w) * 2) * *h;
1384 case GST_MAKE_FOURCC ('Y', '4', '1', 'P'):
1385 fourcc = V4L2_PIX_FMT_Y41P;
1386 outsize = (GST_ROUND_UP_2 (*w) * 2) * *h;
1388 case GST_MAKE_FOURCC ('U', 'Y', 'V', 'Y'):
1389 fourcc = V4L2_PIX_FMT_UYVY;
1390 outsize = (GST_ROUND_UP_2 (*w) * 2) * *h;
1392 case GST_MAKE_FOURCC ('Y', 'V', '1', '2'):
1393 fourcc = V4L2_PIX_FMT_YVU420;
1394 outsize = GST_ROUND_UP_4 (*w) * GST_ROUND_UP_2 (*h);
1395 outsize += 2 * ((GST_ROUND_UP_8 (*w) / 2) * (GST_ROUND_UP_2 (*h) / 2));
1397 case GST_MAKE_FOURCC ('Y', '4', '1', 'B'):
1398 fourcc = V4L2_PIX_FMT_YUV411P;
1399 outsize = GST_ROUND_UP_4 (*w) * *h;
1400 outsize += 2 * ((GST_ROUND_UP_8 (*w) / 4) * *h);
1402 case GST_MAKE_FOURCC ('Y', '4', '2', 'B'):
1403 fourcc = V4L2_PIX_FMT_YUV422P;
1404 outsize = GST_ROUND_UP_4 (*w) * *h;
1405 outsize += 2 * ((GST_ROUND_UP_8 (*w) / 2) * *h);
1407 case GST_MAKE_FOURCC ('N', 'V', '1', '2'):
1408 fourcc = V4L2_PIX_FMT_NV12;
1409 outsize = GST_ROUND_UP_4 (*w) * GST_ROUND_UP_2 (*h);
1410 outsize += (GST_ROUND_UP_4 (*w) * *h) / 2;
1412 case GST_MAKE_FOURCC ('N', 'V', '2', '1'):
1413 fourcc = V4L2_PIX_FMT_NV21;
1414 outsize = GST_ROUND_UP_4 (*w) * GST_ROUND_UP_2 (*h);
1415 outsize += (GST_ROUND_UP_4 (*w) * *h) / 2;
1417 #ifdef V4L2_PIX_FMT_YVYU
1418 case GST_MAKE_FOURCC ('Y', 'V', 'Y', 'U'):
1419 fourcc = V4L2_PIX_FMT_YVYU;
1420 outsize = (GST_ROUND_UP_2 (*w) * 2) * *h;
1424 } else if (!strcmp (mimetype, "video/x-raw-rgb")) {
1425 gint depth, endianness, r_mask;
1427 gst_structure_get_int (structure, "depth", &depth);
1428 gst_structure_get_int (structure, "endianness", &endianness);
1429 gst_structure_get_int (structure, "red_mask", &r_mask);
1433 fourcc = V4L2_PIX_FMT_RGB332;
1436 fourcc = (endianness == G_LITTLE_ENDIAN) ?
1437 V4L2_PIX_FMT_RGB555 : V4L2_PIX_FMT_RGB555X;
1440 fourcc = (endianness == G_LITTLE_ENDIAN) ?
1441 V4L2_PIX_FMT_RGB565 : V4L2_PIX_FMT_RGB565X;
1444 fourcc = (r_mask == 0xFF) ? V4L2_PIX_FMT_BGR24 : V4L2_PIX_FMT_RGB24;
1447 fourcc = (r_mask == 0xFF) ? V4L2_PIX_FMT_BGR32 : V4L2_PIX_FMT_RGB32;
1450 } else if (strcmp (mimetype, "video/x-dv") == 0) {
1451 fourcc = V4L2_PIX_FMT_DV;
1452 } else if (strcmp (mimetype, "image/jpeg") == 0) {
1453 fourcc = V4L2_PIX_FMT_JPEG;
1454 #ifdef V4L2_PIX_FMT_SBGGR8
1455 } else if (strcmp (mimetype, "video/x-raw-bayer") == 0) {
1456 fourcc = V4L2_PIX_FMT_SBGGR8;
1458 #ifdef V4L2_PIX_FMT_SN9C10X
1459 } else if (strcmp (mimetype, "video/x-sonix") == 0) {
1460 fourcc = V4L2_PIX_FMT_SN9C10X;
1462 #ifdef V4L2_PIX_FMT_PWC1
1463 } else if (strcmp (mimetype, "video/x-pwc1") == 0) {
1464 fourcc = V4L2_PIX_FMT_PWC1;
1466 #ifdef V4L2_PIX_FMT_PWC2
1467 } else if (strcmp (mimetype, "video/x-pwc2") == 0) {
1468 fourcc = V4L2_PIX_FMT_PWC2;
1470 } else if (strcmp (mimetype, "video/x-raw-gray") == 0) {
1471 fourcc = V4L2_PIX_FMT_GREY;
1478 *format = gst_v4l2_object_get_format_from_fourcc (v4l2object, fourcc);
1486 gst_v4l2_object_get_nearest_size (GstV4l2Object * v4l2object,
1487 guint32 pixelformat, gint * width, gint * height, gboolean * interlaced);
1490 /* The frame interval enumeration code first appeared in Linux 2.6.19. */
1491 #ifdef VIDIOC_ENUM_FRAMEINTERVALS
1492 static GstStructure *
1493 gst_v4l2_object_probe_caps_for_format_and_size (GstV4l2Object * v4l2object,
1494 guint32 pixelformat,
1495 guint32 width, guint32 height, const GstStructure * template)
1497 gint fd = v4l2object->video_fd;
1498 struct v4l2_frmivalenum ival;
1501 GValue rates = { 0, };
1502 gboolean interlaced;
1503 gint int_width = width;
1504 gint int_height = height;
1506 /* interlaced detection using VIDIOC_TRY/S_FMT */
1507 if (!gst_v4l2_object_get_nearest_size (v4l2object, pixelformat,
1508 &int_width, &int_height, &interlaced))
1511 memset (&ival, 0, sizeof (struct v4l2_frmivalenum));
1513 ival.pixel_format = pixelformat;
1515 ival.height = height;
1517 GST_LOG_OBJECT (v4l2object->element,
1518 "get frame interval for %ux%u, %" GST_FOURCC_FORMAT, width, height,
1519 GST_FOURCC_ARGS (pixelformat));
1521 /* keep in mind that v4l2 gives us frame intervals (durations); we invert the
1522 * fraction to get framerate */
1523 if (v4l2_ioctl (fd, VIDIOC_ENUM_FRAMEINTERVALS, &ival) < 0)
1524 goto enum_frameintervals_failed;
1526 if (ival.type == V4L2_FRMIVAL_TYPE_DISCRETE) {
1527 GValue rate = { 0, };
1529 g_value_init (&rates, GST_TYPE_LIST);
1530 g_value_init (&rate, GST_TYPE_FRACTION);
1533 num = ival.discrete.numerator;
1534 denom = ival.discrete.denominator;
1536 if (num > G_MAXINT || denom > G_MAXINT) {
1537 /* let us hope we don't get here... */
1542 GST_LOG_OBJECT (v4l2object->element, "adding discrete framerate: %d/%d",
1545 /* swap to get the framerate */
1546 gst_value_set_fraction (&rate, denom, num);
1547 gst_value_list_append_value (&rates, &rate);
1550 } while (v4l2_ioctl (fd, VIDIOC_ENUM_FRAMEINTERVALS, &ival) >= 0);
1551 } else if (ival.type == V4L2_FRMIVAL_TYPE_STEPWISE) {
1552 GValue min = { 0, };
1553 GValue step = { 0, };
1554 GValue max = { 0, };
1555 gboolean added = FALSE;
1556 guint32 minnum, mindenom;
1557 guint32 maxnum, maxdenom;
1559 g_value_init (&rates, GST_TYPE_LIST);
1561 g_value_init (&min, GST_TYPE_FRACTION);
1562 g_value_init (&step, GST_TYPE_FRACTION);
1563 g_value_init (&max, GST_TYPE_FRACTION);
1566 minnum = ival.stepwise.min.numerator;
1567 mindenom = ival.stepwise.min.denominator;
1568 if (minnum > G_MAXINT || mindenom > G_MAXINT) {
1572 GST_LOG_OBJECT (v4l2object->element, "stepwise min frame interval: %d/%d",
1574 gst_value_set_fraction (&min, minnum, mindenom);
1577 maxnum = ival.stepwise.max.numerator;
1578 maxdenom = ival.stepwise.max.denominator;
1579 if (maxnum > G_MAXINT || maxdenom > G_MAXINT) {
1584 GST_LOG_OBJECT (v4l2object->element, "stepwise max frame interval: %d/%d",
1586 gst_value_set_fraction (&max, maxnum, maxdenom);
1589 num = ival.stepwise.step.numerator;
1590 denom = ival.stepwise.step.denominator;
1591 if (num > G_MAXINT || denom > G_MAXINT) {
1596 if (num == 0 || denom == 0) {
1597 /* in this case we have a wrong fraction or no step, set the step to max
1598 * so that we only add the min value in the loop below */
1603 /* since we only have gst_value_fraction_subtract and not add, negate the
1605 GST_LOG_OBJECT (v4l2object->element, "stepwise step frame interval: %d/%d",
1607 gst_value_set_fraction (&step, -num, denom);
1609 while (gst_value_compare (&min, &max) <= 0) {
1610 GValue rate = { 0, };
1612 num = gst_value_get_fraction_numerator (&min);
1613 denom = gst_value_get_fraction_denominator (&min);
1614 GST_LOG_OBJECT (v4l2object->element, "adding stepwise framerate: %d/%d",
1617 /* invert to get the framerate */
1618 g_value_init (&rate, GST_TYPE_FRACTION);
1619 gst_value_set_fraction (&rate, denom, num);
1620 gst_value_list_append_value (&rates, &rate);
1623 /* we're actually adding because step was negated above. This is because
1624 * there is no _add function... */
1625 if (!gst_value_fraction_subtract (&min, &min, &step)) {
1626 GST_WARNING_OBJECT (v4l2object->element, "could not step fraction!");
1631 /* no range was added, leave the default range from the template */
1632 GST_WARNING_OBJECT (v4l2object->element,
1633 "no range added, leaving default");
1634 g_value_unset (&rates);
1636 } else if (ival.type == V4L2_FRMIVAL_TYPE_CONTINUOUS) {
1637 guint32 maxnum, maxdenom;
1639 g_value_init (&rates, GST_TYPE_FRACTION_RANGE);
1641 num = ival.stepwise.min.numerator;
1642 denom = ival.stepwise.min.denominator;
1643 if (num > G_MAXINT || denom > G_MAXINT) {
1648 maxnum = ival.stepwise.max.numerator;
1649 maxdenom = ival.stepwise.max.denominator;
1650 if (maxnum > G_MAXINT || maxdenom > G_MAXINT) {
1655 GST_LOG_OBJECT (v4l2object->element,
1656 "continuous frame interval %d/%d to %d/%d", maxdenom, maxnum, denom,
1659 gst_value_set_fraction_range_full (&rates, maxdenom, maxnum, denom, num);
1665 s = gst_structure_copy (template);
1666 gst_structure_set (s, "width", G_TYPE_INT, (gint) width,
1667 "height", G_TYPE_INT, (gint) height,
1668 "interlaced", G_TYPE_BOOLEAN, interlaced, NULL);
1670 if (G_IS_VALUE (&rates)) {
1671 /* only change the framerate on the template when we have a valid probed new
1673 gst_structure_set_value (s, "framerate", &rates);
1674 g_value_unset (&rates);
1676 gst_structure_set (s, "framerate", GST_TYPE_FRACTION_RANGE, 0, 1, 100, 1,
1682 enum_frameintervals_failed:
1684 GST_DEBUG_OBJECT (v4l2object->element,
1685 "Unable to enumerate intervals for %" GST_FOURCC_FORMAT "@%ux%u",
1686 GST_FOURCC_ARGS (pixelformat), width, height);
1691 /* I don't see how this is actually an error, we ignore the format then */
1692 GST_WARNING_OBJECT (v4l2object->element,
1693 "Unknown frame interval type at %" GST_FOURCC_FORMAT "@%ux%u: %u",
1694 GST_FOURCC_ARGS (pixelformat), width, height, ival.type);
1698 #endif /* defined VIDIOC_ENUM_FRAMEINTERVALS */
1700 #ifdef VIDIOC_ENUM_FRAMESIZES
1702 sort_by_frame_size (GstStructure * s1, GstStructure * s2)
1706 gst_structure_get_int (s1, "width", &w1);
1707 gst_structure_get_int (s1, "height", &h1);
1708 gst_structure_get_int (s2, "width", &w2);
1709 gst_structure_get_int (s2, "height", &h2);
1711 /* I think it's safe to assume that this won't overflow for a while */
1712 return ((w2 * h2) - (w1 * h1));
1717 gst_v4l2_object_probe_caps_for_format (GstV4l2Object * v4l2object,
1718 guint32 pixelformat, const GstStructure * template)
1720 GstCaps *ret = gst_caps_new_empty ();
1723 #ifdef VIDIOC_ENUM_FRAMESIZES
1724 gint fd = v4l2object->video_fd;
1725 struct v4l2_frmsizeenum size;
1726 GList *results = NULL;
1729 if (pixelformat == GST_MAKE_FOURCC ('M', 'P', 'E', 'G'))
1730 return gst_caps_new_simple ("video/mpegts", NULL);
1732 memset (&size, 0, sizeof (struct v4l2_frmsizeenum));
1734 size.pixel_format = pixelformat;
1736 GST_DEBUG_OBJECT (v4l2object->element, "Enumerating frame sizes");
1738 if (v4l2_ioctl (fd, VIDIOC_ENUM_FRAMESIZES, &size) < 0)
1739 goto enum_framesizes_failed;
1741 if (size.type == V4L2_FRMSIZE_TYPE_DISCRETE) {
1743 GST_LOG_OBJECT (v4l2object->element, "got discrete frame size %dx%d",
1744 size.discrete.width, size.discrete.height);
1746 w = MIN (size.discrete.width, G_MAXINT);
1747 h = MIN (size.discrete.height, G_MAXINT);
1751 gst_v4l2_object_probe_caps_for_format_and_size (v4l2object,
1752 pixelformat, w, h, template);
1755 results = g_list_prepend (results, tmp);
1759 } while (v4l2_ioctl (fd, VIDIOC_ENUM_FRAMESIZES, &size) >= 0);
1760 GST_DEBUG_OBJECT (v4l2object->element,
1761 "done iterating discrete frame sizes");
1762 } else if (size.type == V4L2_FRMSIZE_TYPE_STEPWISE) {
1763 GST_DEBUG_OBJECT (v4l2object->element, "we have stepwise frame sizes:");
1764 GST_DEBUG_OBJECT (v4l2object->element, "min width: %d",
1765 size.stepwise.min_width);
1766 GST_DEBUG_OBJECT (v4l2object->element, "min height: %d",
1767 size.stepwise.min_height);
1768 GST_DEBUG_OBJECT (v4l2object->element, "max width: %d",
1769 size.stepwise.max_width);
1770 GST_DEBUG_OBJECT (v4l2object->element, "min height: %d",
1771 size.stepwise.max_height);
1772 GST_DEBUG_OBJECT (v4l2object->element, "step width: %d",
1773 size.stepwise.step_width);
1774 GST_DEBUG_OBJECT (v4l2object->element, "step height: %d",
1775 size.stepwise.step_height);
1777 for (w = size.stepwise.min_width, h = size.stepwise.min_height;
1778 w < size.stepwise.max_width && h < size.stepwise.max_height;
1779 w += size.stepwise.step_width, h += size.stepwise.step_height) {
1780 if (w == 0 || h == 0)
1784 gst_v4l2_object_probe_caps_for_format_and_size (v4l2object,
1785 pixelformat, w, h, template);
1788 results = g_list_prepend (results, tmp);
1790 GST_DEBUG_OBJECT (v4l2object->element,
1791 "done iterating stepwise frame sizes");
1792 } else if (size.type == V4L2_FRMSIZE_TYPE_CONTINUOUS) {
1795 GST_DEBUG_OBJECT (v4l2object->element, "we have continuous frame sizes:");
1796 GST_DEBUG_OBJECT (v4l2object->element, "min width: %d",
1797 size.stepwise.min_width);
1798 GST_DEBUG_OBJECT (v4l2object->element, "min height: %d",
1799 size.stepwise.min_height);
1800 GST_DEBUG_OBJECT (v4l2object->element, "max width: %d",
1801 size.stepwise.max_width);
1802 GST_DEBUG_OBJECT (v4l2object->element, "min height: %d",
1803 size.stepwise.max_height);
1805 w = MAX (size.stepwise.min_width, 1);
1806 h = MAX (size.stepwise.min_height, 1);
1807 maxw = MIN (size.stepwise.max_width, G_MAXINT);
1808 maxh = MIN (size.stepwise.max_height, G_MAXINT);
1811 gst_v4l2_object_probe_caps_for_format_and_size (v4l2object, pixelformat,
1814 gst_structure_set (tmp, "width", GST_TYPE_INT_RANGE, (gint) w,
1815 (gint) maxw, "height", GST_TYPE_INT_RANGE, (gint) h, (gint) maxh,
1818 /* no point using the results list here, since there's only one struct */
1819 gst_caps_append_structure (ret, tmp);
1825 /* we use an intermediary list to store and then sort the results of the
1826 * probing because we can't make any assumptions about the order in which
1827 * the driver will give us the sizes, but we want the final caps to contain
1828 * the results starting with the highest resolution and having the lowest
1829 * resolution last, since order in caps matters for things like fixation. */
1830 results = g_list_sort (results, (GCompareFunc) sort_by_frame_size);
1831 while (results != NULL) {
1832 gst_caps_append_structure (ret, GST_STRUCTURE (results->data));
1833 results = g_list_delete_link (results, results);
1836 if (gst_caps_is_empty (ret))
1837 goto enum_framesizes_no_results;
1842 enum_framesizes_failed:
1844 /* I don't see how this is actually an error */
1845 GST_DEBUG_OBJECT (v4l2object->element,
1846 "Failed to enumerate frame sizes for pixelformat %" GST_FOURCC_FORMAT
1847 " (%s)", GST_FOURCC_ARGS (pixelformat), g_strerror (errno));
1848 goto default_frame_sizes;
1850 enum_framesizes_no_results:
1852 /* it's possible that VIDIOC_ENUM_FRAMESIZES is defined but the driver in
1853 * question doesn't actually support it yet */
1854 GST_DEBUG_OBJECT (v4l2object->element,
1855 "No results for pixelformat %" GST_FOURCC_FORMAT
1856 " enumerating frame sizes, trying fallback",
1857 GST_FOURCC_ARGS (pixelformat));
1858 goto default_frame_sizes;
1862 GST_WARNING_OBJECT (v4l2object->element,
1863 "Unknown frame sizeenum type for pixelformat %" GST_FOURCC_FORMAT
1864 ": %u", GST_FOURCC_ARGS (pixelformat), size.type);
1865 goto default_frame_sizes;
1867 default_frame_sizes:
1868 #endif /* defined VIDIOC_ENUM_FRAMESIZES */
1870 gint min_w, max_w, min_h, max_h, fix_num = 0, fix_denom = 0;
1871 gboolean interlaced;
1873 /* This code is for Linux < 2.6.19 */
1875 max_w = max_h = GST_V4L2_MAX_SIZE;
1876 if (!gst_v4l2_object_get_nearest_size (v4l2object, pixelformat, &min_w,
1877 &min_h, &interlaced)) {
1878 GST_WARNING_OBJECT (v4l2object->element,
1879 "Could not probe minimum capture size for pixelformat %"
1880 GST_FOURCC_FORMAT, GST_FOURCC_ARGS (pixelformat));
1882 if (!gst_v4l2_object_get_nearest_size (v4l2object, pixelformat, &max_w,
1883 &max_h, &interlaced)) {
1884 GST_WARNING_OBJECT (v4l2object->element,
1885 "Could not probe maximum capture size for pixelformat %"
1886 GST_FOURCC_FORMAT, GST_FOURCC_ARGS (pixelformat));
1889 /* Since we can't get framerate directly, try to use the current norm */
1890 if (v4l2object->norm && v4l2object->norms) {
1892 GstTunerNorm *norm = NULL;
1894 for (norms = v4l2object->norms; norms != NULL; norms = norms->next) {
1895 norm = (GstTunerNorm *) norms->data;
1896 if (!strcmp (norm->label, v4l2object->norm))
1899 /* If it's possible, set framerate to that (discrete) value */
1901 fix_num = gst_value_get_fraction_numerator (&norm->framerate);
1902 fix_denom = gst_value_get_fraction_denominator (&norm->framerate);
1906 tmp = gst_structure_copy (template);
1908 gst_structure_set (tmp, "framerate", GST_TYPE_FRACTION, fix_num,
1911 /* if norm can't be used, copy the template framerate */
1912 gst_structure_set (tmp, "framerate", GST_TYPE_FRACTION_RANGE, 0, 1,
1917 gst_structure_set (tmp, "width", G_TYPE_INT, max_w, NULL);
1919 gst_structure_set (tmp, "width", GST_TYPE_INT_RANGE, min_w, max_w, NULL);
1922 gst_structure_set (tmp, "height", G_TYPE_INT, max_h, NULL);
1924 gst_structure_set (tmp, "height", GST_TYPE_INT_RANGE, min_h, max_h, NULL);
1926 gst_structure_set (tmp, "interlaced", G_TYPE_BOOLEAN, interlaced, NULL);
1928 gst_caps_append_structure (ret, tmp);
1935 gst_v4l2_object_get_nearest_size (GstV4l2Object * v4l2object,
1936 guint32 pixelformat, gint * width, gint * height, gboolean * interlaced)
1938 struct v4l2_format fmt;
1942 g_return_val_if_fail (width != NULL, FALSE);
1943 g_return_val_if_fail (height != NULL, FALSE);
1945 GST_LOG_OBJECT (v4l2object->element,
1946 "getting nearest size to %dx%d with format %" GST_FOURCC_FORMAT,
1947 *width, *height, GST_FOURCC_ARGS (pixelformat));
1949 fd = v4l2object->video_fd;
1951 /* get size delimiters */
1952 memset (&fmt, 0, sizeof (fmt));
1953 fmt.type = v4l2object->type;
1954 fmt.fmt.pix.width = *width;
1955 fmt.fmt.pix.height = *height;
1956 fmt.fmt.pix.pixelformat = pixelformat;
1957 fmt.fmt.pix.field = V4L2_FIELD_NONE;
1959 r = v4l2_ioctl (fd, VIDIOC_TRY_FMT, &fmt);
1960 if (r < 0 && errno == EINVAL) {
1961 /* try again with interlaced video */
1962 fmt.fmt.pix.width = *width;
1963 fmt.fmt.pix.height = *height;
1964 fmt.fmt.pix.pixelformat = pixelformat;
1965 fmt.fmt.pix.field = V4L2_FIELD_INTERLACED;
1966 r = v4l2_ioctl (fd, VIDIOC_TRY_FMT, &fmt);
1970 /* The driver might not implement TRY_FMT, in which case we will try
1972 if (errno != ENOTTY)
1975 /* Only try S_FMT if we're not actively capturing yet, which we shouldn't
1976 be, because we're still probing */
1977 if (GST_V4L2_IS_ACTIVE (v4l2object))
1980 GST_LOG_OBJECT (v4l2object->element,
1981 "Failed to probe size limit with VIDIOC_TRY_FMT, trying VIDIOC_S_FMT");
1983 fmt.fmt.pix.width = *width;
1984 fmt.fmt.pix.height = *height;
1986 r = v4l2_ioctl (fd, VIDIOC_S_FMT, &fmt);
1987 if (r < 0 && errno == EINVAL) {
1988 /* try again with progressive video */
1989 fmt.fmt.pix.width = *width;
1990 fmt.fmt.pix.height = *height;
1991 fmt.fmt.pix.pixelformat = pixelformat;
1992 fmt.fmt.pix.field = V4L2_FIELD_NONE;
1993 r = v4l2_ioctl (fd, VIDIOC_S_FMT, &fmt);
2000 GST_LOG_OBJECT (v4l2object->element,
2001 "got nearest size %dx%d", fmt.fmt.pix.width, fmt.fmt.pix.height);
2003 *width = fmt.fmt.pix.width;
2004 *height = fmt.fmt.pix.height;
2006 switch (fmt.fmt.pix.field) {
2007 case V4L2_FIELD_ANY:
2008 case V4L2_FIELD_NONE:
2009 *interlaced = FALSE;
2011 case V4L2_FIELD_INTERLACED:
2012 case V4L2_FIELD_INTERLACED_TB:
2013 case V4L2_FIELD_INTERLACED_BT:
2017 GST_WARNING_OBJECT (v4l2object->element,
2018 "Unsupported field type for %" GST_FOURCC_FORMAT "@%ux%u",
2019 GST_FOURCC_ARGS (pixelformat), *width, *height);
2028 gst_v4l2_object_set_format (GstV4l2Object * v4l2object, guint32 pixelformat,
2029 guint32 width, guint32 height, gboolean interlaced)
2031 gint fd = v4l2object->video_fd;
2032 struct v4l2_format format;
2033 enum v4l2_field field;
2036 GST_DEBUG_OBJECT (v4l2object->element, "interlaced video");
2037 /* ideally we would differentiate between types of interlaced video
2038 * but there is not sufficient information in the caps..
2040 field = V4L2_FIELD_INTERLACED;
2042 GST_DEBUG_OBJECT (v4l2object->element, "progressive video");
2043 field = V4L2_FIELD_NONE;
2046 GST_DEBUG_OBJECT (v4l2object->element, "Setting format to %dx%d, format "
2047 "%" GST_FOURCC_FORMAT, width, height, GST_FOURCC_ARGS (pixelformat));
2049 GST_V4L2_CHECK_OPEN (v4l2object);
2050 GST_V4L2_CHECK_NOT_ACTIVE (v4l2object);
2052 if (pixelformat == GST_MAKE_FOURCC ('M', 'P', 'E', 'G'))
2055 memset (&format, 0x00, sizeof (struct v4l2_format));
2056 format.type = v4l2object->type;
2058 if (v4l2_ioctl (fd, VIDIOC_G_FMT, &format) < 0)
2059 goto get_fmt_failed;
2061 if (format.type == v4l2object->type &&
2062 format.fmt.pix.width == width &&
2063 format.fmt.pix.height == height &&
2064 format.fmt.pix.pixelformat == pixelformat &&
2065 format.fmt.pix.field == field) {
2066 /* Nothing to do. We want to succeed immediately
2067 * here because setting the same format back
2068 * can still fail due to EBUSY. By short-circuiting
2069 * here, we allow pausing and re-playing pipelines
2070 * with changed caps, as long as the changed caps
2071 * do not change the webcam's format. Otherwise,
2072 * any caps change would require us to go to NULL
2073 * state to close the device and set format.
2078 format.type = v4l2object->type;
2079 format.fmt.pix.width = width;
2080 format.fmt.pix.height = height;
2081 format.fmt.pix.pixelformat = pixelformat;
2082 format.fmt.pix.field = field;
2084 if (v4l2_ioctl (fd, VIDIOC_S_FMT, &format) < 0) {
2085 goto set_fmt_failed;
2088 if (format.fmt.pix.width != width || format.fmt.pix.height != height)
2089 goto invalid_dimensions;
2091 if (format.fmt.pix.pixelformat != pixelformat)
2092 goto invalid_pixelformat;
2099 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, SETTINGS,
2100 (_("Device '%s' does not support video capture"),
2101 v4l2object->videodev),
2102 ("Call to G_FMT failed: (%s)", g_strerror (errno)));
2107 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, SETTINGS,
2108 (_("Device '%s' cannot capture at %dx%d"),
2109 v4l2object->videodev, width, height),
2110 ("Call to S_FMT failed for %" GST_FOURCC_FORMAT " @ %dx%d: %s",
2111 GST_FOURCC_ARGS (pixelformat), width, height, g_strerror (errno)));
2116 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, SETTINGS,
2117 (_("Device '%s' cannot capture at %dx%d"),
2118 v4l2object->videodev, width, height),
2119 ("Tried to capture at %dx%d, but device returned size %dx%d",
2120 width, height, format.fmt.pix.width, format.fmt.pix.height));
2123 invalid_pixelformat:
2125 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, SETTINGS,
2126 (_("Device '%s' cannot capture in the specified format"),
2127 v4l2object->videodev),
2128 ("Tried to capture in %" GST_FOURCC_FORMAT
2129 ", but device returned format" " %" GST_FOURCC_FORMAT,
2130 GST_FOURCC_ARGS (pixelformat),
2131 GST_FOURCC_ARGS (format.fmt.pix.pixelformat)));
2137 gst_v4l2_object_start_streaming (GstV4l2Object * v4l2object)
2139 if (v4l2_ioctl (v4l2object->video_fd, VIDIOC_STREAMON,
2140 &(v4l2object->type)) < 0) {
2141 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, OPEN_READ,
2142 (_("Error starting streaming on device '%s'."), v4l2object->videodev),
2150 gst_v4l2_object_stop_streaming (GstV4l2Object * v4l2object)
2152 if (v4l2_ioctl (v4l2object->video_fd, VIDIOC_STREAMOFF,
2153 &(v4l2object->type)) < 0) {
2154 GST_ELEMENT_ERROR (v4l2object->element, RESOURCE, OPEN_READ,
2155 (_("Error stopping streaming on device '%s'."), v4l2object->videodev),