generic-library/ffmpeg
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Apply misc fixes spotted by Diego to protocols.texi.

Browse Source 
Originally committed as revision 24726 to svn://svn.ffmpeg.org/ffmpeg/trunk
This commit is contained in:
Stefano Sabatini 2010-08-06 23:15:35 +00:00
parent 63f805fc86
commit 209e451a32
1 changed files with 31 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
doc/protocols.texi
View File

@ -4,9 +4,9 @@
Protocols are configured elements in FFmpeg which allow to access
resources which require the use of a particular protocol.
When you configure your FFmpeg build, all the supported protocols
are enabled by default. You can list them using the configure option
"--list-protocols".
When you configure your FFmpeg build, all the supported protocols are
enabled by default. You can list all available ones using the
configure option "--list-protocols".
You can disable all the protocols using the configure option
"--disable-protocols", and selectively enable a protocol using the
@ -15,7 +15,7 @@ particular protocol using the option
"--disable-protocol=@var{PROTOCOL}".
The option "-protocols" of the ff* tools will display the list of
the supported protocols.
supported protocols.
A description of the currently available protocols follows.
@ -23,10 +23,10 @@ A description of the currently available protocols follows.
Physical concatenation protocol.
Allow to read and seek from many resource in sequence as they were an
unique resource.
Allow to read and seek from many resource in sequence as if they were
a unique resource.
An url accepted by this protocol has the syntax:
An URL accepted by this protocol has the syntax:
@example
concat:@var{URL1}|@var{URL2}|...|@var{URLN}
@end example
@ -57,9 +57,9 @@ use the command:
ffmpeg -i file:input.mpeg output.mpeg
@end example
Note that if not specified otherwise, the ff* tools will use the file
protocol by default, that is a resource specified with the name
"FILE.mpeg" is interpreted as it were the url "file:FILE.mpeg".
The ff* tools default to the file protocol, that is a resource
specified with the name "FILE.mpeg" is interpreted as the URL
"file:FILE.mpeg".
@section gopher
@ -67,7 +67,7 @@ Gopher protocol.
@section http
HTTP (Hyper Text Trasfer Protocol).
HTTP (Hyper Text Transfer Protocol).
@section mmst
@ -77,20 +77,20 @@ MMS (Microsoft Media Server) protocol over TCP.
MD5 output protocol.
Computes the MD5 hash of data written, and on close writes this to the
designated output or stdout if none is specified. It can be used to
test muxers without writing an actual file.
Computes the MD5 hash of the data to be written, and on close writes
this to the designated output or stdout if none is specified. It can
be used to test muxers without writing an actual file.
Some examples follow.
@example
# write the MD5 hash of the encoded AVI file in the file output.avi.md5
# Write the MD5 hash of the encoded AVI file in the file output.avi.md5.
ffmpeg -i input.flv -f avi -y md5:output.avi.md5
# write the MD5 hash of the encoded AVI file to stdout
# Write the MD5 hash of the encoded AVI file to stdout.
ffmpeg -i input.flv -f avi -y md5:
@end example
Note that some formats (typically mov) require the output protocol to
Note that some formats (typically MOV) require the output protocol to
be seekable, so they will fail with the MD5 output protocol.
@section pipe
@ -105,26 +105,25 @@ pipe:[@var{number}]
@end example
@var{number} is the number corresponding to the file descriptor of the
pipe (e.g. 0 for stdin, 1 for stdout, 2 for stderr).
If @var{number} is not specified will use by default stdout if the
protocol is used for writing, stdin if the protocol is used for
reading.
pipe (e.g. 0 for stdin, 1 for stdout, 2 for stderr). If @var{number}
is not specified, by default the stdout file descriptor will be used
for writing, stdin for reading.
For example to read from stdin with @file{ffmpeg}:
@example
cat test.wav | ffmpeg -i pipe:0
# this is the same as
# ...this is the same as...
cat test.wav | ffmpeg -i pipe:
@end example
For writing to stdout with @file{ffmpeg}:
@example
ffmpeg -i test.wav -f avi pipe:1 | cat > test.avi
# this is the same as
# ...this is the same as...
ffmpeg -i test.wav -f avi pipe: | cat > test.avi
@end example
Note that some formats (typically mov), require the output protocol to
Note that some formats (typically MOV), require the output protocol to
be seekable, so they will fail with the pipe output protocol.
@section rtmp
@ -139,18 +138,18 @@ The required syntax is:
rtmp://@var{server}[:@var{port}][/@var{app}][/@var{playpath}]
@end example
Follows the description of the accepted parameters.
The accepted parameters are:
@table @option
@item server
It is the address of the RTMP server.
The address of the RTMP server.
@item port
It is the number of the TCP port to use (by default is 1935).
The number of the TCP port to use (by default is 1935).
@item app
It is the name of the application to acces. It usually corresponds to
the the path where the application is installed on the RTMP server
It is the name of the application to access. It usually corresponds to
the path where the application is installed on the RTMP server
(e.g. @file{/ondemand/}, @file{/flash/live/}, etc.).
@item playpath
@ -170,7 +169,7 @@ ffplay rtmp://myserver/vod/sample
Real-Time Messaging Protocol and its variants supported through
librtmp.
Require the presence of the headers and library of librtmp during
Requires the presence of the librtmp headers and library during
configuration. You need to explicitely configure the build with
"--enable-librtmp". If enabled this will replace the native RTMP
protocol.
@ -188,11 +187,11 @@ The required syntax is:
where @var{rtmp_proto} is one of the strings "rtmp", "rtmpt", "rtmpe",
"rtmps", "rtmpte", "rtmpts" corresponding to each RTMP variant, and
@var{server}, @var{port}, @var{app} and @var{playpath} have the same
meaning has specified for the RTMP native protocol.
meaning as specified for the RTMP native protocol.
@var{options} contains a list of space-separated options of the form
@var{key}=@var{val}.
See the manual page of librtmp (man 3 librtmp) for more information.
See the librtmp manual page (man 3 librtmp) for more information.
For example, to stream a file in real-time to an RTMP server using
@file{ffmpeg}: