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 352BF43918 for ; Sun, 3 Jul 2022 10:27:39 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 5312268B9AC; Sun, 3 Jul 2022 13:27:12 +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 E0E5D68B9A6 for ; Sun, 3 Jul 2022 13:27:10 +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 263AQhZk012696; Sun, 3 Jul 2022 19:26:45 +0900 DKIM-Filter: OpenDKIM Filter v2.10.3 conssluserg-05.nifty.com 263AQhZk012696 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nifty.com; s=dec2015msa; t=1656844005; bh=1qfRIEDq7lH+g2uKQoFwDhjQC7aUIFTkuk1IVAGtLqQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=qKn7lUO7gAloMXVxkt7u/k92HZ2HdS0dno+iLPm0o+6em06pxNwjLBfKf+JNZl8MK jSakGiGJdwCIItat1i6kqOISOjbmOkTIZ3JNvANzevaV8eUOvNlF/gccM1tNLMAuSo j0fglpQQCPGFqmFr7HZLVNFH337M6DoTl8nB8QUBedeZGG+HFw7m1edmHZiV8ae3LA wBf1nntLb1NsCgLSRjpioeE3mY5Wl7hbNhnnwgRRTg06bH7D+zrICOQm4IFXO6pcan eG2RVujrXJm6yYVbwn/ef3pqYUiaTz76TtEf6XFMNbe6yN9wrY5CRBsjMPD5h6uC02 D8OcpSDKqGyZg== X-Nifty-SrcIP: [106.73.25.34] From: TADANO Tokumei To: ffmpeg-devel@ffmpeg.org Date: Sun, 3 Jul 2022 19:26:27 +0900 Message-Id: <20220703102627.398185-5-aimingoff@pc.nifty.jp> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220703102627.398185-1-aimingoff@pc.nifty.jp> References: <20220703102627.398185-1-aimingoff@pc.nifty.jp> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v5 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 e2fcbf5dc9..c9d65e7dad 100644 --- a/doc/decoders.texi +++ b/doc/decoders.texi @@ -349,6 +349,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".