From patchwork Sun Jan 16 23:03:53 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andreas Rheinhardt X-Patchwork-Id: 33625 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a6b:cd86:0:0:0:0:0 with SMTP id d128csp2273402iog; Sun, 16 Jan 2022 15:06:13 -0800 (PST) X-Google-Smtp-Source: ABdhPJzOXfScNwlxJo64K1z6BwOHULiRvxezB3IJTbYQBI+yVvAzAqreZltWDLnD5ZQRG9RssbrV X-Received: by 2002:a17:906:6691:: with SMTP id z17mr14596724ejo.763.1642374373058; Sun, 16 Jan 2022 15:06:13 -0800 (PST) Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id a13si272622ejp.770.2022.01.16.15.06.12; Sun, 16 Jan 2022 15:06:13 -0800 (PST) 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=@outlook.com header.s=selector1 header.b=d5Ws77BY; arc=fail (body hash mismatch); 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=outlook.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 26EE268AF40; Mon, 17 Jan 2022 01:05:12 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from EUR04-HE1-obe.outbound.protection.outlook.com (mail-oln040092073103.outbound.protection.outlook.com [40.92.73.103]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 84D2168AEE9 for ; Mon, 17 Jan 2022 01:05:07 +0200 (EET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dAe8qE5wHFAgp0ura93y+Je//e7FPe/rJwYeftbryUEJq91DbQv5We+HZbQKnKo/iiGx3azX9iCpW8zVghJ8KvJWdGb9pgtsniHuv73YAfL4ycDd3dAuFH5ic5eyVZfyJqo36sL8L5x6NKMCVvurRmEvDCbRkIR5j6VGTa4SB9s6AtlvLHJA8HcmesH55PtyHnmJJmdj67MMfylXgfG1R3XMbGO+a89pP4A3oCymUwmodP1ZSk8osFXjfDZmEdq2OWWUXCHrR/o6C10Kyz+x1C8qkjZhf04wVKfSGBYBRwMNIyaq4OdUKj+19So2UT1kmHgxSJA48+tpAnxkS1Fu7Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=wemSkgdYxanREbR6TCxSckMmdvC+sc3lUeQcY1RgD5I=; b=U3QUivzYrSaGy1NHEQIxxpoXI1jZZ7wxir939OsXwicoP0q/Wkau0lQszw8dqhmNCyI/e1M6PFZki2rdgsqZhrsrQFxQcEVCT1Tllp/pbcGbGERmOZrApkFrtgUkSpQwGDfiNvm3G1MJA5p55TMoihBZ7gq29qAegbUg8UMTAmec5COdLcORIofZFvC5mPR0RL/4jZv+8cAa8uGuAgbmcdVIGa0mtKE1WYbZ0Wp2srnKlh3ar7g4UfqaE63OtpcnASmj9RjhIwKC6i1hDlkEUq8k0Zpvd6xGcm61kHrkhRid8C9mcNgRkZPgkk5bWchQzRleu7JE1LMt8rheA3Mz+g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=wemSkgdYxanREbR6TCxSckMmdvC+sc3lUeQcY1RgD5I=; b=d5Ws77BYbBuhejkGOA4wUqpfbI5Wa7Xva5YuAD9UqK9d6GBKSw9dWuTQEUJVDVkKCxgHvRkuC7BJsOD5V94fJ5FP0ExpLO4WzQlEzQ1tm9WXUU4lCZINIeik1Ntpeyf2PVFOWnqP0dYYYGeuPcm2vAXqwv012P0sCqQAepulikoeSkKenuln3gCcJ+42UhPAxDJjPc+RefFlFRMkno7yhMP00oVfuY1BD2O3j7zwAMfL29L3rGRh7XJzeOphWHQuOH4daaP+CfBTz4X20W6fvuls7U+rXti2EzXk18NjBzfUbuNrkeK0zFUIyvF9uY6WxQyt7u1bS3+ShBlkGzD/0Q== Received: from AM7PR03MB6660.eurprd03.prod.outlook.com (2603:10a6:20b:1c1::22) by AS8PR03MB7704.eurprd03.prod.outlook.com (2603:10a6:20b:403::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.10; Sun, 16 Jan 2022 23:05:06 +0000 Received: from AM7PR03MB6660.eurprd03.prod.outlook.com ([fe80::19fc:be9f:2c9c:53f5]) by AM7PR03MB6660.eurprd03.prod.outlook.com ([fe80::19fc:be9f:2c9c:53f5%9]) with mapi id 15.20.4888.013; Sun, 16 Jan 2022 23:05:06 +0000 From: Andreas Rheinhardt To: ffmpeg-devel@ffmpeg.org Date: Mon, 17 Jan 2022 00:03:53 +0100 Message-ID: X-Mailer: git-send-email 2.32.0 In-Reply-To: References: X-TMN: [ogtI+oJOIfHe96l1V4TjgywKhKZI2V7c] X-ClientProxiedBy: AM0PR10CA0070.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:208:15::23) To AM7PR03MB6660.eurprd03.prod.outlook.com (2603:10a6:20b:1c1::22) X-Microsoft-Original-Message-ID: <20220116230405.194506-12-andreas.rheinhardt@outlook.com> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: c8e09747-a417-4a61-f90b-08d9d944a2b8 X-MS-Exchange-SLBlob-MailProps: q+fD6XS3/UJ6Z3qDqpu+gS/vjEZs5EpAEGLDbr+d922WWc1zFW69Oq0tKktE+eJsOSBavlhUCnvwP9WpTsfefS3EDOjqeVIjwpZbSvLKLpuIHNh2IxB4d0wIkBaPGmt9oX3om9tZqjxWDQVpvktuVH+6UDf3LvVyIFdIdZOxt/UDlqpaFC1nNivv+nmr8UXNsfvA4MpS0VD5TNAN6yeqKCtHqUe+wHwjPOj3YgwHof4qO27Psmnet7KY9Vz6kZpegBFMkwig+vRQ4KvavlPdoS9PNzxVA+XgKQwQZb8aFiqn+e7lPQ8HmR5jG90wqH9nVOsHUlvWDkmJaeYbmWrr7kgYVVAMaFmEny+mhJ1NE4h9Ogq3S0bYe0lQRtp+xBeRWnwf0CykLt4nIesSVc7tm5rVANWU4hImvP2R/NJZPRliaIH2YlheTTN7ojmbfnnNtxsvepC6uUipRC3Ny9d4RkKqZ6CzPp9xrMM9tELsCgTy+MSdQYhLRiQZI3h+4mQWoEy+6GxOf6a0gHKgAVUFoB/7ONfrN/G8sYbHr6oK3jpQgzr/U2KMS/RDoMxjSDIsw54I/cTLLNBh+WkDv+53Zvei2e/HEXXVpkpRs8Ysl4+VItIO9THHh3LFVuBKIZcuA8Sl03a2Q2KDT9DUO+sohjUafdCgAM6Zvh0XKBJVmr6PVIN7KYDuf5G+w8RL6DY+8dmuyJ/i7oDN4YHAcnorYw== X-MS-TrafficTypeDiagnostic: AS8PR03MB7704:EE_ X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 6sLec8Z7IiOGjN1p9p/lT6amdjXShXK9TKvHLsmjQcUSFhrar9E14fY7eBaO2vhE0MvlFgyS4wT3jdLi2iqbzEdXT/xbZ4qWLoXnhxouCOdF+hrEOa0GepsXmCanqrp5j2RkhRAipSL5yNItWjdTVE8gwAM2gFOg1OSPYFxB9pwn3dSb6Va22dlbzeVFeFj7XDuz7HqSS5nuHIume/xdaxwnt8CzJoHw8buDUw/kwT6VJnehJgnQLrpJXifDH+wPVxMnHMcp6Xo20CaNE1INvmjMO/USNQ9loMw5WO3s+LXqFda87EBIUjRiFDbiI9XvnFmWXjlUTbflolpjh1xBXFn0V1S+ZByN1qWc+fuaD3av7ueaq+xwf9AMlhoc+AlFOwZ4tuyS4oWbe/3KqTHGCYt9MQqeekAdBuZhusatFdpmM/NkvprJfKeSjJHPHR+vGK0+QtRf9dGnp/OQ4KjXwwlVb2z0MuyET3MVfgfHi3/m0z27X1jjTXgbzFmTtV6vQu2NiitsRTVzc5JSuqceZyY13/FqOafnrEL1z9KzyDF0rMDFF5mFUzIkAtu8dcKc9P49NDwo+tXQIa5p0MUA2w== X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 4FuN7PpU7Blr2DYkQjOXuWm0aaRyH+Y5a3E2jr+71Mttwy1WZVCobhLt9SsuMVLY0arnOJm1KZfZeD9m2sZ2PDNdo2IAUcQa6ugWf2ruU2bt2mKV38nBSdv5/amPEVIxtUFNj743PoS+7FA5+rBuA83gYUZkGdmD6ru+O2Vx/ZVelDq7g/hSlqcFioKSjBeaEWqYESaGPs/Lg29y5p9Ff5N/J/qFQLH7pwnb8o5OeqCUX/r6yTeAWSzOryOTXe1yVlD9i9uWrhjLm7a+HjqBpdImyTJPPWjg0o/iYUYk5yXfQStUL+WglpNDbLgZO9Ni5iBATyVkStRLwGUxCs2MQOa91Aeze9oBQPR2Zohqvjx+HcrauqByJRZlwa3jETO0oKsQsHRVKTjdsYNwPjw4Ar1RA3yN6yDCySonC2Uu/eJdytyqbOVcSD0E0jHQ8qBHCHX/Fq9tYgjqVKEkpiYBFRrEBcEJu494xH2oftJiI+AI+dLTx3qzT/N4a/afevtUoLPeeauRfczSmAG4sEFgLFi7Rj+emcGvX6YRSSi4TlXjhXB5NyVNXRWEi0BiH+ZJCQp25V9D95r3WitHlEjZNX3hbzYceTwta3eJvrFMEgammH74+b4pIkKsTJt99S5zCLDAcw0UoYuDX0SOUB8N7/zs55lqYdNIcKjgYrKL7CC6sRyhw3osKw/U0hekBO+rNlh2/3U9PezfDzVao3mfNIQI03PtgDi9qSGWL6AqiCQTgQfZascdmi6F841dltTU6bqhZNRaygFOqPAEC6NpzTID1hu4tHdRShzSU7+6sYio4a7FSIRQlOPcNlMsdEsxmvyEymrYe3NrZTuh5T3KLmFJejjNSvFitzZ9H92GHqVQt1esD6Wj9C8+ZLVjub1Vo33EDs7GLdcNA9Nnrtjeq9xmA7R57iOWRzO/tPPrjVj25Qr9BLEqzSRZye2i9RWKondGbMicPsGvCUORjJoCcw== X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: c8e09747-a417-4a61-f90b-08d9d944a2b8 X-MS-Exchange-CrossTenant-AuthSource: AM7PR03MB6660.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Jan 2022 23:05:06.2701 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR03MB7704 Subject: [FFmpeg-devel] [PATCH 13/25] avformat/av1: Document actual behaviour of ff_av1_filter_obus() 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: Andreas Rheinhardt Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: x2tzqsnaKdJd Document that it can be used with a NULL AVIOContext to get the output size in a first pass. Signed-off-by: Andreas Rheinhardt --- libavformat/av1.h | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/libavformat/av1.h b/libavformat/av1.h index dd5b47dc25..f57dabe986 100644 --- a/libavformat/av1.h +++ b/libavformat/av1.h @@ -46,12 +46,14 @@ typedef struct AV1SequenceParameters { * the resulting bitstream to the provided AVIOContext. * * @param pb pointer to the AVIOContext where the filtered bitstream shall be - * written + * written; may be NULL, in which case nothing is written. * @param buf input data buffer * @param size size of the input data buffer * - * @return the amount of bytes written in case of success, a negative AVERROR + * @return the amount of bytes written (or would have been written in case + * pb had been supplied) in case of success, a negative AVERROR * code in case of failure + * @note One can use NULL for pb to just get the output size. */ int ff_av1_filter_obus(AVIOContext *pb, const uint8_t *buf, int size);