[FFmpeg-cvslog] avfilter/scale2ref: deprecate in favor of scale=rw:rh

[Niklas Haas]

ffmpeg | branch: master | Niklas Haas <git at haasn.dev> | Wed Apr 24 12:46:01 2024 +0200| [95568c4e316e8f5f3252596b1f01ce1de22216b6] | committer: Niklas Haas

avfilter/scale2ref: deprecate in favor of scale=rw:rh

And remove it from the documentation.

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=95568c4e316e8f5f3252596b1f01ce1de22216b6
---

 Changelog              |  1 +
 doc/filters.texi       | 73 --------------------------------------------------
 libavfilter/vf_scale.c |  3 +++
 3 files changed, 4 insertions(+), 73 deletions(-)

diff --git a/Changelog b/Changelog
index e821e5ac74..e827208439 100644
--- a/Changelog
+++ b/Changelog
@@ -8,6 +8,7 @@ version <next>:
 - LC3/LC3plus demuxer and muxer
 - pad_vaapi, drawbox_vaapi filters
 - vf_scale supports secondary ref input and framesync options
+- vf_scale2ref deprecated
 
 
 version 7.0:
diff --git a/doc/filters.texi b/doc/filters.texi
index cf884568b0..5198f14f28 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -21590,79 +21590,6 @@ Scale a logo to 1/10th the height of a video, while preserving its display aspec
 @end example
 @end itemize
 
- at section scale2ref
-
-Scale (resize) the input video, based on a reference video.
-
-See the scale filter for available options, scale2ref supports the same but
-uses the reference video instead of the main input as basis. scale2ref also
-supports the following additional constants for the @option{w} and
- at option{h} options:
-
- at table @var
- at item main_w
- at item main_h
-The main input video's width and height
-
- at item main_a
-The same as @var{main_w} / @var{main_h}
-
- at item main_sar
-The main input video's sample aspect ratio
-
- at item main_dar, mdar
-The main input video's display aspect ratio. Calculated from
- at code{(main_w / main_h) * main_sar}.
-
- at item main_hsub
- at item main_vsub
-The main input video's horizontal and vertical chroma subsample values.
-For example for the pixel format "yuv422p" @var{hsub} is 2 and @var{vsub}
-is 1.
-
- at item main_n
-The (sequential) number of the main input frame, starting from 0.
-Only available with @code{eval=frame}.
-
- at item main_t
-The presentation timestamp of the main input frame, expressed as a number of
-seconds. Only available with @code{eval=frame}.
-
- at item main_pos
-The position (byte offset) of the frame in the main input stream, or NaN if
-this information is unavailable and/or meaningless (for example in case of synthetic video).
-Only available with @code{eval=frame}.
- at end table
-
- at subsection Examples
-
- at itemize
- at item
-Scale a subtitle stream (b) to match the main video (a) in size before overlaying
- at example
-'scale2ref[b][a];[a][b]overlay'
- at end example
-
- at item
-Scale a logo to 1/10th the height of a video, while preserving its display aspect ratio.
- at example
-[logo-in][video-in]scale2ref=w=oh*mdar:h=ih/10[logo-out][video-out]
- at end example
- at end itemize
-
- at subsection Commands
-
-This filter supports the following commands:
- at table @option
- at item width, w
- at item height, h
-Set the output video dimension expression.
-The command accepts the same syntax of the corresponding option.
-
-If the specified expression is not valid, it is kept at its current
-value.
- at end table
-
 @section scale2ref_npp
 
 Use the NVIDIA Performance Primitives (libnpp) to scale (resize) the input
diff --git a/libavfilter/vf_scale.c b/libavfilter/vf_scale.c
index f174651333..bc53571c1c 100644
--- a/libavfilter/vf_scale.c
+++ b/libavfilter/vf_scale.c
@@ -368,6 +368,9 @@ static av_cold int init(AVFilterContext *ctx)
     int64_t threads;
     int ret;
 
+    if (ctx->filter == &ff_vf_scale2ref)
+        av_log(ctx, AV_LOG_WARNING, "scale2ref is deprecated, use scale=rw:rh instead\n");
+
     if (scale->size_str && (scale->w_expr || scale->h_expr)) {
         av_log(ctx, AV_LOG_ERROR,
                "Size and width/height expressions cannot be set at the same time.\n");