From patchwork Wed Apr 10 13:47:42 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Sabatini X-Patchwork-Id: 47995 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:c90a:b0:1a7:a0dc:8de5 with SMTP id gx10csp565542pzb; Wed, 10 Apr 2024 06:47:55 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCXc14h6fj8cPDG68wSXJBYoFb/SRyHsB6csdHK62pp+YjPePYkcsidu+POPREvb/eooZjin+BsaT8sEzgR/Hz/Yr6g6sDGMoG/4/w== X-Google-Smtp-Source: AGHT+IGxVZmsTRU1RqBPfnpiNxxeMhdtEdJym1HeYQ9KifNYQXbAs76RSDjTbm8dVGs/1NQymGbE X-Received: by 2002:a50:d681:0:b0:56b:ec47:a846 with SMTP id r1-20020a50d681000000b0056bec47a846mr1422604edi.25.1712756875102; Wed, 10 Apr 2024 06:47:55 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1712756875; cv=none; d=google.com; s=arc-20160816; b=WDUk1mBvRuZgC70MpoiGnC6ySuI2cyf8CzlPJbE4Vk79mE/6RuKDReKtOktoPwKhaL +40ZfO/pkdG4qzQZgdeRuOQIoJlz0vlCxPc0mXKdPrasFDgd4GEPdYSJJVQuYgqmdQvd 9HbmP0beUpl4iOe37uaza9m0KcHds4csDly/EaiZwwDC7+lsoPI0iRW517gzF3NGsU8X pOy35MDK5zBc3iG9h3aIzgbEJRZ3uHinQOWU0bnqLi9mW9WF6dxzmBO8aVOgNBCEFwbD gsO/iAnqXr+QdzEpdNy5WDec4SlzwpzcB2ts/+vkqJDe1lnxsWbrxrSTLhhkJIuDEn5i OdLQ== 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:message-id:date:to:from :dkim-signature:delivered-to; bh=tDqhBoxT6Y1R+/gXMw7u9uiJlTpJU/UAv3TEYbt5560=; fh=QdWxt2OToL83TTnLQn0lGhLakV7i1QyAJdC8te7qN0E=; b=glksrSdJ4EClUfJ84VVpqA0W5y//ZV4nUK4IwlXH+JleEK+fTvGzLSxfrn0zzgU8W3 Fne267zh9/DJPsVtpVFHtfoZPcD0/zezV6Nz+MfV2sYPZzMuv6OwfkHvQ1wFEnD4Yrb1 mCDrPbw8uoduwEOxU78NKelCGFPHAA2qnxrkeCZCwmnoXi5uNl1VkXcLfyeXU5S3w5sH sO5xsPJnxcf0urabQCoWJsO2mak3EHET6muB5tctybxGqI4Tv7MHBtRBpvGoysu5rL/W fmAIZfyPdhdbHWHfMRVzEt2+Qqk/L+6OUztbsiCyzRzWGmF89xvigqpR4MJHcGgTIJv0 Ircw==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20230601 header.b=IHulNhja; 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 b16-20020a056402279000b0056e679d34d8si2843144ede.487.2024.04.10.06.47.54; Wed, 10 Apr 2024 06:47:55 -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=20230601 header.b=IHulNhja; 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 F267768CA66; Wed, 10 Apr 2024 16:47:51 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-ed1-f44.google.com (mail-ed1-f44.google.com [209.85.208.44]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id B746968C30E for ; Wed, 10 Apr 2024 16:47:44 +0300 (EEST) Received: by mail-ed1-f44.google.com with SMTP id 4fb4d7f45d1cf-56e37503115so4997320a12.1 for ; Wed, 10 Apr 2024 06:47:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1712756864; x=1713361664; darn=ffmpeg.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=vXbgJO0hgJXz8bDZdVq8kgIX5rC5/rZ3k2PUbfH2ato=; b=IHulNhjaU7+fhPhsaUNtCEWSq7binkvY561QfJxgutwCkJID7yaRArgtDHo8qVrQvk GTrhlfqR2tPKXXbAmrfHE4nRWziVRodT9DlCkxmQox9xhpCuafmHijkMtHVwuPRaucq9 aZQPfQOWsoFFdc3VVcxxMcOerlTHfGrDD7VxjbQXPd7UNLrB5Rmk6qbP9KoyDM3jS8TY cR9+p/ARGawzR7699R+Wgk2XUwwfuXZ+d0CUrzl9OaQIoXETiTF98su9WgwkjC7i7wez 4qJ+XZnnp2PZN0GFyDuMjxhiHTiNj+uPeABavTRsV9dTP/qCMaOSRg0ShX5ckpVclU/k h2Qg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712756864; x=1713361664; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=vXbgJO0hgJXz8bDZdVq8kgIX5rC5/rZ3k2PUbfH2ato=; b=XlR1DiJ5UFyNUkfve0fcBW9nKAOL3dALCVmDBrqJslNdUpAmS2pNyTHcGsQO5IMIRB 3eXB03Y9Z0vVS1kUQ/miCqXvxU2ZZxqPuyRM8Xwd7OlUKWChtPtKUl1EQGg1rPPQz+s9 qfw8SEyGJge6x/ItrAbDeckvQObEEsFpq8wXkInKq28m2VDauja9ILgsfJrkfiZEQxgY JKhC43yk+u+OQs+hYmwWqAdg58dGLoobEj5weh+8lFPd0mbEaJ6zPcfMTQVwbJbeZysA jdlKGJCGePaE9pPtUDz3YFcwCBaDmLJLBi8lcvs7eykG5n7hWBIWSAV6mkJMBsk+ln9D r9fQ== X-Gm-Message-State: AOJu0YwmfVXgLBcjmuxVbJXIeIa2FotZKHfasi1gb1ExHSEnhQR7GEaO QGs/u5KMX7SGvsCblgwkjwId0uuUgOf5cb6tQv/DDaWlVi0bYmzHWIfIRUN3 X-Received: by 2002:a50:cd59:0:b0:56d:f5ff:83ab with SMTP id d25-20020a50cd59000000b0056df5ff83abmr1797704edj.39.1712756863363; Wed, 10 Apr 2024 06:47:43 -0700 (PDT) Received: from mariano (host-82-58-28-189.retail.telecomitalia.it. [82.58.28.189]) by smtp.gmail.com with ESMTPSA id ds4-20020a0564021cc400b0056e78224d82sm1547399edb.81.2024.04.10.06.47.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 10 Apr 2024 06:47:43 -0700 (PDT) Received: by mariano (Postfix, from userid 1000) id 0E8C5BFCE8; Wed, 10 Apr 2024 15:47:42 +0200 (CEST) From: Stefano Sabatini To: FFmpeg development discussions and patches Date: Wed, 10 Apr 2024 15:47:42 +0200 Message-Id: <20240410134742.58446-1-stefasab@gmail.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 1/2] doc/utils/eval: clarify meaning of random* seed value 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: 6f3JWzl5WuKx Possible address trac issue: http://trac.ffmpeg.org/ticket/10763 --- doc/utils.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/utils.texi b/doc/utils.texi index 76e704fc3c..edf3ae24b0 100644 --- a/doc/utils.texi +++ b/doc/utils.texi @@ -944,11 +944,23 @@ Return a pseudo random value between 0.0 and 1.0. @var{idx} is the index of the internal variable which will be used to save the seed/state. +To initialize the seed, you need to store the seed value as a 64-bit +unsigned integer in the internal variable with index @var{idx}. + +For example, to store the value @code{42} in the internal +variable with index @code{1} and print a few random values: +@example +st(0,42); print(random(0)); print(random(0)); print(random(0)) +@end example + @item randomi(idx, min, max) Return a pseudo random value in the interval between @var{min} and @var{max}. @var{idx} is the index of the internal variable which will be used to save the seed/state. +To initialize the seed, you need to store the seed value as a 64-bit +unsigned integer in the internal variable with index @var{idx}. + @item root(expr, max) Find an input value for which the function represented by @var{expr} with argument @var{ld(0)} is 0 in the interval 0..@var{max}.