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 3DF5E42EB4 for ; Thu, 9 Mar 2023 17:51:47 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 6790868BCEB; Thu, 9 Mar 2023 19:51:36 +0200 (EET) 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 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: --- 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 -- 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".