libavfilter/vf_subtitles.c
28338bc2
 /*
  * Copyright (c) 2011 Baptiste Coudurier
  * Copyright (c) 2011 Stefano Sabatini
3313e46c
  * Copyright (c) 2012 Clément Bœsch
28338bc2
  *
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
  * version 2.1 of the License, or (at your option) any later version.
  *
  * FFmpeg 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
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
  * License along with FFmpeg; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  */
 
 /**
  * @file
  * Libass subtitles burning filter.
  *
  * @see{http://www.matroska.org/technical/specs/subtitles/ssa.html}
  */
 
 #include <ass/ass.h>
 
3313e46c
 #include "config.h"
 #if CONFIG_SUBTITLES_FILTER
 # include "libavcodec/avcodec.h"
 # include "libavformat/avformat.h"
 #endif
28338bc2
 #include "libavutil/avstring.h"
 #include "libavutil/imgutils.h"
8e0d3c03
 #include "libavutil/opt.h"
 #include "libavutil/parseutils.h"
28338bc2
 #include "drawutils.h"
 #include "avfilter.h"
c17808ce
 #include "internal.h"
98701be3
 #include "formats.h"
 #include "video.h"
28338bc2
 
ed93ed5e
 typedef struct AssContext {
8e0d3c03
     const AVClass *class;
28338bc2
     ASS_Library  *library;
     ASS_Renderer *renderer;
     ASS_Track    *track;
     char *filename;
9dbc50b4
     char *fontsdir;
08d149d6
     char *charenc;
40b198e9
     char *force_style;
7a0e689c
     int stream_index;
f19e4118
     int alpha;
28338bc2
     uint8_t rgba_map[4];
     int     pix_step[4];       ///< steps per pixel for each plane of the main output
247fbf07
     int original_w, original_h;
4b58349b
     int shaping;
6c7b5b7b
     FFDrawContext draw;
28338bc2
 } AssContext;
 
8e0d3c03
 #define OFFSET(x) offsetof(AssContext, x)
42d621d1
 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
8e0d3c03
 
3a0a959d
 #define COMMON_OPTIONS \
     {"filename",       "set the filename of file to read",                         OFFSET(filename),   AV_OPT_TYPE_STRING,     {.str = NULL},  CHAR_MIN, CHAR_MAX, FLAGS }, \
     {"f",              "set the filename of file to read",                         OFFSET(filename),   AV_OPT_TYPE_STRING,     {.str = NULL},  CHAR_MIN, CHAR_MAX, FLAGS }, \
     {"original_size",  "set the size of the original video (used to scale fonts)", OFFSET(original_w), AV_OPT_TYPE_IMAGE_SIZE, {.str = NULL},  CHAR_MIN, CHAR_MAX, FLAGS }, \
9dbc50b4
     {"fontsdir",       "set the directory containing the fonts to read",           OFFSET(fontsdir),   AV_OPT_TYPE_STRING,     {.str = NULL},  CHAR_MIN, CHAR_MAX, FLAGS }, \
f19e4118
     {"alpha",          "enable processing of alpha channel",                       OFFSET(alpha),      AV_OPT_TYPE_BOOL,       {.i64 = 0   },         0,        1, FLAGS }, \
8e0d3c03
 
28338bc2
 /* libass supports a log level ranging from 0 to 7 */
74434d3b
 static const int ass_libavfilter_log_level_map[] = {
8a9c5db2
     [0] = AV_LOG_FATAL,     /* MSGL_FATAL */
     [1] = AV_LOG_ERROR,     /* MSGL_ERR */
     [2] = AV_LOG_WARNING,   /* MSGL_WARN */
     [3] = AV_LOG_WARNING,   /* <undefined> */
     [4] = AV_LOG_INFO,      /* MSGL_INFO */
     [5] = AV_LOG_INFO,      /* <undefined> */
     [6] = AV_LOG_VERBOSE,   /* MSGL_V */
     [7] = AV_LOG_DEBUG,     /* MSGL_DBG2 */
28338bc2
 };
 
 static void ass_log(int ass_level, const char *fmt, va_list args, void *ctx)
 {
a87527ad
     const int ass_level_clip = av_clip(ass_level, 0,
         FF_ARRAY_ELEMS(ass_libavfilter_log_level_map) - 1);
     const int level = ass_libavfilter_log_level_map[ass_level_clip];
28338bc2
 
     av_vlog(ctx, level, fmt, args);
     av_log(ctx, level, "\n");
 }
 
