aboutsummaryrefslogtreecommitdiffstats
path: root/ffextract-frame.1
blob: e048414a6d8ed408c0f875459f21eb99a529ab63 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
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)