summaryrefslogtreecommitdiff
path: root/doc/indevs.texi
diff options
context:
space:
mode:
authorOmar Emara <mail@OmarEmara.dev>2020-07-11 11:29:09 +0200
committerAndriy Gelman <andriy.gelman@gmail.com>2020-11-06 23:25:13 -0500
commit04b37b5d7fcd5ffd141054177611d5168629e4ac (patch)
treea426e7e66baecc55ec8086686c92f471a0b1e31a /doc/indevs.texi
parentc8101aabee654f6d147a4d89f77fa73e18908610 (diff)
avdevice/xcbgrab: Add select_region option
This patch adds a select_region option to the xcbgrab input device. If set to 1, the user will be prompted to select the grabbing area graphically by clicking and dragging. A rectangle will be drawn to mark the grabbing area. A single click with no dragging will select the whole screen. The option overwrites the video_size, grab_x, and grab_y options if set by the user. For testing, just set the select_region option as follows: ffmpeg -f x11grab -select_region 1 -i :0.0 output.mp4 The drawing happens directly on the root window using standard rubber banding techniques, so it is very efficient and doesn't depend on any X extensions or compositors. Reviewed-by: Andriy Gelman <andriy.gelman@gmail.com> Signed-off-by: Omar Emara <mail@OmarEmara.dev>
Diffstat (limited to 'doc/indevs.texi')
-rw-r--r--doc/indevs.texi8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/indevs.texi b/doc/indevs.texi
index 3d554bc8d8..62b6ebb3e3 100644
--- a/doc/indevs.texi
+++ b/doc/indevs.texi
@@ -1503,6 +1503,14 @@ ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0+10,20 out.mpg
@subsection Options
@table @option
+@item select_region
+Specify whether to select the grabbing area graphically using the pointer.
+A value of @code{1} prompts the user to select the grabbing area graphically
+by clicking and dragging. A single click with no dragging will select the
+whole screen. A region with zero width or height will also select the whole
+screen. This option overwrites the @var{video_size}, @var{grab_x}, and
+@var{grab_y} options. Default value is @code{0}.
+
@item draw_mouse
Specify whether to draw the mouse pointer. A value of @code{0} specifies
not to draw the pointer. Default value is @code{1}.