From patchwork Sun Mar 26 17:34:01 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Sabatini X-Patchwork-Id: 40839 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:7a30:b0:df:834d:2c1a with SMTP id t48csp775086pzh; Sun, 26 Mar 2023 10:34:25 -0700 (PDT) X-Google-Smtp-Source: AKy350arQJr/AbDm9jvhyWEZ6N4g2zy6wXRrT0Rjxr5ki/ONqK2jy0fNkMEGwRd7xATJLvbO0Iwh X-Received: by 2002:a17:906:9241:b0:932:cec7:6801 with SMTP id c1-20020a170906924100b00932cec76801mr9576726ejx.54.1679852065177; Sun, 26 Mar 2023 10:34:25 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1679852065; cv=none; d=google.com; s=arc-20160816; b=nhv7YwdTo1zuX4TAiGldicE+96Rc/TF4WTTiO1HkABKEISSN+YSyl5Xqg6NwxEgamy HY8DG3Cjlv3SYPr5vhwMCoB0Sy/kykYYJEqya9vJzvDgvsqZ/uQl69/BrqYJCq3V5O6w JRAbckekLBwmkCniery9Dd+ruwBr2Sjyng74t644S1Jns/OgZzd13uCRjA9p8Zo/Q5mm 38sIZuI+R8IZwAzhbbNh8rzMSH1JAqvFbClHjlIzCQgPYFCO6ubiCtLeOgeGqSaweLm+ fRVKzETaZ9rVTN00bF3BiWCD5fHlUmetcrSX9jSexpm903Nxt2+IZUj+YpClBzoNIKkX CzCQ== 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:delivered-to; bh=zYDARStFpe1K3ZRYqknhQWkvPmNkh1t7cYvL7uz5RmQ=; b=t5IfaHsrAuf0wQrEifk0qY+rPD4ARMij73SFapE7UjMZk7uKP5rdvISEMfovFTDLNp E3lsFXFc+joIXuXK8KWhUs+W5O7N5ABN3GUavrd+ry/RbQrZZAiZZV9tN5UeQGOpKpvt m+Dmj8BnhnxjYJQ/34z2vG9lXCr+eV/t5CsI+Vqk6AX4Zi+25xS7UqihvtPLdjIaRXPh Hao1Y59349+6LiXkRCG5vTR4/iQE7SxqwXMX4ER97gPgDQHGTueCt9w0ZG3U0T+dNESF h7hvyJwNOUb4JooxknXNKDSBuNfQSzOaTWYxtZxVrP65U2YD9nVDxeJ3elvExj89IHc5 j7vQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b="EO/EDUQz"; 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; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id gn7-20020a1709070d0700b008c254523c37si30130730ejc.539.2023.03.26.10.34.24; Sun, 26 Mar 2023 10:34:25 -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=@gmail.com header.s=20210112 header.b="EO/EDUQz"; 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; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 6BC8268C05B; Sun, 26 Mar 2023 20:34:12 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org 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 08E0F68C05B for ; Sun, 26 Mar 2023 20:34:05 +0300 (EEST) Received: by mail-ed1-f54.google.com with SMTP id h8so26766336ede.8 for ; Sun, 26 Mar 2023 10:34:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1679852043; 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=qABimQdyvUWR2mXCHo1TLtmUE/FrppKuyiTTh4lGKIU=; b=EO/EDUQzqydtnIsbN7w+8vFoB0v0gXArqD71nLBHupBjyKpC9d7UvAwOAtRqYLHRBR HQUXz8irbcuhZfRv1fFctse2aKGXKXX//nVPagmVkro1gCa8c9qEJktQEty+WsXRf9Sf wChc7VmBvO2uWMDxeYp9AN7IeKkoPIF9jg1Nx2ouKMhs/qKTTSPxL5W5egQuXAUzvSFH pXyLqSjY7YrkAPHAIx3UiRvH2eUd8KzAOufXKC0oyeQYruhXC86QQIE3tgpfnEzsSxD1 t7CjMr0wq4gwF6ookSZBU0N3sFEIH+cjhHiDNFCfELcw7+pAnZhi4XlEQ10/Ip2IzIev Sorg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1679852043; 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=qABimQdyvUWR2mXCHo1TLtmUE/FrppKuyiTTh4lGKIU=; b=3oUt5ZEeKQjK5KC6deUjfoqFA00LOGkNnpd0vy1uHwQHLmvR3FOH7XTEumailkEsJE A+qCWBEfjhDrJn2GbhNXsiRyA+xcR2qT0i2sW6rpcOLrqXUDPay527kzKmsUvgw5i/BU reX3VX53j/av2WCA68u9BEUWQObnCbnZX6WfxVClKiIk1ZjCF6gSo0lRCG790IR9FvkV JDIBewUqVBC8h5VHFpxDCogFI3/wC3DbzERzmObqXGzPft5kbMmh28g0U49kigYTFg5u Ri8t8un+PfSgQrLHdoEu+EqWhP0tw77QvFZ6kQRSSsw8pkxVwM/CAwnAzRBDuZS+ytsw MrLw== X-Gm-Message-State: AAQBX9fJRMd+T3Z6ENpoU9Ib65XhTOTpapOOKoV17CFqPEi+GtDZzZZL hxh5/sBaDrUelC5ADkOAYfAMfQ6hovI= X-Received: by 2002:a05:6402:14d6:b0:502:4184:a067 with SMTP id f22-20020a05640214d600b005024184a067mr2249052edx.15.1679852043517; Sun, 26 Mar 2023 10:34:03 -0700 (PDT) Received: from mariano (dynamic-adsl-62-10-98-143.clienti.tiscali.it. [62.10.98.143]) by smtp.gmail.com with ESMTPSA id q18-20020a50c352000000b00501d39f1d2dsm9234061edb.41.2023.03.26.10.34.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Mar 2023 10:34:02 -0700 (PDT) Received: by mariano (Postfix, from userid 1000) id 4A09BBFB75; Sun, 26 Mar 2023 19:34:01 +0200 (CEST) From: Stefano Sabatini To: FFmpeg development discussions and patches Date: Sun, 26 Mar 2023 19:34:01 +0200 Message-Id: <20230326173401.56228-3-stefasab@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230326173401.56228-1-stefasab@gmail.com> References: <20230326173401.56228-1-stefasab@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 3/3] doc/filters: mentions that whitespaces are ignored in the filtergraph specification 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: m+KIVYTVXy9Y Also provide example showing how to use this feature to improve filtergraph readability. Address issue: http://trac.ffmpeg.org/ticket/8115 --- doc/filters.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/filters.texi b/doc/filters.texi index 1c9d523340..889de8b11a 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -214,6 +214,23 @@ In a complete filterchain all the unlabelled filter input and output pads must be connected. A filtergraph is considered valid if all the filter input and output pads of all the filterchains are connected. +Leading and trailing whitespaces (space, tabs, or line feeds) separating tokens +in the filtergraph specification are ignored. This means that the filtergraph +can be expressed using empty lines and spaces to improve redability. + +For example, the filtergraph: +@example +testsrc,split[L1],hflip[L2];[L1][L2] hstack +@end example + +can be represented as: +@example +testsrc, +split [L1], hflip [L2]; + +[L1][L2] hstack +@end example + Libavfilter will automatically insert @ref{scale} filters where format conversion is required. It is possible to specify swscale flags for those automatically inserted scalers by prepending