From patchwork Tue Mar 19 21:15:04 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marton Balint X-Patchwork-Id: 47237 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:8ba5:b0:1a3:31a3:7958 with SMTP id m37csp13065pzh; Tue, 19 Mar 2024 14:16:06 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCVdQ7IxbR1U/wIgtjHKvz+1IGZMt1bIVFh3xF5J3bbD64Pw6rhkt4asxIoWp7x1GGd5LYeusF8hzWzmUDMGmD2kliml1sWFjPK2zw== X-Google-Smtp-Source: AGHT+IFMXRB/U5kOTG81/ILewhGWxP+0U5kZ65NpbQTKTHIu68Sz0E6+7yNiz9FOE4jB741UJOd4 X-Received: by 2002:a50:d5d6:0:b0:568:9b14:d6c7 with SMTP id g22-20020a50d5d6000000b005689b14d6c7mr3786902edj.16.1710882965835; Tue, 19 Mar 2024 14:16:05 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1710882965; cv=none; d=google.com; s=arc-20160816; b=1IemK9fz1ZsqHvTAfhR42wZFZ/G1eXMVY9szJ2tJoDA2nBKvwWQt2W6VuuYQo4hgv5 GoSoc3MB1xeLJz3weLe9GqUYsFGI7B8fcgAuF/ve9HKs81LA25PzJ4YYN8zjQ6PE/dGl P2xsLMoBKXRZkAAeH7EbX0TFy9BBSDMdVdNJDvlv3Ed0QvED4V694Rxy1Yjq9kU3Vb9u oiQyzeex76sYdIKVcUxTSpw48ZaXO4nrk7OAYZt+4h+Abphg+ilqcxCPes6CMk0dfaJp c007WBDIXtRxOZyYOK94DO3nRew4zLVaCR6e98vyvGL27XPuwNa1uvToCCekyFXLfGPI N4dA== 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=hr2vAFJbZ4G1G12pAVe9oU+VRB07Fuorr6CSLFl8unU=; fh=s+G8Ss4JbeMFkWPSp2LmIH/LXFyBlALRiww1j3FPjHY=; b=pexwLOKSWA45yMVTn3mffiawVV6zSQLWxLy+KsJk/8jT6IWe5ejjhjwW/g0tys/rIh +7y7/PQfzi3/hba8pqzKHYWzlyqVTsZN0ZqvMh2UHvWIEG67APK+gv5a58bxWF1gR1LP Iea/QgSXZ8xY5EvNRvuiGLfdMIo8rnNuR1TzuIl4DHuSao3fw7sSB/DQvXG/SLVwyoU8 JU0g6x0yoIrhU0WyKiZq9DX1vCje9jyDWKJ8DVH6g+Gu7tlXddJ0MMIDAvCFYR/bHP0I VquxRHicbPeiyVSt9IH6CQsP1/OdtARZniQtaZ4cyMZh0rid9ZXE/Q4wnNHMJfdalvf5 Or+A==; dara=google.com 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 n1-20020a170906118100b00a46af0e677fsi3013745eja.509.2024.03.19.14.16.05; Tue, 19 Mar 2024 14:16:05 -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; 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 586B568D456; Tue, 19 Mar 2024 23:15:30 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from iq.passwd.hu (iq.passwd.hu [217.27.212.140]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id B12F068D450 for ; Tue, 19 Mar 2024 23:15:23 +0200 (EET) Received: from localhost (localhost [127.0.0.1]) by iq.passwd.hu (Postfix) with ESMTP id 82B39E9BD0; Tue, 19 Mar 2024 22:15:23 +0100 (CET) X-Virus-Scanned: amavisd-new at passwd.hu Received: from iq.passwd.hu ([127.0.0.1]) by localhost (iq.passwd.hu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id bFznmAl3R3lS; Tue, 19 Mar 2024 22:15:22 +0100 (CET) Received: from bluegene.passwd.hu (localhost [127.0.0.1]) by iq.passwd.hu (Postfix) with ESMTP id 93C37EA1B2; Tue, 19 Mar 2024 22:15:20 +0100 (CET) From: Marton Balint To: ffmpeg-devel@ffmpeg.org Date: Tue, 19 Mar 2024 22:15:04 +0100 Message-Id: <20240319211504.8342-6-cus@passwd.hu> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20240319211504.8342-1-cus@passwd.hu> References: <20240319211504.8342-1-cus@passwd.hu> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 6/6] doc/filters: extend af_channelmap documentation 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: Marton Balint Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: lWx7F6UYdwB3 Signed-off-by: Marton Balint --- doc/filters.texi | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/doc/filters.texi b/doc/filters.texi index 913365671d..18f0d1c5a7 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -4291,14 +4291,18 @@ It accepts the following parameters: @item map Map channels from input to output. The argument is a '|'-separated list of mappings, each in the @code{@var{in_channel}-@var{out_channel}} or -@var{in_channel} form. @var{in_channel} can be either the name of the input -channel (e.g. FL for front left) or its index in the input channel layout. -@var{out_channel} is the name of the output channel or its index in the output -channel layout. If @var{out_channel} is not given then it is implicitly an -index, starting with zero and increasing by one for each mapping. +@code{@var{in_channel}} form. @var{in_channel} can be either the name of the +input channel (e.g. FL for front left) or its index in the input channel +layout. @var{out_channel} is the name of the output channel or its index in the +output channel layout. If @var{out_channel} is not given then it is implicitly +an index, starting with zero and increasing by one for each mapping. Mixing +different types of mappings is not allowed and will result in a parse error. @item channel_layout -The channel layout of the output stream. +The channel layout of the output stream. If not specified, then filter will +guess it based on the @var{out_channel} names or the number of mappings. +Guessed layouts will not necessarily contain channels in the order of the +mappings. @end table If no mapping is present, the filter will implicitly map input channels to