har0ke/FFmpeg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

misc. manpage updates, fixes LP: #501729, Debian: #570050

Browse Source 
Update ffmpeg documentation regarding metadata setting. -title,
-author, -copyright, -track, -album, and -year options have been
dropped in favor of -metadata.
Add an explanation and complete the metadata usage example.

backported revisions r19285, r19287 and r19320 by stefano.



Originally committed as revision 21858 to svn://svn.ffmpeg.org/ffmpeg/branches/0.5
This commit is contained in:
Reinhard Tartler 2010-02-16 23:04:10 +00:00
parent 26f74e832b
commit a0244ae347
1 changed files with 21 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
doc/ffmpeg-doc.texi
View File

@ -141,8 +141,9 @@ to get the desired audio language.
NOTE: To see the supported input formats, use @code{ffmpeg -formats}.
* You can extract images from a video:
* You can extract images from a video, or create a video from many images:
For extracting images from a video:
@example
ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
@end example
@ -151,15 +152,20 @@ This will extract one video frame per second from the video and will
output them in files named @file{foo-001.jpeg}, @file{foo-002.jpeg},
etc. Images will be rescaled to fit the new WxH values.
If you want to extract just a limited number of frames, you can use the
above command in combination with the -vframes or -t option, or in
combination with -ss to start extracting from a certain point in time.
For creating a video from many images:
@example
ffmpeg -f image2 -i foo-%03d.jpeg -r 12 -s WxH foo.avi
@end example
The syntax @code{foo-%03d.jpeg} specifies to use a decimal number
composed of three digits padded with zeroes to express the sequence
number. It is the same syntax supported by the C printf function, but
only formats accepting a normal integer are suitable.
If you want to extract just a limited number of frames, you can use the
above command in combination with the -vframes or -t option, or in
combination with -ss to start extracting from a certain point in time.
* You can put many streams of the same type in the output:
@example
@ -276,29 +282,16 @@ The offset is added to the timestamps of the input files.
Specifying a positive offset means that the corresponding
streams are delayed by 'offset' seconds.
@item -title @var{string}
Set the title.
@item -timestamp @var{time}
Set the timestamp.
@item -author @var{string}
Set the author.
@item -metadata @var{key}=@var{value}
Set a metadata key/value pair.
@item -copyright @var{string}
Set the copyright.
@item -comment @var{string}
Set the comment.
@item -album @var{string}
Set the album.
@item -track @var{number}
Set the track.
@item -year @var{number}
Set the year.
For example, for setting the title in the output file:
@example
ffmpeg -i in.avi -metadata title="my title" out.flv
@end example
@item -v @var{number}
Set the logging verbosity level.
@ -687,6 +680,8 @@ Set the number of audio frames to record.
Set the audio sampling frequency (default = 44100 Hz).
@item -ab @var{bitrate}
Set the audio bitrate in bit/s (default = 64k).
@item -aq @var{q}
Set the audio quality (codec-specific, VBR).
@item -ac @var{channels}
Set the number of audio channels (default = 1).
@item -an
@ -728,6 +723,8 @@ Force subtitle codec ('copy' to copy stream).
Add a new subtitle stream to the current output stream.
@item -slang @var{code}
Set the ISO 639 language code (3 letters) of the current subtitle stream.
@item -sn
Disable subtitle recording.
@item -sbsf @var{bitstream_filter}
Bitstream filters available are "mov2textsub", "text2movsub".
@example