1 /* GStreamer
2 * (c) 2005 Ronald S. Bultje <rbultje@ronald.bitfreak.net>
3 * (c) 2006 Jan Schmidt <thaytan@noraisin.net>
4 * (c) 2008 Stefan Kost <ensonic@users.sf.net>
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
15 *
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
20 */
21
22 /**
23 * SECTION:element-autovideosrc
24 * @see_also: autoaudiosrc, v4l2src, v4lsrc
25 *
26 * autovideosrc is a video src that automatically detects an appropriate
27 * video source to use. It does so by scanning the registry for all elements
28 * that have <quote>Source</quote> and <quote>Video</quote> in the class field
29 * of their element information, and also have a non-zero autoplugging rank.
30 *
31 * <refsect2>
32 * <title>Example launch line</title>
33 * |[
34 * gst-launch-1.0 -v -m autovideosrc ! xvimagesink
35 * ]|
36 * </refsect2>
37 */
38
39 #ifdef HAVE_CONFIG_H
40 #include "config.h"
41 #endif
42
43 #include "gstautovideosrc.h"
44
45 G_DEFINE_TYPE (GstAutoVideoSrc, gst_auto_video_src, GST_TYPE_AUTO_DETECT);
46
47 static GstStaticPadTemplate src_template = GST_STATIC_PAD_TEMPLATE ("src",
48 GST_PAD_SRC,
49 GST_PAD_ALWAYS,
50 GST_STATIC_CAPS_ANY);
51
52 static GstElement *
gst_auto_video_src_create_fake_element(GstAutoDetect * autodetect)53 gst_auto_video_src_create_fake_element (GstAutoDetect * autodetect)
54 {
55 GstElement *fake;
56
57 fake = gst_element_factory_make ("videotestsrc", "fake-auto-video-src");
58 if (fake != NULL) {
59 g_object_set (fake, "is-live", TRUE, NULL);
60 } else {
61 GST_ELEMENT_ERROR (autodetect, RESOURCE, NOT_FOUND,
62 ("Failed to find usable video source element."),
63 ("Failed to find a usable video source and couldn't create a video"
64 "testsrc as fallback either, check your GStreamer installation."));
65 /* This will error out with not-negotiated.. */
66 fake = gst_element_factory_make ("fakesrc", "fake-auto-video-src");
67 }
68 return fake;
69 }
70
71 static void
gst_auto_video_src_class_init(GstAutoVideoSrcClass * klass)72 gst_auto_video_src_class_init (GstAutoVideoSrcClass * klass)
73 {
74 GstAutoDetectClass *autoclass = GST_AUTO_DETECT_CLASS (klass);
75 GstElementClass *eklass = GST_ELEMENT_CLASS (klass);
76
77 gst_element_class_add_static_pad_template (eklass, &src_template);
78 gst_element_class_set_static_metadata (eklass, "Auto video source",
79 "Source/Video",
80 "Wrapper video source for automatically detected video source",
81 "Jan Schmidt <thaytan@noraisin.net>, "
82 "Stefan Kost <ensonic@users.sf.net>");
83
84 autoclass->create_fake_element = gst_auto_video_src_create_fake_element;
85 }
86
87 static void
gst_auto_video_src_init(GstAutoVideoSrc * src)88 gst_auto_video_src_init (GstAutoVideoSrc * src)
89 {
90 GstAutoDetect *autodetect = GST_AUTO_DETECT (src);
91
92 autodetect->media_klass = "Video";
93 autodetect->flag = GST_ELEMENT_FLAG_SOURCE;
94 }
95