From patchwork Mon Feb 12 00:03:31 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andreas Rheinhardt X-Patchwork-Id: 46210 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:9002:b0:19e:cdac:8cce with SMTP id d2csp402882pzc; Sun, 11 Feb 2024 16:04:20 -0800 (PST) X-Google-Smtp-Source: AGHT+IH8UhiP6JLfpoPkbpFiVmF2JH69MbT1LXX4eufuCXuwWtZpUPA4yTaqutEMQQcLeaMTRbML X-Received: by 2002:a17:906:d8b8:b0:a37:e5fd:94ee with SMTP id qc24-20020a170906d8b800b00a37e5fd94eemr4024827ejb.72.1707696260620; Sun, 11 Feb 2024 16:04:20 -0800 (PST) X-Forwarded-Encrypted: i=2; AJvYcCUbdfv8Uf/P289UeYro8pNubNbC6WePlrDtIJG51XWQdFgCaLsikvnqB4WEeS8ItHR4rtTeC3RGdwE27IUH8HC9vdEeGQfuTRA68nlK+1vatCZtMLvRkpVbHyH4NBZCZApdgvmMj3NrzxXlLmh8+x8SgPfqpFOGr+YAwVggYV41/h3jNI7w8sEK7QKsO806UfUGoefvqOc9yxHdwqg+K8Usiv02fQbAhiIYZr/HsqMiqjcqzHpGEmZ8MkxMstht+K1rjqlSLviGLrmsS92YmF1S2pdyjKoGRAClgXxlhB0reRM+HD8WAuGbiB3dJVEPb6YEnNRsbTu5e8YWRWHRcOB3hVVygNVElenRgrKN1u1Txlu6jCE5NRFxyA/zbwxkl77U+TPA8oj1sked4k9ZpzlxbBfsDFE0IXR+HM0z5dy1yju+tgmj3+gbCpzndGeeqXH3TtVLLw6b5QWMQZ+uOjtujzdmh0gwntEw5/ZBCBsY2Hr8gPJ8l4nzwm7RROEShJgtyqN+3mMWgM6tWKO0hM23GNfqDt/tWdDJGNVoR6v493PheuZ1I9h4UQoTp56c9QrgY6wzidQ2D3krySmDj8jkrY2cpSzp4oSZOMPniv/uvGQpbFrNE6+4nc4Q0edLPGBSUoA+rbByppGQ0zMr9WCy9XJnsVk1OfLq6/e9g22TBBx0gwFcfJNc1zOMfeME7uYfp2xMb6EbF/uOcyjVVJRGAnkkBybtXFDpjwJIn2tQZka+w3ftBrhMY+MbiunZ7Mscu1OrfOvumZ52vomq2XOrrrWCqzz35XP2DHp91xzNcJClDTTL91iz1pkWsN+SouOddHTS6LoJZCXXMrkWgo+jWeZAp7P0riv0SNqv1q0l3SabDOegMtO5VqMQYbnfhG9qD3gSJSqX8VDOrxDhCvt+rIkyl2BcwVZAyNiTgeHDS+GRCqiMKaA5PFZbqGU/LhC1CK Dzpj9DsrAv8y1gtsSmlD1Bg2lE5j9dwIKUYjt8wjfwsbwmeuqXgBRNpZxSEv6w286o+X5SYg/t482PjwQO+f9rmkUGuKTm2s3FlqwkYJ09MJaLWQNdxeZr1lGHnwJ7DeASmOcv7JBiCcUKWSyWl1+tBRNDBF/RdhlJVZDmTtxxWojgzM32WgBluvGCtWQ5Gw3AvZpMl4WAiWe+ZpeJUmVZpq8a+6Yx7UrKh3Zi6HrPClpoccHO0hjRDcZh9O2hc5SYh2SRL5BlKaKD5kZLnQBjNtf68ag6hqYfrEedzY2PcNekvcZthBcLZlwC9WIPSpiU/ygwBUOxYAzEDuFcuOYUIfgozbIeSwjkfOvGRvYUzp/er7fNGfWxy0f7MVTR5J5Fc+Xf72kLGXqlr50zTPTsk34SzlGsV2dcIpmETko07w2CNRjc2G8kNrjwuUGM8adOzWoeudwTY/G8kOpKSjE7DH70N9oZ8h+AQw7Srma9wbNwop9o6P79LxbS0mq7dEPBhFYYEV0dpWrTu6B8ysZY8rOvxW0qQcoJIEPNMGbu7U04uErXQ/erxFvgaY0EQeVbEOMuCF/mAfk7WNe8aceJabC19FCuvhdJOfGm0J9milkNO0GqrYk2BG+tJ1HE/+6CSF/t Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id i23-20020a1709061cd700b00a387d9e1672si3271386ejh.1034.2024.02.11.16.04.20; Sun, 11 Feb 2024 16:04:20 -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=taxaVQmq; 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 4EB7768D17B; Mon, 12 Feb 2024 02:03:03 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from EUR03-AM7-obe.outbound.protection.outlook.com (mail-am7eur03olkn2073.outbound.protection.outlook.com [40.92.59.73]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 352BA68D13C for ; Mon, 12 Feb 2024 02:03:01 +0200 (EET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cu6Xc2UQyV0BE024LrN1y5lCzx5fjm1X/llEw8sbWk5PrYTbDazFO8wTuhQAqeSqbo6KW34QqOHBwyhl9iLG4xA2hFrZQ4iKGsCmI+PN71BlUrQi5egsY9iD0PyKvKxUw/PocYqKdcBxsEQo0c3RrVwE3hpEeyXNuUJ+QUUn/fmMaHfWNzSoc7DtHSUwkVjHqdkHatzx8hrcZU3rjIDK0ZnWt/Z1dkPxl6BwrH1tGnWh0KJlpu7ufQZid3hguKytdgU+OtyISank5EmB3ybfN4hLmWxLBG/KreULI3fsAho9NLVDnkoTNZKLDtsYX35Ty7NsuoLzJ6QFPPoe1vRMYg== 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=iToTBIjDpN4j6r67gPWxmw4VtxRS0qMTMp5mCkXhGGg=; b=MYj+AUIiEDlZRWUouzFPKXg2NKxXrepB6wmEhT+YlmD2tzJ5XYJBHNweOGq+sJEro6TvNVS2ZAKt9cWvAOY9OxoOph4Nh/S9PfkvXOCpLSJL+5pOvU97cXmoGwJOqz4Ljesaf20XaRblDNoBun75ObVdAa37DQDIiUq04BNk09G5sr3ct8i6Dzji8+6jrewW7TjME6XEaRRyiSKY+4pFg2hcWU7JtuPMu7ZApDnsDFUVCbf/dpUhPa+CmoFWdfguSbwfYabjYhGMrXsFcDCNHLX2Mxw61FJGo+xjgbg0FIiNTXB2VJbgxvoX+Ju9hOIFyE2INlX9UC81YSTYzYIwBA== 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=iToTBIjDpN4j6r67gPWxmw4VtxRS0qMTMp5mCkXhGGg=; b=taxaVQmqz9xlzV8HOtOFLAHduGCNHm7b645pv2bI+e3BWwIy/BItyDk0GCZfx7T2w3bdQfLp81LzEmCgQvobKxnH1W33+Hlds6ex0JdbmSMPSq5S9Mkw3/sg+R21O+rXws+KvVjn7gDe7wmMWf9WIiTi+5j74ck1+pg4dp45Saw/azZ/Z2JnM9E051yiPmzgCklHZfYTRkwFZqaCf6u5siSRww0SSbwt2CQA6W8Pr9FQLS6Tp7+MulUopCjccF7bU3/xVOpqyysYG38/wLAB/hyKbPf0o9tBgnNqQJ2wSJ9anrzghycLMsc9sYrTh/Y9xZzsVeDwWMUSU6eeosauPA== Received: from DU0P250MB0747.EURP250.PROD.OUTLOOK.COM (2603:10a6:10:3cb::16) by PR3P250MB0257.EURP250.PROD.OUTLOOK.COM (2603:10a6:102:17c::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7270.35; Mon, 12 Feb 2024 00:03:00 +0000 Received: from DU0P250MB0747.EURP250.PROD.OUTLOOK.COM ([fe80::db07:87f6:7c75:38cc]) by DU0P250MB0747.EURP250.PROD.OUTLOOK.COM ([fe80::db07:87f6:7c75:38cc%3]) with mapi id 15.20.7270.036; Mon, 12 Feb 2024 00:03:00 +0000 From: Andreas Rheinhardt To: ffmpeg-devel@ffmpeg.org Date: Mon, 12 Feb 2024 01:03:31 +0100 Message-ID: X-Mailer: git-send-email 2.34.1 In-Reply-To: References: X-TMN: [WurHxVrz2VRT0qaI8tQaKnNrjZXz60Z+] X-ClientProxiedBy: FR3P281CA0146.DEUP281.PROD.OUTLOOK.COM (2603:10a6:d10:95::18) To DU0P250MB0747.EURP250.PROD.OUTLOOK.COM (2603:10a6:10:3cb::16) X-Microsoft-Original-Message-ID: <20240212000335.27984-18-andreas.rheinhardt@outlook.com> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DU0P250MB0747:EE_|PR3P250MB0257:EE_ X-MS-Office365-Filtering-Correlation-Id: f50cc4e4-6e3d-48b2-37fa-08dc2b5df9ba X-MS-Exchange-SLBlob-MailProps: Cq7lScuPrnqwZHg0HfSFdl5Zlrnc8YAZk/oamKGTKMyYHJ1AalAZlI72EHq9XkyAA+iTRsd+7iBDp9uAcQFc3WR9Ou4noAnEQhQNs2fiTwxYXhdA5o9vJakrx7XTxj2bD++SCw8L7ybRyejUUk4MU3BPkaZC2DR0Y5pHHxNoblg4U3IxMzmvofjuQtm0ECVFQoWVmVFC2ut7VPTRF2JOiiRHGFhjKAAnyqeYtmL1PEiIRAX0BpT5kwa0rUv6NcKqgaHWFzeqU0dQP4H9ccrN841rehRiKreVkmXAlirstGIqDldBFa+UCT1PK2t7WlhFS9SY+vo4NBnWvCqk6wKmvLFWFBffUqB5b9RSdWTs5kChZ6TH7hI6Mhbpp2UWTt7SiU00jAxAoVKpKLE82N8xMwLBRFq+3hAUGUnhJaMntHx5+x/YF+KR/gWgP373njvO9L4AdlErG6lielwyTgyhRW582vawaeXq8abxaM2NQh9gINGrsCwz3trq9bOxHuRYlUpPQ7X1HTWUW7TSx+y5vCYSE3LbNjswwbxR8ttGi2p/2tSqeFCTNiFTFdbFsTgsUiUjjOUTEQagUOjtQbi3hyJlFCrqD4qwUAiE3Vj9GstvZHl3bmLeEyYsEoH5fkqiArdfbUDyxvCvk1c8gfiF8ompYRyHmulxIqjdxh8C4IpokzOdldNSpl0Kp4PMOlWrvkJIaTMD1JM+AaRd2E0eKMyIcMdROkDEGBhoKQP17K4IXqeL3yJfd9s0gil0eBRRif0u/MXJfhY= X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: eaqgT+AOpLJcugBTnupoNvXb4qzOkZYhk4mZ2T7zywAGCn+VDyWnyDQccispeqYNYf9itxUSij+N/bi0DgVEezylHNx8f1Dup3FeQ1t4lG5Mcv1wv4M9hwBbI3lRSTFUzSYfNGsyMS6Zjp4oZB5UaJyPRzXtxMPalXkVTxwuJ/Mu3N5jQDLfr2wdZ3TeUvPVcrMJBHYw0CkZ6x0EbPcTQ2VBQAfS/rgTvdTcAWuJmsi76jcR2qxp5RPBLvtI+XENArwLQlW4qd7xqGa1wmBG1+VovypdjAb2ICx8M8BwKButzZsKHlOvKyUlcU3wetQEquCLOnpTeT9cMmtx0Ku5R0X3dEodHEDKwjwPcA7qyxI5yjDv6bjA1Hmu1rHRC0Co9McTyWcTe91qRgiflzais4wkZ/w97rRGwaJ8MzmaBzQSYd0fDdadRZzo0qeQlY8wH5WVKvdVSBi0GBvB+ZzaMQTu42ACUNr8eZODMp/JmjLZKQQ3z6M43d0HGcQXvT6exOATkYcfs/Il59d1noZr0nw47kgp9Rx7vjY98dGcGyBQcBzrIF2ZTA4F4kgedA+6w3ib3CNrdhRjb8A2+Hp9aaOt//ix6aYd6/ujvMREBreKNLYbF5puohulhv/pRJkv X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: JyYNL2qivPXHaLBfe/lFroSdGi+UXM+YVmNylMDUvQ3Q5fPhbAsGH34HYbpF1Q2zQmrgJ1Avr36SLHKyisrgNkipEuYM+J8cJVc6r7KULlVUDXQDKPinA1biqIV+v/2E8WA/PDpL+g0LC0a9ZYHL3/ndeXHRVdxBuVOHE0G7eYzr2LKJnWNfj083oxLZzI1JD7QfoM/WDKRNtyOp18bYo8SDUqVQFho5wO/2hEB2SBEhZGrcnKoIkwJO7elFK9hEiHmK+Vz1sXqWKwMIjmp0WoZg5yJGVYzD3SJfZXYP9xC/Ef3rEfX7PYB5wxhTl8ALNoAwaKsLqZnjx5PHhY5VaxOPVkGz9z0lO826FVJEIeXYxsJT2fKzto/1fAB974OwkCitCOPMXUSCJu3oO4lVGbdFDTL8oql2mv1X7TfOeWQhLvpVmAA/TIXpKBEvXW0zwtpzsZH9Wqp8i3Ph9286v9YrFeoh/L/0GiBT3fjiliR42f4pKs8b21xSV0U+zpVwHbDJRVT2PjASl1pf3OymL6QXyDqEZTQPBQm3kzoWEBm3hJI9O4m6pP9fJjOEroUQwVzh5uqu4e4Pzv4/JXL8c+UDz/kdifOp6OfG9VBs41kPeUSphq3qvuZYiaOyQzAVjJOJ/+ytjNcUMZcxfaLRV5b78UUauHEO6kut65cN9o6B40TfAj4dY2W0ysNf4DZLJq1+QdJdu2IleCKnRDSUrkqDtrGkVRn9bEpQU+eG5efHGHBjasZVF84Fc+R4PdO0xv8FCY/kHOb3+OM8L8znIZPEwb/PA686AU9XtMuL2ViGkoEQIPpU7pg16ZsTauGEg7jOtwMA6stxf5FhG4h1S6pohkCQDlF0FGZ2jbMN1ddi1hbE6o+Xd9Jv1SctUcEGYBhP1+Bh2QICgbTh2JvuIrdCYie5SUI/MGUo9sxTY0sbIooh9XSDSKUP7ddcZTYCkd5kXGmLvO/HlEeG+SUf7fUd+kXs3npQTaaZb1xycvBITPrsP4D9mA26Sl+SqAjeY8OlWDpYN+TyA3SJFxqzm6sbcFy2d/qFTQtaN6/qtCbDzH/ZwpzSWETp9PoHRv3uHjKe/37v44AzwX7WKIbcFZzj4jH+tomGktwTLY+YQZP6bcdSHsxxWUEBw/m6KiaIE7lfRtziw7zJ3veqChyaoHdcb1XUKzw6FAtLGZUr0P5Y1IeVY+b+6gUmfwc4P2kR5C6Gxgk8/BskPUDCShKDjdROjBujusNtOReSHdL2B9xEF5zOaW6qrhG4du/8G/iabMYWBI6/eOQ5oLINxXiBHQ== X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: f50cc4e4-6e3d-48b2-37fa-08dc2b5df9ba X-MS-Exchange-CrossTenant-AuthSource: DU0P250MB0747.EURP250.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Feb 2024 00:03:00.3749 (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: PR3P250MB0257 Subject: [FFmpeg-devel] [PATCH 19/23] avutil/hwcontext: Clarify documentation of AVHWFramesContext.hwctx 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: VBCC+Uz0wrGv Correct the names of the format-specific headers (not hwframe_*.h) and clarify that the user shall ignore this field if there is no public context associated with it. In particular, this allows to use this field for the private context alone if there is no public context. This can't break conforming API users, because they always have to live with the possibility that a new public context has been introduced. Signed-off-by: Andreas Rheinhardt --- libavutil/hwcontext.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/libavutil/hwcontext.h b/libavutil/hwcontext.h index d91391294b..091bceb2f9 100644 --- a/libavutil/hwcontext.h +++ b/libavutil/hwcontext.h @@ -145,9 +145,12 @@ typedef struct AVHWFramesContext { * The format-specific data, allocated and freed automatically along with * this context. * - * Should be cast by the user to the format-specific context defined in the - * corresponding header (hwframe_*.h) and filled as described in the - * documentation before calling av_hwframe_ctx_init(). + * The user shall ignore this field if the corresponding format-specific + * header (hwcontext_*.h) does not define a context to be used as + * AVHWFramesContext.hwctx. + * + * Otherwise, it should be cast by the user to said context and filled + * as described in the documentation before calling av_hwframe_ctx_init(). * * After any frames using this context are created, the contents of this * struct should not be modified by the caller.