[FFmpeg-devel] [PR] avfilter/mestimate_d3d12: add documentation for the filter (PR #21602)

[Steven Xiao via ffmpeg-devel <ffmpeg-devel@ffmpeg.org>]

PR #21602 opened by Steven Xiao (younengxiao)
URL: https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/21602
Patch URL: https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/21602.patch

Add documentation for filter "mestimate_d3d12".

Also bump library version.

This is the follow-up for commit https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/21217/commits



>From 5459d41f7170dea320ad330a7b4eb552c2f16953 Mon Sep 17 00:00:00 2001
From: stevxiao <steven.xiao@amd.com>
Date: Wed, 28 Jan 2026 20:29:31 -0500
Subject: [PATCH] avfilter/mestimate_d3d12: add documentation for the filter

Add documentation for filter "mestimate_d3d12".

Also bump library version.

This is the follow-up for commit https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/21217/commits

Signed-off-by: younengxiao <steven.xiao@amd.com>
---
 doc/filters.texi      | 26 ++++++++++++++++++++++++++
 libavfilter/version.h |  2 +-
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index 0f64b4a3fa..9aecea7d88 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -18096,6 +18096,32 @@ Macroblock size. Default @code{16}.
 Search parameter. Default @code{7}.
 @end table
 
+@section mestimate_d3d12
+
+Estimate and export motion vectors using D3D12 hardware-accelerated motion estimation.
+This filter uses GPU hardware motion estimation capabilities available in
+DirectX 12 Video APIs to achieve significant performance improvements
+over the software-based @code{mestimate} filter.
+
+Motion vectors are stored in frame side data to be used by other filters.
+
+This filter requires the input to be in @code{d3d12} hardware pixel format.
+The filter uses quarter-pixel precision for motion vector estimation.
+
+This filter accepts the following options:
+@table @option
+@item mb_size
+Macroblock size. Only @code{8} and @code{16} are supported.
+Default @code{16}.
+@end table
+
+@subsection Examples
+
+Estimate motion vectors using D3D12 hardware acceleration with 8x8 blocks:
+@example
+ffmpeg -hwaccel d3d12va -hwaccel_output_format d3d12 -i input.mp4 -vf mestimate_d3d12=mb_size=8 -f null -
+@end example
+
 @section midequalizer
 
 Apply Midway Image Equalization effect using two video streams.
diff --git a/libavfilter/version.h b/libavfilter/version.h
index 44dacc29be..4239736a2d 100644
--- a/libavfilter/version.h
+++ b/libavfilter/version.h
@@ -31,7 +31,7 @@
 
 #include "version_major.h"
 
-#define LIBAVFILTER_VERSION_MINOR  11
+#define LIBAVFILTER_VERSION_MINOR  12
 #define LIBAVFILTER_VERSION_MICRO 101
 
 
-- 
2.52.0

_______________________________________________
ffmpeg-devel mailing list -- ffmpeg-devel@ffmpeg.org
To unsubscribe send an email to ffmpeg-devel-leave@ffmpeg.org