Statistics
| Branch: | Revision:

ffmpeg / doc / muxers.texi @ a735bbbb

History | View | Annotate | Download (3.91 KB)

1
@chapter Muxers
2
@c man begin MUXERS
3

    
4
Muxers are configured elements in FFmpeg which allow writing
5
multimedia streams to a particular type of file.
6

    
7
When you configure your FFmpeg build, all the supported muxers
8
are enabled by default. You can list all available muxers using the
9
configure option @code{--list-muxers}.
10

    
11
You can disable all the muxers with the configure option
12
@code{--disable-muxers} and selectively enable / disable single muxers
13
with the options @code{--enable-muxer=@var{MUXER}} /
14
@code{--disable-muxer=@var{MUXER}}.
15

    
16
The option @code{-formats} of the ff* tools will display the list of
17
enabled muxers.
18

    
19
A description of some of the currently available muxers follows.
20

    
21
@section image2
22

    
23
Image file muxer.
24

    
25
This muxer writes video frames to multiple image files specified by a
26
pattern.
27

    
28
The pattern may contain the string "%d" or "%0@var{N}d", which
29
specifies the position of the characters representing a numbering in
30
the filenames. If the form "%d0@var{N}d" is used, the string
31
representing the number in each filename is 0-padded to @var{N}
32
digits. The literal character '%' can be specified in the pattern with
33
the string "%%".
34

    
35
If the pattern contains "%d" or "%0@var{N}d", the first filename of
36
the file list specified will contain the number 1, all the following
37
numbers will be sequential.
38

    
39
The pattern may contain a suffix which is used to automatically
40
determine the format of the image files to write.
41

    
42
For example the pattern "img-%03d.bmp" will specify a sequence of
43
filenames of the form @file{img-001.bmp}, @file{img-002.bmp}, ...,
44
@file{img-010.bmp}, etc.
45
The pattern "img%%-%d.jpg" will specify a sequence of filenames of the
46
form @file{img%-1.jpg}, @file{img%-2.jpg}, ..., @file{img%-10.jpg},
47
etc.
48

    
49
The following example shows how to use @file{ffmpeg} for creating a
50
sequence of files @file{img-001.jpeg}, @file{img-002.jpeg}, ...,
51
taking one image every second from the input video:
52
@example
53
ffmpeg -i in.avi -r 1 -f image2 'img-%03d.jpeg'
54
@end example
55

    
56
Note that with @file{ffmpeg}, if the format is not specified with the
57
@code{-f} option and the output filename specifies an image file
58
format, the image2 muxer is automatically selected, so the previous
59
command can be written as:
60
@example
61
ffmpeg -i in.avi -r 1 'img-%03d.jpeg'
62
@end example
63

    
64
Note also that the pattern must not necessarily contain "%d" or
65
"%0@var{N}d", for example to create a single image file
66
@file{img.jpeg} from the input video you can employ the command:
67
@example
68
ffmpeg -i in.avi -f image2 -vframes 1 img.jpeg
69
@end example
70

    
71
@section mpegts
72

    
73
MPEG transport stream muxer.
74

    
75
This muxer implements ISO 13818-1 and part of ETSI EN 300 468.
76

    
77
The muxer options are:
78

    
79
@table @option
80
@item -mpegts_original_network_id @var{number}
81
Set the original_network_id (default 0x0001). This is unique identifier
82
of a network in DVB. Its main use is in the unique identification of a
83
service through the path Original_Network_ID, Transport_Stream_ID.
84
@item -mpegts_transport_stream_id @var{number}
85
Set the transport_stream_id (default 0x0001). This identifies a
86
transponder in DVB.
87
@item -mpegts_service_id @var{number}
88
Set the service_id (default 0x0001) also known as program in DVB.
89
@item -mpegts_pmt_start_pid @var{number}
90
Set the first PID for PMT (default 0x1000, max 0x1f00).
91
@item -mpegts_start_pid @var{number}
92
Set the first PID for data packets (default 0x0100, max 0x0f00).
93
@end table
94

    
95
The recognized metadata settings in mpegts muxer are @code{service_provider}
96
and @code{service_name}. If they are not set the default for
97
@code{service_provider} is "FFmpeg" and the default for
98
@code{service_name} is "Service01".
99

    
100
@example
101
ffmpeg -i file.mpg -acodec copy -vcodec copy \
102
     -mpegts_original_network_id 0x1122 \
103
     -mpegts_transport_stream_id 0x3344 \
104
     -mpegts_service_id 0x5566 \
105
     -mpegts_pmt_start_pid 0x1500 \
106
     -mpegts_start_pid 0x150 \
107
     -metadata service_provider="Some provider" \
108
     -metadata service_name="Some Channel" \
109
     -y out.ts
110
@end example
111

    
112
@c man end MUXERS