From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTP id D114F4075B for ; Mon, 30 May 2022 14:57:15 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 6587268B61C; Mon, 30 May 2022 17:56:54 +0300 (EEST) Received: from conssluserg-05.nifty.com (conssluserg-05.nifty.com [210.131.2.90]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 1910668B5E7 for ; Mon, 30 May 2022 17:56:45 +0300 (EEST) Received: from osamu-pc.kimura.local (M106073025034.v4.enabler.ne.jp [106.73.25.34]) (authenticated) by conssluserg-05.nifty.com with ESMTP id 24UEuMFH014185; Mon, 30 May 2022 23:56:24 +0900 DKIM-Filter: OpenDKIM Filter v2.10.3 conssluserg-05.nifty.com 24UEuMFH014185 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nifty.com; s=dec2015msa; t=1653922584; bh=PvyW3rOKO2tNMEhsXvPc9tTh9SYf4ouDFc50hrmyCRQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=q5dBiYqJ80YjAbt7Een5ssHX3gTt+kKk2XZRZ2gMkBCQ+eWqA4g8PM94u9MHG5KeE D2XHY1JdkYBy+Zdo67u/05kmKXv8S2VBApBcZ+sLsZ8kWrsLRe8PQnQ7YWhF1gX/Oy /VK8YUXsgnI6SyWgAOW8GFyfoX3gitjD3f/eLxrEA/V7pfplPanN3qNnKd9DjiFlor mYmNZI1oiAMDcAxaktgW4seuLI0pIQHljLCqidCkJ9ko5+0FdIfzWm36C4luPGTdMt vi5xjtj1pFcM1TTefCjJgpsPAjblN9QFqtzEt6RUDGJOuL8pWXrDu43VEv09rzNShw aCldU043h0iyQ== X-Nifty-SrcIP: [106.73.25.34] From: TADANO Tokumei To: ffmpeg-devel@ffmpeg.org Date: Mon, 30 May 2022 23:55:48 +0900 Message-Id: <20220530145548.211886-5-aimingoff@pc.nifty.jp> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220530145548.211886-1-aimingoff@pc.nifty.jp> References: <20220530145548.211886-1-aimingoff@pc.nifty.jp> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v4 4/4] doc/decoders.texi: add document of aribcaption decoder X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: TADANO Tokumei Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: Signed-off-by: TADANO Tokumei --- doc/decoders.texi | 99 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) diff --git a/doc/decoders.texi b/doc/decoders.texi index de2429abba..eb82b4df48 100644 --- a/doc/decoders.texi +++ b/doc/decoders.texi @@ -334,6 +334,105 @@ Enabled by default. @end table +@section aribcaption + +Yet another ARIB STD-B24 caption decoder using external @dfn{libaribcaption} +library. + +Implements profiles A and C of the Japanse ARIB STD-B24 standard, +Brazilian ABNT NBR 15606-1, and Philippines version of ISDB-T. + +Requires the presence of the libaribcaption headers and library +(@url{https://github.com/xqq/libaribcaption}) during configuration. +You need to explicitly configure the build with @code{--enable-libaribcaption}. +If both @dfn{libaribb24} and @dfn{aribcaption} are enabled, @dfn{aribcaption} +decoder precedes. + +@subsection aribcaption Decoder Options + +@table @option + +@item -sub_type @var{subtitle_type} +Specifies the format of the decoded subtitles. + +@table @samp +@item bitmap +Graphical image. +@item ass +ASS formatted text. +@item text +Simple text based output without formatting. +@end table + +The default is @dfn{ass} as same as @dfn{libaribb24} decoder. +Some present players (e.g., @dfn{mpv}) expect ASS format for ARIB caption. + +@item -font @var{font_name[,font_name2,...]} +Specify comma-separated list of font family names to be used for @dfn{bitmap} +or @dfn{ass} type subtitle rendering. +Only first font name is used for @dfn{ass} type subtitle. + +If not specified, use internaly defined default font family. + +@item -ass_workaround @var{boolean} +Since some players (e.g., @dfn{mpv}) can't handle multi-rectangle ASS +subtitle properly, default behavior is all the texts are displayed in +a single-rectangle at a time. +It causes some texts may not be displayed at expected position as described +in ARIB STD-B24. + +The default is @var{true}. + +If a player can handle multi-rectangle ASS subtitle and you prefer +more suitable positioning, set this option to @var{false} or define +@env{ASS_WORKAROUND=0} to change default behavior at compilation. + +@item -replace_fullwidth_ascii @var{boolean} +Specify whether to replace MSZ (Middle Size, half width) fullwidth +alphanumerics with halfwidth alphanumerics. + +The default is @var{true}. + +@item -force_outline_text @var{boolean} +Specify whether always render outline text for all characters regardless of +the indication by charactor style. + +The default is @var{false}. + +@item -outline_width @var{number} (0.0 - 3.0) +Specify width for outline text, in dots (relative). + +The default is @var{1.5}. + +@item -ignore_background @var{boolean} +Specify whether to ignore background color rendering. + +The default is @var{false}. + +@item -ignore_ruby @var{boolean} +Specify whether to ignore rendering for ruby-like (furigana) characters. + +The default is @var{false}. + +@item -replace_drcs @var{boolean} +Specify whether to render replaced DRCS characters as Unicode characters. + +The default is @var{true}. + +@end table + +@subsection aribcaption decoder usage examples + +Display MPEG-TS file with ARIB subtitle by @dfn{ffplay} tool: +@example +ffplay -sub_type bitmap MPEG.TS +@end example + +Embed ARIB subtitle in transcoded video: +@example +ffmpeg -sub_type bitmap -i src.m2t -filter_complex "[0:v][0:s]overlay" -vcodec h264 dest.mp4 +@end example + @section dvbsub @subsection Options -- 2.30.2 _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org https://ffmpeg.org/mailman/listinfo/ffmpeg-devel To unsubscribe, visit link above, or email ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".