ges/ges-video-source.c

   1 /* GStreamer Editing Services
   2  * Copyright (C) 2009 Edward Hervey <edward.hervey@collabora.co.uk>
   3  *               2009 Nokia Corporation
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Library General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Library General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Library General Public
  16  * License along with this library; if not, write to the
  17  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  18  * Boston, MA 02110-1301, USA.
  19  */
  20
  21 /**
  22  * SECTION:gesvideosource
  23  * @short_description: Base Class for video sources
  24  *
  25  * <refsect1 id="GESVideoSource.children_properties" role="properties">
  26  * <title role="children_properties.title">Children Properties</title>
  27  * <para>You can use the following children properties through the
  28  * #ges_track_element_set_child_property and alike set of methods:</para>
  29  * <informaltable frame="none">
  30  * <tgroup cols="3">
  31  * <colspec colname="properties_type" colwidth="150px"/>
  32  * <colspec colname="properties_name" colwidth="200px"/>
  33  * <colspec colname="properties_flags" colwidth="400px"/>
  34  * <tbody>
  35  * <row>
  36  *  <entry role="property_type"><link linkend="gdouble"><type>double</type></link></entry>
  37  *  <entry role="property_name"><link linkend="GESVideoSource--alpha">alpha</link></entry>
  38  *  <entry>The desired alpha for the stream.</entry>
  39  * </row>
  40  * <row>
  41  *  <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
  42  *  <entry role="property_name"><link linkend="GESVideoSource--posx">posx</link></entry>
  43  *  <entry>The desired x position for the stream.</entry>
  44  * </row>
  45  * <row>
  46  *  <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
  47  *  <entry role="property_name"><link linkend="GESVideoSource--posy">posy</link></entry>
  48  *  <entry>The desired y position for the stream</entry>
  49  * </row>
  50  * <row>
  51  *  <entry role="property_type"><link linkend="guint"><type>guint</type></link></entry>
  52  *  <entry role="property_name"><link linkend="GESVideoSource--zorder">zorder</link></entry>
  53  *  <entry>The desired z order for the stream</entry>
  54  * </row>
  55  * <row>
  56  *  <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
  57  *  <entry role="property_name"><link linkend="GESVideoSource--width">width</link></entry>
  58  *  <entry>The desired width for that source. Set to 0 if size is not mandatory, will be set to width of the current track.</entry>
  59  * </row>
  60  * <row>
  61  *  <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
  62  *  <entry role="property_name"><link linkend="GESVideoSource--height">height</link></entry>
  63  *  <entry>The desired height for that source. Set to 0 if size is not mandatory, will be set to height of the current track.</entry>
  64  * </row>
  65  * </tbody>
  66  * </tgroup>
  67  * </informaltable>
  68  * </refsect1>
  69  */
  70
  71 #include <gst/pbutils/missing-plugins.h>
  72
  73 #include "ges-internal.h"
  74 #include "ges/ges-meta-container.h"
  75 #include "ges-track-element.h"
  76 #include "ges-video-source.h"
  77 #include "ges-layer.h"
  78 #include "gstframepositioner.h"
  79
  80 #define parent_class ges_video_source_parent_class
  81 G_DEFINE_ABSTRACT_TYPE (GESVideoSource, ges_video_source, GES_TYPE_SOURCE);
  82
  83 struct _GESVideoSourcePrivate
  84 {
  85   GstFramePositioner *positioner;
  86   GstElement *capsfilter;
  87 };
  88
  89 /* TrackElement VMethods */
  90
  91 static gboolean
  92 _set_priority (GESTimelineElement * element, guint32 priority)
  93 {
  94   gboolean res;
  95   GESVideoSource *self = GES_VIDEO_SOURCE (element);
  96
  97   res = GES_TIMELINE_ELEMENT_CLASS (parent_class)->set_priority (element,
  98       priority);
  99
 100   if (res && self->priv->positioner)
 101     g_object_set (self->priv->positioner, "zorder", G_MAXUINT - priority, NULL);
 102
 103   return res;
 104 }
 105
 106 static void
 107 post_missing_element_message (GstElement * element, const gchar * name)
 108 {
 109   GstMessage *msg;
 110
 111   msg = gst_missing_element_message_new (element, name);
 112   gst_element_post_message (element, msg);
 113 }
 114
 115 static GstElement *
 116 ges_video_source_create_element (GESTrackElement * trksrc)
 117 {
 118   GstElement *topbin;
 119   GstElement *sub_element;
 120   GstElement *queue = gst_element_factory_make ("queue", NULL);
 121   GESVideoSourceClass *source_class = GES_VIDEO_SOURCE_GET_CLASS (trksrc);
 122   GESVideoSource *self;
 123   GstElement *positioner, *videoscale, *videorate, *capsfilter, *videoconvert,
 124       *deinterlace;
 125   const gchar *props[] = { "alpha", "posx", "posy", "width", "height", NULL };
 126
 127   if (!source_class->create_source)
 128     return NULL;
 129
 130   sub_element = source_class->create_source (trksrc);
 131
 132   self = (GESVideoSource *) trksrc;
 133
 134   /* That positioner will add metadata to buffers according to its
 135      properties, acting like a proxy for our smart-mixer dynamic pads. */
 136   positioner = gst_element_factory_make ("framepositioner", "frame_tagger");
 137   g_object_set (positioner, "zorder",
 138       G_MAXUINT - GES_TIMELINE_ELEMENT_PRIORITY (self), NULL);
 139
 140   videoscale =
 141       gst_element_factory_make ("videoscale", "track-element-videoscale");
 142   videoconvert =
 143       gst_element_factory_make ("videoconvert", "track-element-videoconvert");
 144   videorate = gst_element_factory_make ("videorate", "track-element-videorate");
 145   deinterlace = gst_element_factory_make ("deinterlace", "deinterlace");
 146   capsfilter =
 147       gst_element_factory_make ("capsfilter", "track-element-capsfilter");
 148
 149   ges_frame_positioner_set_source_and_filter (GST_FRAME_POSITIONNER
 150       (positioner), trksrc, capsfilter);
 151
 152   ges_track_element_add_children_props (trksrc, positioner, NULL, NULL, props);
 153
 154   if (deinterlace == NULL) {
 155     post_missing_element_message (sub_element, "deinterlace");
 156
 157     GST_ELEMENT_WARNING (sub_element, CORE, MISSING_PLUGIN,
 158         ("Missing element '%s' - check your GStreamer installation.",
 159             "deinterlace"), ("deinterlacing won't work"));
 160     topbin =
 161         ges_source_create_topbin ("videosrcbin", sub_element, queue,
 162         videoconvert, positioner, videoscale, videorate, capsfilter, NULL);
 163   } else {
 164     topbin =
 165         ges_source_create_topbin ("videosrcbin", sub_element, queue,
 166         videoconvert, deinterlace, positioner, videoscale, videorate,
 167         capsfilter, NULL);
 168   }
 169
 170   self->priv->positioner = GST_FRAME_POSITIONNER (positioner);
 171   self->priv->capsfilter = capsfilter;
 172
 173   return topbin;
 174 }
 175
 176 static void
 177 ges_video_source_class_init (GESVideoSourceClass * klass)
 178 {
 179   GESTrackElementClass *track_class = GES_TRACK_ELEMENT_CLASS (klass);
 180   GESTimelineElementClass *element_class = GES_TIMELINE_ELEMENT_CLASS (klass);
 181   GESVideoSourceClass *video_source_class = GES_VIDEO_SOURCE_CLASS (klass);
 182
 183   g_type_class_add_private (klass, sizeof (GESVideoSourcePrivate));
 184
 185   element_class->set_priority = _set_priority;
 186
 187   track_class->nleobject_factorytype = "nlesource";
 188   track_class->create_element = ges_video_source_create_element;
 189   video_source_class->create_source = NULL;
 190 }
 191
 192 static void
 193 ges_video_source_init (GESVideoSource * self)
 194 {
 195   self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
 196       GES_TYPE_VIDEO_SOURCE, GESVideoSourcePrivate);
 197   self->priv->positioner = NULL;
 198   self->priv->capsfilter = NULL;
 199 }