diff options
Diffstat (limited to 'libavcodec/ass.h')
-rw-r--r-- | libavcodec/ass.h | 81 |
1 files changed, 58 insertions, 23 deletions
diff --git a/libavcodec/ass.h b/libavcodec/ass.h index 1302a04..314b43b 100644 --- a/libavcodec/ass.h +++ b/libavcodec/ass.h @@ -2,20 +2,20 @@ * SSA/ASS common functions * Copyright (c) 2010 Aurelien Jacobs <aurel@gnuage.org> * - * This file is part of Libav. + * This file is part of FFmpeg. * - * Libav is free software; you can redistribute it and/or + * 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. * - * Libav is distributed in the hope that it will be useful, + * 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 Libav; if not, write to the Free Software + * License along with FFmpeg; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ @@ -23,6 +23,10 @@ #define AVCODEC_ASS_H #include "avcodec.h" +#include "libavutil/bprint.h" + +#define ASS_DEFAULT_PLAYRESX 384 +#define ASS_DEFAULT_PLAYRESY 288 /** * @name Default values for ASS style @@ -36,8 +40,34 @@ #define ASS_DEFAULT_ITALIC 0 #define ASS_DEFAULT_UNDERLINE 0 #define ASS_DEFAULT_ALIGNMENT 2 +#define ASS_DEFAULT_BORDERSTYLE 1 /** @} */ +typedef struct FFASSDecoderContext { + int readorder; +} FFASSDecoderContext; + +/** + * Generate a suitable AVCodecContext.subtitle_header for SUBTITLE_ASS. + * + * @param avctx pointer to the AVCodecContext + * @param font name of the default font face to use + * @param font_size default font size to use + * @param color default text color to use (ABGR) + * @param back_color default background color to use (ABGR) + * @param bold 1 for bold text, 0 for normal text + * @param italic 1 for italic text, 0 for normal text + * @param underline 1 for underline text, 0 for normal text + * @param alignment position of the text (left, center, top...), defined after + * the layout of the numpad (1-3 sub, 4-6 mid, 7-9 top) + * @return >= 0 on success otherwise an error code <0 + */ +int ff_ass_subtitle_header(AVCodecContext *avctx, + const char *font, int font_size, + int color, int back_color, + int bold, int italic, int underline, + int border_style, int alignment); + /** * Generate a suitable AVCodecContext.subtitle_header for SUBTITLE_ASS * with default style. @@ -48,29 +78,34 @@ int ff_ass_subtitle_header_default(AVCodecContext *avctx); /** - * Initialize an AVSubtitle structure for use with ff_ass_add_rect(). - * - * @param sub pointer to the AVSubtitle + * Craft an ASS dialog string. */ -void ff_ass_init(AVSubtitle *sub); +char *ff_ass_get_dialog(int readorder, int layer, const char *style, + const char *speaker, const char *text); /** - * Add an ASS dialog line to an AVSubtitle as a new AVSubtitleRect. - * - * @param sub pointer to the AVSubtitle - * @param dialog ASS dialog to add to sub - * @param ts_start start timestamp for this dialog (in 1/100 second unit) - * @param ts_end end timestamp for this dialog (in 1/100 second unit) - * @param raw when set to 1, it indicates that dialog contains a whole ASS - * dialog line which should be copied as is. - * when set to 0, it indicates that dialog contains only the Text - * part of the ASS dialog line, the rest of the line - * will be generated. - * @return number of characters read from dialog. It can be less than the whole - * length of dialog, if dialog contains several lines of text. - * A negative value indicates an error. + * Add an ASS dialog to a subtitle. */ int ff_ass_add_rect(AVSubtitle *sub, const char *dialog, - int ts_start, int ts_end, int raw); + int readorder, int layer, const char *style, + const char *speaker); + +/** + * Helper to flush a text subtitles decoder making use of the + * FFASSDecoderContext. + */ +void ff_ass_decoder_flush(AVCodecContext *avctx); +/** + * Escape a text subtitle using ASS syntax into an AVBPrint buffer. + * Newline characters will be escaped to \N. + * + * @param buf pointer to an initialized AVBPrint buffer + * @param p source text + * @param size size of the source text + * @param linebreaks additional newline chars, which will be escaped to \N + * @param keep_ass_markup braces and backslash will not be escaped if set + */ +void ff_ass_bprint_text_event(AVBPrint *buf, const char *p, int size, + const char *linebreaks, int keep_ass_markup); #endif /* AVCODEC_ASS_H */ |