/**
* SECTION:gesvideosource
+ * @title: GESVideoSource
* @short_description: Base Class for video sources
*
- * <refsect1 id="GESVideoSource.children_properties" role="properties">
- * <title role="children_properties.title">Children Properties</title>
- * <para>You can use the following children properties through the
- * #ges_track_element_set_child_property and alike set of methods:</para>
- * <informaltable frame="none">
- * <tgroup cols="3">
- * <colspec colname="properties_type" colwidth="150px"/>
- * <colspec colname="properties_name" colwidth="200px"/>
- * <colspec colname="properties_flags" colwidth="400px"/>
- * <tbody>
- * <row>
- * <entry role="property_type"><link linkend="gdouble"><type>double</type></link></entry>
- * <entry role="property_name"><link linkend="GESVideoSource--alpha">alpha</link></entry>
- * <entry>The desired alpha for the stream.</entry>
- * </row>
- * <row>
- * <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
- * <entry role="property_name"><link linkend="GESVideoSource--posx">posx</link></entry>
- * <entry>The desired x position for the stream.</entry>
- * </row>
- * <row>
- * <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
- * <entry role="property_name"><link linkend="GESVideoSource--posy">posy</link></entry>
- * <entry>The desired y position for the stream</entry>
- * </row>
- * <row>
- * <entry role="property_type"><link linkend="guint"><type>guint</type></link></entry>
- * <entry role="property_name"><link linkend="GESVideoSource--zorder">zorder</link></entry>
- * <entry>The desired z order for the stream</entry>
- * </row>
- * <row>
- * <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
- * <entry role="property_name"><link linkend="GESVideoSource--width">width</link></entry>
- * <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>
- * </row>
- * <row>
- * <entry role="property_type"><link linkend="gint"><type>gint</type></link></entry>
- * <entry role="property_name"><link linkend="GESVideoSource--height">height</link></entry>
- * <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>
- * </row>
- * </tbody>
- * </tgroup>
- * </informaltable>
- * </refsect1>
+ * ## Children Properties:
+ *
+ * You can use the following children properties through the
+ * #ges_track_element_set_child_property and alike set of methods:
+ *
+ * - #gdouble `alpha`: The desired alpha for the stream.
+ * - #gint `posx`: The desired x position for the stream.
+ * - #gint `posy`: The desired y position for the stream
+ * - #gint `width`: The desired width for that source.
+ * Set to 0 if size is not mandatory, will be set to width of the current track.
+ * - #gint `height`: The desired height for that source.
+ * Set to 0 if size is not mandatory, will be set to height of the current track.
+ * - #GstDeinterlaceModes `deinterlace-mode`: Deinterlace Mode
+ * - #GstDeinterlaceFields `deinterlace-fields`: Fields to use for deinterlacing
+ * - #GstDeinterlaceFieldLayout `deinterlace-tff`: Deinterlace top field first
+ * - #GstVideoOrientationMethod `video-direction`: The desired video rotation and flipping.
*/
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
#include <gst/pbutils/missing-plugins.h>
+#include <gst/video/video.h>
#include "ges-internal.h"
#include "ges/ges-meta-container.h"
#include "ges-track-element.h"
#include "ges-video-source.h"
#include "ges-layer.h"
-#include "gstframepositionner.h"
+#include "gstframepositioner.h"
#define parent_class ges_video_source_parent_class
-G_DEFINE_ABSTRACT_TYPE (GESVideoSource, ges_video_source, GES_TYPE_SOURCE);
struct _GESVideoSourcePrivate
{
- GstFramePositionner *positionner;
+ GstFramePositioner *positioner;
GstElement *capsfilter;
};
+G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE (GESVideoSource, ges_video_source,
+ GES_TYPE_SOURCE);
+
/* TrackElement VMethods */
static gboolean
res = GES_TIMELINE_ELEMENT_CLASS (parent_class)->set_priority (element,
priority);
- if (res && self->priv->positionner)
- g_object_set (self->priv->positionner, "zorder",
- GES_TIMELINE_ELEMENT_PRIORITY (self), NULL);
+ if (res && self->priv->positioner)
+ g_object_set (self->priv->positioner, "zorder", G_MAXUINT - priority, NULL);
return res;
}
{
GstElement *topbin;
GstElement *sub_element;
- GstElement *queue = gst_element_factory_make ("queue", NULL);
GESVideoSourceClass *source_class = GES_VIDEO_SOURCE_GET_CLASS (trksrc);
GESVideoSource *self;
- GstElement *positionner, *videoscale, *videorate, *capsfilter, *videoconvert,
- *deinterlace;
- const gchar *props[] = { "alpha", "posx", "posy", "width", "height", NULL };
- GESTimelineElement *parent;
+ GstElement *positioner, *videoflip, *capsfilter, *deinterlace;
+ const gchar *positioner_props[] =
+ { "alpha", "posx", "posy", "width", "height", NULL };
+ const gchar *deinterlace_props[] = { "mode", "fields", "tff", NULL };
+ const gchar *videoflip_props[] = { "video-direction", NULL };
+ gboolean needs_converters = TRUE;
+ GPtrArray *elements;
if (!source_class->create_source)
return NULL;
sub_element = source_class->create_source (trksrc);
self = (GESVideoSource *) trksrc;
+ if (source_class->ABI.abi.needs_converters)
+ needs_converters = source_class->ABI.abi.needs_converters (self);
+
+ elements = g_ptr_array_new ();
+ g_ptr_array_add (elements, gst_element_factory_make ("queue", NULL));
- /* That positionner will add metadata to buffers according to its
+ /* That positioner will add metadata to buffers according to its
properties, acting like a proxy for our smart-mixer dynamic pads. */
- positionner = gst_element_factory_make ("framepositionner", "frame_tagger");
+ positioner = gst_element_factory_make ("framepositioner", "frame_tagger");
+ g_object_set (positioner, "zorder",
+ G_MAXUINT - GES_TIMELINE_ELEMENT_PRIORITY (self), NULL);
+ g_ptr_array_add (elements, positioner);
- videoscale =
- gst_element_factory_make ("videoscale", "track-element-videoscale");
- videoconvert =
- gst_element_factory_make ("videoconvert", "track-element-videoconvert");
- videorate = gst_element_factory_make ("videorate", "track-element-videorate");
- deinterlace = gst_element_factory_make ("deinterlace", "deinterlace");
- if (deinterlace == NULL) {
- deinterlace = gst_element_factory_make ("avdeinterlace", "deinterlace");
+ /* If there's image-orientation tag, make sure the image is correctly oriented
+ * before we scale it. */
+ videoflip = gst_element_factory_make ("videoflip", "track-element-videoflip");
+ g_object_set (videoflip, "video-direction", GST_VIDEO_ORIENTATION_AUTO, NULL);
+ g_ptr_array_add (elements, videoflip);
+
+ if (needs_converters) {
+ g_ptr_array_add (elements, gst_element_factory_make ("videoscale",
+ "track-element-videoscale"));
+ g_ptr_array_add (elements, gst_element_factory_make ("videoconvert",
+ "track-element-videoconvert"));
}
+ g_ptr_array_add (elements, gst_element_factory_make ("videorate",
+ "track-element-videorate"));
capsfilter =
gst_element_factory_make ("capsfilter", "track-element-capsfilter");
+ g_ptr_array_add (elements, capsfilter);
- ges_frame_positionner_set_source_and_filter (GST_FRAME_POSITIONNER
- (positionner), trksrc, capsfilter);
+ ges_frame_positioner_set_source_and_filter (GST_FRAME_POSITIONNER
+ (positioner), trksrc, capsfilter);
- ges_track_element_add_children_props (trksrc, positionner, NULL, NULL, props);
+ ges_track_element_add_children_props (trksrc, positioner, NULL, NULL,
+ positioner_props);
+ ges_track_element_add_children_props (trksrc, videoflip, NULL, NULL,
+ videoflip_props);
+ deinterlace = gst_element_factory_make ("deinterlace", "deinterlace");
if (deinterlace == NULL) {
post_missing_element_message (sub_element, "deinterlace");
GST_ELEMENT_WARNING (sub_element, CORE, MISSING_PLUGIN,
("Missing element '%s' - check your GStreamer installation.",
"deinterlace"), ("deinterlacing won't work"));
- topbin =
- ges_source_create_topbin ("videosrcbin", sub_element, queue,
- videoconvert, positionner, videoscale, videorate, capsfilter, NULL);
} else {
- topbin =
- ges_source_create_topbin ("videosrcbin", sub_element, queue,
- videoconvert, deinterlace, positionner, videoscale, videorate,
- capsfilter, NULL);
- }
-
- parent = ges_timeline_element_get_parent (GES_TIMELINE_ELEMENT (trksrc));
- if (parent) {
- self->priv->positionner = GST_FRAME_POSITIONNER (positionner);
- gst_object_unref (parent);
- } else {
- GST_ERROR ("No parent timeline element, SHOULD NOT HAPPEN");
+ g_ptr_array_add (elements, deinterlace);
+ ges_track_element_add_children_props (trksrc, deinterlace, NULL, NULL,
+ deinterlace_props);
}
+ topbin = ges_source_create_topbin ("videosrcbin", sub_element, elements);
+ g_ptr_array_free (elements, TRUE);
+ self->priv->positioner = GST_FRAME_POSITIONNER (positioner);
+ self->priv->positioner->scale_in_compositor =
+ !GES_VIDEO_SOURCE_GET_CLASS (self)->ABI.abi.disable_scale_in_compositor;
self->priv->capsfilter = capsfilter;
return topbin;
}
+static gboolean
+_lookup_child (GESTimelineElement * object,
+ const gchar * prop_name, GObject ** element, GParamSpec ** pspec)
+{
+ gboolean res;
+
+ gchar *clean_name;
+
+ if (!g_strcmp0 (prop_name, "deinterlace-fields"))
+ clean_name = g_strdup ("GstDeinterlace::fields");
+ else if (!g_strcmp0 (prop_name, "deinterlace-mode"))
+ clean_name = g_strdup ("GstDeinterlace::mode");
+ else if (!g_strcmp0 (prop_name, "deinterlace-tff"))
+ clean_name = g_strdup ("GstDeinterlace::tff");
+ else if (!g_strcmp0 (prop_name, "tff") ||
+ !g_strcmp0 (prop_name, "fields") || !g_strcmp0 (prop_name, "mode")) {
+ GST_DEBUG_OBJECT (object, "Not allowed to use GstDeinterlace %s"
+ " property without prefixing its name", prop_name);
+ return FALSE;
+ } else
+ clean_name = g_strdup (prop_name);
+
+ res =
+ GES_TIMELINE_ELEMENT_CLASS (ges_video_source_parent_class)->lookup_child
+ (object, clean_name, element, pspec);
+
+ g_free (clean_name);
+
+ return res;
+}
+
static void
ges_video_source_class_init (GESVideoSourceClass * klass)
{
- GESTrackElementClass *track_class = GES_TRACK_ELEMENT_CLASS (klass);
+ GESTrackElementClass *track_element_class = GES_TRACK_ELEMENT_CLASS (klass);
GESTimelineElementClass *element_class = GES_TIMELINE_ELEMENT_CLASS (klass);
GESVideoSourceClass *video_source_class = GES_VIDEO_SOURCE_CLASS (klass);
- g_type_class_add_private (klass, sizeof (GESVideoSourcePrivate));
-
element_class->set_priority = _set_priority;
+ element_class->lookup_child = _lookup_child;
- track_class->nleobject_factorytype = "nlesource";
- track_class->create_element = ges_video_source_create_element;
+ track_element_class->nleobject_factorytype = "nlesource";
+ track_element_class->create_element = ges_video_source_create_element;
video_source_class->create_source = NULL;
}
static void
ges_video_source_init (GESVideoSource * self)
{
- self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
- GES_TYPE_VIDEO_SOURCE, GESVideoSourcePrivate);
- self->priv->positionner = NULL;
+ self->priv = ges_video_source_get_instance_private (self);
+ self->priv->positioner = NULL;
self->priv->capsfilter = NULL;
+
+}
+
+/**
+ * ges_video_source_get_natural_size:
+ * @self: A #GESVideoSource
+ * @width: (out): The natural width of the underlying source
+ * @height: (out): The natural height of the underlying source
+ *
+ * Retrieves the natural size of the video stream. The natural size, is
+ * the size at which it will be displayed if no scaling is being applied.
+ *
+ * NOTE: The sources take into account the potential video rotation applied
+ * by the #videoflip element that is inside the source, effects applied on
+ * the clip which potentially also rotate the element are not taken into
+ * account.
+ *
+ * Returns: %TRUE if the object has a natural size, %FALSE otherwise.
+ */
+gboolean
+ges_video_source_get_natural_size (GESVideoSource * self, gint * width,
+ gint * height)
+{
+ GESVideoSourceClass *klass = GES_VIDEO_SOURCE_GET_CLASS (self);
+
+ if (!klass->ABI.abi.get_natural_size)
+ return FALSE;
+
+ return klass->ABI.abi.get_natural_size (self, width, height);
}