From patchwork Wed Sep 21 21:42:02 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: James Almer X-Patchwork-Id: 38136 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:3b1c:b0:96:9ee8:5cfd with SMTP id c28csp2916618pzh; Wed, 21 Sep 2022 14:43:04 -0700 (PDT) X-Google-Smtp-Source: AMsMyM46n6lTEGPhm5/yvBFhSFegw1tpUhyxDtoEIB6l1A4Up6BbXIbGaGwnPiJ4rZ5BguiX3vtc X-Received: by 2002:a17:906:dc8f:b0:77f:ed68:d9ae with SMTP id cs15-20020a170906dc8f00b0077fed68d9aemr225857ejc.692.1663796584218; Wed, 21 Sep 2022 14:43:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1663796584; cv=none; d=google.com; s=arc-20160816; b=JRps1W7pgIZqtMS0kpJFQATwXl3rbYuQXOThpl4ONaRfnoi5sYSiw/Rtl1A8L2fgdr V2ffQn9DLhZ5ROsQGf776j3QixqTU6qbwrPgTjZAbuJDp/S1SGsSs8YhBy9hRSHw97Ux y8wLqb96JXZhJKgnFJE1MlK0OGZNH0SwDxThfYFoCVDEsp55hukgu7X2ARQwxsLUoUro nVXpbdXXZcMspWP26k643hVMZGxsdqYtKduImp+9RICDBaqWywLuhkWE6ZWsRaEQ11so NIWZN+eBTSVIvYd2PCB1/YWaZq6iOgnI1oOo/wBznropjFkzT7qJ1bJEXq0vV7ymL9Ci y9Ww== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:reply-to:list-subscribe :list-help:list-post:list-archive:list-unsubscribe:list-id :precedence:subject:mime-version:message-id:date:to:from :dkim-signature:delivered-to; bh=duwhHsArF1NhWPB/+jni85lMG+6CLuPLrlcrfzXqwZA=; b=y3A90zEpruGJEkva1r/LTLYpZOocoWc+dhzBR27RtYC8NHRjZlzgXrlIt6P1ZhuQV8 DTxyYGNjjy0++5eZNoZfbsGtZfTxWvJumsV6cuE1K56J4gbDolcx7r3vb1gkC1jBhfkX HfKHFKv6lqe8RwhOO/rBOo0wx38g6MyOkafXde/M4TBF2039kkWUwHoyOj2r5VH/tXGK i7rP/TQPxABt78LDQQFpqwm+6BF9GA/TMJB2kcP8fXpxj5fMMJNB8Qlk1U2ZdPq7Nz+X NUb5EKrly35ryQrHn40rRElXgdEAFMioCaZgTvMR+HXxw5QPy7zLevvf0Lc5xBFr+kxO 5GOQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b=TS5FYuD3; 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 r15-20020a1709062ccf00b00773b8e3b6a1si2926232ejr.805.2022.09.21.14.42.48; Wed, 21 Sep 2022 14:43:04 -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=TS5FYuD3; 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 54BCB68BB17; Thu, 22 Sep 2022 00:42:45 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-oi1-f182.google.com (mail-oi1-f182.google.com [209.85.167.182]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id C506068B64C for ; Thu, 22 Sep 2022 00:42:38 +0300 (EEST) Received: by mail-oi1-f182.google.com with SMTP id t62so9812807oie.10 for ; Wed, 21 Sep 2022 14:42:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date; bh=67bw25hYz4z/UV9oenE14OhLPGJO88q9MWMeUaif0Ss=; b=TS5FYuD3RH4wDNTdg8q1egV6WXnuN16y2xm9DgUlvpm1dadi2QP3fmnomZJGc5ofbL OqouAdLZc4cPOItSVlaxRWDQng6VuMMGBgKuGJLO4FrTVRNiHwVEXJC8WVqzCoqA9Wch /CGZlZjGToB4TD6AI32XgWJZ+ITlyjcRvq3cbbmHGb+kmSoI779CMKf37CeFrDmpa4av D3SzJb7xmf1mUD75wEnNGZhBc/M9feTgf80z8ZuaAjgSAvKFmWl9RppXRkvbcdQeL9Nj FsLrHx2m8Tg7si8joFnD0RHxKn5L4CZ0yPMdYhOCWED3YY7DRUQe+CVH/221VKZcCYJJ W9Og== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date; bh=67bw25hYz4z/UV9oenE14OhLPGJO88q9MWMeUaif0Ss=; b=NOCXM5o9xam5witRo0zCam18xIekg2PMsZ1OcySve+fSY/6EReiDOPyYeqrbJcl9YX KbfxUeQ2NpAMPMGalxJV2VC28AuGfvCl9zmmXjVszAemW/ily07SPWUfhJLIIpaiPscM ++RigUv7ddlGD9tLuXuGRyuvn4gCJG0SMf9vlmyHS0U5Jel2ABgNRzE1u7NDEEUaRWnt 0vbNrDftNmbciJjCRL8Qw+HQ5mtA0zH5D+fGmv6hzXQ/OIN3/HyJNOMa2O99crZSVjo9 4vVMxlRMW7uwxu2jB+JV3aahU6DiLIS0vGu8u3QH4ByjUzySeB0bIOHvsPriBhqvwUY7 JX3g== X-Gm-Message-State: ACrzQf1sNf1vVngvzeDc+6cXg3mqYiPyMGbiZ7gLaGxNSbWFmwR8FnwX 1c1Wcr9DrHLZaWovUIGkuT/Zd98NsPw= X-Received: by 2002:a54:4485:0:b0:34f:b741:9932 with SMTP id v5-20020a544485000000b0034fb7419932mr165744oiv.42.1663796556853; Wed, 21 Sep 2022 14:42:36 -0700 (PDT) Received: from localhost.localdomain ([191.97.187.183]) by smtp.gmail.com with ESMTPSA id t12-20020a056870f20c00b0012b5bbbff1dsm2267028oao.42.2022.09.21.14.42.35 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 21 Sep 2022 14:42:36 -0700 (PDT) From: James Almer To: ffmpeg-devel@ffmpeg.org Date: Wed, 21 Sep 2022 18:42:02 -0300 Message-Id: <20220921214202.1300-1-jamrial@gmail.com> X-Mailer: git-send-email 2.37.3 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH] avutil/channel_layout: mention how the API user should treat channel orders it does not understand 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: Cpw9VGeT13Hf In case new orders are added in the future, existing library users can still use the layout simply by ignoring everything but the channel count in it, so make this explicit. Signed-off-by: James Almer --- libavutil/channel_layout.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/libavutil/channel_layout.h b/libavutil/channel_layout.h index 4dd6614de9..9e685fab72 100644 --- a/libavutil/channel_layout.h +++ b/libavutil/channel_layout.h @@ -290,6 +290,9 @@ typedef struct AVChannelCustom { typedef struct AVChannelLayout { /** * Channel order used in this layout. + * Any value not defined in the AVChannelOrder enum in a layout that + * av_channel_layout_check() doesn't reject must be treated as if it was + * AV_CHANNEL_ORDER_UNSPEC. * This is a mandatory field. */ enum AVChannelOrder order;