path: root/ffextract-frame.1

.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)