[FFmpeg-cvslog] doc/filters: note expr and eval mode support in overlay_cuda

[Gyan Doshi]

ffmpeg | branch: master | Gyan Doshi <ffmpeg at gyani.pro> | Wed Jul 21 13:26:13 2021 +0530| [f614390eccbef569cdff7bcccebf88f2920389b8] | committer: Gyan Doshi

doc/filters: note expr and eval mode support in overlay_cuda

Commit 58c908cf94 added support for expressions for x and y parameters.
Also added was option to set eval frequency.

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

 doc/filters.texi | 47 ++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 46 insertions(+), 1 deletion(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index 232d81ae3e..1b1db2ebb8 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -15910,9 +15910,54 @@ It accepts the following parameters:
 @table @option
 @item x
 @item y
-Set the x and y coordinates of the overlaid video on the main video.
+Set expressions for the x and y coordinates of the overlaid video
+on the main video.
+
+They can contain the following parameters:
+
+ at table @option
+
+ at item main_w, W
+ at item main_h, H
+The main input width and height.
+
+ at item overlay_w, w
+ at item overlay_h, h
+The overlay input width and height.
+
+ at item x
+ at item y
+The computed values for @var{x} and @var{y}. They are evaluated for
+each new frame.
+
+ at item n
+The ordinal index of the main input frame, starting from 0.
+
+ at item pos
+The byte offset position in the file of the main input frame, NAN if unknown.
+
+ at item t
+The timestamp of the main input frame, expressed in seconds, NAN if unknown.
+
+ at end table
+
 Default value is "0" for both expressions.
 
+ at item eval
+Set when the expressions for @option{x} and @option{y} are evaluated.
+
+It accepts the following values:
+ at table @option
+ at item init
+Evaluate expressions once during filter initialization or
+when a command is processed.
+
+ at item frame
+Evaluate expressions for each incoming frame
+ at end table
+
+Default value is @option{frame}.
+
 @item eof_action
 See @ref{framesync}.