From patchwork Tue Oct 18 10:40:28 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: TADANO Tokumei X-Patchwork-Id: 38772 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:4a86:b0:9d:28a3:170e with SMTP id fn6csp2035899pzb; Tue, 18 Oct 2022 03:41:54 -0700 (PDT) X-Google-Smtp-Source: AMsMyM55eokfpGtNR2OYqEUOvucse8SL6O9DxmghJuMXNXVEYu09jFapIpNAyXG+HWn79y0jWeHr X-Received: by 2002:aa7:c607:0:b0:458:fe72:4756 with SMTP id h7-20020aa7c607000000b00458fe724756mr1987733edq.423.1666089714413; Tue, 18 Oct 2022 03:41:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666089714; cv=none; d=google.com; s=arc-20160816; b=UKRGUXtSqsq4kBODn2dJoqFeHm3yA7Vwdb/J5J1t2vWPZ+sowk+6WFwu5NvmZB3J5N a1FWBLtH1ugYluyD8mf3VIlR4bjntXg0oQU8DnA/pbnbq+Kweb+zKHjdmPj8tlcY3VFb ROquAtRpS6syWcBCU2lATRmOVYH7H/nMFxdRtoaEy/gYo0nTr3XNiUL1QNEpT+h60DAK 73kBd5egpHzQT9eX4dO0J4yab2XT1t47SxJZUF/ulwwsWQJ4DDLrSRyxj3MW3+q64k2E rowNVXoESwXCwrf7fMeelYbxiJG/1vObPU5VL/lG47IHgkv0BKUVKonH1Jk9LUM5NMuW P+9g== 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=D3sYpsS4/uSaB570P5jrlY8h0nFru6oI49yttV0vo6I=; b=cfKZmuSQ1rRREnkzEa21cwvH06NmW4PnT42UZiHOsqzbdGIWzo+sLRNOteyia/EyVb sY+g1bHO+h+ro2UDrR4jFcTzOLBaqkDcZ1GLktEE5A8QlqjR2VA43Gk42zs3/dE6sFXH mBJqiN8BSXBxlCGNednZ6/Wa+Kq0L97ZhyiGjNvdlQvNbOFHGJERXvRcg+tcI4NIgbFL NTvEnwYyeK0HryFZfAXyrNi8n9R1d9GrfCOluypLhjkimaa9RpoSTc53WOjTOefP/bYi tzMDGOxY8olAEnzDARrBQl5fB7qYIfymF8zmkuGSfVQ/LG/cPqk/BQfJDCxUqA0VAo2A mI1A== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@nifty.com header.s=dec2015msa header.b=lVRbGB+X; 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 z5-20020a056402274500b0045c13366de4si12707249edd.572.2022.10.18.03.41.54; Tue, 18 Oct 2022 03:41:54 -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=lVRbGB+X; 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 BC12F68BD16; Tue, 18 Oct 2022 13:41:23 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from conssluserg-01.nifty.com (conssluserg-01.nifty.com [210.131.2.80]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 5EF9268BB9A for ; Tue, 18 Oct 2022 13:41:11 +0300 (EEST) Received: from osamu-pc.. (M106073025034.v4.enabler.ne.jp [106.73.25.34]) (authenticated) by conssluserg-01.nifty.com with ESMTP id 29IAelI5017112; Tue, 18 Oct 2022 19:40:49 +0900 DKIM-Filter: OpenDKIM Filter v2.10.3 conssluserg-01.nifty.com 29IAelI5017112 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nifty.com; s=dec2015msa; t=1666089649; bh=+c0x6LVvP/rx1RX0qRHoWjw6IzKexPxSWLG4SjTS584=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=lVRbGB+Xat9cJioWmPfdRM9m+vQgP/vHROaSRHvv7ZXKVP+5piOvcdEQhRXazBG0d Q99Afcd9uOXzZKwLT2xo8gJ0rhPR6XzTRilmVJyc2T+6obTF70ykxi48ujx+eiIost sEua8GU3NYQyBBG4wlLerLVFUMYvQiLzxzfj/oXEHQmGRLGcg4xui9Gvk9TXkCY2g1 vEL/ZmuSoniWoIdb/6TRKFD/jmFOsPBiMkEmX4c38vZEDGPTdQNQnktb13rzOzvBCl WvWKti30+pJTEgbcuQ944rjN0UKlE8TiFIPWnmNq6GUBFP1YtLqgJdALuP3+OjsRUJ b1Wry3Xk7fJeA== X-Nifty-SrcIP: [106.73.25.34] From: TADANO Tokumei To: ffmpeg-devel@ffmpeg.org Date: Tue, 18 Oct 2022 19:40:28 +0900 Message-Id: <20221018104028.34644-5-aimingoff@pc.nifty.jp> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20221018104028.34644-1-aimingoff@pc.nifty.jp> References: <20221018104028.34644-1-aimingoff@pc.nifty.jp> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v6 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: yHIZpyfmZUqm --- doc/decoders.texi | 99 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) diff --git a/doc/decoders.texi b/doc/decoders.texi index 5ba85cf9b1..32cdf5eae3 100644 --- a/doc/decoders.texi +++ b/doc/decoders.texi @@ -353,6 +353,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