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 031BE47566 for ; Wed, 10 Jan 2024 21:38:13 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 2DD4468CFFD; Wed, 10 Jan 2024 23:37:28 +0200 (EET) Received: from mail-ed1-f54.google.com (mail-ed1-f54.google.com [209.85.208.54]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 4B07368CFA7 for ; Wed, 10 Jan 2024 23:37:20 +0200 (EET) Received: by mail-ed1-f54.google.com with SMTP id 4fb4d7f45d1cf-5537dd673e5so3948578a12.0 for ; Wed, 10 Jan 2024 13:37:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1704922638; x=1705527438; darn=ffmpeg.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=orC9GEuKowAJOhDzTcwgr2vP6qhXCme/MyODYNNTop0=; b=HssGw9+bxNf9JfBHixFyjqZOvvzpW/BgZw4MfNBivC2hAHGjwRbfKf1+P+Ih0VxCfI ifdGt+jkCRckwcwGlQa/RRmk0UWpswJeHPS+ibsajt0B7PuwOFda2TZPndJKrFBeNuO6 RRnjxg5F0mMXLFjuKiiTPgL/yGwS6MjTW+w7qtTy669YvI+vdg2oazBi3tDOpe2d0HCY Ar6beyDzZDaRtTBfwOplimv60YvQh2HEI+YLY2Hx7HtMiLf8maPUqzkLV/6m45QjmHQT DPE8K5WO1AM97Aidb7Q0tbZByI1h5c4YdGx6qng0GPYg+8tDn7RTW+XYVeneX3CY0VGU H6Ag== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1704922638; x=1705527438; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=orC9GEuKowAJOhDzTcwgr2vP6qhXCme/MyODYNNTop0=; b=LiZJ3JB4XL8aGhJcdvHca/dN3ofaiZxa1ZQPteNkGbmLIgzTuEPAcLDzfOQairRN+Q 1vXmkoH35gFOY1JL+QQXJQzR7UmS2QBVhlEpxe7y7c41rABzGTPVqjkQ3uhiJQzTiTjw FRXzuSVZma1pBeY5Ze6qxYtkoGCc+FvJ13XHrh0+DGdpQhZuKFgUgIviV/5dn5O1C3Hw Jydx7PDOKXdZhY55Hx6CuEKc4ufcKYwAlEupjYJG1oyjOgBxVDpwtdN4iVzw9xKKEbki jktbzEdOpinryYeahQmAWm+kLMt9djK72pKewvmvOgTEqoZls1XYIHequF88VQBd/5E4 V57Q== X-Gm-Message-State: AOJu0YyOEx78o5twab4nb05CxsqYNEQChw2bzm2xMulg12UufFuCN+4u 1Y+GLT5cKiZyZBseP9S778OGPpAwaSw= X-Google-Smtp-Source: AGHT+IHMs0ka4GWEI2hoBuZO6OgBUg2TczpqnNVe0/vi1PsDMqjSRJ8DCVIfEeUVCD05G68Ks8azTw== X-Received: by 2002:aa7:da58:0:b0:556:fb11:c117 with SMTP id w24-20020aa7da58000000b00556fb11c117mr60388eds.2.1704922637740; Wed, 10 Jan 2024 13:37:17 -0800 (PST) Received: from mariano (dynamic-adsl-84-220-189-10.clienti.tiscali.it. [84.220.189.10]) by smtp.gmail.com with ESMTPSA id y24-20020a056402135800b00557b0f8d906sm2372632edw.70.2024.01.10.13.37.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 10 Jan 2024 13:37:16 -0800 (PST) Received: by mariano (Postfix, from userid 1000) id A4879BFCE4; Wed, 10 Jan 2024 22:37:15 +0100 (CET) From: Stefano Sabatini To: FFmpeg development discussions and patches Date: Wed, 10 Jan 2024 22:37:15 +0100 Message-Id: <20240110213715.450452-4-stefasab@gmail.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240110213715.450452-1-stefasab@gmail.com> References: <20240110213715.450452-1-stefasab@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 4/4] doc/muxers/avi: apply misc changes 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: Stefano Sabatini 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: In particular: * sort options by name * apply misc formatting and consistency fixes * add introduction explaining the need to set some options --- doc/muxers.texi | 28 ++++++++++++++++------------ 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/doc/muxers.texi b/doc/muxers.texi index 7ed5ed50a5..1c88816c3c 100644 --- a/doc/muxers.texi +++ b/doc/muxers.texi @@ -794,15 +794,24 @@ It accepts a single audio stream. @anchor{avi} @section avi - Audio Video Interleaved muxer. -@subsection Options +AVI is a proprietary format developed by Microsoft, and later formally specified +through the Open DML specification. -It accepts the following options: +Because of differences in players implementations, it might be required to set +some options to make sure that the generated output can be correctly played by +the target player. +@subsection Options @table @option -@item reserve_index_space +@item flipped_raw_rgb @var{bool} +If set to @code{true}, store positive height for raw RGB bitmaps, which +indicates bitmap is stored bottom-up. Note that this option does not flip the +bitmap which has to be done manually beforehand, e.g. by using the @samp{vflip} +filter. Default is @code{false} and indicates bitmap is stored top down. + +@item reserve_index_space @var{size} Reserve the specified amount of bytes for the OpenDML master index of each stream within the file header. By default additional master indexes are embedded within the data packets if there is no space left in the first master @@ -815,20 +824,15 @@ The required index space depends on the output file size and should be about 16 bytes per gigabyte. When this option is omitted or set to zero the necessary index space is guessed. -@item write_channel_mask +Default value is @code{0}. + +@item write_channel_mask @var{bool} Write the channel layout mask into the audio stream header. This option is enabled by default. Disabling the channel mask can be useful in specific scenarios, e.g. when merging multiple audio streams into one for compatibility with software that only supports a single audio stream in AVI (see @ref{amerge,,the "amerge" section in the ffmpeg-filters manual,ffmpeg-filters}). - -@item flipped_raw_rgb -If set to true, store positive height for raw RGB bitmaps, which indicates -bitmap is stored bottom-up. Note that this option does not flip the bitmap -which has to be done manually beforehand, e.g. by using the vflip filter. -Default is @var{false} and indicates bitmap is stored top down. - @end table @anchor{chromaprint} -- 2.34.1 _______________________________________________ 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".