doc/indevs: Add example using cropping to capture part of a plane
authorMark Thompson <sw@jkqxz.net>
Sat, 23 Mar 2019 16:18:49 +0000 (16:18 +0000)
committerMark Thompson <sw@jkqxz.net>
Sun, 2 Jun 2019 16:30:41 +0000 (17:30 +0100)
doc/indevs.texi

index 1d5ed65..89ba4fb 100644 (file)
@@ -910,6 +910,14 @@ Capture from CRTC ID 42 at 60fps, map the result to VAAPI, convert to NV12 and e
 ffmpeg -crtc_id 42 -framerate 60 -f kmsgrab -i - -vf 'hwmap=derive_device=vaapi,scale_vaapi=w=1920:h=1080:format=nv12' -c:v h264_vaapi output.mp4
 @end example
 
+@item
+To capture only part of a plane the output can be cropped - this can be used to capture
+a single window, as long as it has a known absolute position and size.  For example, to
+capture and encode the middle quarter of a 1920x1080 plane:
+@example
+ffmpeg -f kmsgrab -i - -vf 'hwmap=derive_device=vaapi,crop=960:540:480:270,scale_vaapi=960:540:nv12' -c:v h264_vaapi output.mp4
+@end example
+
 @end itemize
 
 @section lavfi