fd6228e6
 static av_cold int init(AVFilterContext *ctx)
28338bc2
 {
     AssContext *ass = ctx->priv;
faa1cb50
 
     if (!ass->filename) {
28338bc2
         av_log(ctx, AV_LOG_ERROR, "No filename provided!\n");
         return AVERROR(EINVAL);
     }
 
     ass->library = ass_library_init();
     if (!ass->library) {
         av_log(ctx, AV_LOG_ERROR, "Could not initialize libass.\n");
         return AVERROR(EINVAL);
     }
     ass_set_message_cb(ass->library, ass_log, ctx);
 
9dbc50b4
     ass_set_fonts_dir(ass->library, ass->fontsdir);
 
28338bc2
     ass->renderer = ass_renderer_init(ass->library);
     if (!ass->renderer) {
         av_log(ctx, AV_LOG_ERROR, "Could not initialize libass renderer.\n");
         return AVERROR(EINVAL);
     }
 
     return 0;
 }
 
 static av_cold void uninit(AVFilterContext *ctx)
 {
     AssContext *ass = ctx->priv;
 
     if (ass->track)
         ass_free_track(ass->track);
     if (ass->renderer)
         ass_renderer_done(ass->renderer);
     if (ass->library)
         ass_library_done(ass->library);
 }
 
 static int query_formats(AVFilterContext *ctx)
 {
a0854c08
     return ff_set_common_formats(ctx, ff_draw_supported_pixel_formats(0));
28338bc2
 }
 
 static int config_input(AVFilterLink *inlink)
 {
     AssContext *ass = inlink->dst->priv;
 
f19e4118
     ff_draw_init(&ass->draw, inlink->format, ass->alpha ? FF_DRAW_PROCESS_ALPHA : 0);
28338bc2
 
     ass_set_frame_size  (ass->renderer, inlink->w, inlink->h);
247fbf07
     if (ass->original_w && ass->original_h)
         ass_set_aspect_ratio(ass->renderer, (double)inlink->w / inlink->h,
                              (double)ass->original_w / ass->original_h);
4b58349b
     if (ass->shaping != -1)
         ass_set_shaper(ass->renderer, ass->shaping);
28338bc2
 
     return 0;
 }
 
 /* libass stores an RGBA color in the format RRGGBBTT, where TT is the transparency level */
 #define AR(c)  ( (c)>>24)
 #define AG(c)  (((c)>>16)&0xFF)
 #define AB(c)  (((c)>>8) &0xFF)
9d88be68
 #define AA(c)  ((0xFF-(c)) &0xFF)
28338bc2
 
a05a44e2
 static void overlay_ass_image(AssContext *ass, AVFrame *picref,
28338bc2
                               const ASS_Image *image)
 {
     for (; image; image = image->next) {
         uint8_t rgba_color[] = {AR(image->color), AG(image->color), AB(image->color), AA(image->color)};
6c7b5b7b
         FFDrawColor color;
         ff_draw_color(&ass->draw, &color, rgba_color);
         ff_blend_mask(&ass->draw, &color,
                       picref->data, picref->linesize,
a05a44e2
                       picref->width, picref->height,
6c7b5b7b
                       image->bitmap, image->stride, image->w, image->h,
                       3, 0, image->dst_x, image->dst_y);
28338bc2
     }
 }
 
a05a44e2
 static int filter_frame(AVFilterLink *inlink, AVFrame *picref)
28338bc2
 {
     AVFilterContext *ctx = inlink->dst;
     AVFilterLink *outlink = ctx->outputs[0];
     AssContext *ass = ctx->priv;
     int detect_change = 0;
     double time_ms = picref->pts * av_q2d(inlink->time_base) * 1000;
     ASS_Image *image = ass_render_frame(ass->renderer, ass->track,
                                         time_ms, &detect_change);
 
     if (detect_change)
         av_log(ctx, AV_LOG_DEBUG, "Change happened at time ms:%f\n", time_ms);
 
6c7b5b7b
     overlay_ass_image(ass, picref, image);
28338bc2
 
031d6448
     return ff_filter_frame(outlink, picref);
28338bc2
 }
 
