aboutsummaryrefslogtreecommitdiffstats
path: root/ffextract-frame.1
diff options
context:
space:
mode:
Diffstat (limited to 'ffextract-frame.1')
-rw-r--r--ffextract-frame.161
1 files changed, 61 insertions, 0 deletions
diff --git a/ffextract-frame.1 b/ffextract-frame.1
new file mode 100644
index 0000000..e048414
--- /dev/null
+++ b/ffextract-frame.1
@@ -0,0 +1,61 @@
+.TH FFEXTRACT-FRAME 1 FFUTILS
+.SH NAME
+ffextract-frame \- create an image file from a video file
+
+.SH SYNOPSIS
+.B ffextract-frame
+[-t
+.IR time ]
+[-y]
+.I in-file
+.RI [ out-file ]
+
+.SH DESCRIPTION
+.B ffextract-frame
+extracts a frame from the video track from
+.I in-file
+and copies it into the new file
+.IR out-file .
+
+.SH OPTIONS
+.TP
+.BR \-t \ \fItime\fP
+The timestamp of the frame to used. The default is 10 seconds.
+.TP
+.BR \-y
+Overwrite output file if it already exists.
+
+.SH OPERANDS
+.TP
+.I in-file
+Video file to extract the frame from.
+.TP
+.I out-file
+The pathname for the new image file.
+
+If omitted,
+.I in-file
+is used with the suffix (if any) removed
+and replaced with \(dq.png\(dq.
+
+If
+.I in-file
+is a dash
+.RB ( - ),
+standard out is used, and the file format will be
+Portable Network Graphics (PNG) otherwise, the format
+is determined by the filename suffix.
+
+.SH EXIT VALUE
+.TP
+0
+Successful completely.
+.TP
+1
+An error occurred.
+
+.SH SEE ALSO
+.BR ffmpeg (1),
+.BR ffextract-audio (1),
+.BR ffget-audio-extension (1),
+.BR ffuse-frame (1)