From patchwork Sun Jul 3 10:26:27 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: TADANO Tokumei X-Patchwork-Id: 36626 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:8b27:b0:88:1bbf:7fd2 with SMTP id l39csp2138710pzh; Sun, 3 Jul 2022 03:27:42 -0700 (PDT) X-Google-Smtp-Source: AGRyM1tavpWpmMJ8IxjjCw6XWqyx3WO7D6OGlMsT7/rHi4uVXOYwDnaOI7nHNGv7FatMboNEI63I X-Received: by 2002:a17:906:970e:b0:726:3b59:3eae with SMTP id k14-20020a170906970e00b007263b593eaemr23937888ejx.702.1656844062117; Sun, 03 Jul 2022 03:27:42 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1656844062; cv=none; d=google.com; s=arc-20160816; b=0kYf4Tx0nSJpuXIj90xnmiGI82yRBsiD4W5ChQjwLDZWmqrkzTHudjrG5MompWJgiL 3lg19bK162Zr5ATM0VfPQBIFn3nINkyrUnd02qr3SOcZvX7100KcdhkH74YuHgRbxt/J rjeMzA3eBrg1QA+O8qwtSz9Cey27aPJOCpnC/hT/7HuY3JiJ55h5gVhBl/BDHhDVzuHn 5SHEPLGcHYKoazBGyzJZo4GhpmQR6I/xQPeRFlW9H+kCgujNhYiQRm0q2wUufYNxurXj HAm9bWXLrVAnvVm9bJJN2nM/uPiqyNbAtSQswO4e74jzvfIRzbxHm0dqHnlmOOMm9zSa Hg/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:mime-version:references:in-reply-to :message-id:date:to:from:dkim-signature:dkim-filter:delivered-to; bh=9/ttV/U3sVAb/2cQV5IPgJ3MZKlJEf8iH00WYtgTLpE=; b=wmkjzqRUwTTYM7m0uAGI9LM4zy9lGIUNTrIfCy8EZr36VKGblHnPliWO5COs4BVPdv JuYveFPyluprFGCUhRKeCnNqPcRcZ4BglN7w3SSAm9r0AYFgCiJbTWLymOD8vpcxCGHg 5ev3u90U5adb26fTk5mLziqmRj1GTK0t2H6vR1LFtp4BIjiWf7kKaMMKNpnWnRNf1x1I 6i/iIzbkx9510WVA3SIQhCIBoC5IlHFvW7D1flyTlT9Csmn9Qx6CKpkG7eUg4C+Gn6Qr RLBreiVuut0EbiS+QFM75YdtvNso0zHHbKTmlMScmOUEA8B8WyLX6u6TnL1yFmh6hVX3 KRHQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@nifty.com header.s=dec2015msa header.b=qKn7lUO7; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id f14-20020a056402354e00b0043580e5e8bdsi10392701edd.459.2022.07.03.03.27.41; Sun, 03 Jul 2022 03:27:42 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@nifty.com header.s=dec2015msa header.b=qKn7lUO7; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 812D768B9B1; Sun, 3 Jul 2022 13:27:12 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: 3D0D1f2X8juN 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