2d9d4440
 static const AVFilterPad ass_inputs[] = {
     {
         .name             = "default",
         .type             = AVMEDIA_TYPE_VIDEO,
031d6448
         .filter_frame     = filter_frame,
2d9d4440
         .config_props     = config_input,
a05a44e2
         .needs_writable   = 1,
2d9d4440
     },
     { NULL }
 };
 
 static const AVFilterPad ass_outputs[] = {
     {
         .name = "default",
         .type = AVMEDIA_TYPE_VIDEO,
     },
     { NULL }
 };
 
3313e46c
 #if CONFIG_ASS_FILTER
 
3a0a959d
 static const AVOption ass_options[] = {
     COMMON_OPTIONS
4b58349b
     {"shaping", "set shaping engine", OFFSET(shaping), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, FLAGS, "shaping_mode"},
         {"auto", NULL,                 0, AV_OPT_TYPE_CONST, {.i64 = -1},                  INT_MIN, INT_MAX, FLAGS, "shaping_mode"},
         {"simple",  "simple shaping",  0, AV_OPT_TYPE_CONST, {.i64 = ASS_SHAPING_SIMPLE},  INT_MIN, INT_MAX, FLAGS, "shaping_mode"},
         {"complex", "complex shaping", 0, AV_OPT_TYPE_CONST, {.i64 = ASS_SHAPING_COMPLEX}, INT_MIN, INT_MAX, FLAGS, "shaping_mode"},
3a0a959d
     {NULL},
 };
 
3313e46c
 AVFILTER_DEFINE_CLASS(ass);
 
fd6228e6
 static av_cold int init_ass(AVFilterContext *ctx)
3313e46c
 {
     AssContext *ass = ctx->priv;
fd6228e6
     int ret = init(ctx);
3313e46c
 
     if (ret < 0)
         return ret;
 
7e6b3ad6
     /* Initialize fonts */
     ass_set_fonts(ass->renderer, NULL, NULL, 1, NULL, 1);
 
3313e46c
     ass->track = ass_read_file(ass->library, ass->filename, NULL);
     if (!ass->track) {
         av_log(ctx, AV_LOG_ERROR,
                "Could not create a libass track when reading file '%s'\n",
                ass->filename);
         return AVERROR(EINVAL);
     }
     return 0;
 }
 
325f6e0a
 AVFilter ff_vf_ass = {
28338bc2
     .name          = "ass",
90fb3e9b
     .description   = NULL_IF_CONFIG_SMALL("Render ASS subtitles onto input video using the libass library."),
28338bc2
     .priv_size     = sizeof(AssContext),
3313e46c
     .init          = init_ass,
28338bc2
     .uninit        = uninit,
     .query_formats = query_formats,
2d9d4440
     .inputs        = ass_inputs,
     .outputs       = ass_outputs,
     .priv_class    = &ass_class,
28338bc2
 };
3313e46c
 #endif
 
 #if CONFIG_SUBTITLES_FILTER
 
3a0a959d
 static const AVOption subtitles_options[] = {
     COMMON_OPTIONS
7a0e689c
     {"charenc",      "set input character encoding", OFFSET(charenc),      AV_OPT_TYPE_STRING, {.str = NULL}, CHAR_MIN, CHAR_MAX, FLAGS},
     {"stream_index", "set stream index",             OFFSET(stream_index), AV_OPT_TYPE_INT,    { .i64 = -1 }, -1,       INT_MAX,  FLAGS},
     {"si",           "set stream index",             OFFSET(stream_index), AV_OPT_TYPE_INT,    { .i64 = -1 }, -1,       INT_MAX,  FLAGS},
40b198e9
     {"force_style",  "force subtitle style",         OFFSET(force_style),  AV_OPT_TYPE_STRING, {.str = NULL}, CHAR_MIN, CHAR_MAX, FLAGS},
3a0a959d
     {NULL},
 };
 
d9e2aceb
 static const char * const font_mimetypes[] = {
7e6b3ad6
     "application/x-truetype-font",
     "application/vnd.ms-opentype",
     "application/x-font-ttf",
     NULL
 };
 
 static int attachment_is_font(AVStream * st)
 {
     const AVDictionaryEntry *tag = NULL;
     int n;
 
     tag = av_dict_get(st->metadata, "mimetype", NULL, AV_DICT_MATCH_CASE);
 
     if (tag) {
         for (n = 0; font_mimetypes[n]; n++) {
             if (av_strcasecmp(font_mimetypes[n], tag->value) == 0)
                 return 1;
         }
     }
     return 0;
 }
 
