Added gst-plugins-base-subtitles0.10-0.10.34 for Meego Harmattan 1.2
[mafwsubrenderer] / gst-plugins-base-subtitles0.10 / gst-libs / gst / rtsp / gstrtsprange.c
diff --git a/gst-plugins-base-subtitles0.10/gst-libs/gst/rtsp/gstrtsprange.c b/gst-plugins-base-subtitles0.10/gst-libs/gst/rtsp/gstrtsprange.c
new file mode 100644 (file)
index 0000000..0ad75c8
--- /dev/null
@@ -0,0 +1,272 @@
+/* GStreamer
+ * Copyright (C) <2005,2006> Wim Taymans <wim@fluendo.com>
+ *
+ * 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.
+ */
+/*
+ * Unless otherwise indicated, Source Code is licensed under MIT license.
+ * See further explanation attached in License Statement (distributed in the file
+ * LICENSE).
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+ * of the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * SECTION:gstrtsprange
+ * @short_description: dealing with time ranges
+ *  
+ * Provides helper functions to deal with time ranges.
+ *  
+ * Last reviewed on 2007-07-25 (0.10.14)
+ */
+
+
+#include <stdio.h>
+#include <string.h>
+
+#include "gstrtsprange.h"
+
+/* npt-time     =   "now" | npt-sec | npt-hhmmss
+ * npt-sec      =   1*DIGIT [ "." *DIGIT ]
+ * npt-hhmmss   =   npt-hh ":" npt-mm ":" npt-ss [ "." *DIGIT ]
+ * npt-hh       =   1*DIGIT     ; any positive number
+ * npt-mm       =   1*2DIGIT    ; 0-59
+ * npt-ss       =   1*2DIGIT    ; 0-59
+ */
+static GstRTSPResult
+parse_npt_time (const gchar * str, GstRTSPTime * time)
+{
+  if (strncmp (str, "now", 3) == 0) {
+    time->type = GST_RTSP_TIME_NOW;
+  } else if (str[0] == '\0') {
+    time->type = GST_RTSP_TIME_END;
+  } else if (strstr (str, ":")) {
+    gfloat seconds;
+    gint hours, mins;
+
+    sscanf (str, "%2d:%2d:%f", &hours, &mins, &seconds);
+
+    time->type = GST_RTSP_TIME_SECONDS;
+    time->seconds = ((hours * 60) + mins) * 60 + seconds;
+  } else {
+    gfloat seconds;
+
+    sscanf (str, "%f", &seconds);
+
+    time->type = GST_RTSP_TIME_SECONDS;
+    time->seconds = seconds;
+  }
+  return GST_RTSP_OK;
+}
+
+/* npt-range    =   ( npt-time "-" [ npt-time ] ) | ( "-" npt-time )
+ */
+static GstRTSPResult
+parse_npt_range (const gchar * str, GstRTSPTimeRange * range)
+{
+  GstRTSPResult res;
+  gchar *p;
+
+  range->unit = GST_RTSP_RANGE_NPT;
+
+  /* find '-' separator */
+  p = strstr (str, "-");
+  if (p == NULL)
+    return GST_RTSP_EINVAL;
+
+  if ((res = parse_npt_time (str, &range->min)) != GST_RTSP_OK)
+    goto done;
+
+  res = parse_npt_time (p + 1, &range->max);
+
+done:
+  return res;
+}
+
+static GstRTSPResult
+parse_clock_range (const gchar * str, GstRTSPTimeRange * range)
+{
+  return GST_RTSP_ENOTIMPL;
+}
+
+static GstRTSPResult
+parse_smpte_range (const gchar * str, GstRTSPTimeRange * range)
+{
+  return GST_RTSP_ENOTIMPL;
+}
+
+/**
+ * gst_rtsp_range_parse:
+ * @rangestr: a range string to parse
+ * @range: location to hold the #GstRTSPTimeRange result
+ *
+ * Parse @rangestr to a #GstRTSPTimeRange.
+ *
+ * Returns: #GST_RTSP_OK on success.
+ */
+GstRTSPResult
+gst_rtsp_range_parse (const gchar * rangestr, GstRTSPTimeRange ** range)
+{
+  GstRTSPResult ret;
+  GstRTSPTimeRange *res;
+  gchar *p;
+
+  g_return_val_if_fail (rangestr != NULL, GST_RTSP_EINVAL);
+  g_return_val_if_fail (range != NULL, GST_RTSP_EINVAL);
+
+  res = g_new0 (GstRTSPTimeRange, 1);
+
+  p = (gchar *) rangestr;
+  /* first figure out the units of the range */
+  if (g_str_has_prefix (p, "npt=")) {
+    ret = parse_npt_range (p + 4, res);
+  } else if (g_str_has_prefix (p, "clock=")) {
+    ret = parse_clock_range (p + 6, res);
+  } else if (g_str_has_prefix (p, "smpte=")) {
+    res->unit = GST_RTSP_RANGE_SMPTE;
+    ret = parse_smpte_range (p + 6, res);
+  } else if (g_str_has_prefix (p, "smpte-30-drop=")) {
+    res->unit = GST_RTSP_RANGE_SMPTE_30_DROP;
+    ret = parse_smpte_range (p + 14, res);
+  } else if (g_str_has_prefix (p, "smpte-25=")) {
+    res->unit = GST_RTSP_RANGE_SMPTE_25;
+    ret = parse_smpte_range (p + 9, res);
+  } else
+    goto invalid;
+
+  if (ret != GST_RTSP_OK)
+    goto invalid;
+
+  *range = res;
+  return ret;
+
+  /* ERRORS */
+invalid:
+  {
+    gst_rtsp_range_free (res);
+    return GST_RTSP_EINVAL;
+  }
+}
+
+static gboolean
+npt_time_string (const GstRTSPTime * time, GString * string)
+{
+  gboolean res = TRUE;;
+
+  switch (time->type) {
+    case GST_RTSP_TIME_SECONDS:
+      g_string_append_printf (string, "%f", time->seconds);
+      break;
+    case GST_RTSP_TIME_NOW:
+      g_string_append (string, "now");
+      break;
+    case GST_RTSP_TIME_END:
+      break;
+    default:
+      res = FALSE;
+      break;
+  }
+  return res;
+}
+
+static gboolean
+npt_range_string (const GstRTSPTimeRange * range, GString * string)
+{
+  gboolean res;
+
+  if (!(res = npt_time_string (&range->min, string)))
+    goto done;
+
+  g_string_append (string, "-");
+
+  if (!(res = npt_time_string (&range->max, string)))
+    goto done;
+
+done:
+  return res;
+}
+
+/**
+ * gst_rtsp_range_to_string:
+ * @range: a #GstRTSPTimeRange
+ *
+ * Convert @range into a string representation.
+ *
+ * Returns: The string representation of @range. g_free() after usage.
+ *
+ * Since: 0.10.23
+ */
+gchar *
+gst_rtsp_range_to_string (const GstRTSPTimeRange * range)
+{
+  gchar *result = NULL;
+  GString *string;
+
+  g_return_val_if_fail (range != NULL, NULL);
+
+  string = g_string_new ("");
+
+  switch (range->unit) {
+    case GST_RTSP_RANGE_NPT:
+      g_string_append (string, "npt=");
+      if (!npt_range_string (range, string)) {
+        g_string_free (string, TRUE);
+        string = NULL;
+      }
+      break;
+    case GST_RTSP_RANGE_SMPTE:
+    case GST_RTSP_RANGE_SMPTE_30_DROP:
+    case GST_RTSP_RANGE_SMPTE_25:
+    case GST_RTSP_RANGE_CLOCK:
+    default:
+      g_warning ("time range unit not yet implemented");
+      g_string_free (string, TRUE);
+      string = NULL;
+      break;
+  }
+  if (string)
+    result = g_string_free (string, FALSE);
+
+  return result;
+}
+
+/**
+ * gst_rtsp_range_free:
+ * @range: a #GstRTSPTimeRange
+ *
+ * Free the memory alocated by @range.
+ */
+void
+gst_rtsp_range_free (GstRTSPTimeRange * range)
+{
+  g_free (range);
+}