Added gst-plugins-base-subtitles0.10-0.10.34 for Meego Harmattan 1.2
[mafwsubrenderer] / gst-plugins-base-subtitles0.10 / gst-libs / gst / video / gstvideosink.c
diff --git a/gst-plugins-base-subtitles0.10/gst-libs/gst/video/gstvideosink.c b/gst-plugins-base-subtitles0.10/gst-libs/gst/video/gstvideosink.c
new file mode 100644 (file)
index 0000000..2e578d3
--- /dev/null
@@ -0,0 +1,288 @@
+/*  GStreamer video sink base class
+ *  Copyright (C) <2003> Julien Moutte <julien@moutte.net>
+ *  Copyright (C) <2009> Tim-Philipp Müller <tim centricular net>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/**
+ * SECTION:gstvideosink
+ * @short_description: Base class for video sinks
+ * 
+ * <refsect2>
+ * <para>
+ * Provides useful functions and a base class for video sinks. 
+ * </para>
+ * <para>
+ * GstVideoSink will configure the default base sink to drop frames that
+ * arrive later than 20ms as this is considered the default threshold for
+ * observing out-of-sync frames.
+ * </para>
+ * </refsect2>
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include "gstvideosink.h"
+
+enum
+{
+  PROP_SHOW_PREROLL_FRAME = 1
+};
+
+#define DEFAULT_SHOW_PREROLL_FRAME TRUE
+
+struct _GstVideoSinkPrivate
+{
+  gboolean show_preroll_frame;  /* ATOMIC */
+};
+
+GST_DEBUG_CATEGORY_STATIC (video_sink_debug);
+#define GST_CAT_DEFAULT video_sink_debug
+
+static GstBaseSinkClass *parent_class = NULL;
+
+static void gst_video_sink_set_property (GObject * object, guint prop_id,
+    const GValue * value, GParamSpec * pspec);
+static void gst_video_sink_get_property (GObject * object, guint prop_id,
+    GValue * value, GParamSpec * pspec);
+
+static GstFlowReturn gst_video_sink_show_preroll_frame (GstBaseSink * bsink,
+    GstBuffer * buf);
+static GstFlowReturn gst_video_sink_show_frame (GstBaseSink * bsink,
+    GstBuffer * buf);
+
+/**
+ * gst_video_sink_center_rect:
+ * @src: the #GstVideoRectangle describing the source area
+ * @dst: the #GstVideoRectangle describing the destination area
+ * @result: a pointer to a #GstVideoRectangle which will receive the result area
+ * @scaling: a #gboolean indicating if scaling should be applied or not
+ * 
+ * Takes @src rectangle and position it at the center of @dst rectangle with or
+ * without @scaling. It handles clipping if the @src rectangle is bigger than
+ * the @dst one and @scaling is set to FALSE.
+ */
+void
+gst_video_sink_center_rect (GstVideoRectangle src, GstVideoRectangle dst,
+    GstVideoRectangle * result, gboolean scaling)
+{
+  g_return_if_fail (result != NULL);
+
+  if (!scaling) {
+    result->w = MIN (src.w, dst.w);
+    result->h = MIN (src.h, dst.h);
+    result->x = (dst.w - result->w) / 2;
+    result->y = (dst.h - result->h) / 2;
+  } else {
+    gdouble src_ratio, dst_ratio;
+
+    src_ratio = (gdouble) src.w / src.h;
+    dst_ratio = (gdouble) dst.w / dst.h;
+
+    if (src_ratio > dst_ratio) {
+      result->w = dst.w;
+      result->h = dst.w / src_ratio;
+      result->x = 0;
+      result->y = (dst.h - result->h) / 2;
+    } else if (src_ratio < dst_ratio) {
+      result->w = dst.h * src_ratio;
+      result->h = dst.h;
+      result->x = (dst.w - result->w) / 2;
+      result->y = 0;
+    } else {
+      result->x = 0;
+      result->y = 0;
+      result->w = dst.w;
+      result->h = dst.h;
+    }
+  }
+
+  GST_DEBUG ("source is %dx%d dest is %dx%d, result is %dx%d with x,y %dx%d",
+      src.w, src.h, dst.w, dst.h, result->w, result->h, result->x, result->y);
+}
+
+/* Initing stuff */
+
+static void
+gst_video_sink_init (GstVideoSink * videosink)
+{
+  videosink->width = 0;
+  videosink->height = 0;
+
+  /* 20ms is more than enough, 80-130ms is noticable */
+  gst_base_sink_set_max_lateness (GST_BASE_SINK (videosink), 20 * GST_MSECOND);
+  gst_base_sink_set_qos_enabled (GST_BASE_SINK (videosink), TRUE);
+
+  videosink->priv = G_TYPE_INSTANCE_GET_PRIVATE (videosink,
+      GST_TYPE_VIDEO_SINK, GstVideoSinkPrivate);
+}
+
+static void
+gst_video_sink_class_init (GstVideoSinkClass * klass)
+{
+  GstBaseSinkClass *basesink_class = (GstBaseSinkClass *) klass;
+  GObjectClass *gobject_class = (GObjectClass *) klass;
+
+  parent_class = g_type_class_peek_parent (klass);
+
+  gobject_class->set_property = gst_video_sink_set_property;
+  gobject_class->get_property = gst_video_sink_get_property;
+
+  /**
+   * GstVideoSink:show-preroll-frame
+   *
+   * Whether to show video frames during preroll. If set to #FALSE, video
+   * frames will only be rendered in PLAYING state.
+   *
+   * Since: 0.10.25
+   */
+  g_object_class_install_property (gobject_class, PROP_SHOW_PREROLL_FRAME,
+      g_param_spec_boolean ("show-preroll-frame", "Show preroll frame",
+          "Whether to render video frames during preroll",
+          DEFAULT_SHOW_PREROLL_FRAME,
+          G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
+
+  basesink_class->render = GST_DEBUG_FUNCPTR (gst_video_sink_show_frame);
+  basesink_class->preroll =
+      GST_DEBUG_FUNCPTR (gst_video_sink_show_preroll_frame);
+
+  g_type_class_add_private (klass, sizeof (GstVideoSinkPrivate));
+}
+
+static void
+gst_video_sink_base_init (gpointer g_class)
+{
+  GST_DEBUG_CATEGORY_INIT (video_sink_debug, "videosink", 0, "GstVideoSink");
+}
+
+static GstFlowReturn
+gst_video_sink_show_preroll_frame (GstBaseSink * bsink, GstBuffer * buf)
+{
+  GstVideoSinkClass *klass;
+  GstVideoSink *vsink;
+  gboolean do_show;
+
+  vsink = GST_VIDEO_SINK_CAST (bsink);
+  klass = GST_VIDEO_SINK_GET_CLASS (vsink);
+
+  do_show = g_atomic_int_get (&vsink->priv->show_preroll_frame);
+
+  if (G_UNLIKELY (!do_show)) {
+    GST_DEBUG_OBJECT (bsink, "not rendering frame with ts=%" GST_TIME_FORMAT
+        ", preroll rendering disabled",
+        GST_TIME_ARGS (GST_BUFFER_TIMESTAMP (buf)));
+  }
+
+  if (klass->show_frame == NULL || !do_show) {
+    if (parent_class->preroll != NULL)
+      return parent_class->preroll (bsink, buf);
+    else
+      return GST_FLOW_OK;
+  }
+
+  GST_LOG_OBJECT (bsink, "rendering frame, ts=%" GST_TIME_FORMAT,
+      GST_TIME_ARGS (GST_BUFFER_TIMESTAMP (buf)));
+
+  return klass->show_frame (GST_VIDEO_SINK_CAST (bsink), buf);
+}
+
+static GstFlowReturn
+gst_video_sink_show_frame (GstBaseSink * bsink, GstBuffer * buf)
+{
+  GstVideoSinkClass *klass;
+
+  klass = GST_VIDEO_SINK_GET_CLASS (bsink);
+
+  if (klass->show_frame == NULL) {
+    if (parent_class->render != NULL)
+      return parent_class->render (bsink, buf);
+    else
+      return GST_FLOW_OK;
+  }
+
+  GST_LOG_OBJECT (bsink, "rendering frame, ts=%" GST_TIME_FORMAT,
+      GST_TIME_ARGS (GST_BUFFER_TIMESTAMP (buf)));
+
+  return klass->show_frame (GST_VIDEO_SINK_CAST (bsink), buf);
+}
+
+static void
+gst_video_sink_set_property (GObject * object, guint prop_id,
+    const GValue * value, GParamSpec * pspec)
+{
+  GstVideoSink *vsink;
+
+  vsink = GST_VIDEO_SINK (object);
+
+  switch (prop_id) {
+    case PROP_SHOW_PREROLL_FRAME:
+      g_atomic_int_set (&vsink->priv->show_preroll_frame,
+          g_value_get_boolean (value));
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+      break;
+  }
+}
+
+static void
+gst_video_sink_get_property (GObject * object, guint prop_id,
+    GValue * value, GParamSpec * pspec)
+{
+  GstVideoSink *vsink;
+
+  vsink = GST_VIDEO_SINK (object);
+
+  switch (prop_id) {
+    case PROP_SHOW_PREROLL_FRAME:
+      g_value_set_boolean (value,
+          g_atomic_int_get (&vsink->priv->show_preroll_frame));
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+      break;
+  }
+}
+
+/* Public methods */
+
+GType
+gst_video_sink_get_type (void)
+{
+  static GType videosink_type = 0;
+
+  if (!videosink_type) {
+    static const GTypeInfo videosink_info = {
+      sizeof (GstVideoSinkClass),
+      gst_video_sink_base_init,
+      NULL,
+      (GClassInitFunc) gst_video_sink_class_init,
+      NULL,
+      NULL,
+      sizeof (GstVideoSink),
+      0,
+      (GInstanceInitFunc) gst_video_sink_init,
+    };
+
+    videosink_type = g_type_register_static (GST_TYPE_BASE_SINK,
+        "GstVideoSink", &videosink_info, 0);
+  }
+
+  return videosink_type;
+}