3313e46c
 AVFILTER_DEFINE_CLASS(subtitles);
 
fd6228e6
 static av_cold int init_subtitles(AVFilterContext *ctx)
3313e46c
 {
7e6b3ad6
     int j, ret, sid;
7a0e689c
     int k = 0;
08d149d6
     AVDictionary *codec_opts = NULL;
3313e46c
     AVFormatContext *fmt = NULL;
     AVCodecContext *dec_ctx = NULL;
     AVCodec *dec = NULL;
9b9d996b
     const AVCodecDescriptor *dec_desc;
3313e46c
     AVStream *st;
     AVPacket pkt;
     AssContext *ass = ctx->priv;
 
     /* Init libass */
fd6228e6
     ret = init(ctx);
3313e46c
     if (ret < 0)
         return ret;
     ass->track = ass_new_track(ass->library);
     if (!ass->track) {
         av_log(ctx, AV_LOG_ERROR, "Could not create a libass track\n");
         return AVERROR(EINVAL);
     }
 
     /* Open subtitles file */
     ret = avformat_open_input(&fmt, ass->filename, NULL, NULL);
     if (ret < 0) {
         av_log(ctx, AV_LOG_ERROR, "Unable to open %s\n", ass->filename);
         goto end;
     }
     ret = avformat_find_stream_info(fmt, NULL);
     if (ret < 0)
         goto end;
 
     /* Locate subtitles stream */
7a0e689c
     if (ass->stream_index < 0)
         ret = av_find_best_stream(fmt, AVMEDIA_TYPE_SUBTITLE, -1, -1, NULL, 0);
     else {
         ret = -1;
         if (ass->stream_index < fmt->nb_streams) {
             for (j = 0; j < fmt->nb_streams; j++) {
6bcb1e1a
                 if (fmt->streams[j]->codecpar->codec_type == AVMEDIA_TYPE_SUBTITLE) {
7a0e689c
                     if (ass->stream_index == k) {
                         ret = j;
                         break;
                     }
                     k++;
                 }
             }
         }
     }
 
3313e46c
     if (ret < 0) {
         av_log(ctx, AV_LOG_ERROR, "Unable to locate subtitle stream in %s\n",
                ass->filename);
         goto end;
     }
     sid = ret;
     st = fmt->streams[sid];
 
7e6b3ad6
     /* Load attached fonts */
     for (j = 0; j < fmt->nb_streams; j++) {
         AVStream *st = fmt->streams[j];
6bcb1e1a
         if (st->codecpar->codec_type == AVMEDIA_TYPE_ATTACHMENT &&
7e6b3ad6
             attachment_is_font(st)) {
             const AVDictionaryEntry *tag = NULL;
             tag = av_dict_get(st->metadata, "filename", NULL,
                               AV_DICT_MATCH_CASE);
 
             if (tag) {
                 av_log(ctx, AV_LOG_DEBUG, "Loading attached font: %s\n",
                        tag->value);
                 ass_add_font(ass->library, tag->value,
6bcb1e1a
                              st->codecpar->extradata,
                              st->codecpar->extradata_size);
7e6b3ad6
             } else {
                 av_log(ctx, AV_LOG_WARNING,
                        "Font attachment has no filename, ignored.\n");
             }
         }
     }
 
     /* Initialize fonts */
     ass_set_fonts(ass->renderer, NULL, NULL, 1, NULL, 1);
 
3313e46c
     /* Open decoder */
6bcb1e1a
     dec = avcodec_find_decoder(st->codecpar->codec_id);
3313e46c
     if (!dec) {
         av_log(ctx, AV_LOG_ERROR, "Failed to find subtitle codec %s\n",
6bcb1e1a
                avcodec_get_name(st->codecpar->codec_id));
3313e46c
         return AVERROR(EINVAL);
     }
6bcb1e1a
     dec_desc = avcodec_descriptor_get(st->codecpar->codec_id);
380cfce2
     if (dec_desc && !(dec_desc->props & AV_CODEC_PROP_TEXT_SUB)) {
f3147917
         av_log(ctx, AV_LOG_ERROR,
                "Only text based subtitles are currently supported\n");
         return AVERROR_PATCHWELCOME;
     }
08d149d6
     if (ass->charenc)
         av_dict_set(&codec_opts, "sub_charenc", ass->charenc, 0);
653af9f1
     if (LIBAVCODEC_VERSION_INT >= AV_VERSION_INT(57,26,100))
fa2df3a4
         av_dict_set(&codec_opts, "sub_text_format", "ass", 0);
6bcb1e1a
 
     dec_ctx = avcodec_alloc_context3(dec);
     if (!dec_ctx)
         return AVERROR(ENOMEM);
 
     ret = avcodec_parameters_to_context(dec_ctx, st->codecpar);
     if (ret < 0)
         goto end;
 
     /*
      * This is required by the decoding process in order to rescale the
      * timestamps: in the current API the decoded subtitles have their pts
      * expressed in AV_TIME_BASE, and thus the lavc internals need to know the
      * stream time base in order to achieve the rescaling.
      *
      * That API is old and needs to be reworked to match behaviour with A/V.
      */
03dae121
     dec_ctx->pkt_timebase = st->time_base;
6bcb1e1a
 
     ret = avcodec_open2(dec_ctx, NULL, &codec_opts);
3313e46c
     if (ret < 0)
         goto end;
 
40b198e9
     if (ass->force_style) {
         char **list = NULL;
         char *temp = NULL;
         char *ptr = av_strtok(ass->force_style, ",", &temp);
         int i = 0;
         while (ptr) {
             av_dynarray_add(&list, &i, ptr);
             if (!list) {
                 ret = AVERROR(ENOMEM);
                 goto end;
             }
             ptr = av_strtok(NULL, ",", &temp);
         }
         av_dynarray_add(&list, &i, NULL);
         if (!list) {
             ret = AVERROR(ENOMEM);
             goto end;
         }
         ass_set_style_overrides(ass->library, list);
         av_free(list);
     }
3313e46c
     /* Decode subtitles and push them into the renderer (libass) */
     if (dec_ctx->subtitle_header)
         ass_process_codec_private(ass->track,
                                   dec_ctx->subtitle_header,
                                   dec_ctx->subtitle_header_size);
     av_init_packet(&pkt);
     pkt.data = NULL;
     pkt.size = 0;
     while (av_read_frame(fmt, &pkt) >= 0) {
         int i, got_subtitle;
035a3792
         AVSubtitle sub = {0};
3313e46c
 
         if (pkt.stream_index == sid) {
             ret = avcodec_decode_subtitle2(dec_ctx, &sub, &got_subtitle, &pkt);
bb3303b9
             if (ret < 0) {
                 av_log(ctx, AV_LOG_WARNING, "Error decoding: %s (ignored)\n",
                        av_err2str(ret));
             } else if (got_subtitle) {
fa2df3a4
                 const int64_t start_time = av_rescale_q(sub.pts, AV_TIME_BASE_Q, av_make_q(1, 1000));
                 const int64_t duration   = sub.end_display_time;
c557a5b0
                 for (i = 0; i < sub.num_rects; i++) {
                     char *ass_line = sub.rects[i]->ass;
                     if (!ass_line)
                         break;
fa2df3a4
                     if (LIBAVCODEC_VERSION_INT < AV_VERSION_INT(57,25,100))
                         ass_process_data(ass->track, ass_line, strlen(ass_line));
                     else
                         ass_process_chunk(ass->track, ass_line, strlen(ass_line),
                                           start_time, duration);
c557a5b0
                 }
bb3303b9
             }
3313e46c
         }
c2f861ca
         av_packet_unref(&pkt);
3313e46c
         avsubtitle_free(&sub);
     }
 
 end:
08d149d6
     av_dict_free(&codec_opts);
a887fbb5
     avcodec_close(dec_ctx);
e73ccfd6
     avcodec_free_context(&dec_ctx);
a887fbb5
     avformat_close_input(&fmt);
3313e46c
     return ret;
 }
 
325f6e0a
 AVFilter ff_vf_subtitles = {
3313e46c
     .name          = "subtitles",
90fb3e9b
     .description   = NULL_IF_CONFIG_SMALL("Render text subtitles onto input video using the libass library."),
3313e46c
     .priv_size     = sizeof(AssContext),
     .init          = init_subtitles,
     .uninit        = uninit,
     .query_formats = query_formats,
     .inputs        = ass_inputs,
     .outputs       = ass_outputs,
     .priv_class    = &subtitles_class,
 };
 #endif