From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <ffmpeg-devel-bounces@ffmpeg.org>
Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100])
by master.gitmailbox.com (Postfix) with ESMTPS id E12394D271
for <ffmpegdev@gitmailbox.com>; Fri, 21 Mar 2025 10:13:40 +0000 (UTC)
Received: from [127.0.1.1] (localhost [127.0.0.1])
by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 3E574687BE8;
Fri, 21 Mar 2025 12:13:36 +0200 (EET)
Received: from mail-wr1-f41.google.com (mail-wr1-f41.google.com
[209.85.221.41])
by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id B4843687AD2
for <ffmpeg-devel@ffmpeg.org>; Fri, 21 Mar 2025 12:13:29 +0200 (EET)
Received: by mail-wr1-f41.google.com with SMTP id
ffacd0b85a97d-3913fdd003bso941449f8f.1
for <ffmpeg-devel@ffmpeg.org>; Fri, 21 Mar 2025 03:13:29 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20230601; t=1742552009; x=1743156809; 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=pboYd6ttdnCTVptK2mx18t52USo0hiEqm8GWH86jn5k=;
b=a58JxDN2XWZxg/aCqZbMKEJLCOT/Z80hx7yvbkcP00CHU+VPVKwvM5KgYhLtGyQTa5
rwFK0zkdEFhNzcPoawTXI/0tBDbcHOulAIkqVybzq9Co1uphh7K2QPbrsyEjejb+P1EU
QeMA7aUSCdqG2+5t0j9/stvnlDVXPQTzJlNSFfAljFcSoZbJfZ2uWRzMGGUh3sFY3h8V
y/zqN2ENu2k0LVWVQZdutS8cqXMjxsi9PTODZ7+PzArwfemRypzgutUVT33E+z+K8yCB
1VwcSlL6nz/zDHyeOt7kW9MBFkHZLk/Y65WVH4G2oyLxvce3Z8ADRFsYd7py25RzEFxF
nSlQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1742552009; x=1743156809;
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=pboYd6ttdnCTVptK2mx18t52USo0hiEqm8GWH86jn5k=;
b=tCSc8C0+QP+T21ApdKiFgh7pbpCnZHPHAMYJ9RPbd1nem2Gi+YoPvxtQwZ/sw+Bano
uirXDIIR6qUYDYLjvZzySK1pN+3LnmhKjWC6EE6zsF4ehnBzR9wsTt28w+HlaPBM3mzs
IxHQw5ummEdyilb7jcFh6Ni14eZGPs/dM0LJ+uQa+N/PwNWtqhgsWAgcNq3H4Uh8JMfY
3LuQMUaZZiMM4n7vmagENWYkqV+ZX0iA06EJzMG1UeorzfQVgIV2WZQLcP7nDTfgO2zc
yLhkt8ogqMYOEZvmKgaxy24yVf6+5JzLPxrnPhiDBiZo9zW/t9jjtvekJWB3OrXefUK/
dgpg==
X-Gm-Message-State: AOJu0YxV9DByCWNS7p8Nb3lcsPkGISEHTFRTCqVerTxt26HCTn+7uAi5
bH+q3grm+LSIUjA++H9b4a2+EJr2FhyD22edBTGlZjJmdojgz3L+UVlEMns=
X-Gm-Gg: ASbGncvDnpIRGxyd0x5TFx60l/IqNL1DxNdrxxY5S/4dEMhkzszh77ZmGEIVHxE79KX
exx6pJG2ZPgzBCgPLLOH8ydQOntWo/pLXddxdDywV3fIe35mbpkmi7CqBKeGJcRdQbkspUOwLSB
p72xQ/L9fObIfqvpAKXiWsNvNWf4FX4h/cu0hZmjmanB55CmeMTONexMJeo/KEkI1SAcqHUheVI
lIM7/rtaXhtSy+TOTJ69lv4+J/R4qeg/SO9Lbz+YvXzqN1QlBi7jwd7upoWAeBihyQJtqNW5efD
TnL6SRlRejWK2/pP+Hce702UgUQIIeKc5zZKkk2LxAB/W78pUncpvhK5QthBh1mEiOws0QRdLiq
Oy8xAjEX6e2bu
X-Google-Smtp-Source: AGHT+IFMOu5uYhwGsH0BvvoEg3BFYF6/dNix0xIqE18TkCLFQjhck/8UDQocMBuo4PVvYZUL+6grbw==
X-Received: by 2002:a5d:6d88:0:b0:391:39fb:a4d3 with SMTP id
ffacd0b85a97d-3997f8f73a0mr2246164f8f.4.1742552008414;
Fri, 21 Mar 2025 03:13:28 -0700 (PDT)
Received: from MacBookAir.taild0428.ts.net
([2a02:c7c:f079:7200:dce9:8940:ff0c:d39a])
by smtp.gmail.com with ESMTPSA id
ffacd0b85a97d-3997f9b25c9sm1929723f8f.42.2025.03.21.03.13.27
(version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256);
Fri, 21 Mar 2025 03:13:28 -0700 (PDT)
From: Danil Iashchenko <danyaschenko@gmail.com>
To: ffmpeg-devel@ffmpeg.org
Date: Fri, 21 Mar 2025 10:13:25 +0000
Message-Id: <20250321101325.22720-1-danyaschenko@gmail.com>
X-Mailer: git-send-email 2.39.5 (Apple Git-154)
MIME-Version: 1.0
Subject: [FFmpeg-devel] [PATCH] doc/filters: Add thumbnail_cuda
documentation; Update thumbnail_cuda filter description.
X-BeenThere: ffmpeg-devel@ffmpeg.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: FFmpeg development discussions and patches <ffmpeg-devel.ffmpeg.org>
List-Unsubscribe: <https://ffmpeg.org/mailman/options/ffmpeg-devel>,
<mailto:ffmpeg-devel-request@ffmpeg.org?subject=unsubscribe>
List-Archive: <https://ffmpeg.org/pipermail/ffmpeg-devel>
List-Post: <mailto:ffmpeg-devel@ffmpeg.org>
List-Help: <mailto:ffmpeg-devel-request@ffmpeg.org?subject=help>
List-Subscribe: <https://ffmpeg.org/mailman/listinfo/ffmpeg-devel>,
<mailto:ffmpeg-devel-request@ffmpeg.org?subject=subscribe>
Reply-To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
Cc: Danil Iashchenko <danyaschenko@gmail.com>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: ffmpeg-devel-bounces@ffmpeg.org
Sender: "ffmpeg-devel" <ffmpeg-devel-bounces@ffmpeg.org>
Archived-At: <https://master.gitmailbox.com/ffmpegdev/20250321101325.22720-1-danyaschenko@gmail.com/>
List-Archive: <https://master.gitmailbox.com/ffmpegdev/>
List-Post: <mailto:ffmpegdev@gitmailbox.com>
Hi!
Added documentation for the thumbnail_cuda filter and updated its description to align with the format of other CUDA-based filters.
The new description clarifies its behaviour and avoids confusion with the {thumbnail} filter.
Thank you for review!
Regards,
Danil Iashchenko
---
doc/filters.texi | 28 ++++++++++++++++++++++++++++
libavfilter/vf_thumbnail_cuda.c | 2 +-
2 files changed, 29 insertions(+), 1 deletion(-)
diff --git a/doc/filters.texi b/doc/filters.texi
index 37b8674756..52f67fbd0c 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -26917,6 +26917,34 @@ scale_cuda=passthrough=0
@end example
@end itemize
+@subsection thumbnail_cuda
+
+Select the most representative frame in a given sequence of consecutive frames using CUDA.
+
+The filter accepts the following options:
+
+@table @option
+@item n
+Set the frames batch size to analyze; in a set of @var{n} frames, the filter
+will pick one of them, and then handle the next batch of @var{n} frames until
+the end. Default is @code{100}.
+@end table
+
+Since the filter keeps track of the whole frames sequence, a bigger @var{n}
+value will result in a higher memory usage, so a high value is not recommended.
+
+@subsubsection Example
+
+@itemize
+
+@item
+Thumbnails are extracted from every @var{n}=150-frame batch, selecting one per batch. Chosen frames are then scaled with @ref{scale_cuda}.
+@example
+./ffmpeg -hwaccel cuda -hwaccel_output_format cuda -i ./input.mp4 -vf "thumbnail_cuda=150,scale_cuda=1920:1080,hwdownload,format=nv12" ./output/out%03d.png
+@end example
+
+@end itemize
+
@subsection yadif_cuda
Deinterlace the input video using the @ref{yadif} algorithm, but implemented
diff --git a/libavfilter/vf_thumbnail_cuda.c b/libavfilter/vf_thumbnail_cuda.c
index ee09f7fa3e..121274de11 100644
--- a/libavfilter/vf_thumbnail_cuda.c
+++ b/libavfilter/vf_thumbnail_cuda.c
@@ -438,7 +438,7 @@ static const AVFilterPad thumbnail_cuda_outputs[] = {
const FFFilter ff_vf_thumbnail_cuda = {
.p.name = "thumbnail_cuda",
- .p.description = NULL_IF_CONFIG_SMALL("Select the most representative frame in a given sequence of consecutive frames."),
+ .p.description = NULL_IF_CONFIG_SMALL("Select the most representative frame in a given sequence of consecutive frames using CUDA."),
.p.priv_class = &thumbnail_cuda_class,
.priv_size = sizeof(ThumbnailCudaContext),
.init = init,
--
2.39.5 (Apple Git-154)
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".