From patchwork Thu Mar 9 17:51:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nicolas Gaullier X-Patchwork-Id: 40629 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:d046:b0:cd:afd7:272c with SMTP id hv6csp532233pzb; Thu, 9 Mar 2023 09:51:49 -0800 (PST) X-Google-Smtp-Source: AK7set96LrqGIuHuG2JrD01TEzeT7gHdjh0tHQ7oUlGtVXMuA9eWxMTc0FexfLsBl1Lo/uj0P4gn X-Received: by 2002:a17:906:2b99:b0:8b1:fc59:a22b with SMTP id m25-20020a1709062b9900b008b1fc59a22bmr22531530ejg.34.1678384309748; Thu, 09 Mar 2023 09:51:49 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1678384309; cv=none; d=google.com; s=arc-20160816; b=p8DEhhDAXuSQgGM9hHJTZDNij1eerGEJVFh8K+YRiq8ELrv8/CSX+0qjkAiYlU9vXE OhQzBLQY5Z4c3GJlY0KH83y8FrSlGF6ds2oVh4YhtSSKvyZt+6PfaGwUH89PmQUCx9PL oTiLab+HXkzf0fOay1wwj/7k0MWjWG9Ydh8qq44sz6QAJtE6/p1mEO3tFt12TG85/gw1 6NOVoTHtURGzn7mX2XRk7+w3lSOxO+K8y3kO/+jJlAFPFpegirXHaf2uA9z3+Q8cH+G4 Vnt+l/j24WCFsQshX4EbYnSxUPDnbeEAaeZgc6yxJ5lxGTfKTyYMAfqsu7hkxpsROtPs tGiA== 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:delivered-to; bh=t6Bt3/Dt7tCL6yNK6KcqqrGn7I4hV2CrMhA4aqu0IaA=; b=n9KDFHsZXWEkunqSRR6TW+5yOyYL4+3hY7E71jtFnP7+oUZ+11Mj1jnsL9+wGKcWnB A0xwgCZINQ47b6vKK2xuu+fIin+41nCMmTlZRQ6c16cztvwB66BcfeVDQUbgitghZKLl fvag6CP9QaBRQ0YmoNGzC/Kc12vwcYgZjzYOFS+H33gDl0aDLiwnMfUNsZlLQxFV6Eum gLhBtLkpsJxuDKUEnce4iMaVcTa82h4BWb5W9bKkVp77NAo7Q3VNkjF+/oavkbb0CB+z cmPImnpLZ0YM6XGtj8zE0XhOkyPANS7xIcdKf5DXX0aSb/m5mBN1R3/ZBX7wW/T18Zsh WBYg== ARC-Authentication-Results: i=1; mx.google.com; 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 k14-20020a17090627ce00b008db6177cc3bsi2872267ejc.525.2023.03.09.09.51.49; Thu, 09 Mar 2023 09:51:49 -0800 (PST) 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; 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 9888468BCF2; Thu, 9 Mar 2023 19:51:36 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from srv-infra-2.infra.inf.glb.tvvideoms.com (www.inf.tvvideoms.com [213.205.126.156]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 9076068B09D for ; Thu, 9 Mar 2023 19:51:28 +0200 (EET) Received: from cji.paris (unknown [172.16.3.159]) by srv-infra-2.infra.inf.glb.tvvideoms.com (Postfix) with ESMTP id 6096E42C78; Thu, 9 Mar 2023 17:51:27 +0000 (UTC) From: Nicolas Gaullier To: ffmpeg-devel@ffmpeg.org Date: Thu, 9 Mar 2023 18:51:25 +0100 Message-Id: <20230309175125.19691-2-nicolas.gaullier@cji.paris> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230309175125.19691-1-nicolas.gaullier@cji.paris> References: <20230309175125.19691-1-nicolas.gaullier@cji.paris> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 7/7] doc: add doc about dolby_e decoder and wav support 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: Nicolas Gaullier Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: eBO52lT8rO4c --- doc/decoders.texi | 20 ++++++++++++++++++++ doc/demuxers.texi | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+) diff --git a/doc/decoders.texi b/doc/decoders.texi index 5ba85cf9b1..750fb4bd7a 100644 --- a/doc/decoders.texi +++ b/doc/decoders.texi @@ -223,6 +223,26 @@ Loud sounds are fully compressed. Soft sounds are enhanced. @end table +@anchor{dolby_e} +@section dolby_e + +Dolby E audio decoder. + +This is a raw decoder without any further processing, which means the output +sample rate is different from the 48KHz input sample rate. +A dolby E stream is always carried in a s337m muxer, as a raw file +or muxed in any format that is able to transport an AES3 +or an equivalent uncompressed audio stream (stereo, 48KHz, 16/20/24 bits). +Currently, only wav and raw file formats are supported. Other formats require +two passes of processing: a first one to extract the s337m stream, +and another to decode it. +In case of AES3, or if the format itself supports it, the non-PCM mode may +be signaled, but in a more general manner, a stream has to be probed to be +handled as dolby E rather than pcm. +By default, stream probing is enabled which forbids pass-through as no s337m +muxer is implemented yet. In order to pass-through a dolby E stream, +@code{--non_pcm_mode copy} must be specified (see input muxer options). + @section flac FLAC audio decoder. diff --git a/doc/demuxers.texi b/doc/demuxers.texi index 3c81024f03..c86bd91461 100644 --- a/doc/demuxers.texi +++ b/doc/demuxers.texi @@ -928,4 +928,37 @@ which in turn, acts as a ceiling for the size of scripts that can be read. Default is 1 MiB. @end table +@section wav, w64 + +WAV/RF64/BW64/Wave64 demuxer. + +This demuxer supports spdif and s337m probing, as well as direct codec +probing in some cases (dts). +Concerning dolby E, see @ref{dolby_e,,the dolby E section in the ffmpeg-codecs manual,ffmpeg-codecs}. + +@subsection Options + +This demuxer supports the following options: + +@table @option + +@item ignore_length @var{bool} +Ignore the length field of the 'data' chunk: read everything as data up to eof. Default is disabled. +This option is not supported in the Wave64 demuxer. + +@item max_size +Max size of a single packet. Default is 4096. + +@item non_pcm_mode +This option is active only if s337m data is probed. +Specify how this data shall be handled. Default is to demux. +@table @samp +@item copy +Pass-through as pcm: s337m will not be reported +@item demux +Demux and report the encoded stream for later decoding +@end table + +@end table + @c man end DEMUXERS