Revision 9b8bb626 doc/filters.texi

View differences:

doc/filters.texi
1093 1093
"color=red@@0.2:qcif:10 [color]; [in][color] overlay [out]"
1094 1094
@end example
1095 1095

  
1096
@section movie
1097

  
1098
Read a video stream from a movie container.
1099

  
1100
It accepts the syntax: @var{movie_name}[:@var{options}] where
1101
@var{movie_name} is the name of the resource to read (not necessarily
1102
a file but also a device or a stream accessed through some protocol),
1103
and @var{options} is an optional sequence of @var{key}=@var{value}
1104
pairs, separated by ":".
1105

  
1106
The description of the accepted options follows.
1107

  
1108
@table @option
1109

  
1110
@item format_name, f
1111
Specifies the format assumed for the movie to read, and can be either
1112
the name of a container or an input device. If not specified the
1113
format is guessed from @var{movie_name} or by probing.
1114

  
1115
@item seek_point, sp
1116
Specifies the seek point in seconds, the frames will be output
1117
starting from this seek point, the parameter is evaluated with
1118
@code{av_strtod} so the numerical value may be suffixed by an IS
1119
postfix. Default value is "0".
1120

  
1121
@item stream_index, si
1122
Specifies the index of the video stream to read. If the value is -1,
1123
the best suited video stream will be automatically selected. Default
1124
value is "-1".
1125

  
1126
@end table
1127

  
1128
This filter allows to overlay a second video on top of main input of
1129
a filtergraph as shown in this graph:
1130
@example
1131
input -----------> deltapts0 --> overlay --> output
1132
                                    ^
1133
                                    |
1134
movie --> scale--> deltapts1 -------+
1135
@end example
1136

  
1137
Some examples follow:
1138
@example
1139
# skip 3.2 seconds from the start of the avi file in.avi, and overlay it
1140
# on top of the input labelled as "in".
1141
movie=in.avi:seek_point=3.2, scale=180:-1, setpts=PTS-STARTPTS [movie];
1142
[in] setpts=PTS-STARTPTS, [movie] overlay=16:16 [out]
1143

  
1144
# read from a video4linux2 device, and overlay it on top of the input
1145
# labelled as "in"
1146
movie=/dev/video0:f=video4linux2, scale=180:-1, setpts=PTS-STARTPTS [movie];
1147
[in] setpts=PTS-STARTPTS, [movie] overlay=16:16 [out]
1148

  
1149
@end example
1150

  
1096 1151
@section nullsrc
1097 1152

  
1098 1153
Null video source, never return images. It is mainly useful as a

Also available in: Unified diff