gst/subparse/gstssaparse.c

   1 /* GStreamer SSA subtitle parser
   2  * Copyright (c) 2006 Tim-Philipp Müller <tim centricular net>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /* Super-primitive SSA parser - we just want the text and ignore
  21  * everything else like styles and timing codes etc. for now */
  22
  23 #ifdef HAVE_CONFIG_H
  24 #include "config.h"
  25 #endif
  26
  27 #include <stdlib.h>             /* atoi() */
  28 #include <string.h>
  29
  30 #include "gstssaparse.h"
  31
  32 GST_DEBUG_CATEGORY_STATIC (ssa_parse_debug);
  33 #define GST_CAT_DEFAULT ssa_parse_debug
  34
  35 static GstStaticPadTemplate sink_templ = GST_STATIC_PAD_TEMPLATE ("sink",
  36     GST_PAD_SINK,
  37     GST_PAD_ALWAYS,
  38     GST_STATIC_CAPS ("application/x-ssa; application/x-ass")
  39     );
  40
  41 static GstStaticPadTemplate src_templ = GST_STATIC_PAD_TEMPLATE ("src",
  42     GST_PAD_SRC,
  43     GST_PAD_ALWAYS,
  44     GST_STATIC_CAPS ("text/x-pango-markup")
  45     );
  46
  47 #define gst_ssa_parse_parent_class parent_class
  48 G_DEFINE_TYPE (GstSsaParse, gst_ssa_parse, GST_TYPE_ELEMENT);
  49
  50 static GstStateChangeReturn gst_ssa_parse_change_state (GstElement *
  51     element, GstStateChange transition);
  52 static gboolean gst_ssa_parse_setcaps (GstPad * sinkpad, GstCaps * caps);
  53 static gboolean gst_ssa_parse_src_event (GstPad * pad, GstObject * parent,
  54     GstEvent * event);
  55 static gboolean gst_ssa_parse_sink_event (GstPad * pad, GstObject * parent,
  56     GstEvent * event);
  57 static GstFlowReturn gst_ssa_parse_chain (GstPad * sinkpad, GstObject * parent,
  58     GstBuffer * buf);
  59
  60 static void
  61 gst_ssa_parse_dispose (GObject * object)
  62 {
  63   GstSsaParse *parse = GST_SSA_PARSE (object);
  64
  65   g_free (parse->ini);
  66   parse->ini = NULL;
  67
  68   GST_CALL_PARENT (G_OBJECT_CLASS, dispose, (object));
  69 }
  70
  71 static void
  72 gst_ssa_parse_init (GstSsaParse * parse)
  73 {
  74   parse->sinkpad = gst_pad_new_from_static_template (&sink_templ, "sink");
  75   gst_pad_set_chain_function (parse->sinkpad,
  76       GST_DEBUG_FUNCPTR (gst_ssa_parse_chain));
  77   gst_pad_set_event_function (parse->sinkpad,
  78       GST_DEBUG_FUNCPTR (gst_ssa_parse_sink_event));
  79   gst_element_add_pad (GST_ELEMENT (parse), parse->sinkpad);
  80
  81   parse->srcpad = gst_pad_new_from_static_template (&src_templ, "src");
  82   gst_pad_set_event_function (parse->srcpad,
  83       GST_DEBUG_FUNCPTR (gst_ssa_parse_src_event));
  84   gst_element_add_pad (GST_ELEMENT (parse), parse->srcpad);
  85   gst_pad_use_fixed_caps (parse->srcpad);
  86   gst_pad_set_caps (parse->srcpad,
  87       gst_static_pad_template_get_caps (&src_templ));
  88
  89   parse->ini = NULL;
  90   parse->framed = FALSE;
  91   parse->send_tags = FALSE;
  92 }
  93
  94 static void
  95 gst_ssa_parse_class_init (GstSsaParseClass * klass)
  96 {
  97   GObjectClass *object_class = G_OBJECT_CLASS (klass);
  98   GstElementClass *element_class = GST_ELEMENT_CLASS (klass);
  99
 100   object_class->dispose = gst_ssa_parse_dispose;
 101
 102   gst_element_class_add_pad_template (element_class,
 103       gst_static_pad_template_get (&sink_templ));
 104   gst_element_class_add_pad_template (element_class,
 105       gst_static_pad_template_get (&src_templ));
 106   gst_element_class_set_details_simple (element_class,
 107       "SSA Subtitle Parser", "Codec/Parser/Subtitle",
 108       "Parses SSA subtitle streams",
 109       "Tim-Philipp Müller <tim centricular net>");
 110
 111   GST_DEBUG_CATEGORY_INIT (ssa_parse_debug, "ssaparse", 0,
 112       "SSA subtitle parser");
 113
 114   element_class->change_state = GST_DEBUG_FUNCPTR (gst_ssa_parse_change_state);
 115 }
 116
 117 static gboolean
 118 gst_ssa_parse_src_event (GstPad * pad, GstObject * parent, GstEvent * event)
 119 {
 120   return gst_pad_event_default (pad, parent, event);
 121 }
 122
 123 static gboolean
 124 gst_ssa_parse_sink_event (GstPad * pad, GstObject * parent, GstEvent * event)
 125 {
 126   gboolean res;
 127
 128   switch (GST_EVENT_TYPE (event)) {
 129     case GST_EVENT_CAPS:
 130     {
 131       GstCaps *caps;
 132
 133       gst_event_parse_caps (event, &caps);
 134       res = gst_ssa_parse_setcaps (pad, caps);
 135       gst_event_unref (event);
 136       break;
 137     }
 138     default:
 139       res = gst_pad_event_default (pad, parent, event);
 140       break;
 141   }
 142   return res;
 143 }
 144
 145 static gboolean
 146 gst_ssa_parse_setcaps (GstPad * sinkpad, GstCaps * caps)
 147 {
 148   GstSsaParse *parse = GST_SSA_PARSE (GST_PAD_PARENT (sinkpad));
 149   const GValue *val;
 150   GstStructure *s;
 151   const guchar bom_utf8[] = { 0xEF, 0xBB, 0xBF };
 152   GstBuffer *priv;
 153   GstMapInfo map;
 154   gchar *ptr;
 155   gsize left;
 156
 157   s = gst_caps_get_structure (caps, 0);
 158   val = gst_structure_get_value (s, "codec_data");
 159   if (val == NULL) {
 160     parse->framed = FALSE;
 161     GST_ERROR ("Only SSA subtitles embedded in containers are supported");
 162     return FALSE;
 163   }
 164
 165   parse->framed = TRUE;
 166   parse->send_tags = TRUE;
 167
 168   priv = (GstBuffer *) g_value_get_boxed (val);
 169   g_return_val_if_fail (priv != NULL, FALSE);
 170
 171   gst_buffer_ref (priv);
 172
 173   gst_buffer_map (priv, &map, GST_MAP_READ);
 174
 175   ptr = (gchar *) map.data;
 176   left = map.size;
 177
 178   /* skip UTF-8 BOM */
 179   if (left >= 3 && memcmp (ptr, bom_utf8, 3) == 0) {
 180     ptr += 3;
 181     left -= 3;
 182   }
 183
 184   if (!strstr (ptr, "[Script Info]"))
 185     goto invalid_init;
 186
 187   if (!g_utf8_validate (ptr, left, NULL))
 188     goto invalid_utf8;
 189
 190   /* FIXME: parse initial section */
 191   parse->ini = g_strndup (ptr, left);
 192   GST_LOG_OBJECT (parse, "Init section:\n%s", parse->ini);
 193
 194   gst_buffer_unmap (priv, &map);
 195   gst_buffer_unref (priv);
 196
 197   return TRUE;
 198
 199   /* ERRORS */
 200 invalid_init:
 201   {
 202     GST_WARNING_OBJECT (parse, "Invalid Init section - no Script Info header");
 203     gst_buffer_unmap (priv, &map);
 204     gst_buffer_unref (priv);
 205     return FALSE;
 206   }
 207 invalid_utf8:
 208   {
 209     GST_WARNING_OBJECT (parse, "Init section is not valid UTF-8");
 210     gst_buffer_unmap (priv, &map);
 211     gst_buffer_unref (priv);
 212     return FALSE;
 213   }
 214 }
 215
 216 static gboolean
 217 gst_ssa_parse_remove_override_codes (GstSsaParse * parse, gchar * txt)
 218 {
 219   gchar *t, *end;
 220   gboolean removed_any = FALSE;
 221
 222   while ((t = strchr (txt, '{'))) {
 223     end = strchr (txt, '}');
 224     if (end == NULL) {
 225       GST_WARNING_OBJECT (parse, "Missing { for style override code");
 226       return removed_any;
 227     }
 228     /* move terminating NUL character forward as well */
 229     g_memmove (t, end + 1, strlen (end + 1) + 1);
 230     removed_any = TRUE;
 231   }
 232
 233   /* these may occur outside of curly brackets. We don't handle the different
 234    * wrapping modes yet, so just remove these markers from the text for now */
 235   while ((t = strstr (txt, "\\n"))) {
 236     t[0] = ' ';
 237     t[1] = '\n';
 238   }
 239   while ((t = strstr (txt, "\\N"))) {
 240     t[0] = ' ';
 241     t[1] = '\n';
 242   }
 243   while ((t = strstr (txt, "\\h"))) {
 244     t[0] = ' ';
 245     t[1] = ' ';
 246   }
 247
 248   return removed_any;
 249 }
 250
 251 /**
 252  * gst_ssa_parse_push_line:
 253  * @parse: caller element
 254  * @txt: text to push
 255  * @start: timestamp for the buffer
 256  * @duration: duration for the buffer
 257  *
 258  * Parse the text in a buffer with the given properties and
 259  * push it to the srcpad of the @parse element
 260  *
 261  * Returns: result of the push of the created buffer
 262  */
 263 static GstFlowReturn
 264 gst_ssa_parse_push_line (GstSsaParse * parse, gchar * txt,
 265     GstClockTime start, GstClockTime duration)
 266 {
 267   GstFlowReturn ret;
 268   GstBuffer *buf;
 269   gchar *t, *escaped;
 270   gint num, i, len;
 271
 272   num = atoi (txt);
 273   GST_LOG_OBJECT (parse, "Parsing line #%d at %" GST_TIME_FORMAT,
 274       num, GST_TIME_ARGS (start));
 275
 276   /* skip all non-text fields before the actual text */
 277   t = txt;
 278   for (i = 0; i < 8; ++i) {
 279     t = strchr (t, ',');
 280     if (t == NULL)
 281       return GST_FLOW_ERROR;
 282     ++t;
 283   }
 284
 285   GST_LOG_OBJECT (parse, "Text : %s", t);
 286
 287   if (gst_ssa_parse_remove_override_codes (parse, t)) {
 288     GST_LOG_OBJECT (parse, "Clean: %s", t);
 289   }
 290
 291   /* we claim to output pango markup, so we must escape the
 292    * text even if we don't actually use any pango markup yet */
 293   escaped = g_markup_printf_escaped ("%s", t);
 294
 295   len = strlen (escaped);
 296
 297   /* allocate enough for a terminating NUL, but don't include it in buf size */
 298   buf = gst_buffer_new_and_alloc (len + 1);
 299   gst_buffer_fill (buf, 0, escaped, len + 1);
 300   gst_buffer_set_size (buf, len);
 301   g_free (escaped);
 302
 303   GST_BUFFER_TIMESTAMP (buf) = start;
 304   GST_BUFFER_DURATION (buf) = duration;
 305
 306   GST_LOG_OBJECT (parse, "Pushing buffer with timestamp %" GST_TIME_FORMAT
 307       " and duration %" GST_TIME_FORMAT, GST_TIME_ARGS (start),
 308       GST_TIME_ARGS (duration));
 309
 310   ret = gst_pad_push (parse->srcpad, buf);
 311
 312   if (ret != GST_FLOW_OK) {
 313     GST_DEBUG_OBJECT (parse, "Push of text '%s' returned flow %s", txt,
 314         gst_flow_get_name (ret));
 315   }
 316
 317   return ret;
 318 }
 319
 320 static GstFlowReturn
 321 gst_ssa_parse_chain (GstPad * sinkpad, GstObject * parent, GstBuffer * buf)
 322 {
 323   GstFlowReturn ret;
 324   GstSsaParse *parse = GST_SSA_PARSE (parent);
 325   GstClockTime ts;
 326   gchar *txt;
 327   GstMapInfo map;
 328
 329   if (G_UNLIKELY (!parse->framed))
 330     goto not_framed;
 331
 332   if (G_UNLIKELY (parse->send_tags)) {
 333     GstTagList *tags;
 334
 335     tags = gst_tag_list_new_empty ();
 336     gst_tag_list_add (tags, GST_TAG_MERGE_APPEND, GST_TAG_SUBTITLE_CODEC,
 337         "SubStation Alpha", NULL);
 338     gst_pad_push_event (parse->srcpad, gst_event_new_tag (tags));
 339     parse->send_tags = FALSE;
 340   }
 341
 342   /* make double-sure it's 0-terminated and all */
 343   gst_buffer_map (buf, &map, GST_MAP_READ);
 344   txt = g_strndup ((gchar *) map.data, map.size);
 345   gst_buffer_unmap (buf, &map);
 346
 347   if (txt == NULL)
 348     goto empty_text;
 349
 350   ts = GST_BUFFER_TIMESTAMP (buf);
 351   ret = gst_ssa_parse_push_line (parse, txt, ts, GST_BUFFER_DURATION (buf));
 352
 353   if (ret != GST_FLOW_OK && GST_CLOCK_TIME_IS_VALID (ts)) {
 354     GstSegment segment;
 355
 356     /* just advance time without sending anything */
 357     gst_segment_init (&segment, GST_FORMAT_TIME);
 358     segment.start = ts;
 359     segment.time = ts;
 360     gst_pad_push_event (parse->srcpad, gst_event_new_segment (&segment));
 361     ret = GST_FLOW_OK;
 362   }
 363
 364   gst_buffer_unref (buf);
 365   g_free (txt);
 366
 367   return ret;
 368
 369 /* ERRORS */
 370 not_framed:
 371   {
 372     GST_ELEMENT_ERROR (parse, STREAM, FORMAT, (NULL),
 373         ("Only SSA subtitles embedded in containers are supported"));
 374     gst_buffer_unref (buf);
 375     return GST_FLOW_NOT_NEGOTIATED;
 376   }
 377 empty_text:
 378   {
 379     GST_ELEMENT_WARNING (parse, STREAM, FORMAT, (NULL),
 380         ("Received empty subtitle"));
 381     gst_buffer_unref (buf);
 382     return GST_FLOW_OK;
 383   }
 384 }
 385
 386 static GstStateChangeReturn
 387 gst_ssa_parse_change_state (GstElement * element, GstStateChange transition)
 388 {
 389   GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
 390   GstSsaParse *parse = GST_SSA_PARSE (element);
 391
 392   switch (transition) {
 393     case GST_STATE_CHANGE_READY_TO_PAUSED:
 394       break;
 395     default:
 396       break;
 397   }
 398
 399   ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
 400   if (ret == GST_STATE_CHANGE_FAILURE)
 401     return ret;
 402
 403   switch (transition) {
 404     case GST_STATE_CHANGE_PAUSED_TO_READY:
 405       g_free (parse->ini);
 406       parse->ini = NULL;
 407       parse->framed = FALSE;
 408       break;
 409     default:
 410       break;
 411   }
 412
 413   return ret;
 414 }