From patchwork Sun Jun 16 17:08:29 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Sayers X-Patchwork-Id: 49949 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a59:9196:0:b0:460:55fa:d5ed with SMTP id s22csp1498732vqg; Sun, 16 Jun 2024 10:10:21 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCWpadN5gfNQDEB/RUXyay8c4tjGzyls5XSSvnII/j5w2tAWf4J/adgsrmcligpMDYC1cnLzUD+opoUcoUgmVF4ndIisG7iplFw3gg== X-Google-Smtp-Source: AGHT+IE+YXEJaGkdFSbukllMxelZU0AWxnmYhaNY6EoMPtPeH5m6pVxqylIUDfGn5z+g89WC2Upu X-Received: by 2002:a17:906:c9d3:b0:a6f:52db:7e5e with SMTP id a640c23a62f3a-a6f60d27cabmr546584966b.19.1718557820817; Sun, 16 Jun 2024 10:10:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1718557820; cv=none; d=google.com; s=arc-20160816; b=uZNxLbPQptuSv+4kzFvoG+qE0XfqdWEKjV1SJQ3X449E9K8xFLLxrufr3a6bA5gpac /c69teQnpR1nvZI33U96qOWKpurXDXjF8g2HN6GdNjslNhhqUJbXJ/jrDNJlexyCgmkT 1dPHA9eHu9c68Cb7NWzVNBvAUtefnf2oZOI29nMqT7VfV7wTyuIbuwlrQf9QhG1n3+Mh jJld5HD2uJuriudH+G90fu38PXZ4kyG76Vlbpdd4uc7fl9QtLsjV3fQUPdngOViOXpSD 0DLdMZdeEpkYnQokKZPh6XxD1j572JnOpdhnX0s4WOBbZo/hfjFYiKivXlvVNshkNY7e JPuA== 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=MjaCOoEnAdO1j4l/uDE5+l2Iwyr4Zy6xWjybrHC27BU=; fh=73ExZnkQ8FYbu/qeQNmI0dtHCfShNh8/NmZJs1umltM=; b=SGeuJ6e+7F6FtgBNTX8Y5gcIN0vcKYzKz6MsCa6gNMEjSqhO92I+Y+KQJFmXUJRUvu rDfJdQzXgm+ZWJkOBgl38Umis/1hPRoZAtMLbOwmgCxduMd6UzZVcnxqKYvc9I4VhQ2x L3X9z2H8aldcWX5LfKyrOqPdQgTrADxNIRvMqChKQjnrnticw4wlFFim5EuPa5l3Pj0u bP8e2xj+aDRCiQHg2JlNLewJ3P1oDtGErIxjkNFYPHPnLbWmNB2ERgsERP3CblP3p7zp eO1f9WyS4VEYF+iaD2BwkQmYbUpgLz58oTROduFK4Kq957GNL8BKVxlCZU0fZwvug27O 5KqA==; 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 a640c23a62f3a-a6f56e8874esi384874166b.1047.2024.06.16.10.10.20; Sun, 16 Jun 2024 10:10:20 -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 D15DC68D737; Sun, 16 Jun 2024 20:10:10 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from alt2.a-painless.mh.aa.net.uk (alt2.a-painless.mh.aa.net.uk [81.187.30.51]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 93AE368D729 for ; Sun, 16 Jun 2024 20:10:02 +0300 (EEST) Received: from 0.b.4.b.7.4.0.8.c.4.a.5.d.8.b.2.0.5.8.0.9.1.8.0.0.b.8.0.1.0.0.2.ip6.arpa ([2001:8b0:819:850:2b8d:5a4c:8047:b4b0] helo=andrews-2024-laptop.lan) by painless-a.thn.aa.net.uk with esmtp (Exim 4.96) (envelope-from ) id 1sItOD-00CZV1-2a; Sun, 16 Jun 2024 18:10:02 +0100 From: Andrew Sayers To: ffmpeg-devel@ffmpeg.org Date: Sun, 16 Jun 2024 18:08:29 +0100 Message-ID: <20240616170934.426015-2-ffmpeg-devel@pileofstuff.org> X-Mailer: git-send-email 2.45.1 In-Reply-To: <20240616170934.426015-1-ffmpeg-devel@pileofstuff.org> References: <20240616170934.426015-1-ffmpeg-devel@pileofstuff.org> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v3 1/3] lavu/opt: Rename AV_OPT_FLAG_RUNTIME_PARAM to ...POST_INIT_SETTABLE_PARAM 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: Andrew Sayers Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: P7b39P9qr+L7 The old name could be misread as the opposite of "AV_OPT_FLAG_READONLY" - some things can be set at runtime, others are read-only. Clarify that this refers to options that can be set after the struct is initialized. --- libavutil/opt.h | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/libavutil/opt.h b/libavutil/opt.h index 07e27a9208..e050d126ed 100644 --- a/libavutil/opt.h +++ b/libavutil/opt.h @@ -53,6 +53,9 @@ * question is allowed to access the field. This allows us to extend the * semantics of those fields without breaking API compatibility. * + * Note: only options with the AV_OPT_FLAG_POST_INIT_SETTABLE_PARAM flag can be + * modified after the struct is initialized. + * * @section avoptions_scope Scope of AVOptions * * AVOptions is designed to support any set of multimedia configuration options @@ -300,7 +303,12 @@ enum AVOptionType{ #define AV_OPT_FLAG_BSF_PARAM (1 << 8) /** - * A generic parameter which can be set by the user at runtime. + * A generic parameter which can be set by the user after the struct is initialized. + */ +#define AV_OPT_FLAG_POST_INIT_SETTABLE_PARAM (1 << 15) +/** + * A generic parameter which can be set by the user after the struct is initialized. + * @deprecated Renamed to AV_OPT_FLAG_POST_INIT_SETTABLE_PARAM for clarity */ #define AV_OPT_FLAG_RUNTIME_PARAM (1 << 15) /**