diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-bitstream-filters.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-bitstream-filters.1 deleted file mode 100644 index 63217671c3..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-bitstream-filters.1 +++ /dev/null @@ -1,275 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-BITSTREAM-FILTERS 1" -.TH FFMPEG-BITSTREAM-FILTERS 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-bitstream\-filters \- FFmpeg bitstream filters -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This document describes the bitstream filters provided by the -libavcodec library. -.PP -A bitstream filter operates on the encoded stream data, and performs -bitstream level modifications without performing decoding. -.SH "BITSTREAM FILTERS" -.IX Header "BITSTREAM FILTERS" -When you configure your FFmpeg build, all the supported bitstream -filters are enabled by default. You can list all available ones using -the configure option \f(CW\*(C`\-\-list\-bsfs\*(C'\fR. -.PP -You can disable all the bitstream filters using the configure option -\&\f(CW\*(C`\-\-disable\-bsfs\*(C'\fR, and selectively enable any bitstream filter using -the option \f(CW\*(C`\-\-enable\-bsf=BSF\*(C'\fR, or you can disable a particular -bitstream filter using the option \f(CW\*(C`\-\-disable\-bsf=BSF\*(C'\fR. -.PP -The option \f(CW\*(C`\-bsfs\*(C'\fR of the ff* tools will display the list of -all the supported bitstream filters included in your build. -.PP -Below is a description of the currently available bitstream filters. -.Sh "aac_adtstoasc" -.IX Subsection "aac_adtstoasc" -Convert \s-1MPEG\-2/4\s0 \s-1AAC\s0 \s-1ADTS\s0 to \s-1MPEG\-4\s0 Audio Specific Configuration -bitstream filter. -.PP -This filter creates an \s-1MPEG\-4\s0 AudioSpecificConfig from an \s-1MPEG\-2/4\s0 -\&\s-1ADTS\s0 header and removes the \s-1ADTS\s0 header. -.PP -This is required for example when copying an \s-1AAC\s0 stream from a raw -\&\s-1ADTS\s0 \s-1AAC\s0 container to a \s-1FLV\s0 or a \s-1MOV/MP4\s0 file. -.Sh "chomp" -.IX Subsection "chomp" -Remove zero padding at the end of a packet. -.Sh "dump_extra" -.IX Subsection "dump_extra" -Add extradata to the beginning of the filtered packets. -.PP -The additional argument specifies which packets should be filtered. -It accepts the values: -.IP "\fBa\fR" 4 -.IX Item "a" -add extradata to all key packets, but only if \fIlocal_header\fR is -set in the \fBflags2\fR codec context field -.IP "\fBk\fR" 4 -.IX Item "k" -add extradata to all key packets -.IP "\fBe\fR" 4 -.IX Item "e" -add extradata to all packets -.PP -If not specified it is assumed \fBk\fR. -.PP -For example the following \fBffmpeg\fR command forces a global -header (thus disabling individual packet headers) in the H.264 packets -generated by the \f(CW\*(C`libx264\*(C'\fR encoder, but corrects them by adding -the header stored in extradata to the key packets: -.PP -.Vb 1 -\& ffmpeg -i INPUT -map 0 -flags:v +global_header -c:v libx264 -bsf:v dump_extra out.ts -.Ve -.Sh "h264_mp4toannexb" -.IX Subsection "h264_mp4toannexb" -Convert an H.264 bitstream from length prefixed mode to start code -prefixed mode (as defined in the Annex B of the ITU-T H.264 -specification). -.PP -This is required by some streaming formats, typically the \s-1MPEG\-2\s0 -transport stream format (\*(L"mpegts\*(R"). -.PP -For example to remux an \s-1MP4\s0 file containing an H.264 stream to mpegts -format with \fBffmpeg\fR, you can use the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT.mp4 -codec copy -bsf:v h264_mp4toannexb OUTPUT.ts -.Ve -.Sh "imx_dump_header" -.IX Subsection "imx_dump_header" -.Sh "mjpeg2jpeg" -.IX Subsection "mjpeg2jpeg" -Convert \s-1MJPEG/AVI1\s0 packets to full \s-1JPEG/JFIF\s0 packets. -.PP -\&\s-1MJPEG\s0 is a video codec wherein each video frame is essentially a -\&\s-1JPEG\s0 image. The individual frames can be extracted without loss, -e.g. by -.PP -.Vb 1 -\& ffmpeg -i ../some_mjpeg.avi -c:v copy frames_%d.jpg -.Ve -.PP -Unfortunately, these chunks are incomplete \s-1JPEG\s0 images, because -they lack the \s-1DHT\s0 segment required for decoding. Quoting from -<\fBhttp://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml\fR>: -.PP -Avery Lee, writing in the rec.video.desktop newsgroup in 2001, -commented that \*(L"\s-1MJPEG\s0, or at least the \s-1MJPEG\s0 in AVIs having the -\&\s-1MJPG\s0 fourcc, is restricted \s-1JPEG\s0 with a fixed \*(-- and *omitted* \*(-- -Huffman table. The \s-1JPEG\s0 must be YCbCr colorspace, it must be 4:2:2, -and it must use basic Huffman encoding, not arithmetic or -progressive. . . . You can indeed extract the \s-1MJPEG\s0 frames and -decode them with a regular \s-1JPEG\s0 decoder, but you have to prepend -the \s-1DHT\s0 segment to them, or else the decoder won't have any idea -how to decompress the data. The exact table necessary is given in -the OpenDML spec.\*(R" -.PP -This bitstream filter patches the header of frames extracted from an \s-1MJPEG\s0 -stream (carrying the \s-1AVI1\s0 header \s-1ID\s0 and lacking a \s-1DHT\s0 segment) to -produce fully qualified \s-1JPEG\s0 images. -.PP -.Vb 3 -\& ffmpeg -i mjpeg-movie.avi -c:v copy -bsf:v mjpeg2jpeg frame_%d.jpg -\& exiftran -i -9 frame*.jpg -\& ffmpeg -i frame_%d.jpg -c:v copy rotated.avi -.Ve -.Sh "mjpega_dump_header" -.IX Subsection "mjpega_dump_header" -.Sh "movsub" -.IX Subsection "movsub" -.Sh "mp3_header_compress" -.IX Subsection "mp3_header_compress" -.Sh "mp3_header_decompress" -.IX Subsection "mp3_header_decompress" -.Sh "noise" -.IX Subsection "noise" -.Sh "remove_extra" -.IX Subsection "remove_extra" -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavcodec\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-codecs.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-codecs.1 deleted file mode 100644 index 18e93e9761..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-codecs.1 +++ /dev/null @@ -1,3632 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-CODECS 1" -.TH FFMPEG-CODECS 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-codecs \- FFmpeg codecs -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This document describes the codecs (decoders and encoders) provided by -the libavcodec library. -.SH "CODEC OPTIONS" -.IX Header "CODEC OPTIONS" -libavcodec provides some generic global options, which can be set on -all the encoders and decoders. In addition each codec may support -so-called private options, which are specific for a given codec. -.PP -Sometimes, a global option may only affect a specific kind of codec, -and may be unsensical or ignored by another, so you need to be aware -of the meaning of the specified options. Also some options are -meant only for decoding or encoding. -.PP -Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the -FFmpeg tools, or by setting the value explicitly in the -\&\f(CW\*(C`AVCodecContext\*(C'\fR options or using the \fIlibavutil/opt.h\fR \s-1API\s0 -for programmatic use. -.PP -The list of supported options follow: -.IP "\fBb\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "b integer (encoding,audio,video)" -Set bitrate in bits/s. Default value is 200K. -.IP "\fBab\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4 -.IX Item "ab integer (encoding,audio)" -Set audio bitrate (in bits/s). Default value is 128K. -.IP "\fBbt\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "bt integer (encoding,video)" -Set video bitrate tolerance (in bits/s). In 1\-pass mode, bitrate -tolerance specifies how far ratecontrol is willing to deviate from the -target average bitrate value. This is not related to min/max -bitrate. Lowering tolerance too much has an adverse effect on quality. -.IP "\fBflags\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video,subtitles\fR\fB)\fR" 4 -.IX Item "flags flags (decoding/encoding,audio,video,subtitles)" -Set generic flags. -.Sp -Possible values: -.RS 4 -.IP "\fBmv4\fR" 4 -.IX Item "mv4" -Use four motion vector by macroblock (mpeg4). -.IP "\fBqpel\fR" 4 -.IX Item "qpel" -Use 1/4 pel motion compensation. -.IP "\fBloop\fR" 4 -.IX Item "loop" -Use loop filter. -.IP "\fBqscale\fR" 4 -.IX Item "qscale" -Use fixed qscale. -.IP "\fBgmc\fR" 4 -.IX Item "gmc" -Use gmc. -.IP "\fBmv0\fR" 4 -.IX Item "mv0" -Always try a mb with mv=<0,0>. -.IP "\fBinput_preserved\fR" 4 -.IX Item "input_preserved" -.PD 0 -.IP "\fBpass1\fR" 4 -.IX Item "pass1" -.PD -Use internal 2pass ratecontrol in first pass mode. -.IP "\fBpass2\fR" 4 -.IX Item "pass2" -Use internal 2pass ratecontrol in second pass mode. -.IP "\fBgray\fR" 4 -.IX Item "gray" -Only decode/encode grayscale. -.IP "\fBemu_edge\fR" 4 -.IX Item "emu_edge" -Do not draw edges. -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -Set error[?] variables during encoding. -.IP "\fBtruncated\fR" 4 -.IX Item "truncated" -.PD 0 -.IP "\fBnaq\fR" 4 -.IX Item "naq" -.PD -Normalize adaptive quantization. -.IP "\fBildct\fR" 4 -.IX Item "ildct" -Use interlaced \s-1DCT\s0. -.IP "\fBlow_delay\fR" 4 -.IX Item "low_delay" -Force low delay. -.IP "\fBglobal_header\fR" 4 -.IX Item "global_header" -Place global headers in extradata instead of every keyframe. -.IP "\fBbitexact\fR" 4 -.IX Item "bitexact" -Use only bitexact stuff (except (I)DCT). -.IP "\fBaic\fR" 4 -.IX Item "aic" -Apply H263 advanced intra coding / mpeg4 ac prediction. -.IP "\fBcbp\fR" 4 -.IX Item "cbp" -Deprecated, use mpegvideo private options instead. -.IP "\fBqprd\fR" 4 -.IX Item "qprd" -Deprecated, use mpegvideo private options instead. -.IP "\fBilme\fR" 4 -.IX Item "ilme" -Apply interlaced motion estimation. -.IP "\fBcgop\fR" 4 -.IX Item "cgop" -Use closed gop. -.RE -.RS 4 -.RE -.IP "\fBme_method\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "me_method integer (encoding,video)" -Set motion estimation method. -.Sp -Possible values: -.RS 4 -.IP "\fBzero\fR" 4 -.IX Item "zero" -zero motion estimation (fastest) -.IP "\fBfull\fR" 4 -.IX Item "full" -full motion estimation (slowest) -.IP "\fBepzs\fR" 4 -.IX Item "epzs" -\&\s-1EPZS\s0 motion estimation (default) -.IP "\fBesa\fR" 4 -.IX Item "esa" -esa motion estimation (alias for full) -.IP "\fBtesa\fR" 4 -.IX Item "tesa" -tesa motion estimation -.IP "\fBdia\fR" 4 -.IX Item "dia" -dia motion estimation (alias for epzs) -.IP "\fBlog\fR" 4 -.IX Item "log" -log motion estimation -.IP "\fBphods\fR" 4 -.IX Item "phods" -phods motion estimation -.IP "\fBx1\fR" 4 -.IX Item "x1" -X1 motion estimation -.IP "\fBhex\fR" 4 -.IX Item "hex" -hex motion estimation -.IP "\fBumh\fR" 4 -.IX Item "umh" -umh motion estimation -.IP "\fBiter\fR" 4 -.IX Item "iter" -iter motion estimation -.RE -.RS 4 -.RE -.IP "\fBextradata_size\fR \fIinteger\fR" 4 -.IX Item "extradata_size integer" -Set extradata size. -.IP "\fBtime_base\fR \fIrational number\fR" 4 -.IX Item "time_base rational number" -Set codec time base. -.Sp -It is the fundamental unit of time (in seconds) in terms of which -frame timestamps are represented. For fixed-fps content, timebase -should be \f(CW\*(C`1 / frame_rate\*(C'\fR and timestamp increments should be -identically 1. -.IP "\fBg\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "g integer (encoding,video)" -Set the group of picture size. Default value is 12. -.IP "\fBar\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4 -.IX Item "ar integer (decoding/encoding,audio)" -Set audio sampling rate (in Hz). -.IP "\fBac\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4 -.IX Item "ac integer (decoding/encoding,audio)" -Set number of audio channels. -.IP "\fBcutoff\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4 -.IX Item "cutoff integer (encoding,audio)" -Set cutoff bandwidth. -.IP "\fBframe_size\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4 -.IX Item "frame_size integer (encoding,audio)" -Set audio frame size. -.Sp -Each submitted frame except the last must contain exactly frame_size -samples per channel. May be 0 when the codec has -\&\s-1CODEC_CAP_VARIABLE_FRAME_SIZE\s0 set, in that case the frame size is not -restricted. It is set by some decoders to indicate constant frame -size. -.IP "\fBframe_number\fR \fIinteger\fR" 4 -.IX Item "frame_number integer" -Set the frame number. -.IP "\fBdelay\fR \fIinteger\fR" 4 -.IX Item "delay integer" -.PD 0 -.IP "\fBqcomp\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qcomp float (encoding,video)" -.PD -Set video quantizer scale compression (\s-1VBR\s0). It is used as a constant -in the ratecontrol equation. Recommended range for default rc_eq: -0.0\-1.0. -.IP "\fBqblur\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qblur float (encoding,video)" -Set video quantizer scale blur (\s-1VBR\s0). -.IP "\fBqmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qmin integer (encoding,video)" -Set min video quantizer scale (\s-1VBR\s0). Must be included between \-1 and -69, default value is 2. -.IP "\fBqmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qmax integer (encoding,video)" -Set max video quantizer scale (\s-1VBR\s0). Must be included between \-1 and -1024, default value is 31. -.IP "\fBqdiff\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qdiff integer (encoding,video)" -Set max difference between the quantizer scale (\s-1VBR\s0). -.IP "\fBbf\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "bf integer (encoding,video)" -Set max number of B frames. -.IP "\fBb_qfactor\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "b_qfactor float (encoding,video)" -Set qp factor between P and B frames. -.IP "\fBrc_strategy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_strategy integer (encoding,video)" -Set ratecontrol method. -.IP "\fBb_strategy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "b_strategy integer (encoding,video)" -Set strategy to choose between I/P/B\-frames. -.IP "\fBps\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "ps integer (encoding,video)" -Set \s-1RTP\s0 payload size in bytes. -.IP "\fBmv_bits\fR \fIinteger\fR" 4 -.IX Item "mv_bits integer" -.PD 0 -.IP "\fBheader_bits\fR \fIinteger\fR" 4 -.IX Item "header_bits integer" -.IP "\fBi_tex_bits\fR \fIinteger\fR" 4 -.IX Item "i_tex_bits integer" -.IP "\fBp_tex_bits\fR \fIinteger\fR" 4 -.IX Item "p_tex_bits integer" -.IP "\fBi_count\fR \fIinteger\fR" 4 -.IX Item "i_count integer" -.IP "\fBp_count\fR \fIinteger\fR" 4 -.IX Item "p_count integer" -.IP "\fBskip_count\fR \fIinteger\fR" 4 -.IX Item "skip_count integer" -.IP "\fBmisc_bits\fR \fIinteger\fR" 4 -.IX Item "misc_bits integer" -.IP "\fBframe_bits\fR \fIinteger\fR" 4 -.IX Item "frame_bits integer" -.IP "\fBcodec_tag\fR \fIinteger\fR" 4 -.IX Item "codec_tag integer" -.IP "\fBbug\fR \fIflags\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "bug flags (decoding,video)" -.PD -Workaround not auto detected encoder bugs. -.Sp -Possible values: -.RS 4 -.IP "\fBautodetect\fR" 4 -.IX Item "autodetect" -.PD 0 -.IP "\fBold_msmpeg4\fR" 4 -.IX Item "old_msmpeg4" -.PD -some old lavc generated msmpeg4v3 files (no autodetection) -.IP "\fBxvid_ilace\fR" 4 -.IX Item "xvid_ilace" -Xvid interlacing bug (autodetected if fourcc==XVIX) -.IP "\fBump4\fR" 4 -.IX Item "ump4" -(autodetected if fourcc==UMP4) -.IP "\fBno_padding\fR" 4 -.IX Item "no_padding" -padding bug (autodetected) -.IP "\fBamv\fR" 4 -.IX Item "amv" -.PD 0 -.IP "\fBac_vlc\fR" 4 -.IX Item "ac_vlc" -.PD -illegal vlc bug (autodetected per fourcc) -.IP "\fBqpel_chroma\fR" 4 -.IX Item "qpel_chroma" -.PD 0 -.IP "\fBstd_qpel\fR" 4 -.IX Item "std_qpel" -.PD -old standard qpel (autodetected per fourcc/version) -.IP "\fBqpel_chroma2\fR" 4 -.IX Item "qpel_chroma2" -.PD 0 -.IP "\fBdirect_blocksize\fR" 4 -.IX Item "direct_blocksize" -.PD -direct-qpel-blocksize bug (autodetected per fourcc/version) -.IP "\fBedge\fR" 4 -.IX Item "edge" -edge padding bug (autodetected per fourcc/version) -.IP "\fBhpel_chroma\fR" 4 -.IX Item "hpel_chroma" -.PD 0 -.IP "\fBdc_clip\fR" 4 -.IX Item "dc_clip" -.IP "\fBms\fR" 4 -.IX Item "ms" -.PD -Workaround various bugs in microsoft broken decoders. -.IP "\fBtrunc\fR" 4 -.IX Item "trunc" -trancated frames -.RE -.RS 4 -.RE -.IP "\fBlelim\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "lelim integer (encoding,video)" -Set single coefficient elimination threshold for luminance (negative -values also consider \s-1DC\s0 coefficient). -.IP "\fBcelim\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "celim integer (encoding,video)" -Set single coefficient elimination threshold for chrominance (negative -values also consider dc coefficient) -.IP "\fBstrict\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4 -.IX Item "strict integer (decoding/encoding,audio,video)" -Specify how strictly to follow the standards. -.Sp -Possible values: -.RS 4 -.IP "\fBvery\fR" 4 -.IX Item "very" -strictly conform to a older more strict version of the spec or reference software -.IP "\fBstrict\fR" 4 -.IX Item "strict" -strictly conform to all the things in the spec no matter what consequences -.IP "\fBnormal\fR" 4 -.IX Item "normal" -.PD 0 -.IP "\fBunofficial\fR" 4 -.IX Item "unofficial" -.PD -allow unofficial extensions -.IP "\fBexperimental\fR" 4 -.IX Item "experimental" -allow non standardized experimental things, experimental -(unfinished/work in progress/not well tested) decoders and encoders. -Note: experimental decoders can pose a security risk, do not use this for -decoding untrusted input. -.RE -.RS 4 -.RE -.IP "\fBb_qoffset\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "b_qoffset float (encoding,video)" -Set \s-1QP\s0 offset between P and B frames. -.IP "\fBerr_detect\fR \fIflags\fR \fB(\fR\fIdecoding,audio,video\fR\fB)\fR" 4 -.IX Item "err_detect flags (decoding,audio,video)" -Set error detection flags. -.Sp -Possible values: -.RS 4 -.IP "\fBcrccheck\fR" 4 -.IX Item "crccheck" -verify embedded CRCs -.IP "\fBbitstream\fR" 4 -.IX Item "bitstream" -detect bitstream specification deviations -.IP "\fBbuffer\fR" 4 -.IX Item "buffer" -detect improper bitstream length -.IP "\fBexplode\fR" 4 -.IX Item "explode" -abort decoding on minor error detection -.IP "\fBcareful\fR" 4 -.IX Item "careful" -consider things that violate the spec and have not been seen in the wild as errors -.IP "\fBcompliant\fR" 4 -.IX Item "compliant" -consider all spec non compliancies as errors -.IP "\fBaggressive\fR" 4 -.IX Item "aggressive" -consider things that a sane encoder should not do as an error -.RE -.RS 4 -.RE -.IP "\fBhas_b_frames\fR \fIinteger\fR" 4 -.IX Item "has_b_frames integer" -.PD 0 -.IP "\fBblock_align\fR \fIinteger\fR" 4 -.IX Item "block_align integer" -.IP "\fBmpeg_quant\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mpeg_quant integer (encoding,video)" -.PD -Use \s-1MPEG\s0 quantizers instead of H.263. -.IP "\fBqsquish\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qsquish float (encoding,video)" -How to keep quantizer between qmin and qmax (0 = clip, 1 = use -differentiable function). -.IP "\fBrc_qmod_amp\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_qmod_amp float (encoding,video)" -Set experimental quantizer modulation. -.IP "\fBrc_qmod_freq\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_qmod_freq integer (encoding,video)" -Set experimental quantizer modulation. -.IP "\fBrc_override_count\fR \fIinteger\fR" 4 -.IX Item "rc_override_count integer" -.PD 0 -.IP "\fBrc_eq\fR \fIstring\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_eq string (encoding,video)" -.PD -Set rate control equation. When computing the expression, besides the -standard functions defined in the section 'Expression Evaluation', the -following functions are available: bits2qp(bits), qp2bits(qp). Also -the following constants are available: iTex pTex tex mv fCode iCount -mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex -avgTex. -.IP "\fBmaxrate\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "maxrate integer (encoding,audio,video)" -Set max bitrate tolerance (in bits/s). Requires bufsize to be set. -.IP "\fBminrate\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "minrate integer (encoding,audio,video)" -Set min bitrate tolerance (in bits/s). Most useful in setting up a \s-1CBR\s0 -encode. It is of little use elsewise. -.IP "\fBbufsize\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "bufsize integer (encoding,audio,video)" -Set ratecontrol buffer size (in bits). -.IP "\fBrc_buf_aggressivity\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_buf_aggressivity float (encoding,video)" -Currently useless. -.IP "\fBi_qfactor\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "i_qfactor float (encoding,video)" -Set \s-1QP\s0 factor between P and I frames. -.IP "\fBi_qoffset\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "i_qoffset float (encoding,video)" -Set \s-1QP\s0 offset between P and I frames. -.IP "\fBrc_init_cplx\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_init_cplx float (encoding,video)" -Set initial complexity for 1\-pass encoding. -.IP "\fBdct\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "dct integer (encoding,video)" -Set \s-1DCT\s0 algorithm. -.Sp -Possible values: -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -autoselect a good one (default) -.IP "\fBfastint\fR" 4 -.IX Item "fastint" -fast integer -.IP "\fBint\fR" 4 -.IX Item "int" -accurate integer -.IP "\fBmmx\fR" 4 -.IX Item "mmx" -.PD 0 -.IP "\fBaltivec\fR" 4 -.IX Item "altivec" -.IP "\fBfaan\fR" 4 -.IX Item "faan" -.PD -floating point \s-1AAN\s0 \s-1DCT\s0 -.RE -.RS 4 -.RE -.IP "\fBlumi_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "lumi_mask float (encoding,video)" -Compress bright areas stronger than medium ones. -.IP "\fBtcplx_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "tcplx_mask float (encoding,video)" -Set temporal complexity masking. -.IP "\fBscplx_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "scplx_mask float (encoding,video)" -Set spatial complexity masking. -.IP "\fBp_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "p_mask float (encoding,video)" -Set inter masking. -.IP "\fBdark_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "dark_mask float (encoding,video)" -Compress dark areas stronger than medium ones. -.IP "\fBidct\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "idct integer (decoding/encoding,video)" -Select \s-1IDCT\s0 implementation. -.Sp -Possible values: -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -.PD 0 -.IP "\fBint\fR" 4 -.IX Item "int" -.IP "\fBsimple\fR" 4 -.IX Item "simple" -.IP "\fBsimplemmx\fR" 4 -.IX Item "simplemmx" -.IP "\fBarm\fR" 4 -.IX Item "arm" -.IP "\fBaltivec\fR" 4 -.IX Item "altivec" -.IP "\fBsh4\fR" 4 -.IX Item "sh4" -.IP "\fBsimplearm\fR" 4 -.IX Item "simplearm" -.IP "\fBsimplearmv5te\fR" 4 -.IX Item "simplearmv5te" -.IP "\fBsimplearmv6\fR" 4 -.IX Item "simplearmv6" -.IP "\fBsimpleneon\fR" 4 -.IX Item "simpleneon" -.IP "\fBsimplealpha\fR" 4 -.IX Item "simplealpha" -.IP "\fBipp\fR" 4 -.IX Item "ipp" -.IP "\fBxvidmmx\fR" 4 -.IX Item "xvidmmx" -.IP "\fBfaani\fR" 4 -.IX Item "faani" -.PD -floating point \s-1AAN\s0 \s-1IDCT\s0 -.RE -.RS 4 -.RE -.IP "\fBslice_count\fR \fIinteger\fR" 4 -.IX Item "slice_count integer" -.PD 0 -.IP "\fBec\fR \fIflags\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "ec flags (decoding,video)" -.PD -Set error concealment strategy. -.Sp -Possible values: -.RS 4 -.IP "\fBguess_mvs\fR" 4 -.IX Item "guess_mvs" -iterative motion vector (\s-1MV\s0) search (slow) -.IP "\fBdeblock\fR" 4 -.IX Item "deblock" -use strong deblock filter for damaged MBs -.RE -.RS 4 -.RE -.IP "\fBbits_per_coded_sample\fR \fIinteger\fR" 4 -.IX Item "bits_per_coded_sample integer" -.PD 0 -.IP "\fBpred\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "pred integer (encoding,video)" -.PD -Set prediction method. -.Sp -Possible values: -.RS 4 -.IP "\fBleft\fR" 4 -.IX Item "left" -.PD 0 -.IP "\fBplane\fR" 4 -.IX Item "plane" -.IP "\fBmedian\fR" 4 -.IX Item "median" -.RE -.RS 4 -.RE -.IP "\fBaspect\fR \fIrational number\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "aspect rational number (encoding,video)" -.PD -Set sample aspect ratio. -.IP "\fBdebug\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video,subtitles\fR\fB)\fR" 4 -.IX Item "debug flags (decoding/encoding,audio,video,subtitles)" -Print specific debug info. -.Sp -Possible values: -.RS 4 -.IP "\fBpict\fR" 4 -.IX Item "pict" -picture info -.IP "\fBrc\fR" 4 -.IX Item "rc" -rate control -.IP "\fBbitstream\fR" 4 -.IX Item "bitstream" -.PD 0 -.IP "\fBmb_type\fR" 4 -.IX Item "mb_type" -.PD -macroblock (\s-1MB\s0) type -.IP "\fBqp\fR" 4 -.IX Item "qp" -per-block quantization parameter (\s-1QP\s0) -.IP "\fBmv\fR" 4 -.IX Item "mv" -motion vector -.IP "\fBdct_coeff\fR" 4 -.IX Item "dct_coeff" -.PD 0 -.IP "\fBskip\fR" 4 -.IX Item "skip" -.IP "\fBstartcode\fR" 4 -.IX Item "startcode" -.IP "\fBpts\fR" 4 -.IX Item "pts" -.IP "\fBer\fR" 4 -.IX Item "er" -.PD -error recognition -.IP "\fBmmco\fR" 4 -.IX Item "mmco" -memory management control operations (H.264) -.IP "\fBbugs\fR" 4 -.IX Item "bugs" -.PD 0 -.IP "\fBvis_qp\fR" 4 -.IX Item "vis_qp" -.PD -visualize quantization parameter (\s-1QP\s0), lower \s-1QP\s0 are tinted greener -.IP "\fBvis_mb_type\fR" 4 -.IX Item "vis_mb_type" -visualize block types -.IP "\fBbuffers\fR" 4 -.IX Item "buffers" -picture buffer allocations -.IP "\fBthread_ops\fR" 4 -.IX Item "thread_ops" -threading operations -.RE -.RS 4 -.RE -.IP "\fBvismv\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "vismv integer (decoding,video)" -Visualize motion vectors (MVs). -.Sp -Possible values: -.RS 4 -.IP "\fBpf\fR" 4 -.IX Item "pf" -forward predicted MVs of P\-frames -.IP "\fBbf\fR" 4 -.IX Item "bf" -forward predicted MVs of B\-frames -.IP "\fBbb\fR" 4 -.IX Item "bb" -backward predicted MVs of B\-frames -.RE -.RS 4 -.RE -.IP "\fBcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "cmp integer (encoding,video)" -Set full pel me compare function. -.Sp -Possible values: -.RS 4 -.IP "\fBsad\fR" 4 -.IX Item "sad" -sum of absolute differences, fast (default) -.IP "\fBsse\fR" 4 -.IX Item "sse" -sum of squared errors -.IP "\fBsatd\fR" 4 -.IX Item "satd" -sum of absolute Hadamard transformed differences -.IP "\fBdct\fR" 4 -.IX Item "dct" -sum of absolute \s-1DCT\s0 transformed differences -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -sum of squared quantization errors (avoid, low quality) -.IP "\fBbit\fR" 4 -.IX Item "bit" -number of bits needed for the block -.IP "\fBrd\fR" 4 -.IX Item "rd" -rate distortion optimal, slow -.IP "\fBzero\fR" 4 -.IX Item "zero" -0 -.IP "\fBvsad\fR" 4 -.IX Item "vsad" -sum of absolute vertical differences -.IP "\fBvsse\fR" 4 -.IX Item "vsse" -sum of squared vertical differences -.IP "\fBnsse\fR" 4 -.IX Item "nsse" -noise preserving sum of squared differences -.IP "\fBw53\fR" 4 -.IX Item "w53" -5/3 wavelet, only used in snow -.IP "\fBw97\fR" 4 -.IX Item "w97" -9/7 wavelet, only used in snow -.IP "\fBdctmax\fR" 4 -.IX Item "dctmax" -.PD 0 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -.RE -.RS 4 -.RE -.IP "\fBsubcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "subcmp integer (encoding,video)" -.PD -Set sub pel me compare function. -.Sp -Possible values: -.RS 4 -.IP "\fBsad\fR" 4 -.IX Item "sad" -sum of absolute differences, fast (default) -.IP "\fBsse\fR" 4 -.IX Item "sse" -sum of squared errors -.IP "\fBsatd\fR" 4 -.IX Item "satd" -sum of absolute Hadamard transformed differences -.IP "\fBdct\fR" 4 -.IX Item "dct" -sum of absolute \s-1DCT\s0 transformed differences -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -sum of squared quantization errors (avoid, low quality) -.IP "\fBbit\fR" 4 -.IX Item "bit" -number of bits needed for the block -.IP "\fBrd\fR" 4 -.IX Item "rd" -rate distortion optimal, slow -.IP "\fBzero\fR" 4 -.IX Item "zero" -0 -.IP "\fBvsad\fR" 4 -.IX Item "vsad" -sum of absolute vertical differences -.IP "\fBvsse\fR" 4 -.IX Item "vsse" -sum of squared vertical differences -.IP "\fBnsse\fR" 4 -.IX Item "nsse" -noise preserving sum of squared differences -.IP "\fBw53\fR" 4 -.IX Item "w53" -5/3 wavelet, only used in snow -.IP "\fBw97\fR" 4 -.IX Item "w97" -9/7 wavelet, only used in snow -.IP "\fBdctmax\fR" 4 -.IX Item "dctmax" -.PD 0 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -.RE -.RS 4 -.RE -.IP "\fBmbcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mbcmp integer (encoding,video)" -.PD -Set macroblock compare function. -.Sp -Possible values: -.RS 4 -.IP "\fBsad\fR" 4 -.IX Item "sad" -sum of absolute differences, fast (default) -.IP "\fBsse\fR" 4 -.IX Item "sse" -sum of squared errors -.IP "\fBsatd\fR" 4 -.IX Item "satd" -sum of absolute Hadamard transformed differences -.IP "\fBdct\fR" 4 -.IX Item "dct" -sum of absolute \s-1DCT\s0 transformed differences -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -sum of squared quantization errors (avoid, low quality) -.IP "\fBbit\fR" 4 -.IX Item "bit" -number of bits needed for the block -.IP "\fBrd\fR" 4 -.IX Item "rd" -rate distortion optimal, slow -.IP "\fBzero\fR" 4 -.IX Item "zero" -0 -.IP "\fBvsad\fR" 4 -.IX Item "vsad" -sum of absolute vertical differences -.IP "\fBvsse\fR" 4 -.IX Item "vsse" -sum of squared vertical differences -.IP "\fBnsse\fR" 4 -.IX Item "nsse" -noise preserving sum of squared differences -.IP "\fBw53\fR" 4 -.IX Item "w53" -5/3 wavelet, only used in snow -.IP "\fBw97\fR" 4 -.IX Item "w97" -9/7 wavelet, only used in snow -.IP "\fBdctmax\fR" 4 -.IX Item "dctmax" -.PD 0 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -.RE -.RS 4 -.RE -.IP "\fBildctcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "ildctcmp integer (encoding,video)" -.PD -Set interlaced dct compare function. -.Sp -Possible values: -.RS 4 -.IP "\fBsad\fR" 4 -.IX Item "sad" -sum of absolute differences, fast (default) -.IP "\fBsse\fR" 4 -.IX Item "sse" -sum of squared errors -.IP "\fBsatd\fR" 4 -.IX Item "satd" -sum of absolute Hadamard transformed differences -.IP "\fBdct\fR" 4 -.IX Item "dct" -sum of absolute \s-1DCT\s0 transformed differences -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -sum of squared quantization errors (avoid, low quality) -.IP "\fBbit\fR" 4 -.IX Item "bit" -number of bits needed for the block -.IP "\fBrd\fR" 4 -.IX Item "rd" -rate distortion optimal, slow -.IP "\fBzero\fR" 4 -.IX Item "zero" -0 -.IP "\fBvsad\fR" 4 -.IX Item "vsad" -sum of absolute vertical differences -.IP "\fBvsse\fR" 4 -.IX Item "vsse" -sum of squared vertical differences -.IP "\fBnsse\fR" 4 -.IX Item "nsse" -noise preserving sum of squared differences -.IP "\fBw53\fR" 4 -.IX Item "w53" -5/3 wavelet, only used in snow -.IP "\fBw97\fR" 4 -.IX Item "w97" -9/7 wavelet, only used in snow -.IP "\fBdctmax\fR" 4 -.IX Item "dctmax" -.PD 0 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -.RE -.RS 4 -.RE -.IP "\fBdia_size\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "dia_size integer (encoding,video)" -.PD -Set diamond type & size for motion estimation. -.IP "\fBlast_pred\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "last_pred integer (encoding,video)" -Set amount of motion predictors from the previous frame. -.IP "\fBpreme\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "preme integer (encoding,video)" -Set pre motion estimation. -.IP "\fBprecmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "precmp integer (encoding,video)" -Set pre motion estimation compare function. -.Sp -Possible values: -.RS 4 -.IP "\fBsad\fR" 4 -.IX Item "sad" -sum of absolute differences, fast (default) -.IP "\fBsse\fR" 4 -.IX Item "sse" -sum of squared errors -.IP "\fBsatd\fR" 4 -.IX Item "satd" -sum of absolute Hadamard transformed differences -.IP "\fBdct\fR" 4 -.IX Item "dct" -sum of absolute \s-1DCT\s0 transformed differences -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -sum of squared quantization errors (avoid, low quality) -.IP "\fBbit\fR" 4 -.IX Item "bit" -number of bits needed for the block -.IP "\fBrd\fR" 4 -.IX Item "rd" -rate distortion optimal, slow -.IP "\fBzero\fR" 4 -.IX Item "zero" -0 -.IP "\fBvsad\fR" 4 -.IX Item "vsad" -sum of absolute vertical differences -.IP "\fBvsse\fR" 4 -.IX Item "vsse" -sum of squared vertical differences -.IP "\fBnsse\fR" 4 -.IX Item "nsse" -noise preserving sum of squared differences -.IP "\fBw53\fR" 4 -.IX Item "w53" -5/3 wavelet, only used in snow -.IP "\fBw97\fR" 4 -.IX Item "w97" -9/7 wavelet, only used in snow -.IP "\fBdctmax\fR" 4 -.IX Item "dctmax" -.PD 0 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -.RE -.RS 4 -.RE -.IP "\fBpre_dia_size\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "pre_dia_size integer (encoding,video)" -.PD -Set diamond type & size for motion estimation pre\-pass. -.IP "\fBsubq\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "subq integer (encoding,video)" -Set sub pel motion estimation quality. -.IP "\fBdtg_active_format\fR \fIinteger\fR" 4 -.IX Item "dtg_active_format integer" -.PD 0 -.IP "\fBme_range\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "me_range integer (encoding,video)" -.PD -Set limit motion vectors range (1023 for DivX player). -.IP "\fBibias\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "ibias integer (encoding,video)" -Set intra quant bias. -.IP "\fBpbias\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "pbias integer (encoding,video)" -Set inter quant bias. -.IP "\fBcolor_table_id\fR \fIinteger\fR" 4 -.IX Item "color_table_id integer" -.PD 0 -.IP "\fBglobal_quality\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "global_quality integer (encoding,audio,video)" -.IP "\fBcoder\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "coder integer (encoding,video)" -.PD -Possible values: -.RS 4 -.IP "\fBvlc\fR" 4 -.IX Item "vlc" -variable length coder / huffman coder -.IP "\fBac\fR" 4 -.IX Item "ac" -arithmetic coder -.IP "\fBraw\fR" 4 -.IX Item "raw" -raw (no encoding) -.IP "\fBrle\fR" 4 -.IX Item "rle" -run-length coder -.IP "\fBdeflate\fR" 4 -.IX Item "deflate" -deflate-based coder -.RE -.RS 4 -.RE -.IP "\fBcontext\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "context integer (encoding,video)" -Set context model. -.IP "\fBslice_flags\fR \fIinteger\fR" 4 -.IX Item "slice_flags integer" -.PD 0 -.IP "\fBxvmc_acceleration\fR \fIinteger\fR" 4 -.IX Item "xvmc_acceleration integer" -.IP "\fBmbd\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mbd integer (encoding,video)" -.PD -Set macroblock decision algorithm (high quality mode). -.Sp -Possible values: -.RS 4 -.IP "\fBsimple\fR" 4 -.IX Item "simple" -use mbcmp (default) -.IP "\fBbits\fR" 4 -.IX Item "bits" -use fewest bits -.IP "\fBrd\fR" 4 -.IX Item "rd" -use best rate distortion -.RE -.RS 4 -.RE -.IP "\fBstream_codec_tag\fR \fIinteger\fR" 4 -.IX Item "stream_codec_tag integer" -.PD 0 -.IP "\fBsc_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "sc_threshold integer (encoding,video)" -.PD -Set scene change threshold. -.IP "\fBlmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "lmin integer (encoding,video)" -Set min lagrange factor (\s-1VBR\s0). -.IP "\fBlmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "lmax integer (encoding,video)" -Set max lagrange factor (\s-1VBR\s0). -.IP "\fBnr\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "nr integer (encoding,video)" -Set noise reduction. -.IP "\fBrc_init_occupancy\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_init_occupancy integer (encoding,video)" -Set number of bits which should be loaded into the rc buffer before -decoding starts. -.IP "\fBflags2\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4 -.IX Item "flags2 flags (decoding/encoding,audio,video)" -Possible values: -.RS 4 -.IP "\fBfast\fR" 4 -.IX Item "fast" -Allow non spec compliant speedup tricks. -.IP "\fBsgop\fR" 4 -.IX Item "sgop" -Deprecated, use mpegvideo private options instead. -.IP "\fBnoout\fR" 4 -.IX Item "noout" -Skip bitstream encoding. -.IP "\fBignorecrop\fR" 4 -.IX Item "ignorecrop" -Ignore cropping information from sps. -.IP "\fBlocal_header\fR" 4 -.IX Item "local_header" -Place global headers at every keyframe instead of in extradata. -.IP "\fBchunks\fR" 4 -.IX Item "chunks" -Frame data might be split into multiple chunks. -.IP "\fBshowall\fR" 4 -.IX Item "showall" -Show all frames before the first keyframe. -.IP "\fBskiprd\fR" 4 -.IX Item "skiprd" -Deprecated, use mpegvideo private options instead. -.RE -.RS 4 -.RE -.IP "\fBerror\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "error integer (encoding,video)" -.PD 0 -.IP "\fBqns\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "qns integer (encoding,video)" -.PD -Deprecated, use mpegvideo private options instead. -.IP "\fBthreads\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "threads integer (decoding/encoding,video)" -Possible values: -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -detect a good number of threads -.RE -.RS 4 -.RE -.IP "\fBme_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "me_threshold integer (encoding,video)" -Set motion estimation threshold. -.IP "\fBmb_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mb_threshold integer (encoding,video)" -Set macroblock threshold. -.IP "\fBdc\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "dc integer (encoding,video)" -Set intra_dc_precision. -.IP "\fBnssew\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "nssew integer (encoding,video)" -Set nsse weight. -.IP "\fBskip_top\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "skip_top integer (decoding,video)" -Set number of macroblock rows at the top which are skipped. -.IP "\fBskip_bottom\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "skip_bottom integer (decoding,video)" -Set number of macroblock rows at the bottom which are skipped. -.IP "\fBprofile\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "profile integer (encoding,audio,video)" -Possible values: -.RS 4 -.IP "\fBunknown\fR" 4 -.IX Item "unknown" -.PD 0 -.IP "\fBaac_main\fR" 4 -.IX Item "aac_main" -.IP "\fBaac_low\fR" 4 -.IX Item "aac_low" -.IP "\fBaac_ssr\fR" 4 -.IX Item "aac_ssr" -.IP "\fBaac_ltp\fR" 4 -.IX Item "aac_ltp" -.IP "\fBaac_he\fR" 4 -.IX Item "aac_he" -.IP "\fBaac_he_v2\fR" 4 -.IX Item "aac_he_v2" -.IP "\fBaac_ld\fR" 4 -.IX Item "aac_ld" -.IP "\fBaac_eld\fR" 4 -.IX Item "aac_eld" -.IP "\fBmpeg2_aac_low\fR" 4 -.IX Item "mpeg2_aac_low" -.IP "\fBmpeg2_aac_he\fR" 4 -.IX Item "mpeg2_aac_he" -.IP "\fBdts\fR" 4 -.IX Item "dts" -.IP "\fBdts_es\fR" 4 -.IX Item "dts_es" -.IP "\fBdts_96_24\fR" 4 -.IX Item "dts_96_24" -.IP "\fBdts_hd_hra\fR" 4 -.IX Item "dts_hd_hra" -.IP "\fBdts_hd_ma\fR" 4 -.IX Item "dts_hd_ma" -.RE -.RS 4 -.RE -.IP "\fBlevel\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "level integer (encoding,audio,video)" -.PD -Possible values: -.RS 4 -.IP "\fBunknown\fR" 4 -.IX Item "unknown" -.RE -.RS 4 -.RE -.PD 0 -.IP "\fBlowres\fR \fIinteger\fR \fB(\fR\fIdecoding,audio,video\fR\fB)\fR" 4 -.IX Item "lowres integer (decoding,audio,video)" -.PD -Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions. -.IP "\fBskip_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "skip_threshold integer (encoding,video)" -Set frame skip threshold. -.IP "\fBskip_factor\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "skip_factor integer (encoding,video)" -Set frame skip factor. -.IP "\fBskip_exp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "skip_exp integer (encoding,video)" -Set frame skip exponent. -.IP "\fBskipcmp\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "skipcmp integer (encoding,video)" -Set frame skip compare function. -.Sp -Possible values: -.RS 4 -.IP "\fBsad\fR" 4 -.IX Item "sad" -sum of absolute differences, fast (default) -.IP "\fBsse\fR" 4 -.IX Item "sse" -sum of squared errors -.IP "\fBsatd\fR" 4 -.IX Item "satd" -sum of absolute Hadamard transformed differences -.IP "\fBdct\fR" 4 -.IX Item "dct" -sum of absolute \s-1DCT\s0 transformed differences -.IP "\fBpsnr\fR" 4 -.IX Item "psnr" -sum of squared quantization errors (avoid, low quality) -.IP "\fBbit\fR" 4 -.IX Item "bit" -number of bits needed for the block -.IP "\fBrd\fR" 4 -.IX Item "rd" -rate distortion optimal, slow -.IP "\fBzero\fR" 4 -.IX Item "zero" -0 -.IP "\fBvsad\fR" 4 -.IX Item "vsad" -sum of absolute vertical differences -.IP "\fBvsse\fR" 4 -.IX Item "vsse" -sum of squared vertical differences -.IP "\fBnsse\fR" 4 -.IX Item "nsse" -noise preserving sum of squared differences -.IP "\fBw53\fR" 4 -.IX Item "w53" -5/3 wavelet, only used in snow -.IP "\fBw97\fR" 4 -.IX Item "w97" -9/7 wavelet, only used in snow -.IP "\fBdctmax\fR" 4 -.IX Item "dctmax" -.PD 0 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -.RE -.RS 4 -.RE -.IP "\fBborder_mask\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "border_mask float (encoding,video)" -.PD -Increase the quantizer for macroblocks close to borders. -.IP "\fBmblmin\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mblmin integer (encoding,video)" -Set min macroblock lagrange factor (\s-1VBR\s0). -.IP "\fBmblmax\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mblmax integer (encoding,video)" -Set max macroblock lagrange factor (\s-1VBR\s0). -.IP "\fBmepc\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mepc integer (encoding,video)" -Set motion estimation bitrate penalty compensation (1.0 = 256). -.IP "\fBskip_loop_filter\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "skip_loop_filter integer (decoding,video)" -.PD 0 -.IP "\fBskip_idct\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "skip_idct integer (decoding,video)" -.IP "\fBskip_frame\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "skip_frame integer (decoding,video)" -.PD -Make decoder discard processing depending on the frame type selected -by the option value. -.Sp -\&\fBskip_loop_filter\fR skips frame loop filtering, \fBskip_idct\fR -skips frame IDCT/dequantization, \fBskip_frame\fR skips decoding. -.Sp -Possible values: -.RS 4 -.IP "\fBnone\fR" 4 -.IX Item "none" -Discard no frame. -.IP "\fBdefault\fR" 4 -.IX Item "default" -Discard useless frames like 0\-sized frames. -.IP "\fBnoref\fR" 4 -.IX Item "noref" -Discard all non-reference frames. -.IP "\fBbidir\fR" 4 -.IX Item "bidir" -Discard all bidirectional frames. -.IP "\fBnokey\fR" 4 -.IX Item "nokey" -Discard all frames excepts keyframes. -.IP "\fBall\fR" 4 -.IX Item "all" -Discard all frames. -.RE -.RS 4 -.Sp -Default value is \fBdefault\fR. -.RE -.IP "\fBbidir_refine\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "bidir_refine integer (encoding,video)" -Refine the two motion vectors used in bidirectional macroblocks. -.IP "\fBbrd_scale\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "brd_scale integer (encoding,video)" -Downscale frames for dynamic B\-frame decision. -.IP "\fBkeyint_min\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "keyint_min integer (encoding,video)" -Set minimum interval between IDR\-frames. -.IP "\fBrefs\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "refs integer (encoding,video)" -Set reference frames to consider for motion compensation. -.IP "\fBchromaoffset\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "chromaoffset integer (encoding,video)" -Set chroma qp offset from luma. -.IP "\fBtrellis\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "trellis integer (encoding,audio,video)" -Set rate-distortion optimal quantization. -.IP "\fBsc_factor\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "sc_factor integer (encoding,video)" -Set value multiplied by qscale for each frame and added to -scene_change_score. -.IP "\fBmv0_threshold\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "mv0_threshold integer (encoding,video)" -.PD 0 -.IP "\fBb_sensitivity\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "b_sensitivity integer (encoding,video)" -.PD -Adjust sensitivity of b_frame_strategy 1. -.IP "\fBcompression_level\fR \fIinteger\fR \fB(\fR\fIencoding,audio,video\fR\fB)\fR" 4 -.IX Item "compression_level integer (encoding,audio,video)" -.PD 0 -.IP "\fBmin_prediction_order\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4 -.IX Item "min_prediction_order integer (encoding,audio)" -.IP "\fBmax_prediction_order\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4 -.IX Item "max_prediction_order integer (encoding,audio)" -.IP "\fBtimecode_frame_start\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "timecode_frame_start integer (encoding,video)" -.PD -Set \s-1GOP\s0 timecode frame start number, in non drop frame format. -.IP "\fBrequest_channels\fR \fIinteger\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4 -.IX Item "request_channels integer (decoding,audio)" -Set desired number of audio channels. -.IP "\fBbits_per_raw_sample\fR \fIinteger\fR" 4 -.IX Item "bits_per_raw_sample integer" -.PD 0 -.IP "\fBchannel_layout\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio\fR\fB)\fR" 4 -.IX Item "channel_layout integer (decoding/encoding,audio)" -.PD -Possible values: -.RS 4 -.RE -.RS 4 -.RE -.IP "\fBrequest_channel_layout\fR \fIinteger\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4 -.IX Item "request_channel_layout integer (decoding,audio)" -Possible values: -.RS 4 -.RE -.RS 4 -.RE -.IP "\fBrc_max_vbv_use\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_max_vbv_use float (encoding,video)" -.PD 0 -.IP "\fBrc_min_vbv_use\fR \fIfloat\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "rc_min_vbv_use float (encoding,video)" -.IP "\fBticks_per_frame\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,audio,video\fR\fB)\fR" 4 -.IX Item "ticks_per_frame integer (decoding/encoding,audio,video)" -.IP "\fBcolor_primaries\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "color_primaries integer (decoding/encoding,video)" -.IP "\fBcolor_trc\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "color_trc integer (decoding/encoding,video)" -.IP "\fBcolorspace\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "colorspace integer (decoding/encoding,video)" -.IP "\fBcolor_range\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "color_range integer (decoding/encoding,video)" -.IP "\fBchroma_sample_location\fR \fIinteger\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "chroma_sample_location integer (decoding/encoding,video)" -.IP "\fBlog_level_offset\fR \fIinteger\fR" 4 -.IX Item "log_level_offset integer" -.PD -Set the log level offset. -.IP "\fBslices\fR \fIinteger\fR \fB(\fR\fIencoding,video\fR\fB)\fR" 4 -.IX Item "slices integer (encoding,video)" -Number of slices, used in parallelized encoding. -.IP "\fBthread_type\fR \fIflags\fR \fB(\fR\fIdecoding/encoding,video\fR\fB)\fR" 4 -.IX Item "thread_type flags (decoding/encoding,video)" -Select multithreading type. -.Sp -Possible values: -.RS 4 -.IP "\fBslice\fR" 4 -.IX Item "slice" -.PD 0 -.IP "\fBframe\fR" 4 -.IX Item "frame" -.RE -.RS 4 -.RE -.IP "\fBaudio_service_type\fR \fIinteger\fR \fB(\fR\fIencoding,audio\fR\fB)\fR" 4 -.IX Item "audio_service_type integer (encoding,audio)" -.PD -Set audio service type. -.Sp -Possible values: -.RS 4 -.IP "\fBma\fR" 4 -.IX Item "ma" -Main Audio Service -.IP "\fBef\fR" 4 -.IX Item "ef" -Effects -.IP "\fBvi\fR" 4 -.IX Item "vi" -Visually Impaired -.IP "\fBhi\fR" 4 -.IX Item "hi" -Hearing Impaired -.IP "\fBdi\fR" 4 -.IX Item "di" -Dialogue -.IP "\fBco\fR" 4 -.IX Item "co" -Commentary -.IP "\fBem\fR" 4 -.IX Item "em" -Emergency -.IP "\fBvo\fR" 4 -.IX Item "vo" -Voice Over -.IP "\fBka\fR" 4 -.IX Item "ka" -Karaoke -.RE -.RS 4 -.RE -.IP "\fBrequest_sample_fmt\fR \fIsample_fmt\fR \fB(\fR\fIdecoding,audio\fR\fB)\fR" 4 -.IX Item "request_sample_fmt sample_fmt (decoding,audio)" -Set sample format audio decoders should prefer. Default value is -\&\f(CW\*(C`none\*(C'\fR. -.IP "\fBpkt_timebase\fR \fIrational number\fR" 4 -.IX Item "pkt_timebase rational number" -.PD 0 -.IP "\fBsub_charenc\fR \fIencoding\fR \fB(\fR\fIdecoding,subtitles\fR\fB)\fR" 4 -.IX Item "sub_charenc encoding (decoding,subtitles)" -.PD -Set the input subtitles character encoding. -.IP "\fBfield_order\fR \fIfield_order\fR \fB(\fR\fIvideo\fR\fB)\fR" 4 -.IX Item "field_order field_order (video)" -Set/override the field order of the video. -Possible values: -.RS 4 -.IP "\fBprogressive\fR" 4 -.IX Item "progressive" -Progressive video -.IP "\fBtt\fR" 4 -.IX Item "tt" -Interlaced video, top field coded and displayed first -.IP "\fBbb\fR" 4 -.IX Item "bb" -Interlaced video, bottom field coded and displayed first -.IP "\fBtb\fR" 4 -.IX Item "tb" -Interlaced video, top coded first, bottom displayed first -.IP "\fBbt\fR" 4 -.IX Item "bt" -Interlaced video, bottom coded first, top displayed first -.RE -.RS 4 -.RE -.IP "\fBskip_alpha\fR \fIinteger\fR \fB(\fR\fIdecoding,video\fR\fB)\fR" 4 -.IX Item "skip_alpha integer (decoding,video)" -Set to 1 to disable processing alpha (transparency). This works like the -\&\fBgray\fR flag in the \fBflags\fR option which skips chroma information -instead of alpha. Default is 0. -.SH "DECODERS" -.IX Header "DECODERS" -Decoders are configured elements in FFmpeg which allow the decoding of -multimedia streams. -.PP -When you configure your FFmpeg build, all the supported native decoders -are enabled by default. Decoders requiring an external library must be enabled -manually via the corresponding \f(CW\*(C`\-\-enable\-lib\*(C'\fR option. You can list all -available decoders using the configure option \f(CW\*(C`\-\-list\-decoders\*(C'\fR. -.PP -You can disable all the decoders with the configure option -\&\f(CW\*(C`\-\-disable\-decoders\*(C'\fR and selectively enable / disable single decoders -with the options \f(CW\*(C`\-\-enable\-decoder=\f(CI\s-1DECODER\s0\f(CW\*(C'\fR / -\&\f(CW\*(C`\-\-disable\-decoder=\f(CI\s-1DECODER\s0\f(CW\*(C'\fR. -.PP -The option \f(CW\*(C`\-codecs\*(C'\fR of the ff* tools will display the list of -enabled decoders. -.SH "VIDEO DECODERS" -.IX Header "VIDEO DECODERS" -A description of some of the currently available video decoders -follows. -.Sh "rawvideo" -.IX Subsection "rawvideo" -Raw video decoder. -.PP -This decoder decodes rawvideo streams. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBtop\fR \fItop_field_first\fR" 4 -.IX Item "top top_field_first" -Specify the assumed field type of the input video. -.RS 4 -.IP "\fB\-1\fR" 4 -.IX Item "-1" -the video is assumed to be progressive (default) -.IP "\fB0\fR" 4 -.IX Item "0" -bottom-field-first is assumed -.IP "\fB1\fR" 4 -.IX Item "1" -top-field-first is assumed -.RE -.RS 4 -.RE -.SH "AUDIO DECODERS" -.IX Header "AUDIO DECODERS" -.Sh "ffwavesynth" -.IX Subsection "ffwavesynth" -Internal wave synthetizer. -.PP -This decoder generates wave patterns according to predefined sequences. Its -use is purely internal and the format of the data it accepts is not publicly -documented. -.Sh "libcelt" -.IX Subsection "libcelt" -libcelt decoder wrapper. -.PP -libcelt allows libavcodec to decode the Xiph \s-1CELT\s0 ultra-low delay audio codec. -Requires the presence of the libcelt headers and library during configuration. -You need to explicitly configure the build with \f(CW\*(C`\-\-enable\-libcelt\*(C'\fR. -.Sh "libgsm" -.IX Subsection "libgsm" -libgsm decoder wrapper. -.PP -libgsm allows libavcodec to decode the \s-1GSM\s0 full rate audio codec. Requires -the presence of the libgsm headers and library during configuration. You need -to explicitly configure the build with \f(CW\*(C`\-\-enable\-libgsm\*(C'\fR. -.PP -This decoder supports both the ordinary \s-1GSM\s0 and the Microsoft variant. -.Sh "libilbc" -.IX Subsection "libilbc" -libilbc decoder wrapper. -.PP -libilbc allows libavcodec to decode the Internet Low Bitrate Codec (iLBC) -audio codec. Requires the presence of the libilbc headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libilbc\*(C'\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following option is supported by the libilbc wrapper. -.IP "\fBenhance\fR" 4 -.IX Item "enhance" -Enable the enhancement of the decoded audio when set to 1. The default -value is 0 (disabled). -.Sh "libopencore-amrnb" -.IX Subsection "libopencore-amrnb" -libopencore-amrnb decoder wrapper. -.PP -libopencore-amrnb allows libavcodec to decode the Adaptive Multi-Rate -Narrowband audio codec. Using it requires the presence of the -libopencore-amrnb headers and library during configuration. You need to -explicitly configure the build with \f(CW\*(C`\-\-enable\-libopencore\-amrnb\*(C'\fR. -.PP -An FFmpeg native decoder for AMR-NB exists, so users can decode AMR-NB -without this library. -.Sh "libopencore-amrwb" -.IX Subsection "libopencore-amrwb" -libopencore-amrwb decoder wrapper. -.PP -libopencore-amrwb allows libavcodec to decode the Adaptive Multi-Rate -Wideband audio codec. Using it requires the presence of the -libopencore-amrwb headers and library during configuration. You need to -explicitly configure the build with \f(CW\*(C`\-\-enable\-libopencore\-amrwb\*(C'\fR. -.PP -An FFmpeg native decoder for AMR-WB exists, so users can decode AMR-WB -without this library. -.Sh "libopus" -.IX Subsection "libopus" -libopus decoder wrapper. -.PP -libopus allows libavcodec to decode the Opus Interactive Audio Codec. -Requires the presence of the libopus headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libopus\*(C'\fR. -.SH "SUBTITLES DECODERS" -.IX Header "SUBTITLES DECODERS" -.Sh "dvdsub" -.IX Subsection "dvdsub" -This codec decodes the bitmap subtitles used in DVDs; the same subtitles can -also be found in VobSub file pairs and in some Matroska files. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBpalette\fR" 4 -.IX Item "palette" -Specify the global palette used by the bitmaps. When stored in VobSub, the -palette is normally specified in the index file; in Matroska, the palette is -stored in the codec extra-data in the same format as in VobSub. In DVDs, the -palette is stored in the \s-1IFO\s0 file, and therefore not available when reading -from dumped \s-1VOB\s0 files. -.Sp -The format for this option is a string containing 16 24\-bits hexadecimal -numbers (without 0x prefix) separated by comas, for example \f(CW\*(C`0d00ee, -ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1, -7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b\*(C'\fR. -.Sh "libzvbi-teletext" -.IX Subsection "libzvbi-teletext" -Libzvbi allows libavcodec to decode \s-1DVB\s0 teletext pages and \s-1DVB\s0 teletext -subtitles. Requires the presence of the libzvbi headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libzvbi\*(C'\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBtxt_page\fR" 4 -.IX Item "txt_page" -List of teletext page numbers to decode. You may use the special * string to -match all pages. Pages that do not match the specified list are dropped. -Default value is *. -.IP "\fBtxt_chop_top\fR" 4 -.IX Item "txt_chop_top" -Discards the top teletext line. Default value is 1. -.IP "\fBtxt_format\fR" 4 -.IX Item "txt_format" -Specifies the format of the decoded subtitles. The teletext decoder is capable -of decoding the teletext pages to bitmaps or to simple text, you should use -\&\*(L"bitmap\*(R" for teletext pages, because certain graphics and colors cannot be -expressed in simple text. You might use \*(L"text\*(R" for teletext based subtitles if -your application can handle simple text based subtitles. Default value is -bitmap. -.IP "\fBtxt_left\fR" 4 -.IX Item "txt_left" -X offset of generated bitmaps, default is 0. -.IP "\fBtxt_top\fR" 4 -.IX Item "txt_top" -Y offset of generated bitmaps, default is 0. -.IP "\fBtxt_chop_spaces\fR" 4 -.IX Item "txt_chop_spaces" -Chops leading and trailing spaces and removes empty lines from the generated -text. This option is useful for teletext based subtitles where empty spaces may -be present at the start or at the end of the lines or empty lines may be -present between the subtitle lines because of double-sized teletext charactes. -Default value is 1. -.IP "\fBtxt_duration\fR" 4 -.IX Item "txt_duration" -Sets the display duration of the decoded teletext pages or subtitles in -miliseconds. Default value is 30000 which is 30 seconds. -.IP "\fBtxt_transparent\fR" 4 -.IX Item "txt_transparent" -Force transparent background of the generated teletext bitmaps. Default value -is 0 which means an opaque (black) background. -.SH "ENCODERS" -.IX Header "ENCODERS" -Encoders are configured elements in FFmpeg which allow the encoding of -multimedia streams. -.PP -When you configure your FFmpeg build, all the supported native encoders -are enabled by default. Encoders requiring an external library must be enabled -manually via the corresponding \f(CW\*(C`\-\-enable\-lib\*(C'\fR option. You can list all -available encoders using the configure option \f(CW\*(C`\-\-list\-encoders\*(C'\fR. -.PP -You can disable all the encoders with the configure option -\&\f(CW\*(C`\-\-disable\-encoders\*(C'\fR and selectively enable / disable single encoders -with the options \f(CW\*(C`\-\-enable\-encoder=\f(CI\s-1ENCODER\s0\f(CW\*(C'\fR / -\&\f(CW\*(C`\-\-disable\-encoder=\f(CI\s-1ENCODER\s0\f(CW\*(C'\fR. -.PP -The option \f(CW\*(C`\-codecs\*(C'\fR of the ff* tools will display the list of -enabled encoders. -.SH "AUDIO ENCODERS" -.IX Header "AUDIO ENCODERS" -A description of some of the currently available audio encoders -follows. -.Sh "aac" -.IX Subsection "aac" -Advanced Audio Coding (\s-1AAC\s0) encoder. -.PP -This encoder is an experimental FFmpeg-native \s-1AAC\s0 encoder. Currently only the -low complexity (\s-1AAC\-LC\s0) profile is supported. To use this encoder, you must set -\&\fBstrict\fR option to \fBexperimental\fR or lower. -.PP -As this encoder is experimental, unexpected behavior may exist from time to -time. For a more stable \s-1AAC\s0 encoder, see libvo\-aacenc. However, be warned -that it has a worse quality reported by some users. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBb\fR" 4 -.IX Item "b" -Set bit rate in bits/s. Setting this automatically activates constant bit rate -(\s-1CBR\s0) mode. -.IP "\fBq\fR" 4 -.IX Item "q" -Set quality for variable bit rate (\s-1VBR\s0) mode. This option is valid only using -the \fBffmpeg\fR command-line tool. For library interface users, use -\&\fBglobal_quality\fR. -.IP "\fBstereo_mode\fR" 4 -.IX Item "stereo_mode" -Set stereo encoding mode. Possible values: -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -Automatically selected by the encoder. -.IP "\fBms_off\fR" 4 -.IX Item "ms_off" -Disable middle/side encoding. This is the default. -.IP "\fBms_force\fR" 4 -.IX Item "ms_force" -Force middle/side encoding. -.RE -.RS 4 -.RE -.IP "\fBaac_coder\fR" 4 -.IX Item "aac_coder" -Set \s-1AAC\s0 encoder coding method. Possible values: -.RS 4 -.IP "\fBfaac\fR" 4 -.IX Item "faac" -FAAC-inspired method. -.Sp -This method is a simplified reimplementation of the method used in \s-1FAAC\s0, which -sets thresholds proportional to the band energies, and then decreases all the -thresholds with quantizer steps to find the appropriate quantization with -distortion below threshold band by band. -.Sp -The quality of this method is comparable to the two loop searching method -descibed below, but somewhat a little better and slower. -.IP "\fBanmr\fR" 4 -.IX Item "anmr" -Average noise to mask ratio (\s-1ANMR\s0) trellis-based solution. -.Sp -This has a theoretic best quality out of all the coding methods, but at the -cost of the slowest speed. -.IP "\fBtwoloop\fR" 4 -.IX Item "twoloop" -Two loop searching (\s-1TLS\s0) method. -.Sp -This method first sets quantizers depending on band thresholds and then tries -to find an optimal combination by adding or subtracting a specific value from -all quantizers and adjusting some individual quantizer a little. -.Sp -This method produces similar quality with the \s-1FAAC\s0 method and is the default. -.IP "\fBfast\fR" 4 -.IX Item "fast" -Constant quantizer method. -.Sp -This method sets a constant quantizer for all bands. This is the fastest of all -the methods, yet produces the worst quality. -.RE -.RS 4 -.RE -.Sh "ac3 and ac3_fixed" -.IX Subsection "ac3 and ac3_fixed" -\&\s-1AC\-3\s0 audio encoders. -.PP -These encoders implement part of \s-1ATSC\s0 A/52:2010 and \s-1ETSI\s0 \s-1TS\s0 102 366, as well as -the undocumented RealAudio 3 (a.k.a. dnet). -.PP -The \fIac3\fR encoder uses floating-point math, while the \fIac3_fixed\fR -encoder only uses fixed-point integer math. This does not mean that one is -always faster, just that one or the other may be better suited to a -particular system. The floating-point encoder will generally produce better -quality audio for a given bitrate. The \fIac3_fixed\fR encoder is not the -default codec for any of the output formats, so it must be specified explicitly -using the option \f(CW\*(C`\-acodec ac3_fixed\*(C'\fR in order to use it. -.PP -\fI\s-1AC\-3\s0 Metadata\fR -.IX Subsection "AC-3 Metadata" -.PP -The \s-1AC\-3\s0 metadata options are used to set parameters that describe the audio, -but in most cases do not affect the audio encoding itself. Some of the options -do directly affect or influence the decoding and playback of the resulting -bitstream, while others are just for informational purposes. A few of the -options will add bits to the output stream that could otherwise be used for -audio data, and will thus affect the quality of the output. Those will be -indicated accordingly with a note in the option list below. -.PP -These parameters are described in detail in several publicly-available -documents. -.IP "*<<\fBhttp://www.atsc.org/cms/standards/a_52\-2010.pdf\fR>>" 4 -.IX Item "*<>" -.PD 0 -.IP "*<<\fBhttp://www.atsc.org/cms/standards/a_54a_with_corr_1.pdf\fR>>" 4 -.IX Item "*<>" -.IP "*<<\fBhttp://www.dolby.com/uploadedFiles/zz\-_Shared_Assets/English_PDFs/Professional/18_Metadata.Guide.pdf\fR>>" 4 -.IX Item "*<>" -.IP "*<<\fBhttp://www.dolby.com/uploadedFiles/zz\-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf\fR>>" 4 -.IX Item "*<>" -.PD -.PP -Metadata Control Options -.IX Subsection "Metadata Control Options" -.IP "\fB\-per_frame_metadata\fR \fIboolean\fR" 4 -.IX Item "-per_frame_metadata boolean" -Allow Per-Frame Metadata. Specifies if the encoder should check for changing -metadata for each frame. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -The metadata values set at initialization will be used for every frame in the -stream. (default) -.IP "\fB1\fR" 4 -.IX Item "1" -Metadata values can be changed before encoding each frame. -.RE -.RS 4 -.RE -.PP -Downmix Levels -.IX Subsection "Downmix Levels" -.IP "\fB\-center_mixlev\fR \fIlevel\fR" 4 -.IX Item "-center_mixlev level" -Center Mix Level. The amount of gain the decoder should apply to the center -channel when downmixing to stereo. This field will only be written to the -bitstream if a center channel is present. The value is specified as a scale -factor. There are 3 valid values: -.RS 4 -.IP "\fB0.707\fR" 4 -.IX Item "0.707" -Apply \-3dB gain -.IP "\fB0.595\fR" 4 -.IX Item "0.595" -Apply \-4.5dB gain (default) -.IP "\fB0.500\fR" 4 -.IX Item "0.500" -Apply \-6dB gain -.RE -.RS 4 -.RE -.IP "\fB\-surround_mixlev\fR \fIlevel\fR" 4 -.IX Item "-surround_mixlev level" -Surround Mix Level. The amount of gain the decoder should apply to the surround -channel(s) when downmixing to stereo. This field will only be written to the -bitstream if one or more surround channels are present. The value is specified -as a scale factor. There are 3 valid values: -.RS 4 -.IP "\fB0.707\fR" 4 -.IX Item "0.707" -Apply \-3dB gain -.IP "\fB0.500\fR" 4 -.IX Item "0.500" -Apply \-6dB gain (default) -.IP "\fB0.000\fR" 4 -.IX Item "0.000" -Silence Surround Channel(s) -.RE -.RS 4 -.RE -.PP -Audio Production Information -.IX Subsection "Audio Production Information" -.PP -Audio Production Information is optional information describing the mixing -environment. Either none or both of the fields are written to the bitstream. -.IP "\fB\-mixing_level\fR \fInumber\fR" 4 -.IX Item "-mixing_level number" -Mixing Level. Specifies peak sound pressure level (\s-1SPL\s0) in the production -environment when the mix was mastered. Valid values are 80 to 111, or \-1 for -unknown or not indicated. The default value is \-1, but that value cannot be -used if the Audio Production Information is written to the bitstream. Therefore, -if the \f(CW\*(C`room_type\*(C'\fR option is not the default value, the \f(CW\*(C`mixing_level\*(C'\fR -option must not be \-1. -.IP "\fB\-room_type\fR \fItype\fR" 4 -.IX Item "-room_type type" -Room Type. Describes the equalization used during the final mixing session at -the studio or on the dubbing stage. A large room is a dubbing stage with the -industry standard X\-curve equalization; a small room has flat equalization. -This field will not be written to the bitstream if both the \f(CW\*(C`mixing_level\*(C'\fR -option and the \f(CW\*(C`room_type\*(C'\fR option have the default values. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBnotindicated\fR" 4 -.IX Item "notindicated" -.PD -Not Indicated (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBlarge\fR" 4 -.IX Item "large" -.PD -Large Room -.IP "\fB2\fR" 4 -.IX Item "2" -.PD 0 -.IP "\fBsmall\fR" 4 -.IX Item "small" -.PD -Small Room -.RE -.RS 4 -.RE -.PP -Other Metadata Options -.IX Subsection "Other Metadata Options" -.IP "\fB\-copyright\fR \fIboolean\fR" 4 -.IX Item "-copyright boolean" -Copyright Indicator. Specifies whether a copyright exists for this audio. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBoff\fR" 4 -.IX Item "off" -.PD -No Copyright Exists (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBon\fR" 4 -.IX Item "on" -.PD -Copyright Exists -.RE -.RS 4 -.RE -.IP "\fB\-dialnorm\fR \fIvalue\fR" 4 -.IX Item "-dialnorm value" -Dialogue Normalization. Indicates how far the average dialogue level of the -program is below digital 100% full scale (0 dBFS). This parameter determines a -level shift during audio reproduction that sets the average volume of the -dialogue to a preset level. The goal is to match volume level between program -sources. A value of \-31dB will result in no volume level change, relative to -the source volume, during audio reproduction. Valid values are whole numbers in -the range \-31 to \-1, with \-31 being the default. -.IP "\fB\-dsur_mode\fR \fImode\fR" 4 -.IX Item "-dsur_mode mode" -Dolby Surround Mode. Specifies whether the stereo signal uses Dolby Surround -(Pro Logic). This field will only be written to the bitstream if the audio -stream is stereo. Using this option does \fB\s-1NOT\s0\fR mean the encoder will actually -apply Dolby Surround processing. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBnotindicated\fR" 4 -.IX Item "notindicated" -.PD -Not Indicated (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBoff\fR" 4 -.IX Item "off" -.PD -Not Dolby Surround Encoded -.IP "\fB2\fR" 4 -.IX Item "2" -.PD 0 -.IP "\fBon\fR" 4 -.IX Item "on" -.PD -Dolby Surround Encoded -.RE -.RS 4 -.RE -.IP "\fB\-original\fR \fIboolean\fR" 4 -.IX Item "-original boolean" -Original Bit Stream Indicator. Specifies whether this audio is from the -original source and not a copy. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBoff\fR" 4 -.IX Item "off" -.PD -Not Original Source -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBon\fR" 4 -.IX Item "on" -.PD -Original Source (default) -.RE -.RS 4 -.RE -.PP -\fIExtended Bitstream Information\fR -.IX Subsection "Extended Bitstream Information" -.PP -The extended bitstream options are part of the Alternate Bit Stream Syntax as -specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts. -If any one parameter in a group is specified, all values in that group will be -written to the bitstream. Default values are used for those that are written -but have not been specified. If the mixing levels are written, the decoder -will use these values instead of the ones specified in the \f(CW\*(C`center_mixlev\*(C'\fR -and \f(CW\*(C`surround_mixlev\*(C'\fR options if it supports the Alternate Bit Stream -Syntax. -.PP -Extended Bitstream Information \- Part 1 -.IX Subsection "Extended Bitstream Information - Part 1" -.IP "\fB\-dmix_mode\fR \fImode\fR" 4 -.IX Item "-dmix_mode mode" -Preferred Stereo Downmix Mode. Allows the user to select either Lt/Rt -(Dolby Surround) or Lo/Ro (normal stereo) as the preferred stereo downmix mode. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBnotindicated\fR" 4 -.IX Item "notindicated" -.PD -Not Indicated (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBltrt\fR" 4 -.IX Item "ltrt" -.PD -Lt/Rt Downmix Preferred -.IP "\fB2\fR" 4 -.IX Item "2" -.PD 0 -.IP "\fBloro\fR" 4 -.IX Item "loro" -.PD -Lo/Ro Downmix Preferred -.RE -.RS 4 -.RE -.IP "\fB\-ltrt_cmixlev\fR \fIlevel\fR" 4 -.IX Item "-ltrt_cmixlev level" -Lt/Rt Center Mix Level. The amount of gain the decoder should apply to the -center channel when downmixing to stereo in Lt/Rt mode. -.RS 4 -.IP "\fB1.414\fR" 4 -.IX Item "1.414" -Apply +3dB gain -.IP "\fB1.189\fR" 4 -.IX Item "1.189" -Apply +1.5dB gain -.IP "\fB1.000\fR" 4 -.IX Item "1.000" -Apply 0dB gain -.IP "\fB0.841\fR" 4 -.IX Item "0.841" -Apply \-1.5dB gain -.IP "\fB0.707\fR" 4 -.IX Item "0.707" -Apply \-3.0dB gain -.IP "\fB0.595\fR" 4 -.IX Item "0.595" -Apply \-4.5dB gain (default) -.IP "\fB0.500\fR" 4 -.IX Item "0.500" -Apply \-6.0dB gain -.IP "\fB0.000\fR" 4 -.IX Item "0.000" -Silence Center Channel -.RE -.RS 4 -.RE -.IP "\fB\-ltrt_surmixlev\fR \fIlevel\fR" 4 -.IX Item "-ltrt_surmixlev level" -Lt/Rt Surround Mix Level. The amount of gain the decoder should apply to the -surround channel(s) when downmixing to stereo in Lt/Rt mode. -.RS 4 -.IP "\fB0.841\fR" 4 -.IX Item "0.841" -Apply \-1.5dB gain -.IP "\fB0.707\fR" 4 -.IX Item "0.707" -Apply \-3.0dB gain -.IP "\fB0.595\fR" 4 -.IX Item "0.595" -Apply \-4.5dB gain -.IP "\fB0.500\fR" 4 -.IX Item "0.500" -Apply \-6.0dB gain (default) -.IP "\fB0.000\fR" 4 -.IX Item "0.000" -Silence Surround Channel(s) -.RE -.RS 4 -.RE -.IP "\fB\-loro_cmixlev\fR \fIlevel\fR" 4 -.IX Item "-loro_cmixlev level" -Lo/Ro Center Mix Level. The amount of gain the decoder should apply to the -center channel when downmixing to stereo in Lo/Ro mode. -.RS 4 -.IP "\fB1.414\fR" 4 -.IX Item "1.414" -Apply +3dB gain -.IP "\fB1.189\fR" 4 -.IX Item "1.189" -Apply +1.5dB gain -.IP "\fB1.000\fR" 4 -.IX Item "1.000" -Apply 0dB gain -.IP "\fB0.841\fR" 4 -.IX Item "0.841" -Apply \-1.5dB gain -.IP "\fB0.707\fR" 4 -.IX Item "0.707" -Apply \-3.0dB gain -.IP "\fB0.595\fR" 4 -.IX Item "0.595" -Apply \-4.5dB gain (default) -.IP "\fB0.500\fR" 4 -.IX Item "0.500" -Apply \-6.0dB gain -.IP "\fB0.000\fR" 4 -.IX Item "0.000" -Silence Center Channel -.RE -.RS 4 -.RE -.IP "\fB\-loro_surmixlev\fR \fIlevel\fR" 4 -.IX Item "-loro_surmixlev level" -Lo/Ro Surround Mix Level. The amount of gain the decoder should apply to the -surround channel(s) when downmixing to stereo in Lo/Ro mode. -.RS 4 -.IP "\fB0.841\fR" 4 -.IX Item "0.841" -Apply \-1.5dB gain -.IP "\fB0.707\fR" 4 -.IX Item "0.707" -Apply \-3.0dB gain -.IP "\fB0.595\fR" 4 -.IX Item "0.595" -Apply \-4.5dB gain -.IP "\fB0.500\fR" 4 -.IX Item "0.500" -Apply \-6.0dB gain (default) -.IP "\fB0.000\fR" 4 -.IX Item "0.000" -Silence Surround Channel(s) -.RE -.RS 4 -.RE -.PP -Extended Bitstream Information \- Part 2 -.IX Subsection "Extended Bitstream Information - Part 2" -.IP "\fB\-dsurex_mode\fR \fImode\fR" 4 -.IX Item "-dsurex_mode mode" -Dolby Surround \s-1EX\s0 Mode. Indicates whether the stream uses Dolby Surround \s-1EX\s0 -(7.1 matrixed to 5.1). Using this option does \fB\s-1NOT\s0\fR mean the encoder will actually -apply Dolby Surround \s-1EX\s0 processing. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBnotindicated\fR" 4 -.IX Item "notindicated" -.PD -Not Indicated (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBon\fR" 4 -.IX Item "on" -.PD -Dolby Surround \s-1EX\s0 Off -.IP "\fB2\fR" 4 -.IX Item "2" -.PD 0 -.IP "\fBoff\fR" 4 -.IX Item "off" -.PD -Dolby Surround \s-1EX\s0 On -.RE -.RS 4 -.RE -.IP "\fB\-dheadphone_mode\fR \fImode\fR" 4 -.IX Item "-dheadphone_mode mode" -Dolby Headphone Mode. Indicates whether the stream uses Dolby Headphone -encoding (multi\-channel matrixed to 2.0 for use with headphones). Using this -option does \fB\s-1NOT\s0\fR mean the encoder will actually apply Dolby Headphone -processing. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBnotindicated\fR" 4 -.IX Item "notindicated" -.PD -Not Indicated (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBon\fR" 4 -.IX Item "on" -.PD -Dolby Headphone Off -.IP "\fB2\fR" 4 -.IX Item "2" -.PD 0 -.IP "\fBoff\fR" 4 -.IX Item "off" -.PD -Dolby Headphone On -.RE -.RS 4 -.RE -.IP "\fB\-ad_conv_type\fR \fItype\fR" 4 -.IX Item "-ad_conv_type type" -A/D Converter Type. Indicates whether the audio has passed through \s-1HDCD\s0 A/D -conversion. -.RS 4 -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBstandard\fR" 4 -.IX Item "standard" -.PD -Standard A/D Converter (default) -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBhdcd\fR" 4 -.IX Item "hdcd" -.PD -\&\s-1HDCD\s0 A/D Converter -.RE -.RS 4 -.RE -.PP -\fIOther \s-1AC\-3\s0 Encoding Options\fR -.IX Subsection "Other AC-3 Encoding Options" -.IP "\fB\-stereo_rematrixing\fR \fIboolean\fR" 4 -.IX Item "-stereo_rematrixing boolean" -Stereo Rematrixing. Enables/Disables use of rematrixing for stereo input. This -is an optional \s-1AC\-3\s0 feature that increases quality by selectively encoding -the left/right channels as mid/side. This option is enabled by default, and it -is highly recommended that it be left as enabled except for testing purposes. -.PP -\fIFloating-Point-Only \s-1AC\-3\s0 Encoding Options\fR -.IX Subsection "Floating-Point-Only AC-3 Encoding Options" -.PP -These options are only valid for the floating-point encoder and do not exist -for the fixed-point encoder due to the corresponding features not being -implemented in fixed\-point. -.IP "\fB\-channel_coupling\fR \fIboolean\fR" 4 -.IX Item "-channel_coupling boolean" -Enables/Disables use of channel coupling, which is an optional \s-1AC\-3\s0 feature -that increases quality by combining high frequency information from multiple -channels into a single channel. The per-channel high frequency information is -sent with less accuracy in both the frequency and time domains. This allows -more bits to be used for lower frequencies while preserving enough information -to reconstruct the high frequencies. This option is enabled by default for the -floating-point encoder and should generally be left as enabled except for -testing purposes or to increase encoding speed. -.RS 4 -.IP "\fB\-1\fR" 4 -.IX Item "-1" -.PD 0 -.IP "\fBauto\fR" 4 -.IX Item "auto" -.PD -Selected by Encoder (default) -.IP "\fB0\fR" 4 -.IX Item "0" -.PD 0 -.IP "\fBoff\fR" 4 -.IX Item "off" -.PD -Disable Channel Coupling -.IP "\fB1\fR" 4 -.IX Item "1" -.PD 0 -.IP "\fBon\fR" 4 -.IX Item "on" -.PD -Enable Channel Coupling -.RE -.RS 4 -.RE -.IP "\fB\-cpl_start_band\fR \fInumber\fR" 4 -.IX Item "-cpl_start_band number" -Coupling Start Band. Sets the channel coupling start band, from 1 to 15. If a -value higher than the bandwidth is used, it will be reduced to 1 less than the -coupling end band. If \fIauto\fR is used, the start band will be determined by -the encoder based on the bit rate, sample rate, and channel layout. This option -has no effect if channel coupling is disabled. -.RS 4 -.IP "\fB\-1\fR" 4 -.IX Item "-1" -.PD 0 -.IP "\fBauto\fR" 4 -.IX Item "auto" -.PD -Selected by Encoder (default) -.RE -.RS 4 -.RE -.Sh "libmp3lame" -.IX Subsection "libmp3lame" -\&\s-1LAME\s0 (Lame Ain't an \s-1MP3\s0 Encoder) \s-1MP3\s0 encoder wrapper. -.PP -Requires the presence of the libmp3lame headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libmp3lame\*(C'\fR. -.PP -See libshine for a fixed-point \s-1MP3\s0 encoder, although with a -lower quality. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following options are supported by the libmp3lame wrapper. The -\&\fBlame\fR\-equivalent of the options are listed in parentheses. -.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4 -.IX Item "b (-b)" -Set bitrate expressed in bits/s for \s-1CBR\s0. \s-1LAME\s0 \f(CW\*(C`bitrate\*(C'\fR is -expressed in kilobits/s. -.IP "\fBq (\fR\fI\-V\fR\fB)\fR" 4 -.IX Item "q (-V)" -Set constant quality setting for \s-1VBR\s0. This option is valid only -using the \fBffmpeg\fR command-line tool. For library interface -users, use \fBglobal_quality\fR. -.IP "\fBcompression_level (\fR\fI\-q\fR\fB)\fR" 4 -.IX Item "compression_level (-q)" -Set algorithm quality. Valid arguments are integers in the 0\-9 range, -with 0 meaning highest quality but slowest, and 9 meaning fastest -while producing the worst quality. -.IP "\fBreservoir\fR" 4 -.IX Item "reservoir" -Enable use of bit reservoir when set to 1. Default value is 1. \s-1LAME\s0 -has this enabled by default, but can be overriden by use -\&\fB\-\-nores\fR option. -.IP "\fBjoint_stereo (\fR\fI\-m j\fR\fB)\fR" 4 -.IX Item "joint_stereo (-m j)" -Enable the encoder to use (on a frame by frame basis) either L/R -stereo or mid/side stereo. Default value is 1. -.Sh "libopencore-amrnb" -.IX Subsection "libopencore-amrnb" -OpenCORE Adaptive Multi-Rate Narrowband encoder. -.PP -Requires the presence of the libopencore-amrnb headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libopencore\-amrnb \-\-enable\-version3\*(C'\fR. -.PP -This is a mono-only encoder. Officially it only supports 8000Hz sample rate, -but you can override it by setting \fBstrict\fR to \fBunofficial\fR or -lower. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBb\fR" 4 -.IX Item "b" -Set bitrate in bits per second. Only the following bitrates are supported, -otherwise libavcodec will round to the nearest valid bitrate. -.RS 4 -.IP "\fB4750\fR" 4 -.IX Item "4750" -.PD 0 -.IP "\fB5150\fR" 4 -.IX Item "5150" -.IP "\fB5900\fR" 4 -.IX Item "5900" -.IP "\fB6700\fR" 4 -.IX Item "6700" -.IP "\fB7400\fR" 4 -.IX Item "7400" -.IP "\fB7950\fR" 4 -.IX Item "7950" -.IP "\fB10200\fR" 4 -.IX Item "10200" -.IP "\fB12200\fR" 4 -.IX Item "12200" -.RE -.RS 4 -.RE -.IP "\fBdtx\fR" 4 -.IX Item "dtx" -.PD -Allow discontinuous transmission (generate comfort noise) when set to 1. The -default value is 0 (disabled). -.Sh "libshine" -.IX Subsection "libshine" -Shine Fixed-Point \s-1MP3\s0 encoder wrapper. -.PP -Shine is a fixed-point \s-1MP3\s0 encoder. It has a far better performance on -platforms without an \s-1FPU\s0, e.g. armel CPUs, and some phones and tablets. -However, as it is more targeted on performance than quality, it is not on par -with \s-1LAME\s0 and other production-grade encoders quality\-wise. Also, according to -the project's homepage, this encoder may not be free of bugs as the code was -written a long time ago and the project was dead for at least 5 years. -.PP -This encoder only supports stereo and mono input. This is also CBR\-only. -.PP -The original project (last updated in early 2007) is at -<\fBhttp://sourceforge.net/projects/libshine\-fxp/\fR>. We only support the -updated fork by the Savonet/Liquidsoap project at <\fBhttps://github.com/savonet/shine\fR>. -.PP -Requires the presence of the libshine headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libshine\*(C'\fR. -.PP -See also libmp3lame. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following options are supported by the libshine wrapper. The -\&\fBshineenc\fR\-equivalent of the options are listed in parentheses. -.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4 -.IX Item "b (-b)" -Set bitrate expressed in bits/s for \s-1CBR\s0. \fBshineenc\fR \fB\-b\fR option -is expressed in kilobits/s. -.Sh "libtwolame" -.IX Subsection "libtwolame" -TwoLAME \s-1MP2\s0 encoder wrapper. -.PP -Requires the presence of the libtwolame headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libtwolame\*(C'\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following options are supported by the libtwolame wrapper. The -\&\fBtwolame\fR\-equivalent options follow the FFmpeg ones and are in -parentheses. -.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4 -.IX Item "b (-b)" -Set bitrate expressed in bits/s for \s-1CBR\s0. \fBtwolame\fR \fBb\fR -option is expressed in kilobits/s. Default value is 128k. -.IP "\fBq (\fR\fI\-V\fR\fB)\fR" 4 -.IX Item "q (-V)" -Set quality for experimental \s-1VBR\s0 support. Maximum value range is -from \-50 to 50, useful range is from \-10 to 10. The higher the -value, the better the quality. This option is valid only using the -\&\fBffmpeg\fR command-line tool. For library interface users, -use \fBglobal_quality\fR. -.IP "\fBmode (\fR\fI\-\-mode\fR\fB)\fR" 4 -.IX Item "mode (--mode)" -Set the mode of the resulting audio. Possible values: -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -Choose mode automatically based on the input. This is the default. -.IP "\fBstereo\fR" 4 -.IX Item "stereo" -Stereo -.IP "\fBjoint_stereo\fR" 4 -.IX Item "joint_stereo" -Joint stereo -.IP "\fBdual_channel\fR" 4 -.IX Item "dual_channel" -Dual channel -.IP "\fBmono\fR" 4 -.IX Item "mono" -Mono -.RE -.RS 4 -.RE -.IP "\fBpsymodel (\fR\fI\-\-psyc\-mode\fR\fB)\fR" 4 -.IX Item "psymodel (--psyc-mode)" -Set psychoacoustic model to use in encoding. The argument must be -an integer between \-1 and 4, inclusive. The higher the value, the -better the quality. The default value is 3. -.IP "\fBenergy_levels (\fR\fI\-\-energy\fR\fB)\fR" 4 -.IX Item "energy_levels (--energy)" -Enable energy levels extensions when set to 1. The default value is -0 (disabled). -.IP "\fBerror_protection (\fR\fI\-\-protect\fR\fB)\fR" 4 -.IX Item "error_protection (--protect)" -Enable \s-1CRC\s0 error protection when set to 1. The default value is 0 -(disabled). -.IP "\fBcopyright (\fR\fI\-\-copyright\fR\fB)\fR" 4 -.IX Item "copyright (--copyright)" -Set \s-1MPEG\s0 audio copyright flag when set to 1. The default value is 0 -(disabled). -.IP "\fBoriginal (\fR\fI\-\-original\fR\fB)\fR" 4 -.IX Item "original (--original)" -Set \s-1MPEG\s0 audio original flag when set to 1. The default value is 0 -(disabled). -.Sh "libvo-aacenc" -.IX Subsection "libvo-aacenc" -VisualOn \s-1AAC\s0 encoder. -.PP -Requires the presence of the libvo-aacenc headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libvo\-aacenc \-\-enable\-version3\*(C'\fR. -.PP -This encoder is considered to be worse than the -native experimental FFmpeg \s-1AAC\s0 encoder, according to -multiple sources. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The VisualOn \s-1AAC\s0 encoder only support encoding AAC-LC and up to 2 -channels. It is also CBR\-only. -.IP "\fBb\fR" 4 -.IX Item "b" -Set bit rate in bits/s. -.Sh "libvo-amrwbenc" -.IX Subsection "libvo-amrwbenc" -VisualOn Adaptive Multi-Rate Wideband encoder. -.PP -Requires the presence of the libvo-amrwbenc headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libvo\-amrwbenc \-\-enable\-version3\*(C'\fR. -.PP -This is a mono-only encoder. Officially it only supports 16000Hz sample -rate, but you can override it by setting \fBstrict\fR to -\&\fBunofficial\fR or lower. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBb\fR" 4 -.IX Item "b" -Set bitrate in bits/s. Only the following bitrates are supported, otherwise -libavcodec will round to the nearest valid bitrate. -.RS 4 -.IP "\fB6600\fR" 4 -.IX Item "6600" -.PD 0 -.IP "\fB8850\fR" 4 -.IX Item "8850" -.IP "\fB12650\fR" 4 -.IX Item "12650" -.IP "\fB14250\fR" 4 -.IX Item "14250" -.IP "\fB15850\fR" 4 -.IX Item "15850" -.IP "\fB18250\fR" 4 -.IX Item "18250" -.IP "\fB19850\fR" 4 -.IX Item "19850" -.IP "\fB23050\fR" 4 -.IX Item "23050" -.IP "\fB23850\fR" 4 -.IX Item "23850" -.RE -.RS 4 -.RE -.IP "\fBdtx\fR" 4 -.IX Item "dtx" -.PD -Allow discontinuous transmission (generate comfort noise) when set to 1. The -default value is 0 (disabled). -.Sh "libopus" -.IX Subsection "libopus" -libopus Opus Interactive Audio Codec encoder wrapper. -.PP -Requires the presence of the libopus headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libopus\*(C'\fR. -.PP -\fIOption Mapping\fR -.IX Subsection "Option Mapping" -.PP -Most libopus options are modeled after the \fBopusenc\fR utility from -opus\-tools. The following is an option mapping chart describing options -supported by the libopus wrapper, and their \fBopusenc\fR\-equivalent -in parentheses. -.IP "\fBb (\fR\fIbitrate\fR\fB)\fR" 4 -.IX Item "b (bitrate)" -Set the bit rate in bits/s. FFmpeg's \fBb\fR option is -expressed in bits/s, while \fBopusenc\fR's \fBbitrate\fR in -kilobits/s. -.IP "\fBvbr (\fR\fIvbr\fR\fB,\fR \fIhard-cbr\fR\fB, and\fR \fIcvbr\fR\fB)\fR" 4 -.IX Item "vbr (vbr, hard-cbr, and cvbr)" -Set \s-1VBR\s0 mode. The FFmpeg \fBvbr\fR option has the following -valid arguments, with the their \fBopusenc\fR equivalent options -in parentheses: -.RS 4 -.IP "\fBoff (\fR\fIhard-cbr\fR\fB)\fR" 4 -.IX Item "off (hard-cbr)" -Use constant bit rate encoding. -.IP "\fBon (\fR\fIvbr\fR\fB)\fR" 4 -.IX Item "on (vbr)" -Use variable bit rate encoding (the default). -.IP "\fBconstrained (\fR\fIcvbr\fR\fB)\fR" 4 -.IX Item "constrained (cvbr)" -Use constrained variable bit rate encoding. -.RE -.RS 4 -.RE -.IP "\fBcompression_level (\fR\fIcomp\fR\fB)\fR" 4 -.IX Item "compression_level (comp)" -Set encoding algorithm complexity. Valid options are integers in -the 0\-10 range. 0 gives the fastest encodes but lower quality, while 10 -gives the highest quality but slowest encoding. The default is 10. -.IP "\fBframe_duration (\fR\fIframesize\fR\fB)\fR" 4 -.IX Item "frame_duration (framesize)" -Set maximum frame size, or duration of a frame in milliseconds. The -argument must be exactly the following: 2.5, 5, 10, 20, 40, 60. Smaller -frame sizes achieve lower latency but less quality at a given bitrate. -Sizes greater than 20ms are only interesting at fairly low bitrates. -The default of FFmpeg is 10ms, but is 20ms in \fBopusenc\fR. -.IP "\fBpacket_loss (\fR\fIexpect-loss\fR\fB)\fR" 4 -.IX Item "packet_loss (expect-loss)" -Set expected packet loss percentage. The default is 0. -.IP "\fBapplication (N.A.)\fR" 4 -.IX Item "application (N.A.)" -Set intended application type. Valid options are listed below: -.RS 4 -.IP "\fBvoip\fR" 4 -.IX Item "voip" -Favor improved speech intelligibility. -.IP "\fBaudio\fR" 4 -.IX Item "audio" -Favor faithfulness to the input (the default). -.IP "\fBlowdelay\fR" 4 -.IX Item "lowdelay" -Restrict to only the lowest delay modes. -.RE -.RS 4 -.RE -.IP "\fBcutoff (N.A.)\fR" 4 -.IX Item "cutoff (N.A.)" -Set cutoff bandwidth in Hz. The argument must be exactly one of the -following: 4000, 6000, 8000, 12000, or 20000, corresponding to -narrowband, mediumband, wideband, super wideband, and fullband -respectively. The default is 0 (cutoff disabled). -.Sh "libvorbis" -.IX Subsection "libvorbis" -libvorbis encoder wrapper. -.PP -Requires the presence of the libvorbisenc headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libvorbis\*(C'\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following options are supported by the libvorbis wrapper. The -\&\fBoggenc\fR\-equivalent of the options are listed in parentheses. -.PP -To get a more accurate and extensive documentation of the libvorbis -options, consult the libvorbisenc's and \fBoggenc\fR's documentations. -See <\fBhttp://xiph.org/vorbis/\fR>, -<\fBhttp://wiki.xiph.org/Vorbis\-tools\fR>, and \fIoggenc\fR\|(1). -.IP "\fBb (\fR\fI\-b\fR\fB)\fR" 4 -.IX Item "b (-b)" -Set bitrate expressed in bits/s for \s-1ABR\s0. \fBoggenc\fR \fB\-b\fR is -expressed in kilobits/s. -.IP "\fBq (\fR\fI\-q\fR\fB)\fR" 4 -.IX Item "q (-q)" -Set constant quality setting for \s-1VBR\s0. The value should be a float -number in the range of \-1.0 to 10.0. The higher the value, the better -the quality. The default value is \fB3.0\fR. -.Sp -This option is valid only using the \fBffmpeg\fR command-line tool. -For library interface users, use \fBglobal_quality\fR. -.IP "\fBcutoff (\fR\fI\-\-advanced\-encode\-option lowpass_frequency=N\fR\fB)\fR" 4 -.IX Item "cutoff (--advanced-encode-option lowpass_frequency=N)" -Set cutoff bandwidth in Hz, a value of 0 disables cutoff. \fBoggenc\fR's -related option is expressed in kHz. The default value is \fB0\fR (cutoff -disabled). -.IP "\fBminrate (\fR\fI\-m\fR\fB)\fR" 4 -.IX Item "minrate (-m)" -Set minimum bitrate expressed in bits/s. \fBoggenc\fR \fB\-m\fR is -expressed in kilobits/s. -.IP "\fBmaxrate (\fR\fI\-M\fR\fB)\fR" 4 -.IX Item "maxrate (-M)" -Set maximum bitrate expressed in bits/s. \fBoggenc\fR \fB\-M\fR is -expressed in kilobits/s. This only has effect on \s-1ABR\s0 mode. -.IP "\fBiblock (\fR\fI\-\-advanced\-encode\-option impulse_noisetune=N\fR\fB)\fR" 4 -.IX Item "iblock (--advanced-encode-option impulse_noisetune=N)" -Set noise floor bias for impulse blocks. The value is a float number from -\&\-15.0 to 0.0. A negative bias instructs the encoder to pay special attention -to the crispness of transients in the encoded audio. The tradeoff for better -transient response is a higher bitrate. -.Sh "libwavpack" -.IX Subsection "libwavpack" -A wrapper providing WavPack encoding through libwavpack. -.PP -Only lossless mode using 32\-bit integer samples is supported currently. -The \fBcompression_level\fR option can be used to control speed vs. -compression tradeoff, with the values mapped to libwavpack as follows: -.IP "\fB0\fR" 4 -.IX Item "0" -Fast mode \- corresponding to the wavpack \fB\-f\fR option. -.IP "\fB1\fR" 4 -.IX Item "1" -Normal (default) settings. -.IP "\fB2\fR" 4 -.IX Item "2" -High quality \- corresponding to the wavpack \fB\-h\fR option. -.IP "\fB3\fR" 4 -.IX Item "3" -Very high quality \- corresponding to the wavpack \fB\-hh\fR option. -.IP "\fB4\-8\fR" 4 -.IX Item "4-8" -Same as 3, but with extra processing enabled \- corresponding to the wavpack -\&\fB\-x\fR option. I.e. 4 is the same as \fB\-x2\fR and 8 is the same as -\&\fB\-x6\fR. -.SH "VIDEO ENCODERS" -.IX Header "VIDEO ENCODERS" -A description of some of the currently available video encoders -follows. -.Sh "libtheora" -.IX Subsection "libtheora" -Theora format supported through libtheora. -.PP -Requires the presence of the libtheora headers and library during -configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libtheora\*(C'\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following global options are mapped to internal libtheora options -which affect the quality and the bitrate of the encoded stream. -.IP "\fBb\fR" 4 -.IX Item "b" -Set the video bitrate, only works if the \f(CW\*(C`qscale\*(C'\fR flag in -\&\fBflags\fR is not enabled. -.IP "\fBflags\fR" 4 -.IX Item "flags" -Used to enable constant quality mode encoding through the -\&\fBqscale\fR flag, and to enable the \f(CW\*(C`pass1\*(C'\fR and \f(CW\*(C`pass2\*(C'\fR -modes. -.IP "\fBg\fR" 4 -.IX Item "g" -Set the \s-1GOP\s0 size. -.IP "\fBglobal_quality\fR" 4 -.IX Item "global_quality" -Set the global quality in lambda units, only works if the -\&\f(CW\*(C`qscale\*(C'\fR flag in \fBflags\fR is enabled. The value is clipped -in the [0 \- 10*\f(CW\*(C`FF_QP2LAMBDA\*(C'\fR] range, and then multiplied for 6.3 -to get a value in the native libtheora range [0\-63]. A higher value -corresponds to a higher quality. -.Sp -For example, to set maximum constant quality encoding with -\&\fBffmpeg\fR: -.Sp -.Vb 1 -\& ffmpeg -i INPUT -flags:v qscale -global_quality:v "10*QP2LAMBDA" -codec:v libtheora OUTPUT.ogg -.Ve -.Sh "libvpx" -.IX Subsection "libvpx" -\&\s-1VP8\s0 format supported through libvpx. -.PP -Requires the presence of the libvpx headers and library during configuration. -You need to explicitly configure the build with \f(CW\*(C`\-\-enable\-libvpx\*(C'\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -Mapping from FFmpeg to libvpx options with conversion notes in parentheses. -.IP "\fBthreads\fR" 4 -.IX Item "threads" -g_threads -.IP "\fBprofile\fR" 4 -.IX Item "profile" -g_profile -.IP "\fBvb\fR" 4 -.IX Item "vb" -rc_target_bitrate -.IP "\fBg\fR" 4 -.IX Item "g" -kf_max_dist -.IP "\fBkeyint_min\fR" 4 -.IX Item "keyint_min" -kf_min_dist -.IP "\fBqmin\fR" 4 -.IX Item "qmin" -rc_min_quantizer -.IP "\fBqmax\fR" 4 -.IX Item "qmax" -rc_max_quantizer -.IP "\fBbufsize, vb\fR" 4 -.IX Item "bufsize, vb" -rc_buf_sz -\&\f(CW\*(C`(bufsize * 1000 / vb)\*(C'\fR -.Sp -rc_buf_optimal_sz -\&\f(CW\*(C`(bufsize * 1000 / vb * 5 / 6)\*(C'\fR -.IP "\fBrc_init_occupancy, vb\fR" 4 -.IX Item "rc_init_occupancy, vb" -rc_buf_initial_sz -\&\f(CW\*(C`(rc_init_occupancy * 1000 / vb)\*(C'\fR -.IP "\fBrc_buffer_aggressivity\fR" 4 -.IX Item "rc_buffer_aggressivity" -rc_undershoot_pct -.IP "\fBskip_threshold\fR" 4 -.IX Item "skip_threshold" -rc_dropframe_thresh -.IP "\fBqcomp\fR" 4 -.IX Item "qcomp" -rc_2pass_vbr_bias_pct -.IP "\fBmaxrate, vb\fR" 4 -.IX Item "maxrate, vb" -rc_2pass_vbr_maxsection_pct -\&\f(CW\*(C`(maxrate * 100 / vb)\*(C'\fR -.IP "\fBminrate, vb\fR" 4 -.IX Item "minrate, vb" -rc_2pass_vbr_minsection_pct -\&\f(CW\*(C`(minrate * 100 / vb)\*(C'\fR -.IP "\fBminrate, maxrate, vb\fR" 4 -.IX Item "minrate, maxrate, vb" -\&\f(CW\*(C`VPX_CBR\*(C'\fR -\&\f(CW\*(C`(minrate == maxrate == vb)\*(C'\fR -.IP "\fBcrf\fR" 4 -.IX Item "crf" -\&\f(CW\*(C`VPX_CQ\*(C'\fR, \f(CW\*(C`VP8E_SET_CQ_LEVEL\*(C'\fR -.IP "\fBquality\fR" 4 -.IX Item "quality" -.RS 4 -.PD 0 -.IP "\fIbest\fR" 4 -.IX Item "best" -.PD -\&\f(CW\*(C`VPX_DL_BEST_QUALITY\*(C'\fR -.IP "\fIgood\fR" 4 -.IX Item "good" -\&\f(CW\*(C`VPX_DL_GOOD_QUALITY\*(C'\fR -.IP "\fIrealtime\fR" 4 -.IX Item "realtime" -\&\f(CW\*(C`VPX_DL_REALTIME\*(C'\fR -.RE -.RS 4 -.RE -.IP "\fBspeed\fR" 4 -.IX Item "speed" -\&\f(CW\*(C`VP8E_SET_CPUUSED\*(C'\fR -.IP "\fBnr\fR" 4 -.IX Item "nr" -\&\f(CW\*(C`VP8E_SET_NOISE_SENSITIVITY\*(C'\fR -.IP "\fBmb_threshold\fR" 4 -.IX Item "mb_threshold" -\&\f(CW\*(C`VP8E_SET_STATIC_THRESHOLD\*(C'\fR -.IP "\fBslices\fR" 4 -.IX Item "slices" -\&\f(CW\*(C`VP8E_SET_TOKEN_PARTITIONS\*(C'\fR -.IP "\fBmax-intra-rate\fR" 4 -.IX Item "max-intra-rate" -\&\f(CW\*(C`VP8E_SET_MAX_INTRA_BITRATE_PCT\*(C'\fR -.IP "\fBforce_key_frames\fR" 4 -.IX Item "force_key_frames" -\&\f(CW\*(C`VPX_EFLAG_FORCE_KF\*(C'\fR -.IP "\fBAlternate reference frame related\fR" 4 -.IX Item "Alternate reference frame related" -.RS 4 -.PD 0 -.IP "\fBvp8flags altref\fR" 4 -.IX Item "vp8flags altref" -.PD -\&\f(CW\*(C`VP8E_SET_ENABLEAUTOALTREF\*(C'\fR -.IP "\fIarnr_max_frames\fR" 4 -.IX Item "arnr_max_frames" -\&\f(CW\*(C`VP8E_SET_ARNR_MAXFRAMES\*(C'\fR -.IP "\fIarnr_type\fR" 4 -.IX Item "arnr_type" -\&\f(CW\*(C`VP8E_SET_ARNR_TYPE\*(C'\fR -.IP "\fIarnr_strength\fR" 4 -.IX Item "arnr_strength" -\&\f(CW\*(C`VP8E_SET_ARNR_STRENGTH\*(C'\fR -.IP "\fIrc_lookahead\fR" 4 -.IX Item "rc_lookahead" -g_lag_in_frames -.RE -.RS 4 -.RE -.IP "\fBvp8flags error_resilient\fR" 4 -.IX Item "vp8flags error_resilient" -g_error_resilient -.PP -For more information about libvpx see: -<\fBhttp://www.webmproject.org/\fR> -.Sh "libx264" -.IX Subsection "libx264" -x264 H.264/MPEG\-4 \s-1AVC\s0 encoder wrapper. -.PP -This encoder requires the presence of the libx264 headers and library -during configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libx264\*(C'\fR. -.PP -libx264 supports an impressive number of features, including 8x8 and -4x4 adaptive spatial transform, adaptive B\-frame placement, \s-1CAVLC/CABAC\s0 -entropy coding, interlacing (\s-1MBAFF\s0), lossless mode, psy optimizations -for detail retention (adaptive quantization, psy\-RD, psy\-trellis). -.PP -Many libx264 encoder options are mapped to FFmpeg global codec -options, while unique encoder options are provided through private -options. Additionally the \fBx264opts\fR and \fBx264\-params\fR -private options allows to pass a list of key=value tuples as accepted -by the libx264 \f(CW\*(C`x264_param_parse\*(C'\fR function. -.PP -The x264 project website is at -<\fBhttp://www.videolan.org/developers/x264.html\fR>. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following options are supported by the libx264 wrapper. The -\&\fBx264\fR\-equivalent options or values are listed in parentheses -for easy migration. -.PP -To reduce the duplication of documentation, only the private options -and some others requiring special attention are documented here. For -the documentation of the undocumented generic options, see -the Codec Options chapter. -.PP -To get a more accurate and extensive documentation of the libx264 -options, invoke the command \fBx264 \-\-full\-help\fR or consult -the libx264 documentation. -.IP "\fBb (\fR\fIbitrate\fR\fB)\fR" 4 -.IX Item "b (bitrate)" -Set bitrate in bits/s. Note that FFmpeg's \fBb\fR option is -expressed in bits/s, while \fBx264\fR's \fBbitrate\fR is in -kilobits/s. -.IP "\fBbf (\fR\fIbframes\fR\fB)\fR" 4 -.IX Item "bf (bframes)" -.PD 0 -.IP "\fBg (\fR\fIkeyint\fR\fB)\fR" 4 -.IX Item "g (keyint)" -.IP "\fBqmax (\fR\fIqpmax\fR\fB)\fR" 4 -.IX Item "qmax (qpmax)" -.IP "\fBqmin (\fR\fIqpmin\fR\fB)\fR" 4 -.IX Item "qmin (qpmin)" -.IP "\fBqdiff (\fR\fIqpstep\fR\fB)\fR" 4 -.IX Item "qdiff (qpstep)" -.IP "\fBqblur (\fR\fIqblur\fR\fB)\fR" 4 -.IX Item "qblur (qblur)" -.IP "\fBqcomp (\fR\fIqcomp\fR\fB)\fR" 4 -.IX Item "qcomp (qcomp)" -.IP "\fBrefs (\fR\fIref\fR\fB)\fR" 4 -.IX Item "refs (ref)" -.IP "\fBsc_threshold (\fR\fIscenecut\fR\fB)\fR" 4 -.IX Item "sc_threshold (scenecut)" -.IP "\fBtrellis (\fR\fItrellis\fR\fB)\fR" 4 -.IX Item "trellis (trellis)" -.IP "\fBnr (\fR\fInr\fR\fB)\fR" 4 -.IX Item "nr (nr)" -.IP "\fBme_range (\fR\fImerange\fR\fB)\fR" 4 -.IX Item "me_range (merange)" -.IP "\fBme_method (\fR\fIme\fR\fB)\fR" 4 -.IX Item "me_method (me)" -.PD -Set motion estimation method. Possible values in the decreasing order -of speed: -.RS 4 -.IP "\fBdia (\fR\fIdia\fR\fB)\fR" 4 -.IX Item "dia (dia)" -.PD 0 -.IP "\fBepzs (\fR\fIdia\fR\fB)\fR" 4 -.IX Item "epzs (dia)" -.PD -Diamond search with radius 1 (fastest). \fBepzs\fR is an alias for -\&\fBdia\fR. -.IP "\fBhex (\fR\fIhex\fR\fB)\fR" 4 -.IX Item "hex (hex)" -Hexagonal search with radius 2. -.IP "\fBumh (\fR\fIumh\fR\fB)\fR" 4 -.IX Item "umh (umh)" -Uneven multi-hexagon search. -.IP "\fBesa (\fR\fIesa\fR\fB)\fR" 4 -.IX Item "esa (esa)" -Exhaustive search. -.IP "\fBtesa (\fR\fItesa\fR\fB)\fR" 4 -.IX Item "tesa (tesa)" -Hadamard exhaustive search (slowest). -.RE -.RS 4 -.RE -.IP "\fBsubq (\fR\fIsubme\fR\fB)\fR" 4 -.IX Item "subq (subme)" -.PD 0 -.IP "\fBb_strategy (\fR\fIb\-adapt\fR\fB)\fR" 4 -.IX Item "b_strategy (b-adapt)" -.IP "\fBkeyint_min (\fR\fImin-keyint\fR\fB)\fR" 4 -.IX Item "keyint_min (min-keyint)" -.IP "\fBcoder\fR" 4 -.IX Item "coder" -.PD -Set entropy encoder. Possible values: -.RS 4 -.IP "\fBac\fR" 4 -.IX Item "ac" -Enable \s-1CABAC\s0. -.IP "\fBvlc\fR" 4 -.IX Item "vlc" -Enable \s-1CAVLC\s0 and disable \s-1CABAC\s0. It generates the same effect as -\&\fBx264\fR's \fB\-\-no\-cabac\fR option. -.RE -.RS 4 -.RE -.IP "\fBcmp\fR" 4 -.IX Item "cmp" -Set full pixel motion estimation comparation algorithm. Possible values: -.RS 4 -.IP "\fBchroma\fR" 4 -.IX Item "chroma" -Enable chroma in motion estimation. -.IP "\fBsad\fR" 4 -.IX Item "sad" -Ignore chroma in motion estimation. It generates the same effect as -\&\fBx264\fR's \fB\-\-no\-chroma\-me\fR option. -.RE -.RS 4 -.RE -.IP "\fBthreads (\fR\fIthreads\fR\fB)\fR" 4 -.IX Item "threads (threads)" -.PD 0 -.IP "\fBthread_type\fR" 4 -.IX Item "thread_type" -.PD -Set multithreading technique. Possible values: -.RS 4 -.IP "\fBslice\fR" 4 -.IX Item "slice" -Slice-based multithreading. It generates the same effect as -\&\fBx264\fR's \fB\-\-sliced\-threads\fR option. -.IP "\fBframe\fR" 4 -.IX Item "frame" -Frame-based multithreading. -.RE -.RS 4 -.RE -.IP "\fBflags\fR" 4 -.IX Item "flags" -Set encoding flags. It can be used to disable closed \s-1GOP\s0 and enable -open \s-1GOP\s0 by setting it to \f(CW\*(C`\-cgop\*(C'\fR. The result is similar to -the behavior of \fBx264\fR's \fB\-\-open\-gop\fR option. -.IP "\fBrc_init_occupancy (\fR\fIvbv-init\fR\fB)\fR" 4 -.IX Item "rc_init_occupancy (vbv-init)" -.PD 0 -.IP "\fBpreset (\fR\fIpreset\fR\fB)\fR" 4 -.IX Item "preset (preset)" -.PD -Set the encoding preset. -.IP "\fBtune (\fR\fItune\fR\fB)\fR" 4 -.IX Item "tune (tune)" -Set tuning of the encoding params. -.IP "\fBprofile (\fR\fIprofile\fR\fB)\fR" 4 -.IX Item "profile (profile)" -Set profile restrictions. -.IP "\fBfastfirstpass\fR" 4 -.IX Item "fastfirstpass" -Enable fast settings when encoding first pass, when set to 1. When set -to 0, it has the same effect of \fBx264\fR's -\&\fB\-\-slow\-firstpass\fR option. -.IP "\fBcrf (\fR\fIcrf\fR\fB)\fR" 4 -.IX Item "crf (crf)" -Set the quality for constant quality mode. -.IP "\fBcrf_max (\fR\fIcrf-max\fR\fB)\fR" 4 -.IX Item "crf_max (crf-max)" -In \s-1CRF\s0 mode, prevents \s-1VBV\s0 from lowering quality beyond this point. -.IP "\fBqp (\fR\fIqp\fR\fB)\fR" 4 -.IX Item "qp (qp)" -Set constant quantization rate control method parameter. -.IP "\fBaq-mode (\fR\fIaq-mode\fR\fB)\fR" 4 -.IX Item "aq-mode (aq-mode)" -Set \s-1AQ\s0 method. Possible values: -.RS 4 -.IP "\fBnone (\fR\fI0\fR\fB)\fR" 4 -.IX Item "none (0)" -Disabled. -.IP "\fBvariance (\fR\fI1\fR\fB)\fR" 4 -.IX Item "variance (1)" -Variance \s-1AQ\s0 (complexity mask). -.IP "\fBautovariance (\fR\fI2\fR\fB)\fR" 4 -.IX Item "autovariance (2)" -Auto-variance \s-1AQ\s0 (experimental). -.RE -.RS 4 -.RE -.IP "\fBaq-strength (\fR\fIaq-strength\fR\fB)\fR" 4 -.IX Item "aq-strength (aq-strength)" -Set \s-1AQ\s0 strength, reduce blocking and blurring in flat and textured areas. -.IP "\fBpsy\fR" 4 -.IX Item "psy" -Use psychovisual optimizations when set to 1. When set to 0, it has the -same effect as \fBx264\fR's \fB\-\-no\-psy\fR option. -.IP "\fBpsy-rd (\fR\fIpsy-rd\fR\fB)\fR" 4 -.IX Item "psy-rd (psy-rd)" -Set strength of psychovisual optimization, in -\&\fIpsy-rd\fR:\fIpsy-trellis\fR format. -.IP "\fBrc-lookahead (\fR\fIrc-lookahead\fR\fB)\fR" 4 -.IX Item "rc-lookahead (rc-lookahead)" -Set number of frames to look ahead for frametype and ratecontrol. -.IP "\fBweightb\fR" 4 -.IX Item "weightb" -Enable weighted prediction for B\-frames when set to 1. When set to 0, -it has the same effect as \fBx264\fR's \fB\-\-no\-weightb\fR option. -.IP "\fBweightp (\fR\fIweightp\fR\fB)\fR" 4 -.IX Item "weightp (weightp)" -Set weighted prediction method for P\-frames. Possible values: -.RS 4 -.IP "\fBnone (\fR\fI0\fR\fB)\fR" 4 -.IX Item "none (0)" -Disabled -.IP "\fBsimple (\fR\fI1\fR\fB)\fR" 4 -.IX Item "simple (1)" -Enable only weighted refs -.IP "\fBsmart (\fR\fI2\fR\fB)\fR" 4 -.IX Item "smart (2)" -Enable both weighted refs and duplicates -.RE -.RS 4 -.RE -.IP "\fBssim (\fR\fIssim\fR\fB)\fR" 4 -.IX Item "ssim (ssim)" -Enable calculation and printing \s-1SSIM\s0 stats after the encoding. -.IP "\fBintra-refresh (\fR\fIintra-refresh\fR\fB)\fR" 4 -.IX Item "intra-refresh (intra-refresh)" -Enable the use of Periodic Intra Refresh instead of \s-1IDR\s0 frames when set -to 1. -.IP "\fBbluray-compat (\fR\fIbluray-compat\fR\fB)\fR" 4 -.IX Item "bluray-compat (bluray-compat)" -Configure the encoder to be compatible with the bluray standard. -It is a shorthand for setting \*(L"bluray\-compat=1 force\-cfr=1\*(R". -.IP "\fBb\-bias (\fR\fIb\-bias\fR\fB)\fR" 4 -.IX Item "b-bias (b-bias)" -Set the influence on how often B\-frames are used. -.IP "\fBb\-pyramid (\fR\fIb\-pyramid\fR\fB)\fR" 4 -.IX Item "b-pyramid (b-pyramid)" -Set method for keeping of some B\-frames as references. Possible values: -.RS 4 -.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4 -.IX Item "none (none)" -Disabled. -.IP "\fBstrict (\fR\fIstrict\fR\fB)\fR" 4 -.IX Item "strict (strict)" -Strictly hierarchical pyramid. -.IP "\fBnormal (\fR\fInormal\fR\fB)\fR" 4 -.IX Item "normal (normal)" -Non-strict (not Blu-ray compatible). -.RE -.RS 4 -.RE -.IP "\fBmixed-refs\fR" 4 -.IX Item "mixed-refs" -Enable the use of one reference per partition, as opposed to one -reference per macroblock when set to 1. When set to 0, it has the -same effect as \fBx264\fR's \fB\-\-no\-mixed\-refs\fR option. -.IP "\fB8x8dct\fR" 4 -.IX Item "8x8dct" -Enable adaptive spatial transform (high profile 8x8 transform) -when set to 1. When set to 0, it has the same effect as -\&\fBx264\fR's \fB\-\-no\-8x8dct\fR option. -.IP "\fBfast-pskip\fR" 4 -.IX Item "fast-pskip" -Enable early \s-1SKIP\s0 detection on P\-frames when set to 1. When set -to 0, it has the same effect as \fBx264\fR's -\&\fB\-\-no\-fast\-pskip\fR option. -.IP "\fBaud (\fR\fIaud\fR\fB)\fR" 4 -.IX Item "aud (aud)" -Enable use of access unit delimiters when set to 1. -.IP "\fBmbtree\fR" 4 -.IX Item "mbtree" -Enable use macroblock tree ratecontrol when set to 1. When set -to 0, it has the same effect as \fBx264\fR's -\&\fB\-\-no\-mbtree\fR option. -.IP "\fBdeblock (\fR\fIdeblock\fR\fB)\fR" 4 -.IX Item "deblock (deblock)" -Set loop filter parameters, in \fIalpha\fR:\fIbeta\fR form. -.IP "\fBcplxblur (\fR\fIcplxblur\fR\fB)\fR" 4 -.IX Item "cplxblur (cplxblur)" -Set fluctuations reduction in \s-1QP\s0 (before curve compression). -.IP "\fBpartitions (\fR\fIpartitions\fR\fB)\fR" 4 -.IX Item "partitions (partitions)" -Set partitions to consider as a comma-separated list of. Possible -values in the list: -.RS 4 -.IP "\fBp8x8\fR" 4 -.IX Item "p8x8" -8x8 P\-frame partition. -.IP "\fBp4x4\fR" 4 -.IX Item "p4x4" -4x4 P\-frame partition. -.IP "\fBb8x8\fR" 4 -.IX Item "b8x8" -4x4 B\-frame partition. -.IP "\fBi8x8\fR" 4 -.IX Item "i8x8" -8x8 I\-frame partition. -.IP "\fBi4x4\fR" 4 -.IX Item "i4x4" -4x4 I\-frame partition. -(Enabling \fBp4x4\fR requires \fBp8x8\fR to be enabled. Enabling -\&\fBi8x8\fR requires adaptive spatial transform (\fB8x8dct\fR -option) to be enabled.) -.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4 -.IX Item "none (none)" -Do not consider any partitions. -.IP "\fBall (\fR\fIall\fR\fB)\fR" 4 -.IX Item "all (all)" -Consider every partition. -.RE -.RS 4 -.RE -.IP "\fBdirect-pred (\fR\fIdirect\fR\fB)\fR" 4 -.IX Item "direct-pred (direct)" -Set direct \s-1MV\s0 prediction mode. Possible values: -.RS 4 -.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4 -.IX Item "none (none)" -Disable \s-1MV\s0 prediction. -.IP "\fBspatial (\fR\fIspatial\fR\fB)\fR" 4 -.IX Item "spatial (spatial)" -Enable spatial predicting. -.IP "\fBtemporal (\fR\fItemporal\fR\fB)\fR" 4 -.IX Item "temporal (temporal)" -Enable temporal predicting. -.IP "\fBauto (\fR\fIauto\fR\fB)\fR" 4 -.IX Item "auto (auto)" -Automatically decided. -.RE -.RS 4 -.RE -.IP "\fBslice-max-size (\fR\fIslice-max-size\fR\fB)\fR" 4 -.IX Item "slice-max-size (slice-max-size)" -Set the limit of the size of each slice in bytes. If not specified -but \s-1RTP\s0 payload size (\fBps\fR) is specified, that is used. -.IP "\fBstats (\fR\fIstats\fR\fB)\fR" 4 -.IX Item "stats (stats)" -Set the file name for multi-pass stats. -.IP "\fBnal-hrd (\fR\fInal-hrd\fR\fB)\fR" 4 -.IX Item "nal-hrd (nal-hrd)" -Set signal \s-1HRD\s0 information (requires \fBvbv-bufsize\fR to be set). -Possible values: -.RS 4 -.IP "\fBnone (\fR\fInone\fR\fB)\fR" 4 -.IX Item "none (none)" -Disable \s-1HRD\s0 information signaling. -.IP "\fBvbr (\fR\fIvbr\fR\fB)\fR" 4 -.IX Item "vbr (vbr)" -Variable bit rate. -.IP "\fBcbr (\fR\fIcbr\fR\fB)\fR" 4 -.IX Item "cbr (cbr)" -Constant bit rate (not allowed in \s-1MP4\s0 container). -.RE -.RS 4 -.RE -.IP "\fBx264opts (N.A.)\fR" 4 -.IX Item "x264opts (N.A.)" -Set any x264 option, see \fBx264 \-\-fullhelp\fR for a list. -.Sp -Argument is a list of \fIkey\fR=\fIvalue\fR couples separated by -\&\*(L":\*(R". In \fIfilter\fR and \fIpsy-rd\fR options that use \*(L":\*(R" as a separator -themselves, use \*(L",\*(R" instead. They accept it as well since long ago but this -is kept undocumented for some reason. -.Sp -For example to specify libx264 encoding options with \fBffmpeg\fR: -.Sp -.Vb 1 -\& ffmpeg -i foo.mpg -vcodec libx264 -x264opts keyint=123:min-keyint=20 -an out.mkv -.Ve -.IP "\fBx264\-params (N.A.)\fR" 4 -.IX Item "x264-params (N.A.)" -Override the x264 configuration using a :\-separated list of key=value -parameters. -.Sp -This option is functionally the same as the \fBx264opts\fR, but is -duplicated for compability with the Libav fork. -.Sp -For example to specify libx264 encoding options with \fBffmpeg\fR: -.Sp -.Vb 3 -\& ffmpeg -i INPUT -c:v libx264 -x264-params level=30:bframes=0:weightp=0:\e -\& cabac=0:ref=1:vbv-maxrate=768:vbv-bufsize=2000:analyse=all:me=umh:\e -\& no-fast-pskip=1:subq=6:8x8dct=0:trellis=0 OUTPUT -.Ve -.PP -Encoding ffpresets for common usages are provided so they can be used with the -general presets system (e.g. passing the \fBpre\fR option). -.Sh "libxvid" -.IX Subsection "libxvid" -Xvid \s-1MPEG\-4\s0 Part 2 encoder wrapper. -.PP -This encoder requires the presence of the libxvidcore headers and library -during configuration. You need to explicitly configure the build with -\&\f(CW\*(C`\-\-enable\-libxvid \-\-enable\-gpl\*(C'\fR. -.PP -The native \f(CW\*(C`mpeg4\*(C'\fR encoder supports the \s-1MPEG\-4\s0 Part 2 format, so -users can encode to this format without this library. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -The following options are supported by the libxvid wrapper. Some of -the following options are listed but are not documented, and -correspond to shared codec options. See the Codec -Options chapter for their documentation. The other shared options -which are not listed have no effect for the libxvid encoder. -.IP "\fBb\fR" 4 -.IX Item "b" -.PD 0 -.IP "\fBg\fR" 4 -.IX Item "g" -.IP "\fBqmin\fR" 4 -.IX Item "qmin" -.IP "\fBqmax\fR" 4 -.IX Item "qmax" -.IP "\fBmpeg_quant\fR" 4 -.IX Item "mpeg_quant" -.IP "\fBthreads\fR" 4 -.IX Item "threads" -.IP "\fBbf\fR" 4 -.IX Item "bf" -.IP "\fBb_qfactor\fR" 4 -.IX Item "b_qfactor" -.IP "\fBb_qoffset\fR" 4 -.IX Item "b_qoffset" -.IP "\fBflags\fR" 4 -.IX Item "flags" -.PD -Set specific encoding flags. Possible values: -.RS 4 -.IP "\fBmv4\fR" 4 -.IX Item "mv4" -Use four motion vector by macroblock. -.IP "\fBaic\fR" 4 -.IX Item "aic" -Enable high quality \s-1AC\s0 prediction. -.IP "\fBgray\fR" 4 -.IX Item "gray" -Only encode grayscale. -.IP "\fBgmc\fR" 4 -.IX Item "gmc" -Enable the use of global motion compensation (\s-1GMC\s0). -.IP "\fBqpel\fR" 4 -.IX Item "qpel" -Enable quarter-pixel motion compensation. -.IP "\fBcgop\fR" 4 -.IX Item "cgop" -Enable closed \s-1GOP\s0. -.IP "\fBglobal_header\fR" 4 -.IX Item "global_header" -Place global headers in extradata instead of every keyframe. -.RE -.RS 4 -.RE -.IP "\fBtrellis\fR" 4 -.IX Item "trellis" -.PD 0 -.IP "\fBme_method\fR" 4 -.IX Item "me_method" -.PD -Set motion estimation method. Possible values in decreasing order of -speed and increasing order of quality: -.RS 4 -.IP "\fBzero\fR" 4 -.IX Item "zero" -Use no motion estimation (default). -.IP "\fBphods\fR" 4 -.IX Item "phods" -.PD 0 -.IP "\fBx1\fR" 4 -.IX Item "x1" -.IP "\fBlog\fR" 4 -.IX Item "log" -.PD -Enable advanced diamond zonal search for 16x16 blocks and half-pixel -refinement for 16x16 blocks. \fBx1\fR and \fBlog\fR are aliases for -\&\fBphods\fR. -.IP "\fBepzs\fR" 4 -.IX Item "epzs" -Enable all of the things described above, plus advanced diamond zonal -search for 8x8 blocks, half-pixel refinement for 8x8 blocks, and motion -estimation on chroma planes. -.IP "\fBfull\fR" 4 -.IX Item "full" -Enable all of the things described above, plus extended 16x16 and 8x8 -blocks search. -.RE -.RS 4 -.RE -.IP "\fBmbd\fR" 4 -.IX Item "mbd" -Set macroblock decision algorithm. Possible values in the increasing -order of quality: -.RS 4 -.IP "\fBsimple\fR" 4 -.IX Item "simple" -Use macroblock comparing function algorithm (default). -.IP "\fBbits\fR" 4 -.IX Item "bits" -Enable rate distortion-based half pixel and quarter pixel refinement for -16x16 blocks. -.IP "\fBrd\fR" 4 -.IX Item "rd" -Enable all of the things described above, plus rate distortion-based -half pixel and quarter pixel refinement for 8x8 blocks, and rate -distortion-based search using square pattern. -.RE -.RS 4 -.RE -.IP "\fBlumi_aq\fR" 4 -.IX Item "lumi_aq" -Enable lumi masking adaptive quantization when set to 1. Default is 0 -(disabled). -.IP "\fBvariance_aq\fR" 4 -.IX Item "variance_aq" -Enable variance adaptive quantization when set to 1. Default is 0 -(disabled). -.Sp -When combined with \fBlumi_aq\fR, the resulting quality will not -be better than any of the two specified individually. In other -words, the resulting quality will be the worse one of the two -effects. -.IP "\fBssim\fR" 4 -.IX Item "ssim" -Set structural similarity (\s-1SSIM\s0) displaying method. Possible values: -.RS 4 -.IP "\fBoff\fR" 4 -.IX Item "off" -Disable displaying of \s-1SSIM\s0 information. -.IP "\fBavg\fR" 4 -.IX Item "avg" -Output average \s-1SSIM\s0 at the end of encoding to stdout. The format of -showing the average \s-1SSIM\s0 is: -.Sp -.Vb 1 -\& Average SSIM: %f -.Ve -.Sp -For users who are not familiar with C, \f(CW%f\fR means a float number, or -a decimal (e.g. 0.939232). -.IP "\fBframe\fR" 4 -.IX Item "frame" -Output both per-frame \s-1SSIM\s0 data during encoding and average \s-1SSIM\s0 at -the end of encoding to stdout. The format of per-frame information -is: -.Sp -.Vb 1 -\& SSIM: avg: %1.3f min: %1.3f max: %1.3f -.Ve -.Sp -For users who are not familiar with C, \f(CW%1\fR.3f means a float number -rounded to 3 digits after the dot (e.g. 0.932). -.RE -.RS 4 -.RE -.IP "\fBssim_acc\fR" 4 -.IX Item "ssim_acc" -Set \s-1SSIM\s0 accuracy. Valid options are integers within the range of -0\-4, while 0 gives the most accurate result and 4 computes the -fastest. -.Sh "png" -.IX Subsection "png" -\&\s-1PNG\s0 image encoder. -.PP -\fIPrivate options\fR -.IX Subsection "Private options" -.IP "\fBdpi\fR \fIinteger\fR" 4 -.IX Item "dpi integer" -Set physical density of pixels, in dots per inch, unset by default -.IP "\fBdpm\fR \fIinteger\fR" 4 -.IX Item "dpm integer" -Set physical density of pixels, in dots per meter, unset by default -.Sh "ProRes" -.IX Subsection "ProRes" -Apple ProRes encoder. -.PP -FFmpeg contains 2 ProRes encoders, the prores-aw and prores-ks encoder. -The used encoder can be choosen with the \f(CW\*(C`\-vcodec\*(C'\fR option. -.PP -\fIPrivate Options for prores-ks\fR -.IX Subsection "Private Options for prores-ks" -.IP "\fBprofile\fR \fIinteger\fR" 4 -.IX Item "profile integer" -Select the ProRes profile to encode -.RS 4 -.IP "\fBproxy\fR" 4 -.IX Item "proxy" -.PD 0 -.IP "\fBlt\fR" 4 -.IX Item "lt" -.IP "\fBstandard\fR" 4 -.IX Item "standard" -.IP "\fBhq\fR" 4 -.IX Item "hq" -.IP "\fB4444\fR" 4 -.IX Item "4444" -.RE -.RS 4 -.RE -.IP "\fBquant_mat\fR \fIinteger\fR" 4 -.IX Item "quant_mat integer" -.PD -Select quantization matrix. -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -.PD 0 -.IP "\fBdefault\fR" 4 -.IX Item "default" -.IP "\fBproxy\fR" 4 -.IX Item "proxy" -.IP "\fBlt\fR" 4 -.IX Item "lt" -.IP "\fBstandard\fR" 4 -.IX Item "standard" -.IP "\fBhq\fR" 4 -.IX Item "hq" -.RE -.RS 4 -.PD -.Sp -If set to \fIauto\fR, the matrix matching the profile will be picked. -If not set, the matrix providing the highest quality, \fIdefault\fR, will be -picked. -.RE -.IP "\fBbits_per_mb\fR \fIinteger\fR" 4 -.IX Item "bits_per_mb integer" -How many bits to allot for coding one macroblock. Different profiles use -between 200 and 2400 bits per macroblock, the maximum is 8000. -.IP "\fBmbs_per_slice\fR \fIinteger\fR" 4 -.IX Item "mbs_per_slice integer" -Number of macroblocks in each slice (1\-8); the default value (8) -should be good in almost all situations. -.IP "\fBvendor\fR \fIstring\fR" 4 -.IX Item "vendor string" -Override the 4\-byte vendor \s-1ID\s0. -A custom vendor \s-1ID\s0 like \fIapl0\fR would claim the stream was produced by -the Apple encoder. -.IP "\fBalpha_bits\fR \fIinteger\fR" 4 -.IX Item "alpha_bits integer" -Specify number of bits for alpha component. -Possible values are \fI0\fR, \fI8\fR and \fI16\fR. -Use \fI0\fR to disable alpha plane coding. -.PP -\fISpeed considerations\fR -.IX Subsection "Speed considerations" -.PP -In the default mode of operation the encoder has to honor frame constraints -(i.e. not produc frames with size bigger than requested) while still making -output picture as good as possible. -A frame containing a lot of small details is harder to compress and the encoder -would spend more time searching for appropriate quantizers for each slice. -.PP -Setting a higher \fBbits_per_mb\fR limit will improve the speed. -.PP -For the fastest encoding speed set the \fBqscale\fR parameter (4 is the -recommended value) and do not set a size constraint. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavcodec\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-devices.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-devices.1 deleted file mode 100644 index 9847d5c3f4..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-devices.1 +++ /dev/null @@ -1,1208 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-DEVICES 1" -.TH FFMPEG-DEVICES 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-devices \- FFmpeg devices -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This document describes the input and output devices provided by the -libavdevice library. -.SH "DEVICE OPTIONS" -.IX Header "DEVICE OPTIONS" -The libavdevice library provides the same interface as -libavformat. Namely, an input device is considered like a demuxer, and -an output device like a muxer, and the interface and generic device -options are the same provided by libavformat (see the ffmpeg-formats -manual). -.PP -In addition each input or output device may support so-called private -options, which are specific for that component. -.PP -Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the -FFmpeg tools, or by setting the value explicitly in the device -\&\f(CW\*(C`AVFormatContext\*(C'\fR options or using the \fIlibavutil/opt.h\fR \s-1API\s0 -for programmatic use. -.SH "INPUT DEVICES" -.IX Header "INPUT DEVICES" -Input devices are configured elements in FFmpeg which allow to access -the data coming from a multimedia device attached to your system. -.PP -When you configure your FFmpeg build, all the supported input devices -are enabled by default. You can list all available ones using the -configure option \*(L"\-\-list\-indevs\*(R". -.PP -You can disable all the input devices using the configure option -\&\*(L"\-\-disable\-indevs\*(R", and selectively enable an input device using the -option "\-\-enable\-indev=\fI\s-1INDEV\s0\fR\*(L", or you can disable a particular -input device using the option \*(R"\-\-disable\-indev=\fI\s-1INDEV\s0\fR". -.PP -The option \*(L"\-formats\*(R" of the ff* tools will display the list of -supported input devices (amongst the demuxers). -.PP -A description of the currently available input devices follows. -.Sh "alsa" -.IX Subsection "alsa" -\&\s-1ALSA\s0 (Advanced Linux Sound Architecture) input device. -.PP -To enable this input device during configuration you need libasound -installed on your system. -.PP -This device allows capturing from an \s-1ALSA\s0 device. The name of the -device to capture has to be an \s-1ALSA\s0 card identifier. -.PP -An \s-1ALSA\s0 identifier has the syntax: -.PP -.Vb 1 -\& hw:[,[,]] -.Ve -.PP -where the \fI\s-1DEV\s0\fR and \fI\s-1SUBDEV\s0\fR components are optional. -.PP -The three arguments (in order: \fI\s-1CARD\s0\fR,\fI\s-1DEV\s0\fR,\fI\s-1SUBDEV\s0\fR) -specify card number or identifier, device number and subdevice number -(\-1 means any). -.PP -To see the list of cards currently recognized by your system check the -files \fI/proc/asound/cards\fR and \fI/proc/asound/devices\fR. -.PP -For example to capture with \fBffmpeg\fR from an \s-1ALSA\s0 device with -card id 0, you may run the command: -.PP -.Vb 1 -\& ffmpeg -f alsa -i hw:0 alsaout.wav -.Ve -.PP -For more information see: -<\fBhttp://www.alsa\-project.org/alsa\-doc/alsa\-lib/pcm.html\fR> -.Sh "bktr" -.IX Subsection "bktr" -\&\s-1BSD\s0 video input device. -.Sh "dshow" -.IX Subsection "dshow" -Windows DirectShow input device. -.PP -DirectShow support is enabled when FFmpeg is built with the mingw\-w64 project. -Currently only audio and video devices are supported. -.PP -Multiple devices may be opened as separate inputs, but they may also be -opened on the same input, which should improve synchronism between them. -.PP -The input name should be in the format: -.PP -.Vb 1 -\& =[:=] -.Ve -.PP -where \fI\s-1TYPE\s0\fR can be either \fIaudio\fR or \fIvideo\fR, -and \fI\s-1NAME\s0\fR is the device's name. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -If no options are specified, the device's defaults are used. -If the device does not support the requested options, it will -fail to open. -.IP "\fBvideo_size\fR" 4 -.IX Item "video_size" -Set the video size in the captured video. -.IP "\fBframerate\fR" 4 -.IX Item "framerate" -Set the frame rate in the captured video. -.IP "\fBsample_rate\fR" 4 -.IX Item "sample_rate" -Set the sample rate (in Hz) of the captured audio. -.IP "\fBsample_size\fR" 4 -.IX Item "sample_size" -Set the sample size (in bits) of the captured audio. -.IP "\fBchannels\fR" 4 -.IX Item "channels" -Set the number of channels in the captured audio. -.IP "\fBlist_devices\fR" 4 -.IX Item "list_devices" -If set to \fBtrue\fR, print a list of devices and exit. -.IP "\fBlist_options\fR" 4 -.IX Item "list_options" -If set to \fBtrue\fR, print a list of selected device's options -and exit. -.IP "\fBvideo_device_number\fR" 4 -.IX Item "video_device_number" -Set video device number for devices with same name (starts at 0, -defaults to 0). -.IP "\fBaudio_device_number\fR" 4 -.IX Item "audio_device_number" -Set audio device number for devices with same name (starts at 0, -defaults to 0). -.IP "\fBpixel_format\fR" 4 -.IX Item "pixel_format" -Select pixel format to be used by DirectShow. This may only be set when -the video codec is not set or set to rawvideo. -.IP "\fBaudio_buffer_size\fR" 4 -.IX Item "audio_buffer_size" -Set audio device buffer size in milliseconds (which can directly -impact latency, depending on the device). -Defaults to using the audio device's -default buffer size (typically some multiple of 500ms). -Setting this value too low can degrade performance. -See also -<\fBhttp://msdn.microsoft.com/en\-us/library/windows/desktop/dd377582(v=vs.85).aspx\fR> -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -Print the list of DirectShow supported devices and exit: -.Sp -.Vb 1 -\& $ ffmpeg -list_devices true -f dshow -i dummy -.Ve -.IP "\(bu" 4 -Open video device \fICamera\fR: -.Sp -.Vb 1 -\& $ ffmpeg -f dshow -i video="Camera" -.Ve -.IP "\(bu" 4 -Open second video device with name \fICamera\fR: -.Sp -.Vb 1 -\& $ ffmpeg -f dshow -video_device_number 1 -i video="Camera" -.Ve -.IP "\(bu" 4 -Open video device \fICamera\fR and audio device \fIMicrophone\fR: -.Sp -.Vb 1 -\& $ ffmpeg -f dshow -i video="Camera":audio="Microphone" -.Ve -.IP "\(bu" 4 -Print the list of supported options in selected device and exit: -.Sp -.Vb 1 -\& $ ffmpeg -list_options true -f dshow -i video="Camera" -.Ve -.Sh "dv1394" -.IX Subsection "dv1394" -Linux \s-1DV\s0 1394 input device. -.Sh "fbdev" -.IX Subsection "fbdev" -Linux framebuffer input device. -.PP -The Linux framebuffer is a graphic hardware-independent abstraction -layer to show graphics on a computer monitor, typically on the -console. It is accessed through a file device node, usually -\&\fI/dev/fb0\fR. -.PP -For more detailed information read the file -Documentation/fb/framebuffer.txt included in the Linux source tree. -.PP -To record from the framebuffer device \fI/dev/fb0\fR with -\&\fBffmpeg\fR: -.PP -.Vb 1 -\& ffmpeg -f fbdev -r 10 -i /dev/fb0 out.avi -.Ve -.PP -You can take a single screenshot image with the command: -.PP -.Vb 1 -\& ffmpeg -f fbdev -frames:v 1 -r 1 -i /dev/fb0 screenshot.jpeg -.Ve -.PP -See also <\fBhttp://linux\-fbdev.sourceforge.net/\fR>, and \fIfbset\fR\|(1). -.Sh "iec61883" -.IX Subsection "iec61883" -FireWire \s-1DV/HDV\s0 input device using libiec61883. -.PP -To enable this input device, you need libiec61883, libraw1394 and -libavc1394 installed on your system. Use the configure option -\&\f(CW\*(C`\-\-enable\-libiec61883\*(C'\fR to compile with the device enabled. -.PP -The iec61883 capture device supports capturing from a video device -connected via \s-1IEEE1394\s0 (FireWire), using libiec61883 and the new Linux -FireWire stack (juju). This is the default \s-1DV/HDV\s0 input method in Linux -Kernel 2.6.37 and later, since the old FireWire stack was removed. -.PP -Specify the FireWire port to be used as input file, or \*(L"auto\*(R" -to choose the first port connected. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBdvtype\fR" 4 -.IX Item "dvtype" -Override autodetection of \s-1DV/HDV\s0. This should only be used if auto -detection does not work, or if usage of a different device type -should be prohibited. Treating a \s-1DV\s0 device as \s-1HDV\s0 (or vice versa) will -not work and result in undefined behavior. -The values \fBauto\fR, \fBdv\fR and \fBhdv\fR are supported. -.IP "\fBdvbuffer\fR" 4 -.IX Item "dvbuffer" -Set maxiumum size of buffer for incoming data, in frames. For \s-1DV\s0, this -is an exact value. For \s-1HDV\s0, it is not frame exact, since \s-1HDV\s0 does -not have a fixed frame size. -.IP "\fBdvguid\fR" 4 -.IX Item "dvguid" -Select the capture device by specifying it's \s-1GUID\s0. Capturing will only -be performed from the specified device and fails if no device with the -given \s-1GUID\s0 is found. This is useful to select the input if multiple -devices are connected at the same time. -Look at /sys/bus/firewire/devices to find out the GUIDs. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -Grab and show the input of a FireWire \s-1DV/HDV\s0 device. -.Sp -.Vb 1 -\& ffplay -f iec61883 -i auto -.Ve -.IP "\(bu" 4 -Grab and record the input of a FireWire \s-1DV/HDV\s0 device, -using a packet buffer of 100000 packets if the source is \s-1HDV\s0. -.Sp -.Vb 1 -\& ffmpeg -f iec61883 -i auto -hdvbuffer 100000 out.mpg -.Ve -.Sh "jack" -.IX Subsection "jack" -\&\s-1JACK\s0 input device. -.PP -To enable this input device during configuration you need libjack -installed on your system. -.PP -A \s-1JACK\s0 input device creates one or more \s-1JACK\s0 writable clients, one for -each audio channel, with name \fIclient_name\fR:input_\fIN\fR, where -\&\fIclient_name\fR is the name provided by the application, and \fIN\fR -is a number which identifies the channel. -Each writable client will send the acquired data to the FFmpeg input -device. -.PP -Once you have created one or more \s-1JACK\s0 readable clients, you need to -connect them to one or more \s-1JACK\s0 writable clients. -.PP -To connect or disconnect \s-1JACK\s0 clients you can use the \fBjack_connect\fR -and \fBjack_disconnect\fR programs, or do it through a graphical interface, -for example with \fBqjackctl\fR. -.PP -To list the \s-1JACK\s0 clients and their properties you can invoke the command -\&\fBjack_lsp\fR. -.PP -Follows an example which shows how to capture a \s-1JACK\s0 readable client -with \fBffmpeg\fR. -.PP -.Vb 2 -\& # Create a JACK writable client with name "ffmpeg". -\& $ ffmpeg -f jack -i ffmpeg -y out.wav -.Ve -.PP -.Vb 2 -\& # Start the sample jack_metro readable client. -\& $ jack_metro -b 120 -d 0.2 -f 4000 -.Ve -.PP -.Vb 8 -\& # List the current JACK clients. -\& $ jack_lsp -c -\& system:capture_1 -\& system:capture_2 -\& system:playback_1 -\& system:playback_2 -\& ffmpeg:input_1 -\& metro:120_bpm -.Ve -.PP -.Vb 2 -\& # Connect metro to the ffmpeg writable client. -\& $ jack_connect metro:120_bpm ffmpeg:input_1 -.Ve -.PP -For more information read: -<\fBhttp://jackaudio.org/\fR> -.Sh "lavfi" -.IX Subsection "lavfi" -Libavfilter input virtual device. -.PP -This input device reads data from the open output pads of a libavfilter -filtergraph. -.PP -For each filtergraph open output, the input device will create a -corresponding stream which is mapped to the generated output. Currently -only video data is supported. The filtergraph is specified through the -option \fBgraph\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBgraph\fR" 4 -.IX Item "graph" -Specify the filtergraph to use as input. Each video open output must be -labelled by a unique string of the form "out\fIN\fR", where \fIN\fR is a -number starting from 0 corresponding to the mapped input stream -generated by the device. -The first unlabelled output is automatically assigned to the \*(L"out0\*(R" -label, but all the others need to be specified explicitly. -.Sp -If not specified defaults to the filename specified for the input -device. -.IP "\fBgraph_file\fR" 4 -.IX Item "graph_file" -Set the filename of the filtergraph to be read and sent to the other -filters. Syntax of the filtergraph is the same as the one specified by -the option \fIgraph\fR. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -Create a color video stream and play it back with \fBffplay\fR: -.Sp -.Vb 1 -\& ffplay -f lavfi -graph "color=c=pink [out0]" dummy -.Ve -.IP "\(bu" 4 -As the previous example, but use filename for specifying the graph -description, and omit the \*(L"out0\*(R" label: -.Sp -.Vb 1 -\& ffplay -f lavfi color=c=pink -.Ve -.IP "\(bu" 4 -Create three different video test filtered sources and play them: -.Sp -.Vb 1 -\& ffplay -f lavfi -graph "testsrc [out0]; testsrc,hflip [out1]; testsrc,negate [out2]" test3 -.Ve -.IP "\(bu" 4 -Read an audio stream from a file using the amovie source and play it -back with \fBffplay\fR: -.Sp -.Vb 1 -\& ffplay -f lavfi "amovie=test.wav" -.Ve -.IP "\(bu" 4 -Read an audio stream and a video stream and play it back with -\&\fBffplay\fR: -.Sp -.Vb 1 -\& ffplay -f lavfi "movie=test.avi[out0];amovie=test.wav[out1]" -.Ve -.Sh "libdc1394" -.IX Subsection "libdc1394" -\&\s-1IIDC1394\s0 input device, based on libdc1394 and libraw1394. -.Sh "openal" -.IX Subsection "openal" -The OpenAL input device provides audio capture on all systems with a -working OpenAL 1.1 implementation. -.PP -To enable this input device during configuration, you need OpenAL -headers and libraries installed on your system, and need to configure -FFmpeg with \f(CW\*(C`\-\-enable\-openal\*(C'\fR. -.PP -OpenAL headers and libraries should be provided as part of your OpenAL -implementation, or as an additional download (an \s-1SDK\s0). Depending on your -installation you may need to specify additional flags via the -\&\f(CW\*(C`\-\-extra\-cflags\*(C'\fR and \f(CW\*(C`\-\-extra\-ldflags\*(C'\fR for allowing the build -system to locate the OpenAL headers and libraries. -.PP -An incomplete list of OpenAL implementations follows: -.IP "\fBCreative\fR" 4 -.IX Item "Creative" -The official Windows implementation, providing hardware acceleration -with supported devices and software fallback. -See <\fBhttp://openal.org/\fR>. -.IP "\fBOpenAL Soft\fR" 4 -.IX Item "OpenAL Soft" -Portable, open source (\s-1LGPL\s0) software implementation. Includes -backends for the most common sound APIs on the Windows, Linux, -Solaris, and \s-1BSD\s0 operating systems. -See <\fBhttp://kcat.strangesoft.net/openal.html\fR>. -.IP "\fBApple\fR" 4 -.IX Item "Apple" -OpenAL is part of Core Audio, the official Mac \s-1OS\s0 X Audio interface. -See <\fBhttp://developer.apple.com/technologies/mac/audio\-and\-video.html\fR> -.PP -This device allows to capture from an audio input device handled -through OpenAL. -.PP -You need to specify the name of the device to capture in the provided -filename. If the empty string is provided, the device will -automatically select the default device. You can get the list of the -supported devices by using the option \fIlist_devices\fR. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBchannels\fR" 4 -.IX Item "channels" -Set the number of channels in the captured audio. Only the values -\&\fB1\fR (monaural) and \fB2\fR (stereo) are currently supported. -Defaults to \fB2\fR. -.IP "\fBsample_size\fR" 4 -.IX Item "sample_size" -Set the sample size (in bits) of the captured audio. Only the values -\&\fB8\fR and \fB16\fR are currently supported. Defaults to -\&\fB16\fR. -.IP "\fBsample_rate\fR" 4 -.IX Item "sample_rate" -Set the sample rate (in Hz) of the captured audio. -Defaults to \fB44.1k\fR. -.IP "\fBlist_devices\fR" 4 -.IX Item "list_devices" -If set to \fBtrue\fR, print a list of devices and exit. -Defaults to \fBfalse\fR. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.PP -Print the list of OpenAL supported devices and exit: -.PP -.Vb 1 -\& $ ffmpeg -list_devices true -f openal -i dummy out.ogg -.Ve -.PP -Capture from the OpenAL device \fI\s-1DR\-BT101\s0 via PulseAudio\fR: -.PP -.Vb 1 -\& $ ffmpeg -f openal -i 'DR-BT101 via PulseAudio' out.ogg -.Ve -.PP -Capture from the default device (note the empty string '' as filename): -.PP -.Vb 1 -\& $ ffmpeg -f openal -i '' out.ogg -.Ve -.PP -Capture from two devices simultaneously, writing to two different files, -within the same \fBffmpeg\fR command: -.PP -.Vb 1 -\& $ ffmpeg -f openal -i 'DR-BT101 via PulseAudio' out1.ogg -f openal -i 'ALSA Default' out2.ogg -.Ve -.PP -Note: not all OpenAL implementations support multiple simultaneous capture \- -try the latest OpenAL Soft if the above does not work. -.Sh "oss" -.IX Subsection "oss" -Open Sound System input device. -.PP -The filename to provide to the input device is the device node -representing the \s-1OSS\s0 input device, and is usually set to -\&\fI/dev/dsp\fR. -.PP -For example to grab from \fI/dev/dsp\fR using \fBffmpeg\fR use the -command: -.PP -.Vb 1 -\& ffmpeg -f oss -i /dev/dsp /tmp/oss.wav -.Ve -.PP -For more information about \s-1OSS\s0 see: -<\fBhttp://manuals.opensound.com/usersguide/dsp.html\fR> -.Sh "pulse" -.IX Subsection "pulse" -PulseAudio input device. -.PP -To enable this output device you need to configure FFmpeg with \f(CW\*(C`\-\-enable\-libpulse\*(C'\fR. -.PP -The filename to provide to the input device is a source device or the -string \*(L"default\*(R" -.PP -To list the PulseAudio source devices and their properties you can invoke -the command \fBpactl list sources\fR. -.PP -More information about PulseAudio can be found on <\fBhttp://www.pulseaudio.org\fR>. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBserver\fR" 4 -.IX Item "server" -Connect to a specific PulseAudio server, specified by an \s-1IP\s0 address. -Default server is used when not provided. -.IP "\fBname\fR" 4 -.IX Item "name" -Specify the application name PulseAudio will use when showing active clients, -by default it is the \f(CW\*(C`LIBAVFORMAT_IDENT\*(C'\fR string. -.IP "\fBstream_name\fR" 4 -.IX Item "stream_name" -Specify the stream name PulseAudio will use when showing active streams, -by default it is \*(L"record\*(R". -.IP "\fBsample_rate\fR" 4 -.IX Item "sample_rate" -Specify the samplerate in Hz, by default 48kHz is used. -.IP "\fBchannels\fR" 4 -.IX Item "channels" -Specify the channels in use, by default 2 (stereo) is set. -.IP "\fBframe_size\fR" 4 -.IX Item "frame_size" -Specify the number of bytes per frame, by default it is set to 1024. -.IP "\fBfragment_size\fR" 4 -.IX Item "fragment_size" -Specify the minimal buffering fragment in PulseAudio, it will affect the -audio latency. By default it is unset. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.PP -Record a stream from default device: -.PP -.Vb 1 -\& ffmpeg -f pulse -i default /tmp/pulse.wav -.Ve -.Sh "sndio" -.IX Subsection "sndio" -sndio input device. -.PP -To enable this input device during configuration you need libsndio -installed on your system. -.PP -The filename to provide to the input device is the device node -representing the sndio input device, and is usually set to -\&\fI/dev/audio0\fR. -.PP -For example to grab from \fI/dev/audio0\fR using \fBffmpeg\fR use the -command: -.PP -.Vb 1 -\& ffmpeg -f sndio -i /dev/audio0 /tmp/oss.wav -.Ve -.Sh "video4linux2, v4l2" -.IX Subsection "video4linux2, v4l2" -Video4Linux2 input video device. -.PP -\&\*(L"v4l2\*(R" can be used as alias for \*(L"video4linux2\*(R". -.PP -If FFmpeg is built with v4l\-utils support (by using the -\&\f(CW\*(C`\-\-enable\-libv4l2\*(C'\fR configure option), it is possible to use it with the -\&\f(CW\*(C`\-use_libv4l2\*(C'\fR input device option. -.PP -The name of the device to grab is a file device node, usually Linux -systems tend to automatically create such nodes when the device -(e.g. an \s-1USB\s0 webcam) is plugged into the system, and has a name of the -kind \fI/dev/video\fIN\fI\fR, where \fIN\fR is a number associated to -the device. -.PP -Video4Linux2 devices usually support a limited set of -\&\fIwidth\fRx\fIheight\fR sizes and frame rates. You can check which are -supported using \fB\-list_formats all\fR for Video4Linux2 devices. -Some devices, like \s-1TV\s0 cards, support one or more standards. It is possible -to list all the supported standards using \fB\-list_standards all\fR. -.PP -The time base for the timestamps is 1 microsecond. Depending on the kernel -version and configuration, the timestamps may be derived from the real time -clock (origin at the Unix Epoch) or the monotonic clock (origin usually at -boot time, unaffected by \s-1NTP\s0 or manual changes to the clock). The -\&\fB\-timestamps abs\fR or \fB\-ts abs\fR option can be used to force -conversion into the real time clock. -.PP -Some usage examples of the video4linux2 device with \fBffmpeg\fR -and \fBffplay\fR: -.IP "\(bu" 4 -Grab and show the input of a video4linux2 device: -.Sp -.Vb 1 -\& ffplay -f video4linux2 -framerate 30 -video_size hd720 /dev/video0 -.Ve -.IP "\(bu" 4 -Grab and record the input of a video4linux2 device, leave the -frame rate and size as previously set: -.Sp -.Vb 1 -\& ffmpeg -f video4linux2 -input_format mjpeg -i /dev/video0 out.mpeg -.Ve -.PP -For more information about Video4Linux, check <\fBhttp://linuxtv.org/\fR>. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBstandard\fR" 4 -.IX Item "standard" -Set the standard. Must be the name of a supported standard. To get a -list of the supported standards, use the \fBlist_standards\fR -option. -.IP "\fBchannel\fR" 4 -.IX Item "channel" -Set the input channel number. Default to \-1, which means using the -previously selected channel. -.IP "\fBvideo_size\fR" 4 -.IX Item "video_size" -Set the video frame size. The argument must be a string in the form -\&\fI\s-1WIDTH\s0\fRx\fI\s-1HEIGHT\s0\fR or a valid size abbreviation. -.IP "\fBpixel_format\fR" 4 -.IX Item "pixel_format" -Select the pixel format (only valid for raw video input). -.IP "\fBinput_format\fR" 4 -.IX Item "input_format" -Set the preferred pixel format (for raw video) or a codec name. -This option allows to select the input format, when several are -available. -.IP "\fBframerate\fR" 4 -.IX Item "framerate" -Set the preferred video frame rate. -.IP "\fBlist_formats\fR" 4 -.IX Item "list_formats" -List available formats (supported pixel formats, codecs, and frame -sizes) and exit. -.Sp -Available values are: -.RS 4 -.IP "\fBall\fR" 4 -.IX Item "all" -Show all available (compressed and non\-compressed) formats. -.IP "\fBraw\fR" 4 -.IX Item "raw" -Show only raw video (non\-compressed) formats. -.IP "\fBcompressed\fR" 4 -.IX Item "compressed" -Show only compressed formats. -.RE -.RS 4 -.RE -.IP "\fBlist_standards\fR" 4 -.IX Item "list_standards" -List supported standards and exit. -.Sp -Available values are: -.RS 4 -.IP "\fBall\fR" 4 -.IX Item "all" -Show all supported standards. -.RE -.RS 4 -.RE -.IP "\fBtimestamps, ts\fR" 4 -.IX Item "timestamps, ts" -Set type of timestamps for grabbed frames. -.Sp -Available values are: -.RS 4 -.IP "\fBdefault\fR" 4 -.IX Item "default" -Use timestamps from the kernel. -.IP "\fBabs\fR" 4 -.IX Item "abs" -Use absolute timestamps (wall clock). -.IP "\fBmono2abs\fR" 4 -.IX Item "mono2abs" -Force conversion from monotonic to absolute timestamps. -.RE -.RS 4 -.Sp -Default value is \f(CW\*(C`default\*(C'\fR. -.RE -.Sh "vfwcap" -.IX Subsection "vfwcap" -VfW (Video for Windows) capture input device. -.PP -The filename passed as input is the capture driver number, ranging from -0 to 9. You may use \*(L"list\*(R" as filename to print a list of drivers. Any -other filename will be interpreted as device number 0. -.Sh "x11grab" -.IX Subsection "x11grab" -X11 video input device. -.PP -This device allows to capture a region of an X11 display. -.PP -The filename passed as input has the syntax: -.PP -.Vb 1 -\& []:.[+,] -.Ve -.PP -\&\fIhostname\fR:\fIdisplay_number\fR.\fIscreen_number\fR specifies the -X11 display name of the screen to grab from. \fIhostname\fR can be -omitted, and defaults to \*(L"localhost\*(R". The environment variable -\&\fB\s-1DISPLAY\s0\fR contains the default display name. -.PP -\&\fIx_offset\fR and \fIy_offset\fR specify the offsets of the grabbed -area with respect to the top-left border of the X11 screen. They -default to 0. -.PP -Check the X11 documentation (e.g. man X) for more detailed information. -.PP -Use the \fBdpyinfo\fR program for getting basic information about the -properties of your X11 display (e.g. grep for \*(L"name\*(R" or \*(L"dimensions\*(R"). -.PP -For example to grab from \fI:0.0\fR using \fBffmpeg\fR: -.PP -.Vb 1 -\& ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0 out.mpg -.Ve -.PP -Grab at position \f(CW\*(C`10,20\*(C'\fR: -.PP -.Vb 1 -\& ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0+10,20 out.mpg -.Ve -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBdraw_mouse\fR" 4 -.IX Item "draw_mouse" -Specify whether to draw the mouse pointer. A value of \f(CW0\fR specify -not to draw the pointer. Default value is \f(CW1\fR. -.IP "\fBfollow_mouse\fR" 4 -.IX Item "follow_mouse" -Make the grabbed area follow the mouse. The argument can be -\&\f(CW\*(C`centered\*(C'\fR or a number of pixels \fI\s-1PIXELS\s0\fR. -.Sp -When it is specified with \*(L"centered\*(R", the grabbing region follows the mouse -pointer and keeps the pointer at the center of region; otherwise, the region -follows only when the mouse pointer reaches within \fI\s-1PIXELS\s0\fR (greater than -zero) to the edge of region. -.Sp -For example: -.Sp -.Vb 1 -\& ffmpeg -f x11grab -follow_mouse centered -framerate 25 -video_size cif -i :0.0 out.mpg -.Ve -.Sp -To follow only when the mouse pointer reaches within 100 pixels to edge: -.Sp -.Vb 1 -\& ffmpeg -f x11grab -follow_mouse 100 -framerate 25 -video_size cif -i :0.0 out.mpg -.Ve -.IP "\fBframerate\fR" 4 -.IX Item "framerate" -Set the grabbing frame rate. Default value is \f(CW\*(C`ntsc\*(C'\fR, -corresponding to a frame rate of \f(CW\*(C`30000/1001\*(C'\fR. -.IP "\fBshow_region\fR" 4 -.IX Item "show_region" -Show grabbed region on screen. -.Sp -If \fIshow_region\fR is specified with \f(CW1\fR, then the grabbing -region will be indicated on screen. With this option, it is easy to -know what is being grabbed if only a portion of the screen is grabbed. -.Sp -For example: -.Sp -.Vb 1 -\& ffmpeg -f x11grab -show_region 1 -framerate 25 -video_size cif -i :0.0+10,20 out.mpg -.Ve -.Sp -With \fIfollow_mouse\fR: -.Sp -.Vb 1 -\& ffmpeg -f x11grab -follow_mouse centered -show_region 1 -framerate 25 -video_size cif -i :0.0 out.mpg -.Ve -.IP "\fBvideo_size\fR" 4 -.IX Item "video_size" -Set the video frame size. Default value is \f(CW\*(C`vga\*(C'\fR. -.SH "OUTPUT DEVICES" -.IX Header "OUTPUT DEVICES" -Output devices are configured elements in FFmpeg that can write -multimedia data to an output device attached to your system. -.PP -When you configure your FFmpeg build, all the supported output devices -are enabled by default. You can list all available ones using the -configure option \*(L"\-\-list\-outdevs\*(R". -.PP -You can disable all the output devices using the configure option -\&\*(L"\-\-disable\-outdevs\*(R", and selectively enable an output device using the -option "\-\-enable\-outdev=\fI\s-1OUTDEV\s0\fR\*(L", or you can disable a particular -input device using the option \*(R"\-\-disable\-outdev=\fI\s-1OUTDEV\s0\fR". -.PP -The option \*(L"\-formats\*(R" of the ff* tools will display the list of -enabled output devices (amongst the muxers). -.PP -A description of the currently available output devices follows. -.Sh "alsa" -.IX Subsection "alsa" -\&\s-1ALSA\s0 (Advanced Linux Sound Architecture) output device. -.Sh "caca" -.IX Subsection "caca" -\&\s-1CACA\s0 output device. -.PP -This output device allows to show a video stream in \s-1CACA\s0 window. -Only one \s-1CACA\s0 window is allowed per application, so you can -have only one instance of this output device in an application. -.PP -To enable this output device you need to configure FFmpeg with -\&\f(CW\*(C`\-\-enable\-libcaca\*(C'\fR. -libcaca is a graphics library that outputs text instead of pixels. -.PP -For more information about libcaca, check: -<\fBhttp://caca.zoy.org/wiki/libcaca\fR> -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBwindow_title\fR" 4 -.IX Item "window_title" -Set the \s-1CACA\s0 window title, if not specified default to the filename -specified for the output device. -.IP "\fBwindow_size\fR" 4 -.IX Item "window_size" -Set the \s-1CACA\s0 window size, can be a string of the form -\&\fIwidth\fRx\fIheight\fR or a video size abbreviation. -If not specified it defaults to the size of the input video. -.IP "\fBdriver\fR" 4 -.IX Item "driver" -Set display driver. -.IP "\fBalgorithm\fR" 4 -.IX Item "algorithm" -Set dithering algorithm. Dithering is necessary -because the picture being rendered has usually far more colours than -the available palette. -The accepted values are listed with \f(CW\*(C`\-list_dither algorithms\*(C'\fR. -.IP "\fBantialias\fR" 4 -.IX Item "antialias" -Set antialias method. Antialiasing smoothens the rendered -image and avoids the commonly seen staircase effect. -The accepted values are listed with \f(CW\*(C`\-list_dither antialiases\*(C'\fR. -.IP "\fBcharset\fR" 4 -.IX Item "charset" -Set which characters are going to be used when rendering text. -The accepted values are listed with \f(CW\*(C`\-list_dither charsets\*(C'\fR. -.IP "\fBcolor\fR" 4 -.IX Item "color" -Set color to be used when rendering text. -The accepted values are listed with \f(CW\*(C`\-list_dither colors\*(C'\fR. -.IP "\fBlist_drivers\fR" 4 -.IX Item "list_drivers" -If set to \fBtrue\fR, print a list of available drivers and exit. -.IP "\fBlist_dither\fR" 4 -.IX Item "list_dither" -List available dither options related to the argument. -The argument must be one of \f(CW\*(C`algorithms\*(C'\fR, \f(CW\*(C`antialiases\*(C'\fR, -\&\f(CW\*(C`charsets\*(C'\fR, \f(CW\*(C`colors\*(C'\fR. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -The following command shows the \fBffmpeg\fR output is an -\&\s-1CACA\s0 window, forcing its size to 80x25: -.Sp -.Vb 1 -\& ffmpeg -i INPUT -vcodec rawvideo -pix_fmt rgb24 -window_size 80x25 -f caca - -.Ve -.IP "\(bu" 4 -Show the list of available drivers and exit: -.Sp -.Vb 1 -\& ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_drivers true - -.Ve -.IP "\(bu" 4 -Show the list of available dither colors and exit: -.Sp -.Vb 1 -\& ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_dither colors - -.Ve -.Sh "fbdev" -.IX Subsection "fbdev" -Linux framebuffer output device. -.PP -The Linux framebuffer is a graphic hardware-independent abstraction -layer to show graphics on a computer monitor, typically on the -console. It is accessed through a file device node, usually -\&\fI/dev/fb0\fR. -.PP -For more detailed information read the file -\&\fIDocumentation/fb/framebuffer.txt\fR included in the Linux source tree. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBxoffset\fR" 4 -.IX Item "xoffset" -.PD 0 -.IP "\fByoffset\fR" 4 -.IX Item "yoffset" -.PD -Set x/y coordinate of top left corner. Default is 0. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.PP -Play a file on framebuffer device \fI/dev/fb0\fR. -Required pixel format depends on current framebuffer settings. -.PP -.Vb 1 -\& ffmpeg -re -i INPUT -vcodec rawvideo -pix_fmt bgra -f fbdev /dev/fb0 -.Ve -.PP -See also <\fBhttp://linux\-fbdev.sourceforge.net/\fR>, and \fIfbset\fR\|(1). -.Sh "oss" -.IX Subsection "oss" -\&\s-1OSS\s0 (Open Sound System) output device. -.Sh "pulse" -.IX Subsection "pulse" -PulseAudio output device. -.PP -To enable this output device you need to configure FFmpeg with \f(CW\*(C`\-\-enable\-libpulse\*(C'\fR. -.PP -More information about PulseAudio can be found on <\fBhttp://www.pulseaudio.org\fR> -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBserver\fR" 4 -.IX Item "server" -Connect to a specific PulseAudio server, specified by an \s-1IP\s0 address. -Default server is used when not provided. -.IP "\fBname\fR" 4 -.IX Item "name" -Specify the application name PulseAudio will use when showing active clients, -by default it is the \f(CW\*(C`LIBAVFORMAT_IDENT\*(C'\fR string. -.IP "\fBstream_name\fR" 4 -.IX Item "stream_name" -Specify the stream name PulseAudio will use when showing active streams, -by default it is set to the specified output name. -.IP "\fBdevice\fR" 4 -.IX Item "device" -Specify the device to use. Default device is used when not provided. -List of output devices can be obtained with command \fBpactl list sinks\fR. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.PP -Play a file on default device on default server: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f pulse "stream name" -.Ve -.Sh "sdl" -.IX Subsection "sdl" -\&\s-1SDL\s0 (Simple DirectMedia Layer) output device. -.PP -This output device allows to show a video stream in an \s-1SDL\s0 -window. Only one \s-1SDL\s0 window is allowed per application, so you can -have only one instance of this output device in an application. -.PP -To enable this output device you need libsdl installed on your system -when configuring your build. -.PP -For more information about \s-1SDL\s0, check: -<\fBhttp://www.libsdl.org/\fR> -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBwindow_title\fR" 4 -.IX Item "window_title" -Set the \s-1SDL\s0 window title, if not specified default to the filename -specified for the output device. -.IP "\fBicon_title\fR" 4 -.IX Item "icon_title" -Set the name of the iconified \s-1SDL\s0 window, if not specified it is set -to the same value of \fIwindow_title\fR. -.IP "\fBwindow_size\fR" 4 -.IX Item "window_size" -Set the \s-1SDL\s0 window size, can be a string of the form -\&\fIwidth\fRx\fIheight\fR or a video size abbreviation. -If not specified it defaults to the size of the input video, -downscaled according to the aspect ratio. -.IP "\fBwindow_fullscreen\fR" 4 -.IX Item "window_fullscreen" -Set fullscreen mode when non-zero value is provided. -Zero is a default. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.PP -The following command shows the \fBffmpeg\fR output is an -\&\s-1SDL\s0 window, forcing its size to the qcif format: -.PP -.Vb 1 -\& ffmpeg -i INPUT -vcodec rawvideo -pix_fmt yuv420p -window_size qcif -f sdl "SDL output" -.Ve -.Sh "sndio" -.IX Subsection "sndio" -sndio audio output device. -.Sh "xv" -.IX Subsection "xv" -\&\s-1XV\s0 (XVideo) output device. -.PP -This output device allows to show a video stream in a X Window System -window. -.PP -\fIOptions\fR -.IX Subsection "Options" -.IP "\fBdisplay_name\fR" 4 -.IX Item "display_name" -Specify the hardware display name, which determines the display and -communications domain to be used. -.Sp -The display name or \s-1DISPLAY\s0 environment variable can be a string in -the format \fIhostname\fR[:\fInumber\fR[.\fIscreen_number\fR]]. -.Sp -\&\fIhostname\fR specifies the name of the host machine on which the -display is physically attached. \fInumber\fR specifies the number of -the display server on that host machine. \fIscreen_number\fR specifies -the screen to be used on that server. -.Sp -If unspecified, it defaults to the value of the \s-1DISPLAY\s0 environment -variable. -.Sp -For example, \f(CW\*(C`dual\-headed:0.1\*(C'\fR would specify screen 1 of display -0 on the machine named ``dual\-headed''. -.Sp -Check the X11 specification for more detailed information about the -display name format. -.IP "\fBwindow_size\fR" 4 -.IX Item "window_size" -Set the created window size, can be a string of the form -\&\fIwidth\fRx\fIheight\fR or a video size abbreviation. If not -specified it defaults to the size of the input video. -.IP "\fBwindow_x\fR" 4 -.IX Item "window_x" -.PD 0 -.IP "\fBwindow_y\fR" 4 -.IX Item "window_y" -.PD -Set the X and Y window offsets for the created window. They are both -set to 0 by default. The values may be ignored by the window manager. -.IP "\fBwindow_title\fR" 4 -.IX Item "window_title" -Set the window title, if not specified default to the filename -specified for the output device. -.PP -For more information about XVideo see <\fBhttp://www.x.org/\fR>. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -Decode, display and encode video input with \fBffmpeg\fR at the -same time: -.Sp -.Vb 1 -\& ffmpeg -i INPUT OUTPUT -f xv display -.Ve -.IP "\(bu" 4 -Decode and display the input video to multiple X11 windows: -.Sp -.Vb 1 -\& ffmpeg -i INPUT -f xv normal -vf negate -f xv negated -.Ve -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavdevice\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-formats.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-formats.1 deleted file mode 100644 index f618fc86a4..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-formats.1 +++ /dev/null @@ -1,1700 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-FORMATS 1" -.TH FFMPEG-FORMATS 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-formats \- FFmpeg formats -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This document describes the supported formats (muxers and demuxers) -provided by the libavformat library. -.SH "FORMAT OPTIONS" -.IX Header "FORMAT OPTIONS" -The libavformat library provides some generic global options, which -can be set on all the muxers and demuxers. In addition each muxer or -demuxer may support so-called private options, which are specific for -that component. -.PP -Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the -FFmpeg tools, or by setting the value explicitly in the -\&\f(CW\*(C`AVFormatContext\*(C'\fR options or using the \fIlibavutil/opt.h\fR \s-1API\s0 -for programmatic use. -.PP -The list of supported options follows: -.IP "\fBavioflags\fR \fIflags\fR \fB(\fR\fIinput/output\fR\fB)\fR" 4 -.IX Item "avioflags flags (input/output)" -Possible values: -.RS 4 -.IP "\fBdirect\fR" 4 -.IX Item "direct" -Reduce buffering. -.RE -.RS 4 -.RE -.IP "\fBprobesize\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "probesize integer (input)" -Set probing size in bytes, i.e. the size of the data to analyze to get -stream information. A higher value will allow to detect more -information in case it is dispersed into the stream, but will increase -latency. Must be an integer not lesser than 32. It is 5000000 by default. -.IP "\fBpacketsize\fR \fIinteger\fR \fB(\fR\fIoutput\fR\fB)\fR" 4 -.IX Item "packetsize integer (output)" -Set packet size. -.IP "\fBfflags\fR \fIflags\fR \fB(\fR\fIinput/output\fR\fB)\fR" 4 -.IX Item "fflags flags (input/output)" -Set format flags. -.Sp -Possible values: -.RS 4 -.IP "\fBignidx\fR" 4 -.IX Item "ignidx" -Ignore index. -.IP "\fBgenpts\fR" 4 -.IX Item "genpts" -Generate \s-1PTS\s0. -.IP "\fBnofillin\fR" 4 -.IX Item "nofillin" -Do not fill in missing values that can be exactly calculated. -.IP "\fBnoparse\fR" 4 -.IX Item "noparse" -Disable AVParsers, this needs \f(CW\*(C`+nofillin\*(C'\fR too. -.IP "\fBigndts\fR" 4 -.IX Item "igndts" -Ignore \s-1DTS\s0. -.IP "\fBdiscardcorrupt\fR" 4 -.IX Item "discardcorrupt" -Discard corrupted frames. -.IP "\fBsortdts\fR" 4 -.IX Item "sortdts" -Try to interleave output packets by \s-1DTS\s0. -.IP "\fBkeepside\fR" 4 -.IX Item "keepside" -Do not merge side data. -.IP "\fBlatm\fR" 4 -.IX Item "latm" -Enable \s-1RTP\s0 \s-1MP4A\-LATM\s0 payload. -.IP "\fBnobuffer\fR" 4 -.IX Item "nobuffer" -Reduce the latency introduced by optional buffering -.RE -.RS 4 -.RE -.IP "\fBseek2any\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "seek2any integer (input)" -Allow seeking to non-keyframes on demuxer level when supported if set to 1. -Default is 0. -.IP "\fBanalyzeduration\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "analyzeduration integer (input)" -Specify how many microseconds are analyzed to probe the input. A -higher value will allow to detect more accurate information, but will -increase latency. It defaults to 5,000,000 microseconds = 5 seconds. -.IP "\fBcryptokey\fR \fIhexadecimal string\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "cryptokey hexadecimal string (input)" -Set decryption key. -.IP "\fBindexmem\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "indexmem integer (input)" -Set max memory used for timestamp index (per stream). -.IP "\fBrtbufsize\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "rtbufsize integer (input)" -Set max memory used for buffering real-time frames. -.IP "\fBfdebug\fR \fIflags\fR \fB(\fR\fIinput/output\fR\fB)\fR" 4 -.IX Item "fdebug flags (input/output)" -Print specific debug info. -.Sp -Possible values: -.RS 4 -.IP "\fBts\fR" 4 -.IX Item "ts" -.RE -.RS 4 -.RE -.PD 0 -.IP "\fBmax_delay\fR \fIinteger\fR \fB(\fR\fIinput/output\fR\fB)\fR" 4 -.IX Item "max_delay integer (input/output)" -.PD -Set maximum muxing or demuxing delay in microseconds. -.IP "\fBfpsprobesize\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "fpsprobesize integer (input)" -Set number of frames used to probe fps. -.IP "\fBaudio_preload\fR \fIinteger\fR \fB(\fR\fIoutput\fR\fB)\fR" 4 -.IX Item "audio_preload integer (output)" -Set microseconds by which audio packets should be interleaved earlier. -.IP "\fBchunk_duration\fR \fIinteger\fR \fB(\fR\fIoutput\fR\fB)\fR" 4 -.IX Item "chunk_duration integer (output)" -Set microseconds for each chunk. -.IP "\fBchunk_size\fR \fIinteger\fR \fB(\fR\fIoutput\fR\fB)\fR" 4 -.IX Item "chunk_size integer (output)" -Set size in bytes for each chunk. -.IP "\fBerr_detect, f_err_detect\fR \fIflags\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "err_detect, f_err_detect flags (input)" -Set error detection flags. \f(CW\*(C`f_err_detect\*(C'\fR is deprecated and -should be used only via the \fBffmpeg\fR tool. -.Sp -Possible values: -.RS 4 -.IP "\fBcrccheck\fR" 4 -.IX Item "crccheck" -Verify embedded CRCs. -.IP "\fBbitstream\fR" 4 -.IX Item "bitstream" -Detect bitstream specification deviations. -.IP "\fBbuffer\fR" 4 -.IX Item "buffer" -Detect improper bitstream length. -.IP "\fBexplode\fR" 4 -.IX Item "explode" -Abort decoding on minor error detection. -.IP "\fBcareful\fR" 4 -.IX Item "careful" -Consider things that violate the spec and have not been seen in the -wild as errors. -.IP "\fBcompliant\fR" 4 -.IX Item "compliant" -Consider all spec non compliancies as errors. -.IP "\fBaggressive\fR" 4 -.IX Item "aggressive" -Consider things that a sane encoder should not do as an error. -.RE -.RS 4 -.RE -.IP "\fBuse_wallclock_as_timestamps\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "use_wallclock_as_timestamps integer (input)" -Use wallclock as timestamps. -.IP "\fBavoid_negative_ts\fR \fIinteger\fR \fB(\fR\fIoutput\fR\fB)\fR" 4 -.IX Item "avoid_negative_ts integer (output)" -Shift timestamps to make them non\-negative. A value of 1 enables shifting, -a value of 0 disables it, the default value of \-1 enables shifting -when required by the target format. -.Sp -When shifting is enabled, all output timestamps are shifted by the -same amount. Audio, video, and subtitles desynching and relative -timestamp differences are preserved compared to how they would have -been without shifting. -.Sp -Also note that this affects only leading negative timestamps, and not -non-monotonic negative timestamps. -.IP "\fBskip_initial_bytes\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "skip_initial_bytes integer (input)" -Set number of bytes to skip before reading header and frames if set to 1. -Default is 0. -.IP "\fBcorrect_ts_overflow\fR \fIinteger\fR \fB(\fR\fIinput\fR\fB)\fR" 4 -.IX Item "correct_ts_overflow integer (input)" -Correct single timestamp overflows if set to 1. Default is 1. -.IP "\fBflush_packets\fR \fIinteger\fR \fB(\fR\fIoutput\fR\fB)\fR" 4 -.IX Item "flush_packets integer (output)" -Flush the underlying I/O stream after each packet. Default 1 enables it, and -has the effect of reducing the latency; 0 disables it and may slightly -increase performance in some cases. -.Sh "Format stream specifiers" -.IX Subsection "Format stream specifiers" -Format stream specifiers allow selection of one or more streams that -match specific properties. -.PP -Possible forms of stream specifiers are: -.IP "\fIstream_index\fR" 4 -.IX Item "stream_index" -Matches the stream with this index. -.IP "\fIstream_type\fR\fB[:\fR\fIstream_index\fR\fB]\fR" 4 -.IX Item "stream_type[:stream_index]" -\&\fIstream_type\fR is one of following: 'v' for video, 'a' for audio, -\&'s' for subtitle, 'd' for data, and 't' for attachments. If -\&\fIstream_index\fR is given, then it matches the stream number -\&\fIstream_index\fR of this type. Otherwise, it matches all streams of -this type. -.IP "\fBp:\fR\fIprogram_id\fR\fB[:\fR\fIstream_index\fR\fB]\fR" 4 -.IX Item "p:program_id[:stream_index]" -If \fIstream_index\fR is given, then it matches the stream with number -\&\fIstream_index\fR in the program with the id -\&\fIprogram_id\fR. Otherwise, it matches all streams in the program. -.IP "\fB#\fR\fIstream_id\fR" 4 -.IX Item "#stream_id" -Matches the stream by a format-specific \s-1ID\s0. -.PP -The exact semantics of stream specifiers is defined by the -\&\f(CW\*(C`avformat_match_stream_specifier()\*(C'\fR function declared in the -\&\fIlibavformat/avformat.h\fR header. -.SH "DEMUXERS" -.IX Header "DEMUXERS" -Demuxers are configured elements in FFmpeg that can read the -multimedia streams from a particular type of file. -.PP -When you configure your FFmpeg build, all the supported demuxers -are enabled by default. You can list all available ones using the -configure option \f(CW\*(C`\-\-list\-demuxers\*(C'\fR. -.PP -You can disable all the demuxers using the configure option -\&\f(CW\*(C`\-\-disable\-demuxers\*(C'\fR, and selectively enable a single demuxer with -the option \f(CW\*(C`\-\-enable\-demuxer=\f(CI\s-1DEMUXER\s0\f(CW\*(C'\fR, or disable it -with the option \f(CW\*(C`\-\-disable\-demuxer=\f(CI\s-1DEMUXER\s0\f(CW\*(C'\fR. -.PP -The option \f(CW\*(C`\-formats\*(C'\fR of the ff* tools will display the list of -enabled demuxers. -.PP -The description of some of the currently available demuxers follows. -.Sh "applehttp" -.IX Subsection "applehttp" -Apple \s-1HTTP\s0 Live Streaming demuxer. -.PP -This demuxer presents all AVStreams from all variant streams. -The id field is set to the bitrate variant index number. By setting -the discard flags on AVStreams (by pressing 'a' or 'v' in ffplay), -the caller can decide which variant streams to actually receive. -The total bitrate of the variant that the stream belongs to is -available in a metadata key named \*(L"variant_bitrate\*(R". -.Sh "asf" -.IX Subsection "asf" -Advanced Systems Format demuxer. -.PP -This demuxer is used to demux \s-1ASF\s0 files and \s-1MMS\s0 network streams. -.IP "\fB\-no_resync_search\fR \fIbool\fR" 4 -.IX Item "-no_resync_search bool" -Do not try to resynchronize by looking for a certain optional start code. -.Sh "concat" -.IX Subsection "concat" -Virtual concatenation script demuxer. -.PP -This demuxer reads a list of files and other directives from a text file and -demuxes them one after the other, as if all their packet had been muxed -together. -.PP -The timestamps in the files are adjusted so that the first file starts at 0 -and each next file starts where the previous one finishes. Note that it is -done globally and may cause gaps if all streams do not have exactly the same -length. -.PP -All files must have the same streams (same codecs, same time base, etc.). -.PP -The duration of each file is used to adjust the timestamps of the next file: -if the duration is incorrect (because it was computed using the bit-rate or -because the file is truncated, for example), it can cause artifacts. The -\&\f(CW\*(C`duration\*(C'\fR directive can be used to override the duration stored in -each file. -.PP -\fISyntax\fR -.IX Subsection "Syntax" -.PP -The script is a text file in extended\-ASCII, with one directive per line. -Empty lines, leading spaces and lines starting with '#' are ignored. The -following directive is recognized: -.ie n .IP "\fB\fB""file \f(BIpath\f(CB""\fB\fR" 4 -.el .IP "\fB\f(CBfile \f(CBpath\f(CB\fB\fR" 4 -.IX Item "file path" -Path to a file to read; special characters and spaces must be escaped with -backslash or single quotes. -.Sp -All subsequent directives apply to that file. -.ie n .IP "\fB\fB""ffconcat version 1.0""\fB\fR" 4 -.el .IP "\fB\f(CBffconcat version 1.0\fB\fR" 4 -.IX Item "ffconcat version 1.0" -Identify the script type and version. It also sets the \fBsafe\fR option -to 1 if it was to its default \-1. -.Sp -To make FFmpeg recognize the format automatically, this directive must -appears exactly as is (no extra space or byte\-order\-mark) on the very first -line of the script. -.ie n .IP "\fB\fB""duration \f(BIdur\f(CB""\fB\fR" 4 -.el .IP "\fB\f(CBduration \f(CBdur\f(CB\fB\fR" 4 -.IX Item "duration dur" -Duration of the file. This information can be specified from the file; -specifying it here may be more efficient or help if the information from the -file is not available or accurate. -.Sp -If the duration is set for all files, then it is possible to seek in the -whole concatenated video. -.PP -\fIOptions\fR -.IX Subsection "Options" -.PP -This demuxer accepts the following option: -.IP "\fBsafe\fR" 4 -.IX Item "safe" -If set to 1, reject unsafe file paths. A file path is considered safe if it -does not contain a protocol specification and is relative and all components -only contain characters from the portable character set (letters, digits, -period, underscore and hyphen) and have no period at the beginning of a -component. -.Sp -If set to 0, any file name is accepted. -.Sp -The default is \-1, it is equivalent to 1 if the format was automatically -probed and 0 otherwise. -.Sh "flv" -.IX Subsection "flv" -Adobe Flash Video Format demuxer. -.PP -This demuxer is used to demux \s-1FLV\s0 files and \s-1RTMP\s0 network streams. -.IP "\fB\-flv_metadata\fR \fIbool\fR" 4 -.IX Item "-flv_metadata bool" -Allocate the streams according to the onMetaData array content. -.Sh "libgme" -.IX Subsection "libgme" -The Game Music Emu library is a collection of video game music file emulators. -.PP -See <\fBhttp://code.google.com/p/game\-music\-emu/\fR> for more information. -.PP -Some files have multiple tracks. The demuxer will pick the first track by -default. The \fBtrack_index\fR option can be used to select a different -track. Track indexes start at 0. The demuxer exports the number of tracks as -\&\fItracks\fR meta data entry. -.PP -For very large files, the \fBmax_size\fR option may have to be adjusted. -.Sh "libquvi" -.IX Subsection "libquvi" -Play media from Internet services using the quvi project. -.PP -The demuxer accepts a \fBformat\fR option to request a specific quality. It -is by default set to \fIbest\fR. -.PP -See <\fBhttp://quvi.sourceforge.net/\fR> for more information. -.PP -FFmpeg needs to be built with \f(CW\*(C`\-\-enable\-libquvi\*(C'\fR for this demuxer to be -enabled. -.Sh "image2" -.IX Subsection "image2" -Image file demuxer. -.PP -This demuxer reads from a list of image files specified by a pattern. -The syntax and meaning of the pattern is specified by the -option \fIpattern_type\fR. -.PP -The pattern may contain a suffix which is used to automatically -determine the format of the images contained in the files. -.PP -The size, the pixel format, and the format of each image must be the -same for all the files in the sequence. -.PP -This demuxer accepts the following options: -.IP "\fBframerate\fR" 4 -.IX Item "framerate" -Set the frame rate for the video stream. It defaults to 25. -.IP "\fBloop\fR" 4 -.IX Item "loop" -If set to 1, loop over the input. Default value is 0. -.IP "\fBpattern_type\fR" 4 -.IX Item "pattern_type" -Select the pattern type used to interpret the provided filename. -.Sp -\&\fIpattern_type\fR accepts one of the following values. -.RS 4 -.IP "\fBsequence\fR" 4 -.IX Item "sequence" -Select a sequence pattern type, used to specify a sequence of files -indexed by sequential numbers. -.Sp -A sequence pattern may contain the string \*(L"%d\*(R" or "%0\fIN\fRd\*(L", which -specifies the position of the characters representing a sequential -number in each filename matched by the pattern. If the form -\&\*(R"%d0\fIN\fRd" is used, the string representing the number in each -filename is 0\-padded and \fIN\fR is the total number of 0\-padded -digits representing the number. The literal character '%' can be -specified in the pattern with the string \*(L"%%\*(R". -.Sp -If the sequence pattern contains \*(L"%d\*(R" or "%0\fIN\fRd", the first filename of -the file list specified by the pattern must contain a number -inclusively contained between \fIstart_number\fR and -\&\fIstart_number\fR+\fIstart_number_range\fR\-1, and all the following -numbers must be sequential. -.Sp -For example the pattern \*(L"img\-%03d.bmp\*(R" will match a sequence of -filenames of the form \fIimg\-001.bmp\fR, \fIimg\-002.bmp\fR, ..., -\&\fIimg\-010.bmp\fR, etc.; the pattern \*(L"i%%m%%g\-%d.jpg\*(R" will match a -sequence of filenames of the form \fIi%m%g\-1.jpg\fR, -\&\fIi%m%g\-2.jpg\fR, ..., \fIi%m%g\-10.jpg\fR, etc. -.Sp -Note that the pattern must not necessarily contain \*(L"%d\*(R" or -"%0\fIN\fRd", for example to convert a single image file -\&\fIimg.jpeg\fR you can employ the command: -.Sp -.Vb 1 -\& ffmpeg -i img.jpeg img.png -.Ve -.IP "\fBglob\fR" 4 -.IX Item "glob" -Select a glob wildcard pattern type. -.Sp -The pattern is interpreted like a \f(CW\*(C`glob()\*(C'\fR pattern. This is only -selectable if libavformat was compiled with globbing support. -.IP "\fBglob_sequence\fR \fI(deprecated, will be removed)\fR" 4 -.IX Item "glob_sequence (deprecated, will be removed)" -Select a mixed glob wildcard/sequence pattern. -.Sp -If your version of libavformat was compiled with globbing support, and -the provided pattern contains at least one glob meta character among -\&\f(CW\*(C`%*?[]{}\*(C'\fR that is preceded by an unescaped \*(L"%\*(R", the pattern is -interpreted like a \f(CW\*(C`glob()\*(C'\fR pattern, otherwise it is interpreted -like a sequence pattern. -.Sp -All glob special characters \f(CW\*(C`%*?[]{}\*(C'\fR must be prefixed -with \*(L"%\*(R". To escape a literal \*(L"%\*(R" you shall use \*(L"%%\*(R". -.Sp -For example the pattern \f(CW\*(C`foo\-%*.jpeg\*(C'\fR will match all the -filenames prefixed by \*(L"foo\-\*(R" and terminating with \*(L".jpeg\*(R", and -\&\f(CW\*(C`foo\-%?%?%?.jpeg\*(C'\fR will match all the filenames prefixed with -\&\*(L"foo\-\*(R", followed by a sequence of three characters, and terminating -with \*(L".jpeg\*(R". -.Sp -This pattern type is deprecated in favor of \fIglob\fR and -\&\fIsequence\fR. -.RE -.RS 4 -.Sp -Default value is \fIglob_sequence\fR. -.RE -.IP "\fBpixel_format\fR" 4 -.IX Item "pixel_format" -Set the pixel format of the images to read. If not specified the pixel -format is guessed from the first image file in the sequence. -.IP "\fBstart_number\fR" 4 -.IX Item "start_number" -Set the index of the file matched by the image file pattern to start -to read from. Default value is 0. -.IP "\fBstart_number_range\fR" 4 -.IX Item "start_number_range" -Set the index interval range to check when looking for the first image -file in the sequence, starting from \fIstart_number\fR. Default value -is 5. -.IP "\fBts_from_file\fR" 4 -.IX Item "ts_from_file" -If set to 1, will set frame timestamp to modification time of image file. Note -that monotonity of timestamps is not provided: images go in the same order as -without this option. Default value is 0. -.IP "\fBvideo_size\fR" 4 -.IX Item "video_size" -Set the video size of the images to read. If not specified the video -size is guessed from the first image file in the sequence. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -Use \fBffmpeg\fR for creating a video from the images in the file -sequence \fIimg\-001.jpeg\fR, \fIimg\-002.jpeg\fR, ..., assuming an -input frame rate of 10 frames per second: -.Sp -.Vb 1 -\& ffmpeg -framerate 10 -i 'img-%03d.jpeg' out.mkv -.Ve -.IP "\(bu" 4 -As above, but start by reading from a file with index 100 in the sequence: -.Sp -.Vb 1 -\& ffmpeg -framerate 10 -start_number 100 -i 'img-%03d.jpeg' out.mkv -.Ve -.IP "\(bu" 4 -Read images matching the \*(L"*.png\*(R" glob pattern , that is all the files -terminating with the \*(L".png\*(R" suffix: -.Sp -.Vb 1 -\& ffmpeg -framerate 10 -pattern_type glob -i "*.png" out.mkv -.Ve -.Sh "mpegts" -.IX Subsection "mpegts" -\&\s-1MPEG\-2\s0 transport stream demuxer. -.IP "\fBfix_teletext_pts\fR" 4 -.IX Item "fix_teletext_pts" -Overrides teletext packet \s-1PTS\s0 and \s-1DTS\s0 values with the timestamps calculated -from the \s-1PCR\s0 of the first program which the teletext stream is part of and is -not discarded. Default value is 1, set this option to 0 if you want your -teletext packet \s-1PTS\s0 and \s-1DTS\s0 values untouched. -.Sh "rawvideo" -.IX Subsection "rawvideo" -Raw video demuxer. -.PP -This demuxer allows to read raw video data. Since there is no header -specifying the assumed video parameters, the user must specify them -in order to be able to decode the data correctly. -.PP -This demuxer accepts the following options: -.IP "\fBframerate\fR" 4 -.IX Item "framerate" -Set input video frame rate. Default value is 25. -.IP "\fBpixel_format\fR" 4 -.IX Item "pixel_format" -Set the input video pixel format. Default value is \f(CW\*(C`yuv420p\*(C'\fR. -.IP "\fBvideo_size\fR" 4 -.IX Item "video_size" -Set the input video size. This value must be specified explicitly. -.PP -For example to read a rawvideo file \fIinput.raw\fR with -\&\fBffplay\fR, assuming a pixel format of \f(CW\*(C`rgb24\*(C'\fR, a video -size of \f(CW\*(C`320x240\*(C'\fR, and a frame rate of 10 images per second, use -the command: -.PP -.Vb 1 -\& ffplay -f rawvideo -pixel_format rgb24 -video_size 320x240 -framerate 10 input.raw -.Ve -.Sh "sbg" -.IX Subsection "sbg" -SBaGen script demuxer. -.PP -This demuxer reads the script language used by SBaGen -<\fBhttp://uazu.net/sbagen/\fR> to generate binaural beats sessions. A \s-1SBG\s0 -script looks like that: -.PP -.Vb 9 -\& -SE -\& a: 300-2.5/3 440+4.5/0 -\& b: 300-2.5/0 440+4.5/3 -\& off: - -\& NOW == a -\& +0:07:00 == b -\& +0:14:00 == a -\& +0:21:00 == b -\& +0:30:00 off -.Ve -.PP -A \s-1SBG\s0 script can mix absolute and relative timestamps. If the script uses -either only absolute timestamps (including the script start time) or only -relative ones, then its layout is fixed, and the conversion is -straightforward. On the other hand, if the script mixes both kind of -timestamps, then the \fI\s-1NOW\s0\fR reference for relative timestamps will be -taken from the current time of day at the time the script is read, and the -script layout will be frozen according to that reference. That means that if -the script is directly played, the actual times will match the absolute -timestamps up to the sound controller's clock accuracy, but if the user -somehow pauses the playback or seeks, all times will be shifted accordingly. -.Sh "tedcaptions" -.IX Subsection "tedcaptions" -\&\s-1JSON\s0 captions used for <\fBhttp://www.ted.com/\fR>. -.PP -\&\s-1TED\s0 does not provide links to the captions, but they can be guessed from the -page. The file \fItools/bookmarklets.html\fR from the FFmpeg source tree -contains a bookmarklet to expose them. -.PP -This demuxer accepts the following option: -.IP "\fBstart_time\fR" 4 -.IX Item "start_time" -Set the start time of the \s-1TED\s0 talk, in milliseconds. The default is 15000 -(15s). It is used to sync the captions with the downloadable videos, because -they include a 15s intro. -.PP -Example: convert the captions to a format most players understand: -.PP -.Vb 1 -\& ffmpeg -i http://www.ted.com/talks/subtitles/id/1/lang/en talk1-en.srt -.Ve -.SH "MUXERS" -.IX Header "MUXERS" -Muxers are configured elements in FFmpeg which allow writing -multimedia streams to a particular type of file. -.PP -When you configure your FFmpeg build, all the supported muxers -are enabled by default. You can list all available muxers using the -configure option \f(CW\*(C`\-\-list\-muxers\*(C'\fR. -.PP -You can disable all the muxers with the configure option -\&\f(CW\*(C`\-\-disable\-muxers\*(C'\fR and selectively enable / disable single muxers -with the options \f(CW\*(C`\-\-enable\-muxer=\f(CI\s-1MUXER\s0\f(CW\*(C'\fR / -\&\f(CW\*(C`\-\-disable\-muxer=\f(CI\s-1MUXER\s0\f(CW\*(C'\fR. -.PP -The option \f(CW\*(C`\-formats\*(C'\fR of the ff* tools will display the list of -enabled muxers. -.PP -A description of some of the currently available muxers follows. -.Sh "aiff" -.IX Subsection "aiff" -Audio Interchange File Format muxer. -.PP -It accepts the following options: -.IP "\fBwrite_id3v2\fR" 4 -.IX Item "write_id3v2" -Enable ID3v2 tags writing when set to 1. Default is 0 (disabled). -.IP "\fBid3v2_version\fR" 4 -.IX Item "id3v2_version" -Select ID3v2 version to write. Currently only version 3 and 4 (aka. -ID3v2.3 and ID3v2.4) are supported. The default is version 4. -.Sh "crc" -.IX Subsection "crc" -\&\s-1CRC\s0 (Cyclic Redundancy Check) testing format. -.PP -This muxer computes and prints the Adler\-32 \s-1CRC\s0 of all the input audio -and video frames. By default audio frames are converted to signed -16\-bit raw audio and video frames to raw video before computing the -\&\s-1CRC\s0. -.PP -The output of the muxer consists of a single line of the form: -CRC=0x\fI\s-1CRC\s0\fR, where \fI\s-1CRC\s0\fR is a hexadecimal number 0\-padded to -8 digits containing the \s-1CRC\s0 for all the decoded input frames. -.PP -For example to compute the \s-1CRC\s0 of the input, and store it in the file -\&\fIout.crc\fR: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f crc out.crc -.Ve -.PP -You can print the \s-1CRC\s0 to stdout with the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f crc - -.Ve -.PP -You can select the output format of each frame with \fBffmpeg\fR by -specifying the audio and video codec and format. For example to -compute the \s-1CRC\s0 of the input audio converted to \s-1PCM\s0 unsigned 8\-bit -and the input video converted to \s-1MPEG\-2\s0 video, use the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc - -.Ve -.PP -See also the framecrc muxer. -.Sh "framecrc" -.IX Subsection "framecrc" -Per-packet \s-1CRC\s0 (Cyclic Redundancy Check) testing format. -.PP -This muxer computes and prints the Adler\-32 \s-1CRC\s0 for each audio -and video packet. By default audio frames are converted to signed -16\-bit raw audio and video frames to raw video before computing the -\&\s-1CRC\s0. -.PP -The output of the muxer consists of a line for each audio and video -packet of the form: -.PP -.Vb 1 -\& , , , , , 0x -.Ve -.PP -\&\fI\s-1CRC\s0\fR is a hexadecimal number 0\-padded to 8 digits containing the -\&\s-1CRC\s0 of the packet. -.PP -For example to compute the \s-1CRC\s0 of the audio and video frames in -\&\fI\s-1INPUT\s0\fR, converted to raw audio and video packets, and store it -in the file \fIout.crc\fR: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f framecrc out.crc -.Ve -.PP -To print the information to stdout, use the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f framecrc - -.Ve -.PP -With \fBffmpeg\fR, you can select the output format to which the -audio and video frames are encoded before computing the \s-1CRC\s0 for each -packet by specifying the audio and video codec. For example, to -compute the \s-1CRC\s0 of each decoded input audio frame converted to \s-1PCM\s0 -unsigned 8\-bit and of each decoded input video frame converted to -\&\s-1MPEG\-2\s0 video, use the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f framecrc - -.Ve -.PP -See also the crc muxer. -.Sh "framemd5" -.IX Subsection "framemd5" -Per-packet \s-1MD5\s0 testing format. -.PP -This muxer computes and prints the \s-1MD5\s0 hash for each audio -and video packet. By default audio frames are converted to signed -16\-bit raw audio and video frames to raw video before computing the -hash. -.PP -The output of the muxer consists of a line for each audio and video -packet of the form: -.PP -.Vb 1 -\& , , , , , -.Ve -.PP -\&\fI\s-1MD5\s0\fR is a hexadecimal number representing the computed \s-1MD5\s0 hash -for the packet. -.PP -For example to compute the \s-1MD5\s0 of the audio and video frames in -\&\fI\s-1INPUT\s0\fR, converted to raw audio and video packets, and store it -in the file \fIout.md5\fR: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f framemd5 out.md5 -.Ve -.PP -To print the information to stdout, use the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f framemd5 - -.Ve -.PP -See also the md5 muxer. -.Sh "hls" -.IX Subsection "hls" -Apple \s-1HTTP\s0 Live Streaming muxer that segments MPEG-TS according to -the \s-1HTTP\s0 Live Streaming specification. -.PP -It creates a playlist file and numbered segment files. The output -filename specifies the playlist filename; the segment filenames -receive the same basename as the playlist, a sequential number and -a .ts extension. -.PP -.Vb 1 -\& ffmpeg -i in.nut out.m3u8 -.Ve -.IP "\fB\-hls_time\fR \fIseconds\fR" 4 -.IX Item "-hls_time seconds" -Set the segment length in seconds. -.IP "\fB\-hls_list_size\fR \fIsize\fR" 4 -.IX Item "-hls_list_size size" -Set the maximum number of playlist entries. -.IP "\fB\-hls_wrap\fR \fIwrap\fR" 4 -.IX Item "-hls_wrap wrap" -Set the number after which index wraps. -.IP "\fB\-start_number\fR \fInumber\fR" 4 -.IX Item "-start_number number" -Start the sequence from \fInumber\fR. -.Sh "ico" -.IX Subsection "ico" -\&\s-1ICO\s0 file muxer. -.PP -Microsoft's icon file format (\s-1ICO\s0) has some strict limitations that should be noted: -.IP "\(bu" 4 -Size cannot exceed 256 pixels in any dimension -.IP "\(bu" 4 -Only \s-1BMP\s0 and \s-1PNG\s0 images can be stored -.IP "\(bu" 4 -If a \s-1BMP\s0 image is used, it must be one of the following pixel formats: -.Sp -.Vb 7 -\& BMP Bit Depth FFmpeg Pixel Format -\& 1bit pal8 -\& 4bit pal8 -\& 8bit pal8 -\& 16bit rgb555le -\& 24bit bgr24 -\& 32bit bgra -.Ve -.IP "\(bu" 4 -If a \s-1BMP\s0 image is used, it must use the \s-1BITMAPINFOHEADER\s0 \s-1DIB\s0 header -.IP "\(bu" 4 -If a \s-1PNG\s0 image is used, it must use the rgba pixel format -.Sh "image2" -.IX Subsection "image2" -Image file muxer. -.PP -The image file muxer writes video frames to image files. -.PP -The output filenames are specified by a pattern, which can be used to -produce sequentially numbered series of files. -The pattern may contain the string \*(L"%d\*(R" or "%0\fIN\fRd\*(L", this string -specifies the position of the characters representing a numbering in -the filenames. If the form \*(R"%0\fIN\fRd" is used, the string -representing the number in each filename is 0\-padded to \fIN\fR -digits. The literal character '%' can be specified in the pattern with -the string \*(L"%%\*(R". -.PP -If the pattern contains \*(L"%d\*(R" or "%0\fIN\fRd", the first filename of -the file list specified will contain the number 1, all the following -numbers will be sequential. -.PP -The pattern may contain a suffix which is used to automatically -determine the format of the image files to write. -.PP -For example the pattern \*(L"img\-%03d.bmp\*(R" will specify a sequence of -filenames of the form \fIimg\-001.bmp\fR, \fIimg\-002.bmp\fR, ..., -\&\fIimg\-010.bmp\fR, etc. -The pattern \*(L"img%%\-%d.jpg\*(R" will specify a sequence of filenames of the -form \fIimg%\-1.jpg\fR, \fIimg%\-2.jpg\fR, ..., \fIimg%\-10.jpg\fR, -etc. -.PP -The following example shows how to use \fBffmpeg\fR for creating a -sequence of files \fIimg\-001.jpeg\fR, \fIimg\-002.jpeg\fR, ..., -taking one image every second from the input video: -.PP -.Vb 1 -\& ffmpeg -i in.avi -vsync 1 -r 1 -f image2 'img-%03d.jpeg' -.Ve -.PP -Note that with \fBffmpeg\fR, if the format is not specified with the -\&\f(CW\*(C`\-f\*(C'\fR option and the output filename specifies an image file -format, the image2 muxer is automatically selected, so the previous -command can be written as: -.PP -.Vb 1 -\& ffmpeg -i in.avi -vsync 1 -r 1 'img-%03d.jpeg' -.Ve -.PP -Note also that the pattern must not necessarily contain \*(L"%d\*(R" or -"%0\fIN\fRd", for example to create a single image file -\&\fIimg.jpeg\fR from the input video you can employ the command: -.PP -.Vb 1 -\& ffmpeg -i in.avi -f image2 -frames:v 1 img.jpeg -.Ve -.IP "\fBstart_number\fR \fInumber\fR" 4 -.IX Item "start_number number" -Start the sequence from \fInumber\fR. Default value is 1. Must be a -non-negative number. -.IP "\fB\-update\fR \fInumber\fR" 4 -.IX Item "-update number" -If \fInumber\fR is nonzero, the filename will always be interpreted as just a -filename, not a pattern, and this file will be continuously overwritten with new -images. -.PP -The image muxer supports the .Y.U.V image file format. This format is -special in that that each image frame consists of three files, for -each of the \s-1YUV420P\s0 components. To read or write this image file format, -specify the name of the '.Y' file. The muxer will automatically open the -\&'.U' and '.V' files as required. -.Sh "matroska" -.IX Subsection "matroska" -Matroska container muxer. -.PP -This muxer implements the matroska and webm container specs. -.PP -The recognized metadata settings in this muxer are: -.IP "\fBtitle=\fR\fItitle name\fR" 4 -.IX Item "title=title name" -Name provided to a single track -.IP "\fBlanguage=\fR\fIlanguage name\fR" 4 -.IX Item "language=language name" -Specifies the language of the track in the Matroska languages form -.IP "\fBstereo_mode=\fR\fImode\fR" 4 -.IX Item "stereo_mode=mode" -Stereo 3D video layout of two views in a single video track -.RS 4 -.IP "\fBmono\fR" 4 -.IX Item "mono" -video is not stereo -.IP "\fBleft_right\fR" 4 -.IX Item "left_right" -Both views are arranged side by side, Left-eye view is on the left -.IP "\fBbottom_top\fR" 4 -.IX Item "bottom_top" -Both views are arranged in top-bottom orientation, Left-eye view is at bottom -.IP "\fBtop_bottom\fR" 4 -.IX Item "top_bottom" -Both views are arranged in top-bottom orientation, Left-eye view is on top -.IP "\fBcheckerboard_rl\fR" 4 -.IX Item "checkerboard_rl" -Each view is arranged in a checkerboard interleaved pattern, Left-eye view being first -.IP "\fBcheckerboard_lr\fR" 4 -.IX Item "checkerboard_lr" -Each view is arranged in a checkerboard interleaved pattern, Right-eye view being first -.IP "\fBrow_interleaved_rl\fR" 4 -.IX Item "row_interleaved_rl" -Each view is constituted by a row based interleaving, Right-eye view is first row -.IP "\fBrow_interleaved_lr\fR" 4 -.IX Item "row_interleaved_lr" -Each view is constituted by a row based interleaving, Left-eye view is first row -.IP "\fBcol_interleaved_rl\fR" 4 -.IX Item "col_interleaved_rl" -Both views are arranged in a column based interleaving manner, Right-eye view is first column -.IP "\fBcol_interleaved_lr\fR" 4 -.IX Item "col_interleaved_lr" -Both views are arranged in a column based interleaving manner, Left-eye view is first column -.IP "\fBanaglyph_cyan_red\fR" 4 -.IX Item "anaglyph_cyan_red" -All frames are in anaglyph format viewable through red-cyan filters -.IP "\fBright_left\fR" 4 -.IX Item "right_left" -Both views are arranged side by side, Right-eye view is on the left -.IP "\fBanaglyph_green_magenta\fR" 4 -.IX Item "anaglyph_green_magenta" -All frames are in anaglyph format viewable through green-magenta filters -.IP "\fBblock_lr\fR" 4 -.IX Item "block_lr" -Both eyes laced in one Block, Left-eye view is first -.IP "\fBblock_rl\fR" 4 -.IX Item "block_rl" -Both eyes laced in one Block, Right-eye view is first -.RE -.RS 4 -.RE -.PP -For example a 3D WebM clip can be created using the following command line: -.PP -.Vb 1 -\& ffmpeg -i sample_left_right_clip.mpg -an -c:v libvpx -metadata stereo_mode=left_right -y stereo_clip.webm -.Ve -.PP -This muxer supports the following options: -.IP "\fBreserve_index_space\fR" 4 -.IX Item "reserve_index_space" -By default, this muxer writes the index for seeking (called cues in Matroska -terms) at the end of the file, because it cannot know in advance how much space -to leave for the index at the beginning of the file. However for some use cases -\&\*(-- e.g. streaming where seeking is possible but slow \*(-- it is useful to put the -index at the beginning of the file. -.Sp -If this option is set to a non-zero value, the muxer will reserve a given amount -of space in the file header and then try to write the cues there when the muxing -finishes. If the available space does not suffice, muxing will fail. A safe size -for most use cases should be about 50kB per hour of video. -.Sp -Note that cues are only written if the output is seekable and this option will -have no effect if it is not. -.Sh "md5" -.IX Subsection "md5" -\&\s-1MD5\s0 testing format. -.PP -This muxer computes and prints the \s-1MD5\s0 hash of all the input audio -and video frames. By default audio frames are converted to signed -16\-bit raw audio and video frames to raw video before computing the -hash. -.PP -The output of the muxer consists of a single line of the form: -MD5=\fI\s-1MD5\s0\fR, where \fI\s-1MD5\s0\fR is a hexadecimal number representing -the computed \s-1MD5\s0 hash. -.PP -For example to compute the \s-1MD5\s0 hash of the input converted to raw -audio and video, and store it in the file \fIout.md5\fR: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f md5 out.md5 -.Ve -.PP -You can print the \s-1MD5\s0 to stdout with the command: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f md5 - -.Ve -.PP -See also the framemd5 muxer. -.Sh "\s-1MOV/MP4/ISMV\s0" -.IX Subsection "MOV/MP4/ISMV" -The mov/mp4/ismv muxer supports fragmentation. Normally, a \s-1MOV/MP4\s0 -file has all the metadata about all packets stored in one location -(written at the end of the file, it can be moved to the start for -better playback by adding \fIfaststart\fR to the \fImovflags\fR, or -using the \fBqt-faststart\fR tool). A fragmented -file consists of a number of fragments, where packets and metadata -about these packets are stored together. Writing a fragmented -file has the advantage that the file is decodable even if the -writing is interrupted (while a normal \s-1MOV/MP4\s0 is undecodable if -it is not properly finished), and it requires less memory when writing -very long files (since writing normal \s-1MOV/MP4\s0 files stores info about -every single packet in memory until the file is closed). The downside -is that it is less compatible with other applications. -.PP -Fragmentation is enabled by setting one of the AVOptions that define -how to cut the file into fragments: -.IP "\fB\-moov_size\fR \fIbytes\fR" 4 -.IX Item "-moov_size bytes" -Reserves space for the moov atom at the beginning of the file instead of placing the -moov atom at the end. If the space reserved is insufficient, muxing will fail. -.IP "\fB\-movflags frag_keyframe\fR" 4 -.IX Item "-movflags frag_keyframe" -Start a new fragment at each video keyframe. -.IP "\fB\-frag_duration\fR \fIduration\fR" 4 -.IX Item "-frag_duration duration" -Create fragments that are \fIduration\fR microseconds long. -.IP "\fB\-frag_size\fR \fIsize\fR" 4 -.IX Item "-frag_size size" -Create fragments that contain up to \fIsize\fR bytes of payload data. -.IP "\fB\-movflags frag_custom\fR" 4 -.IX Item "-movflags frag_custom" -Allow the caller to manually choose when to cut fragments, by -calling \f(CW\*(C`av_write_frame(ctx, NULL)\*(C'\fR to write a fragment with -the packets written so far. (This is only useful with other -applications integrating libavformat, not from \fBffmpeg\fR.) -.IP "\fB\-min_frag_duration\fR \fIduration\fR" 4 -.IX Item "-min_frag_duration duration" -Don't create fragments that are shorter than \fIduration\fR microseconds long. -.PP -If more than one condition is specified, fragments are cut when -one of the specified conditions is fulfilled. The exception to this is -\&\f(CW\*(C`\-min_frag_duration\*(C'\fR, which has to be fulfilled for any of the other -conditions to apply. -.PP -Additionally, the way the output file is written can be adjusted -through a few other options: -.IP "\fB\-movflags empty_moov\fR" 4 -.IX Item "-movflags empty_moov" -Write an initial moov atom directly at the start of the file, without -describing any samples in it. Generally, an mdat/moov pair is written -at the start of the file, as a normal \s-1MOV/MP4\s0 file, containing only -a short portion of the file. With this option set, there is no initial -mdat atom, and the moov atom only describes the tracks but has -a zero duration. -.Sp -Files written with this option set do not work in QuickTime. -This option is implicitly set when writing ismv (Smooth Streaming) files. -.IP "\fB\-movflags separate_moof\fR" 4 -.IX Item "-movflags separate_moof" -Write a separate moof (movie fragment) atom for each track. Normally, -packets for all tracks are written in a moof atom (which is slightly -more efficient), but with this option set, the muxer writes one moof/mdat -pair for each track, making it easier to separate tracks. -.Sp -This option is implicitly set when writing ismv (Smooth Streaming) files. -.IP "\fB\-movflags faststart\fR" 4 -.IX Item "-movflags faststart" -Run a second pass moving the index (moov atom) to the beginning of the file. -This operation can take a while, and will not work in various situations such -as fragmented output, thus it is not enabled by default. -.IP "\fB\-movflags rtphint\fR" 4 -.IX Item "-movflags rtphint" -Add \s-1RTP\s0 hinting tracks to the output file. -.PP -Smooth Streaming content can be pushed in real time to a publishing -point on \s-1IIS\s0 with this muxer. Example: -.PP -.Vb 1 -\& ffmpeg -re <> -movflags isml+frag_keyframe -f ismv http://server/publishingpoint.isml/Streams(Encoder1) -.Ve -.Sh "mp3" -.IX Subsection "mp3" -The \s-1MP3\s0 muxer writes a raw \s-1MP3\s0 stream with an ID3v2 header at the beginning and -optionally an ID3v1 tag at the end. ID3v2.3 and ID3v2.4 are supported, the -\&\f(CW\*(C`id3v2_version\*(C'\fR option controls which one is used. The legacy ID3v1 tag is -not written by default, but may be enabled with the \f(CW\*(C`write_id3v1\*(C'\fR option. -.PP -For seekable output the muxer also writes a Xing frame at the beginning, which -contains the number of frames in the file. It is useful for computing duration -of \s-1VBR\s0 files. -.PP -The muxer supports writing ID3v2 attached pictures (\s-1APIC\s0 frames). The pictures -are supplied to the muxer in form of a video stream with a single packet. There -can be any number of those streams, each will correspond to a single \s-1APIC\s0 frame. -The stream metadata tags \fItitle\fR and \fIcomment\fR map to \s-1APIC\s0 -\&\fIdescription\fR and \fIpicture type\fR respectively. See -<\fBhttp://id3.org/id3v2.4.0\-frames\fR> for allowed picture types. -.PP -Note that the \s-1APIC\s0 frames must be written at the beginning, so the muxer will -buffer the audio frames until it gets all the pictures. It is therefore advised -to provide the pictures as soon as possible to avoid excessive buffering. -.PP -Examples: -.PP -Write an mp3 with an ID3v2.3 header and an ID3v1 footer: -.PP -.Vb 1 -\& ffmpeg -i INPUT -id3v2_version 3 -write_id3v1 1 out.mp3 -.Ve -.PP -To attach a picture to an mp3 file select both the audio and the picture stream -with \f(CW\*(C`map\*(C'\fR: -.PP -.Vb 2 -\& ffmpeg -i input.mp3 -i cover.png -c copy -map 0 -map 1 -\& -metadata:s:v title="Album cover" -metadata:s:v comment="Cover (Front)" out.mp3 -.Ve -.Sh "mpegts" -.IX Subsection "mpegts" -\&\s-1MPEG\s0 transport stream muxer. -.PP -This muxer implements \s-1ISO\s0 13818\-1 and part of \s-1ETSI\s0 \s-1EN\s0 300 468. -.PP -The muxer options are: -.IP "\fB\-mpegts_original_network_id\fR \fInumber\fR" 4 -.IX Item "-mpegts_original_network_id number" -Set the original_network_id (default 0x0001). This is unique identifier -of a network in \s-1DVB\s0. Its main use is in the unique identification of a -service through the path Original_Network_ID, Transport_Stream_ID. -.IP "\fB\-mpegts_transport_stream_id\fR \fInumber\fR" 4 -.IX Item "-mpegts_transport_stream_id number" -Set the transport_stream_id (default 0x0001). This identifies a -transponder in \s-1DVB\s0. -.IP "\fB\-mpegts_service_id\fR \fInumber\fR" 4 -.IX Item "-mpegts_service_id number" -Set the service_id (default 0x0001) also known as program in \s-1DVB\s0. -.IP "\fB\-mpegts_pmt_start_pid\fR \fInumber\fR" 4 -.IX Item "-mpegts_pmt_start_pid number" -Set the first \s-1PID\s0 for \s-1PMT\s0 (default 0x1000, max 0x1f00). -.IP "\fB\-mpegts_start_pid\fR \fInumber\fR" 4 -.IX Item "-mpegts_start_pid number" -Set the first \s-1PID\s0 for data packets (default 0x0100, max 0x0f00). -.IP "\fB\-mpegts_m2ts_mode\fR \fInumber\fR" 4 -.IX Item "-mpegts_m2ts_mode number" -Enable m2ts mode if set to 1. Default value is \-1 which disables m2ts mode. -.IP "\fB\-muxrate\fR \fInumber\fR" 4 -.IX Item "-muxrate number" -Set muxrate. -.IP "\fB\-pes_payload_size\fR \fInumber\fR" 4 -.IX Item "-pes_payload_size number" -Set minimum \s-1PES\s0 packet payload in bytes. -.IP "\fB\-mpegts_flags\fR \fIflags\fR" 4 -.IX Item "-mpegts_flags flags" -Set flags (see below). -.IP "\fB\-mpegts_copyts\fR \fInumber\fR" 4 -.IX Item "-mpegts_copyts number" -Preserve original timestamps, if value is set to 1. Default value is \-1, which -results in shifting timestamps so that they start from 0. -.IP "\fB\-tables_version\fR \fInumber\fR" 4 -.IX Item "-tables_version number" -Set \s-1PAT\s0, \s-1PMT\s0 and \s-1SDT\s0 version (default 0, valid values are from 0 to 31, inclusively). -This option allows updating stream structure so that standard consumer may -detect the change. To do so, reopen output AVFormatContext (in case of \s-1API\s0 -usage) or restart ffmpeg instance, cyclically changing tables_version value: -.Sp -.Vb 7 -\& ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111 -\& ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111 -\& ... -\& ffmpeg -i source3.ts -codec copy -f mpegts -tables_version 31 udp://1.1.1.1:1111 -\& ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111 -\& ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111 -\& ... -.Ve -.PP -Option mpegts_flags may take a set of such flags: -.IP "\fBresend_headers\fR" 4 -.IX Item "resend_headers" -Reemit \s-1PAT/PMT\s0 before writing the next packet. -.IP "\fBlatm\fR" 4 -.IX Item "latm" -Use \s-1LATM\s0 packetization for \s-1AAC\s0. -.PP -The recognized metadata settings in mpegts muxer are \f(CW\*(C`service_provider\*(C'\fR -and \f(CW\*(C`service_name\*(C'\fR. If they are not set the default for -\&\f(CW\*(C`service_provider\*(C'\fR is \*(L"FFmpeg\*(R" and the default for -\&\f(CW\*(C`service_name\*(C'\fR is \*(L"Service01\*(R". -.PP -.Vb 9 -\& ffmpeg -i file.mpg -c copy \e -\& -mpegts_original_network_id 0x1122 \e -\& -mpegts_transport_stream_id 0x3344 \e -\& -mpegts_service_id 0x5566 \e -\& -mpegts_pmt_start_pid 0x1500 \e -\& -mpegts_start_pid 0x150 \e -\& -metadata service_provider="Some provider" \e -\& -metadata service_name="Some Channel" \e -\& -y out.ts -.Ve -.Sh "null" -.IX Subsection "null" -Null muxer. -.PP -This muxer does not generate any output file, it is mainly useful for -testing or benchmarking purposes. -.PP -For example to benchmark decoding with \fBffmpeg\fR you can use the -command: -.PP -.Vb 1 -\& ffmpeg -benchmark -i INPUT -f null out.null -.Ve -.PP -Note that the above command does not read or write the \fIout.null\fR -file, but specifying the output file is required by the \fBffmpeg\fR -syntax. -.PP -Alternatively you can write the command as: -.PP -.Vb 1 -\& ffmpeg -benchmark -i INPUT -f null - -.Ve -.Sh "ogg" -.IX Subsection "ogg" -Ogg container muxer. -.IP "\fB\-page_duration\fR \fIduration\fR" 4 -.IX Item "-page_duration duration" -Preferred page duration, in microseconds. The muxer will attempt to create -pages that are approximately \fIduration\fR microseconds long. This allows the -user to compromise between seek granularity and container overhead. The default -is 1 second. A value of 0 will fill all segments, making pages as large as -possible. A value of 1 will effectively use 1 packet-per-page in most -situations, giving a small seek granularity at the cost of additional container -overhead. -.Sh "segment, stream_segment, ssegment" -.IX Subsection "segment, stream_segment, ssegment" -Basic stream segmenter. -.PP -The segmenter muxer outputs streams to a number of separate files of nearly -fixed duration. Output filename pattern can be set in a fashion similar to -image2. -.PP -\&\f(CW\*(C`stream_segment\*(C'\fR is a variant of the muxer used to write to -streaming output formats, i.e. which do not require global headers, -and is recommended for outputting e.g. to \s-1MPEG\s0 transport stream segments. -\&\f(CW\*(C`ssegment\*(C'\fR is a shorter alias for \f(CW\*(C`stream_segment\*(C'\fR. -.PP -Every segment starts with a keyframe of the selected reference stream, -which is set through the \fBreference_stream\fR option. -.PP -Note that if you want accurate splitting for a video file, you need to -make the input key frames correspond to the exact splitting times -expected by the segmenter, or the segment muxer will start the new -segment with the key frame found next after the specified start -time. -.PP -The segment muxer works best with a single constant frame rate video. -.PP -Optionally it can generate a list of the created segments, by setting -the option \fIsegment_list\fR. The list type is specified by the -\&\fIsegment_list_type\fR option. -.PP -The segment muxer supports the following options: -.IP "\fBreference_stream\fR \fIspecifier\fR" 4 -.IX Item "reference_stream specifier" -Set the reference stream, as specified by the string \fIspecifier\fR. -If \fIspecifier\fR is set to \f(CW\*(C`auto\*(C'\fR, the reference is choosen -automatically. Otherwise it must be a stream specifier (see the ``Stream -specifiers'' chapter in the ffmpeg manual) which specifies the -reference stream. The default value is \f(CW\*(C`auto\*(C'\fR. -.IP "\fBsegment_format\fR \fIformat\fR" 4 -.IX Item "segment_format format" -Override the inner container format, by default it is guessed by the filename -extension. -.IP "\fBsegment_list\fR \fIname\fR" 4 -.IX Item "segment_list name" -Generate also a listfile named \fIname\fR. If not specified no -listfile is generated. -.IP "\fBsegment_list_flags\fR \fIflags\fR" 4 -.IX Item "segment_list_flags flags" -Set flags affecting the segment list generation. -.Sp -It currently supports the following flags: -.RS 4 -.IP "\fBcache\fR" 4 -.IX Item "cache" -Allow caching (only affects M3U8 list files). -.IP "\fBlive\fR" 4 -.IX Item "live" -Allow live-friendly file generation. -.RE -.RS 4 -.Sp -Default value is \f(CW\*(C`samp\*(C'\fR. -.RE -.IP "\fBsegment_list_size\fR \fIsize\fR" 4 -.IX Item "segment_list_size size" -Update the list file so that it contains at most the last \fIsize\fR -segments. If 0 the list file will contain all the segments. Default -value is 0. -.IP "\fBsegment_list_type\fR \fItype\fR" 4 -.IX Item "segment_list_type type" -Specify the format for the segment list file. -.Sp -The following values are recognized: -.RS 4 -.IP "\fBflat\fR" 4 -.IX Item "flat" -Generate a flat list for the created segments, one segment per line. -.IP "\fBcsv, ext\fR" 4 -.IX Item "csv, ext" -Generate a list for the created segments, one segment per line, -each line matching the format (comma\-separated values): -.Sp -.Vb 1 -\& ,, -.Ve -.Sp -\&\fIsegment_filename\fR is the name of the output file generated by the -muxer according to the provided pattern. \s-1CSV\s0 escaping (according to -\&\s-1RFC4180\s0) is applied if required. -.Sp -\&\fIsegment_start_time\fR and \fIsegment_end_time\fR specify -the segment start and end time expressed in seconds. -.Sp -A list file with the suffix \f(CW".csv"\fR or \f(CW".ext"\fR will -auto-select this format. -.Sp -\&\fBext\fR is deprecated in favor or \fBcsv\fR. -.IP "\fBffconcat\fR" 4 -.IX Item "ffconcat" -Generate an ffconcat file for the created segments. The resulting file -can be read using the FFmpeg concat demuxer. -.Sp -A list file with the suffix \f(CW".ffcat"\fR or \f(CW".ffconcat"\fR will -auto-select this format. -.IP "\fBm3u8\fR" 4 -.IX Item "m3u8" -Generate an extended M3U8 file, version 3, compliant with -<\fBhttp://tools.ietf.org/id/draft\-pantos\-http\-live\-streaming\fR>. -.Sp -A list file with the suffix \f(CW".m3u8"\fR will auto-select this format. -.RE -.RS 4 -.Sp -If not specified the type is guessed from the list file name suffix. -.RE -.IP "\fBsegment_time\fR \fItime\fR" 4 -.IX Item "segment_time time" -Set segment duration to \fItime\fR, the value must be a duration -specification. Default value is \*(L"2\*(R". See also the -\&\fBsegment_times\fR option. -.Sp -Note that splitting may not be accurate, unless you force the -reference stream key-frames at the given time. See the introductory -notice and the examples below. -.IP "\fBsegment_time_delta\fR \fIdelta\fR" 4 -.IX Item "segment_time_delta delta" -Specify the accuracy time when selecting the start time for a -segment, expressed as a duration specification. Default value is \*(L"0\*(R". -.Sp -When delta is specified a key-frame will start a new segment if its -\&\s-1PTS\s0 satisfies the relation: -.Sp -.Vb 1 -\& PTS >= start_time - time_delta -.Ve -.Sp -This option is useful when splitting video content, which is always -split at \s-1GOP\s0 boundaries, in case a key frame is found just before the -specified split time. -.Sp -In particular may be used in combination with the \fIffmpeg\fR option -\&\fIforce_key_frames\fR. The key frame times specified by -\&\fIforce_key_frames\fR may not be set accurately because of rounding -issues, with the consequence that a key frame time may result set just -before the specified time. For constant frame rate videos a value of -1/2*\fIframe_rate\fR should address the worst case mismatch between -the specified time and the time set by \fIforce_key_frames\fR. -.IP "\fBsegment_times\fR \fItimes\fR" 4 -.IX Item "segment_times times" -Specify a list of split points. \fItimes\fR contains a list of comma -separated duration specifications, in increasing order. See also -the \fBsegment_time\fR option. -.IP "\fBsegment_frames\fR \fIframes\fR" 4 -.IX Item "segment_frames frames" -Specify a list of split video frame numbers. \fIframes\fR contains a -list of comma separated integer numbers, in increasing order. -.Sp -This option specifies to start a new segment whenever a reference -stream key frame is found and the sequential number (starting from 0) -of the frame is greater or equal to the next value in the list. -.IP "\fBsegment_wrap\fR \fIlimit\fR" 4 -.IX Item "segment_wrap limit" -Wrap around segment index once it reaches \fIlimit\fR. -.IP "\fBsegment_start_number\fR \fInumber\fR" 4 -.IX Item "segment_start_number number" -Set the sequence number of the first segment. Defaults to \f(CW0\fR. -.IP "\fBreset_timestamps\fR \fI1|0\fR" 4 -.IX Item "reset_timestamps 1|0" -Reset timestamps at the begin of each segment, so that each segment -will start with near-zero timestamps. It is meant to ease the playback -of the generated segments. May not work with some combinations of -muxers/codecs. It is set to \f(CW0\fR by default. -.IP "\fBinitial_offset\fR \fIoffset\fR" 4 -.IX Item "initial_offset offset" -Specify timestamp offset to apply to the output packet timestamps. The -argument must be a time duration specification, and defaults to 0. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -To remux the content of file \fIin.mkv\fR to a list of segments -\&\fIout\-000.nut\fR, \fIout\-001.nut\fR, etc., and write the list of -generated segments to \fIout.list\fR: -.Sp -.Vb 1 -\& ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.list out%03d.nut -.Ve -.IP "\(bu" 4 -As the example above, but segment the input file according to the split -points specified by the \fIsegment_times\fR option: -.Sp -.Vb 1 -\& ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.csv -segment_times 1,2,3,5,8,13,21 out%03d.nut -.Ve -.IP "\(bu" 4 -As the example above, but use the \fBffmpeg\fR \fBforce_key_frames\fR -option to force key frames in the input at the specified location, together -with the segment option \fBsegment_time_delta\fR to account for -possible roundings operated when setting key frame times. -.Sp -.Vb 2 -\& ffmpeg -i in.mkv -force_key_frames 1,2,3,5,8,13,21 -codec:v mpeg4 -codec:a pcm_s16le -map 0 \e -\& -f segment -segment_list out.csv -segment_times 1,2,3,5,8,13,21 -segment_time_delta 0.05 out%03d.nut -.Ve -.Sp -In order to force key frames on the input file, transcoding is -required. -.IP "\(bu" 4 -Segment the input file by splitting the input file according to the -frame numbers sequence specified with the \fBsegment_frames\fR option: -.Sp -.Vb 1 -\& ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.csv -segment_frames 100,200,300,500,800 out%03d.nut -.Ve -.IP "\(bu" 4 -To convert the \fIin.mkv\fR to \s-1TS\s0 segments using the \f(CW\*(C`libx264\*(C'\fR -and \f(CW\*(C`libfaac\*(C'\fR encoders: -.Sp -.Vb 1 -\& ffmpeg -i in.mkv -map 0 -codec:v libx264 -codec:a libfaac -f ssegment -segment_list out.list out%03d.ts -.Ve -.IP "\(bu" 4 -Segment the input file, and create an M3U8 live playlist (can be used -as live \s-1HLS\s0 source): -.Sp -.Vb 2 -\& ffmpeg -re -i in.mkv -codec copy -map 0 -f segment -segment_list playlist.m3u8 \e -\& -segment_list_flags +live -segment_time 10 out%03d.mkv -.Ve -.Sh "tee" -.IX Subsection "tee" -The tee muxer can be used to write the same data to several files or any -other kind of muxer. It can be used, for example, to both stream a video to -the network and save it to disk at the same time. -.PP -It is different from specifying several outputs to the \fBffmpeg\fR -command-line tool because the audio and video data will be encoded only once -with the tee muxer; encoding can be a very expensive process. It is not -useful when using the libavformat \s-1API\s0 directly because it is then possible -to feed the same packets to several muxers directly. -.PP -The slave outputs are specified in the file name given to the muxer, -separated by '|'. If any of the slave name contains the '|' separator, -leading or trailing spaces or any special character, it must be -escaped (see the ``Quoting and escaping'' section in the ffmpeg-utils -manual). -.PP -Muxer options can be specified for each slave by prepending them as a list of -\&\fIkey\fR=\fIvalue\fR pairs separated by ':', between square brackets. If -the options values contain a special character or the ':' separator, they -must be escaped; note that this is a second level escaping. -.PP -The following special options are also recognized: -.IP "\fBf\fR" 4 -.IX Item "f" -Specify the format name. Useful if it cannot be guessed from the -output name suffix. -.IP "\fBbsfs[/\fR\fIspec\fR\fB]\fR" 4 -.IX Item "bsfs[/spec]" -Specify a list of bitstream filters to apply to the specified -output. It is possible to specify to which streams a given bitstream -filter applies, by appending a stream specifier to the option -separated by \f(CW\*(C`/\*(C'\fR. If the stream specifier is not specified, the -bistream filters will be applied to all streams in the output. -.Sp -Several bitstream filters can be specified, separated by \*(L",\*(R". -.IP "\fBselect\fR" 4 -.IX Item "select" -Select the streams that should be mapped to the slave output, -specified by a stream specifier. If not specified, this defaults to -all the input streams. -.PP -Some examples follow. -.IP "\(bu" 4 -Encode something and both archive it in a WebM file and stream it -as MPEG-TS over \s-1UDP\s0 (the streams need to be explicitly mapped): -.Sp -.Vb 2 -\& ffmpeg -i ... -c:v libx264 -c:a mp2 -f tee -map 0:v -map 0:a -\& "archive-20121107.mkv|[f=mpegts]udp://10.0.1.255:1234/" -.Ve -.IP "\(bu" 4 -Use \fBffmpeg\fR to encode the input, and send the output -to three different destinations. The \f(CW\*(C`dump_extra\*(C'\fR bitstream -filter is used to add extradata information to all the output video -keyframes packets, as requested by the MPEG-TS format. The select -option is applied to \fIout.aac\fR in order to make it contain only -audio packets. -.Sp -.Vb 2 -\& ffmpeg -i ... -map 0 -flags +global_header -c:v libx264 -c:a aac -strict experimental -\& -f tee "[bsfs/v=dump_extra]out.ts|[movflags=+faststart]out.mp4|[select=a]out.aac" -.Ve -.PP -Note: some codecs may need different options depending on the output format; -the auto-detection of this can not work with the tee muxer. The main example -is the \fBglobal_header\fR flag. -.SH "METADATA" -.IX Header "METADATA" -FFmpeg is able to dump metadata from media files into a simple UTF\-8\-encoded -INI-like text file and then load it back using the metadata muxer/demuxer. -.PP -The file format is as follows: -.IP "1." 4 -A file consists of a header and a number of metadata tags divided into sections, -each on its own line. -.IP "2." 4 -The header is a ';FFMETADATA' string, followed by a version number (now 1). -.IP "3." 4 -Metadata tags are of the form 'key=value' -.IP "4." 4 -Immediately after header follows global metadata -.IP "5." 4 -After global metadata there may be sections with per\-stream/per\-chapter -metadata. -.IP "6." 4 -A section starts with the section name in uppercase (i.e. \s-1STREAM\s0 or \s-1CHAPTER\s0) in -brackets ('[', ']') and ends with next section or end of file. -.IP "7." 4 -At the beginning of a chapter section there may be an optional timebase to be -used for start/end values. It must be in form 'TIMEBASE=num/den', where num and -den are integers. If the timebase is missing then start/end times are assumed to -be in milliseconds. -Next a chapter section must contain chapter start and end times in form -\&'START=num', 'END=num', where num is a positive integer. -.IP "8." 4 -Empty lines and lines starting with ';' or '#' are ignored. -.IP "9." 4 -Metadata keys or values containing special characters ('=', ';', '#', '\e' and a -newline) must be escaped with a backslash '\e'. -.IP "10." 4 -.IX Item "10." -Note that whitespace in metadata (e.g. foo = bar) is considered to be a part of -the tag (in the example above key is 'foo ', value is ' bar'). -.PP -A ffmetadata file might look like this: -.PP -.Vb 4 -\& ;FFMETADATA1 -\& title=bike\e\eshed -\& ;this is a comment -\& artist=FFmpeg troll team -.Ve -.PP -.Vb 9 -\& [CHAPTER] -\& TIMEBASE=1/1000 -\& START=0 -\& #chapter ends at 0:01:00 -\& END=60000 -\& title=chapter \e#1 -\& [STREAM] -\& title=multi\e -\& line -.Ve -.PP -By using the ffmetadata muxer and demuxer it is possible to extract -metadata from an input file to an ffmetadata file, and then transcode -the file into an output file with the edited ffmetadata file. -.PP -Extracting an ffmetadata file with \fIffmpeg\fR goes as follows: -.PP -.Vb 1 -\& ffmpeg -i INPUT -f ffmetadata FFMETADATAFILE -.Ve -.PP -Reinserting edited metadata information from the \s-1FFMETADATAFILE\s0 file can -be done as: -.PP -.Vb 1 -\& ffmpeg -i INPUT -i FFMETADATAFILE -map_metadata 1 -codec copy OUTPUT -.Ve -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavformat\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-protocols.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-protocols.1 deleted file mode 100644 index 0d9148782d..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-protocols.1 +++ /dev/null @@ -1,1199 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-PROTOCOLS 1" -.TH FFMPEG-PROTOCOLS 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-protocols \- FFmpeg protocols -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This document describes the input and output protocols provided by the -libavformat library. -.SH "PROTOCOLS" -.IX Header "PROTOCOLS" -Protocols are configured elements in FFmpeg that enable access to -resources that require specific protocols. -.PP -When you configure your FFmpeg build, all the supported protocols are -enabled by default. You can list all available ones using the -configure option \*(L"\-\-list\-protocols\*(R". -.PP -You can disable all the protocols using the configure option -\&\*(L"\-\-disable\-protocols\*(R", and selectively enable a protocol using the -option "\-\-enable\-protocol=\fI\s-1PROTOCOL\s0\fR\*(L", or you can disable a -particular protocol using the option -\&\*(R"\-\-disable\-protocol=\fI\s-1PROTOCOL\s0\fR". -.PP -The option \*(L"\-protocols\*(R" of the ff* tools will display the list of -supported protocols. -.PP -A description of the currently available protocols follows. -.Sh "bluray" -.IX Subsection "bluray" -Read BluRay playlist. -.PP -The accepted options are: -.IP "\fBangle\fR" 4 -.IX Item "angle" -BluRay angle -.IP "\fBchapter\fR" 4 -.IX Item "chapter" -Start chapter (1...N) -.IP "\fBplaylist\fR" 4 -.IX Item "playlist" -Playlist to read (\s-1BDMV/PLAYLIST/\s0?????.mpls) -.PP -Examples: -.PP -Read longest playlist from BluRay mounted to /mnt/bluray: -.PP -.Vb 1 -\& bluray:/mnt/bluray -.Ve -.PP -Read angle 2 of playlist 4 from BluRay mounted to /mnt/bluray, start from chapter 2: -.PP -.Vb 1 -\& -playlist 4 -angle 2 -chapter 2 bluray:/mnt/bluray -.Ve -.Sh "cache" -.IX Subsection "cache" -Caching wrapper for input stream. -.PP -Cache the input stream to temporary file. It brings seeking capability to live streams. -.PP -.Vb 1 -\& cache: -.Ve -.Sh "concat" -.IX Subsection "concat" -Physical concatenation protocol. -.PP -Allow to read and seek from many resource in sequence as if they were -a unique resource. -.PP -A \s-1URL\s0 accepted by this protocol has the syntax: -.PP -.Vb 1 -\& concat:||...| -.Ve -.PP -where \fI\s-1URL1\s0\fR, \fI\s-1URL2\s0\fR, ..., \fI\s-1URLN\s0\fR are the urls of the -resource to be concatenated, each one possibly specifying a distinct -protocol. -.PP -For example to read a sequence of files \fIsplit1.mpeg\fR, -\&\fIsplit2.mpeg\fR, \fIsplit3.mpeg\fR with \fBffplay\fR use the -command: -.PP -.Vb 1 -\& ffplay concat:split1.mpeg\e|split2.mpeg\e|split3.mpeg -.Ve -.PP -Note that you may need to escape the character \*(L"|\*(R" which is special for -many shells. -.Sh "crypto" -.IX Subsection "crypto" -AES-encrypted stream reading protocol. -.PP -The accepted options are: -.IP "\fBkey\fR" 4 -.IX Item "key" -Set the \s-1AES\s0 decryption key binary block from given hexadecimal representation. -.IP "\fBiv\fR" 4 -.IX Item "iv" -Set the \s-1AES\s0 decryption initialization vector binary block from given hexadecimal representation. -.PP -Accepted \s-1URL\s0 formats: -.PP -.Vb 2 -\& crypto: -\& crypto+ -.Ve -.Sh "data" -.IX Subsection "data" -Data in-line in the \s-1URI\s0. See <\fBhttp://en.wikipedia.org/wiki/Data_URI_scheme\fR>. -.PP -For example, to convert a \s-1GIF\s0 file given inline with \fBffmpeg\fR: -.PP -.Vb 1 -\& ffmpeg -i "data:image/gif;base64,R0lGODdhCAAIAMIEAAAAAAAA//8AAP//AP///////////////ywAAAAACAAIAAADF0gEDLojDgdGiJdJqUX02iB4E8Q9jUMkADs=" smiley.png -.Ve -.Sh "file" -.IX Subsection "file" -File access protocol. -.PP -Allow to read from or read to a file. -.PP -For example to read from a file \fIinput.mpeg\fR with \fBffmpeg\fR -use the command: -.PP -.Vb 1 -\& ffmpeg -i file:input.mpeg output.mpeg -.Ve -.PP -The ff* tools default to the file protocol, that is a resource -specified with the name \*(L"\s-1FILE\s0.mpeg\*(R" is interpreted as the \s-1URL\s0 -\&\*(L"file:FILE.mpeg\*(R". -.PP -This protocol accepts the following options: -.IP "\fBtruncate\fR" 4 -.IX Item "truncate" -Truncate existing files on write, if set to 1. A value of 0 prevents -truncating. Default value is 1. -.IP "\fBblocksize\fR" 4 -.IX Item "blocksize" -Set I/O operation maximum block size, in bytes. Default value is -\&\f(CW\*(C`INT_MAX\*(C'\fR, which results in not limiting the requested block size. -Setting this value reasonably low improves user termination request reaction -time, which is valuable for files on slow medium. -.Sh "ftp" -.IX Subsection "ftp" -\&\s-1FTP\s0 (File Transfer Protocol). -.PP -Allow to read from or write to remote resources using \s-1FTP\s0 protocol. -.PP -Following syntax is required. -.PP -.Vb 1 -\& ftp://[user[:password]@]server[:port]/path/to/remote/resource.mpeg -.Ve -.PP -This protocol accepts the following options. -.IP "\fBtimeout\fR" 4 -.IX Item "timeout" -Set timeout of socket I/O operations used by the underlying low level -operation. By default it is set to \-1, which means that the timeout is -not specified. -.IP "\fBftp-anonymous-password\fR" 4 -.IX Item "ftp-anonymous-password" -Password used when login as anonymous user. Typically an e\-mail address -should be used. -.IP "\fBftp-write-seekable\fR" 4 -.IX Item "ftp-write-seekable" -Control seekability of connection during encoding. If set to 1 the -resource is supposed to be seekable, if set to 0 it is assumed not -to be seekable. Default value is 0. -.PP -\&\s-1NOTE:\s0 Protocol can be used as output, but it is recommended to not do -it, unless special care is taken (tests, customized server configuration -etc.). Different \s-1FTP\s0 servers behave in different way during seek -operation. ff* tools may produce incomplete content due to server limitations. -.Sh "gopher" -.IX Subsection "gopher" -Gopher protocol. -.Sh "hls" -.IX Subsection "hls" -Read Apple \s-1HTTP\s0 Live Streaming compliant segmented stream as -a uniform one. The M3U8 playlists describing the segments can be -remote \s-1HTTP\s0 resources or local files, accessed using the standard -file protocol. -The nested protocol is declared by specifying -"+\fIproto\fR" after the hls \s-1URI\s0 scheme name, where \fIproto\fR -is either \*(L"file\*(R" or \*(L"http\*(R". -.PP -.Vb 2 -\& hls+http://host/path/to/remote/resource.m3u8 -\& hls+file://path/to/local/resource.m3u8 -.Ve -.PP -Using this protocol is discouraged \- the hls demuxer should work -just as well (if not, please report the issues) and is more complete. -To use the hls demuxer instead, simply use the direct URLs to the -m3u8 files. -.Sh "http" -.IX Subsection "http" -\&\s-1HTTP\s0 (Hyper Text Transfer Protocol). -.PP -This protocol accepts the following options. -.IP "\fBseekable\fR" 4 -.IX Item "seekable" -Control seekability of connection. If set to 1 the resource is -supposed to be seekable, if set to 0 it is assumed not to be seekable, -if set to \-1 it will try to autodetect if it is seekable. Default -value is \-1. -.IP "\fBchunked_post\fR" 4 -.IX Item "chunked_post" -If set to 1 use chunked transfer-encoding for posts, default is 1. -.IP "\fBheaders\fR" 4 -.IX Item "headers" -Set custom \s-1HTTP\s0 headers, can override built in default headers. The -value must be a string encoding the headers. -.IP "\fBcontent_type\fR" 4 -.IX Item "content_type" -Force a content type. -.IP "\fBuser-agent\fR" 4 -.IX Item "user-agent" -Override User-Agent header. If not specified the protocol will use a -string describing the libavformat build. -.IP "\fBmultiple_requests\fR" 4 -.IX Item "multiple_requests" -Use persistent connections if set to 1. By default it is 0. -.IP "\fBpost_data\fR" 4 -.IX Item "post_data" -Set custom \s-1HTTP\s0 post data. -.IP "\fBtimeout\fR" 4 -.IX Item "timeout" -Set timeout of socket I/O operations used by the underlying low level -operation. By default it is set to \-1, which means that the timeout is -not specified. -.IP "\fBmime_type\fR" 4 -.IX Item "mime_type" -Set \s-1MIME\s0 type. -.IP "\fBicy\fR" 4 -.IX Item "icy" -If set to 1 request \s-1ICY\s0 (SHOUTcast) metadata from the server. If the server -supports this, the metadata has to be retrieved by the application by reading -the \fBicy_metadata_headers\fR and \fBicy_metadata_packet\fR options. -The default is 0. -.IP "\fBicy_metadata_headers\fR" 4 -.IX Item "icy_metadata_headers" -If the server supports \s-1ICY\s0 metadata, this contains the \s-1ICY\s0 specific \s-1HTTP\s0 reply -headers, separated with newline characters. -.IP "\fBicy_metadata_packet\fR" 4 -.IX Item "icy_metadata_packet" -If the server supports \s-1ICY\s0 metadata, and \fBicy\fR was set to 1, this -contains the last non-empty metadata packet sent by the server. -.IP "\fBcookies\fR" 4 -.IX Item "cookies" -Set the cookies to be sent in future requests. The format of each cookie is the -same as the value of a Set-Cookie \s-1HTTP\s0 response field. Multiple cookies can be -delimited by a newline character. -.PP -\fI\s-1HTTP\s0 Cookies\fR -.IX Subsection "HTTP Cookies" -.PP -Some \s-1HTTP\s0 requests will be denied unless cookie values are passed in with the -request. The \fBcookies\fR option allows these cookies to be specified. At -the very least, each cookie must specify a value along with a path and domain. -\&\s-1HTTP\s0 requests that match both the domain and path will automatically include the -cookie value in the \s-1HTTP\s0 Cookie header field. Multiple cookies can be delimited -by a newline. -.PP -The required syntax to play a stream specifying a cookie is: -.PP -.Vb 1 -\& ffplay -cookies "nlqptid=nltid=tsn; path=/; domain=somedomain.com;" http://somedomain.com/somestream.m3u8 -.Ve -.Sh "mmst" -.IX Subsection "mmst" -\&\s-1MMS\s0 (Microsoft Media Server) protocol over \s-1TCP\s0. -.Sh "mmsh" -.IX Subsection "mmsh" -\&\s-1MMS\s0 (Microsoft Media Server) protocol over \s-1HTTP\s0. -.PP -The required syntax is: -.PP -.Vb 1 -\& mmsh://[:][/][/] -.Ve -.Sh "md5" -.IX Subsection "md5" -\&\s-1MD5\s0 output protocol. -.PP -Computes the \s-1MD5\s0 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. -.PP -Some examples follow. -.PP -.Vb 2 -\& # Write the MD5 hash of the encoded AVI file to the file output.avi.md5. -\& ffmpeg -i input.flv -f avi -y md5:output.avi.md5 -.Ve -.PP -.Vb 2 -\& # Write the MD5 hash of the encoded AVI file to stdout. -\& ffmpeg -i input.flv -f avi -y md5: -.Ve -.PP -Note that some formats (typically \s-1MOV\s0) require the output protocol to -be seekable, so they will fail with the \s-1MD5\s0 output protocol. -.Sh "pipe" -.IX Subsection "pipe" -\&\s-1UNIX\s0 pipe access protocol. -.PP -Allow to read and write from \s-1UNIX\s0 pipes. -.PP -The accepted syntax is: -.PP -.Vb 1 -\& pipe:[] -.Ve -.PP -\&\fInumber\fR is the number corresponding to the file descriptor of the -pipe (e.g. 0 for stdin, 1 for stdout, 2 for stderr). If \fInumber\fR -is not specified, by default the stdout file descriptor will be used -for writing, stdin for reading. -.PP -For example to read from stdin with \fBffmpeg\fR: -.PP -.Vb 3 -\& cat test.wav | ffmpeg -i pipe:0 -\& # ...this is the same as... -\& cat test.wav | ffmpeg -i pipe: -.Ve -.PP -For writing to stdout with \fBffmpeg\fR: -.PP -.Vb 3 -\& ffmpeg -i test.wav -f avi pipe:1 | cat > test.avi -\& # ...this is the same as... -\& ffmpeg -i test.wav -f avi pipe: | cat > test.avi -.Ve -.PP -This protocol accepts the following options: -.IP "\fBblocksize\fR" 4 -.IX Item "blocksize" -Set I/O operation maximum block size, in bytes. Default value is -\&\f(CW\*(C`INT_MAX\*(C'\fR, which results in not limiting the requested block size. -Setting this value reasonably low improves user termination request reaction -time, which is valuable if data transmission is slow. -.PP -Note that some formats (typically \s-1MOV\s0), require the output protocol to -be seekable, so they will fail with the pipe output protocol. -.Sh "rtmp" -.IX Subsection "rtmp" -Real-Time Messaging Protocol. -.PP -The Real-Time Messaging Protocol (\s-1RTMP\s0) is used for streaming multimedia -content across a \s-1TCP/IP\s0 network. -.PP -The required syntax is: -.PP -.Vb 1 -\& rtmp://[:@][:][/][/][/] -.Ve -.PP -The accepted parameters are: -.IP "\fBusername\fR" 4 -.IX Item "username" -An optional username (mostly for publishing). -.IP "\fBpassword\fR" 4 -.IX Item "password" -An optional password (mostly for publishing). -.IP "\fBserver\fR" 4 -.IX Item "server" -The address of the \s-1RTMP\s0 server. -.IP "\fBport\fR" 4 -.IX Item "port" -The number of the \s-1TCP\s0 port to use (by default is 1935). -.IP "\fBapp\fR" 4 -.IX Item "app" -It is the name of the application to access. It usually corresponds to -the path where the application is installed on the \s-1RTMP\s0 server -(e.g. \fI/ondemand/\fR, \fI/flash/live/\fR, etc.). You can override -the value parsed from the \s-1URI\s0 through the \f(CW\*(C`rtmp_app\*(C'\fR option, too. -.IP "\fBplaypath\fR" 4 -.IX Item "playpath" -It is the path or name of the resource to play with reference to the -application specified in \fIapp\fR, may be prefixed by \*(L"mp4:\*(R". You -can override the value parsed from the \s-1URI\s0 through the \f(CW\*(C`rtmp_playpath\*(C'\fR -option, too. -.IP "\fBlisten\fR" 4 -.IX Item "listen" -Act as a server, listening for an incoming connection. -.IP "\fBtimeout\fR" 4 -.IX Item "timeout" -Maximum time to wait for the incoming connection. Implies listen. -.PP -Additionally, the following parameters can be set via command line options -(or in code via \f(CW\*(C`AVOption\*(C'\fRs): -.IP "\fBrtmp_app\fR" 4 -.IX Item "rtmp_app" -Name of application to connect on the \s-1RTMP\s0 server. This option -overrides the parameter specified in the \s-1URI\s0. -.IP "\fBrtmp_buffer\fR" 4 -.IX Item "rtmp_buffer" -Set the client buffer time in milliseconds. The default is 3000. -.IP "\fBrtmp_conn\fR" 4 -.IX Item "rtmp_conn" -Extra arbitrary \s-1AMF\s0 connection parameters, parsed from a string, -e.g. like \f(CW\*(C`B:1 S:authMe O:1 NN:code:1.23 NS:flag:ok O:0\*(C'\fR. -Each value is prefixed by a single character denoting the type, -B for Boolean, N for number, S for string, O for object, or Z for null, -followed by a colon. For Booleans the data must be either 0 or 1 for -\&\s-1FALSE\s0 or \s-1TRUE\s0, respectively. Likewise for Objects the data must be 0 or -1 to end or begin an object, respectively. Data items in subobjects may -be named, by prefixing the type with 'N' and specifying the name before -the value (i.e. \f(CW\*(C`NB:myFlag:1\*(C'\fR). This option may be used multiple -times to construct arbitrary \s-1AMF\s0 sequences. -.IP "\fBrtmp_flashver\fR" 4 -.IX Item "rtmp_flashver" -Version of the Flash plugin used to run the \s-1SWF\s0 player. The default -is \s-1LNX\s0 9,0,124,2. (When publishing, the default is \s-1FMLE/3\s0.0 (compatible; -).) -.IP "\fBrtmp_flush_interval\fR" 4 -.IX Item "rtmp_flush_interval" -Number of packets flushed in the same request (\s-1RTMPT\s0 only). The default -is 10. -.IP "\fBrtmp_live\fR" 4 -.IX Item "rtmp_live" -Specify that the media is a live stream. No resuming or seeking in -live streams is possible. The default value is \f(CW\*(C`any\*(C'\fR, which means the -subscriber first tries to play the live stream specified in the -playpath. If a live stream of that name is not found, it plays the -recorded stream. The other possible values are \f(CW\*(C`live\*(C'\fR and -\&\f(CW\*(C`recorded\*(C'\fR. -.IP "\fBrtmp_pageurl\fR" 4 -.IX Item "rtmp_pageurl" -\&\s-1URL\s0 of the web page in which the media was embedded. By default no -value will be sent. -.IP "\fBrtmp_playpath\fR" 4 -.IX Item "rtmp_playpath" -Stream identifier to play or to publish. This option overrides the -parameter specified in the \s-1URI\s0. -.IP "\fBrtmp_subscribe\fR" 4 -.IX Item "rtmp_subscribe" -Name of live stream to subscribe to. By default no value will be sent. -It is only sent if the option is specified or if rtmp_live -is set to live. -.IP "\fBrtmp_swfhash\fR" 4 -.IX Item "rtmp_swfhash" -\&\s-1SHA256\s0 hash of the decompressed \s-1SWF\s0 file (32 bytes). -.IP "\fBrtmp_swfsize\fR" 4 -.IX Item "rtmp_swfsize" -Size of the decompressed \s-1SWF\s0 file, required for SWFVerification. -.IP "\fBrtmp_swfurl\fR" 4 -.IX Item "rtmp_swfurl" -\&\s-1URL\s0 of the \s-1SWF\s0 player for the media. By default no value will be sent. -.IP "\fBrtmp_swfverify\fR" 4 -.IX Item "rtmp_swfverify" -\&\s-1URL\s0 to player swf file, compute hash/size automatically. -.IP "\fBrtmp_tcurl\fR" 4 -.IX Item "rtmp_tcurl" -\&\s-1URL\s0 of the target stream. Defaults to proto://host[:port]/app. -.PP -For example to read with \fBffplay\fR a multimedia resource named -\&\*(L"sample\*(R" from the application \*(L"vod\*(R" from an \s-1RTMP\s0 server \*(L"myserver\*(R": -.PP -.Vb 1 -\& ffplay rtmp://myserver/vod/sample -.Ve -.PP -To publish to a password protected server, passing the playpath and -app names separately: -.PP -.Vb 1 -\& ffmpeg -re -i -f flv -rtmp_playpath some/long/path -rtmp_app long/app/name rtmp://username:password@myserver/ -.Ve -.Sh "rtmpe" -.IX Subsection "rtmpe" -Encrypted Real-Time Messaging Protocol. -.PP -The Encrypted Real-Time Messaging Protocol (\s-1RTMPE\s0) is used for -streaming multimedia content within standard cryptographic primitives, -consisting of Diffie-Hellman key exchange and \s-1HMACSHA256\s0, generating -a pair of \s-1RC4\s0 keys. -.Sh "rtmps" -.IX Subsection "rtmps" -Real-Time Messaging Protocol over a secure \s-1SSL\s0 connection. -.PP -The Real-Time Messaging Protocol (\s-1RTMPS\s0) is used for streaming -multimedia content across an encrypted connection. -.Sh "rtmpt" -.IX Subsection "rtmpt" -Real-Time Messaging Protocol tunneled through \s-1HTTP\s0. -.PP -The Real-Time Messaging Protocol tunneled through \s-1HTTP\s0 (\s-1RTMPT\s0) is used -for streaming multimedia content within \s-1HTTP\s0 requests to traverse -firewalls. -.Sh "rtmpte" -.IX Subsection "rtmpte" -Encrypted Real-Time Messaging Protocol tunneled through \s-1HTTP\s0. -.PP -The Encrypted Real-Time Messaging Protocol tunneled through \s-1HTTP\s0 (\s-1RTMPTE\s0) -is used for streaming multimedia content within \s-1HTTP\s0 requests to traverse -firewalls. -.Sh "rtmpts" -.IX Subsection "rtmpts" -Real-Time Messaging Protocol tunneled through \s-1HTTPS\s0. -.PP -The Real-Time Messaging Protocol tunneled through \s-1HTTPS\s0 (\s-1RTMPTS\s0) is used -for streaming multimedia content within \s-1HTTPS\s0 requests to traverse -firewalls. -.Sh "libssh" -.IX Subsection "libssh" -Secure File Transfer Protocol via libssh -.PP -Allow to read from or write to remote resources using \s-1SFTP\s0 protocol. -.PP -Following syntax is required. -.PP -.Vb 1 -\& sftp://[user[:password]@]server[:port]/path/to/remote/resource.mpeg -.Ve -.PP -This protocol accepts the following options. -.IP "\fBtimeout\fR" 4 -.IX Item "timeout" -Set timeout of socket I/O operations used by the underlying low level -operation. By default it is set to \-1, which means that the timeout -is not specified. -.IP "\fBtruncate\fR" 4 -.IX Item "truncate" -Truncate existing files on write, if set to 1. A value of 0 prevents -truncating. Default value is 1. -.PP -Example: Play a file stored on remote server. -.PP -.Vb 1 -\& ffplay sftp://user:password@server_address:22/home/user/resource.mpeg -.Ve -.Sh "librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte" -.IX Subsection "librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte" -Real-Time Messaging Protocol and its variants supported through -librtmp. -.PP -Requires the presence of the librtmp headers and library during -configuration. You need to explicitly configure the build with -\&\*(L"\-\-enable\-librtmp\*(R". If enabled this will replace the native \s-1RTMP\s0 -protocol. -.PP -This protocol provides most client functions and a few server -functions needed to support \s-1RTMP\s0, \s-1RTMP\s0 tunneled in \s-1HTTP\s0 (\s-1RTMPT\s0), -encrypted \s-1RTMP\s0 (\s-1RTMPE\s0), \s-1RTMP\s0 over \s-1SSL/TLS\s0 (\s-1RTMPS\s0) and tunneled -variants of these encrypted types (\s-1RTMPTE\s0, \s-1RTMPTS\s0). -.PP -The required syntax is: -.PP -.Vb 1 -\& ://[:][/][/] -.Ve -.PP -where \fIrtmp_proto\fR is one of the strings \*(L"rtmp\*(R", \*(L"rtmpt\*(R", \*(L"rtmpe\*(R", -\&\*(L"rtmps\*(R", \*(L"rtmpte\*(R", \*(L"rtmpts\*(R" corresponding to each \s-1RTMP\s0 variant, and -\&\fIserver\fR, \fIport\fR, \fIapp\fR and \fIplaypath\fR have the same -meaning as specified for the \s-1RTMP\s0 native protocol. -\&\fIoptions\fR contains a list of space-separated options of the form -\&\fIkey\fR=\fIval\fR. -.PP -See the librtmp manual page (man 3 librtmp) for more information. -.PP -For example, to stream a file in real-time to an \s-1RTMP\s0 server using -\&\fBffmpeg\fR: -.PP -.Vb 1 -\& ffmpeg -re -i myfile -f flv rtmp://myserver/live/mystream -.Ve -.PP -To play the same stream using \fBffplay\fR: -.PP -.Vb 1 -\& ffplay "rtmp://myserver/live/mystream live=1" -.Ve -.Sh "rtp" -.IX Subsection "rtp" -Real-time Transport Protocol. -.PP -The required syntax for an \s-1RTP\s0 \s-1URL\s0 is: -rtp://\fIhostname\fR[:\fIport\fR][?\fIoption\fR=\fIval\fR...] -.PP -\&\fIport\fR specifies the \s-1RTP\s0 port to use. -.PP -The following \s-1URL\s0 options are supported: -.IP "\fBttl=\fR\fIn\fR" 4 -.IX Item "ttl=n" -Set the \s-1TTL\s0 (Time\-To\-Live) value (for multicast only). -.IP "\fBrtcpport=\fR\fIn\fR" 4 -.IX Item "rtcpport=n" -Set the remote \s-1RTCP\s0 port to \fIn\fR. -.IP "\fBlocalrtpport=\fR\fIn\fR" 4 -.IX Item "localrtpport=n" -Set the local \s-1RTP\s0 port to \fIn\fR. -.IP "\fBlocalrtcpport=\fR\fIn\fR\fB'\fR" 4 -.IX Item "localrtcpport=n'" -Set the local \s-1RTCP\s0 port to \fIn\fR. -.IP "\fBpkt_size=\fR\fIn\fR" 4 -.IX Item "pkt_size=n" -Set max packet size (in bytes) to \fIn\fR. -.IP "\fBconnect=0|1\fR" 4 -.IX Item "connect=0|1" -Do a \f(CW\*(C`connect()\*(C'\fR on the \s-1UDP\s0 socket (if set to 1) or not (if set -to 0). -.IP "\fBsources=\fR\fIip\fR\fB[,\fR\fIip\fR\fB]\fR" 4 -.IX Item "sources=ip[,ip]" -List allowed source \s-1IP\s0 addresses. -.IP "\fBblock=\fR\fIip\fR\fB[,\fR\fIip\fR\fB]\fR" 4 -.IX Item "block=ip[,ip]" -List disallowed (blocked) source \s-1IP\s0 addresses. -.IP "\fBwrite_to_source=0|1\fR" 4 -.IX Item "write_to_source=0|1" -Send packets to the source address of the latest received packet (if -set to 1) or to a default remote address (if set to 0). -.IP "\fBlocalport=\fR\fIn\fR" 4 -.IX Item "localport=n" -Set the local \s-1RTP\s0 port to \fIn\fR. -.Sp -This is a deprecated option. Instead, \fBlocalrtpport\fR should be -used. -.PP -Important notes: -.IP "1." 4 -If \fBrtcpport\fR is not set the \s-1RTCP\s0 port will be set to the \s-1RTP\s0 -port value plus 1. -.IP "2." 4 -If \fBlocalrtpport\fR (the local \s-1RTP\s0 port) is not set any available -port will be used for the local \s-1RTP\s0 and \s-1RTCP\s0 ports. -.IP "3." 4 -If \fBlocalrtcpport\fR (the local \s-1RTCP\s0 port) is not set it will be -set to the the local \s-1RTP\s0 port value plus 1. -.Sh "rtsp" -.IX Subsection "rtsp" -\&\s-1RTSP\s0 is not technically a protocol handler in libavformat, it is a demuxer -and muxer. The demuxer supports both normal \s-1RTSP\s0 (with data transferred -over \s-1RTP\s0; this is used by e.g. Apple and Microsoft) and Real-RTSP (with -data transferred over \s-1RDT\s0). -.PP -The muxer can be used to send a stream using \s-1RTSP\s0 \s-1ANNOUNCE\s0 to a server -supporting it (currently Darwin Streaming Server and Mischa Spiegelmock's -<\fBhttp://github.com/revmischa/rtsp\-server\fR>). -.PP -The required syntax for a \s-1RTSP\s0 url is: -.PP -.Vb 1 -\& rtsp://[:]/ -.Ve -.PP -The following options (set on the \fBffmpeg\fR/\fBffplay\fR command -line, or set in code via \f(CW\*(C`AVOption\*(C'\fRs or in \f(CW\*(C`avformat_open_input\*(C'\fR), -are supported: -.PP -Flags for \f(CW\*(C`rtsp_transport\*(C'\fR: -.IP "\fBudp\fR" 4 -.IX Item "udp" -Use \s-1UDP\s0 as lower transport protocol. -.IP "\fBtcp\fR" 4 -.IX Item "tcp" -Use \s-1TCP\s0 (interleaving within the \s-1RTSP\s0 control channel) as lower -transport protocol. -.IP "\fBudp_multicast\fR" 4 -.IX Item "udp_multicast" -Use \s-1UDP\s0 multicast as lower transport protocol. -.IP "\fBhttp\fR" 4 -.IX Item "http" -Use \s-1HTTP\s0 tunneling as lower transport protocol, which is useful for -passing proxies. -.PP -Multiple lower transport protocols may be specified, in that case they are -tried one at a time (if the setup of one fails, the next one is tried). -For the muxer, only the \f(CW\*(C`tcp\*(C'\fR and \f(CW\*(C`udp\*(C'\fR options are supported. -.PP -Flags for \f(CW\*(C`rtsp_flags\*(C'\fR: -.IP "\fBfilter_src\fR" 4 -.IX Item "filter_src" -Accept packets only from negotiated peer address and port. -.IP "\fBlisten\fR" 4 -.IX Item "listen" -Act as a server, listening for an incoming connection. -.PP -When receiving data over \s-1UDP\s0, the demuxer tries to reorder received packets -(since they may arrive out of order, or packets may get lost totally). This -can be disabled by setting the maximum demuxing delay to zero (via -the \f(CW\*(C`max_delay\*(C'\fR field of AVFormatContext). -.PP -When watching multi-bitrate Real-RTSP streams with \fBffplay\fR, the -streams to display can be chosen with \f(CW\*(C`\-vst\*(C'\fR \fIn\fR and -\&\f(CW\*(C`\-ast\*(C'\fR \fIn\fR for video and audio respectively, and can be switched -on the fly by pressing \f(CW\*(C`v\*(C'\fR and \f(CW\*(C`a\*(C'\fR. -.PP -Example command lines: -.PP -To watch a stream over \s-1UDP\s0, with a max reordering delay of 0.5 seconds: -.PP -.Vb 1 -\& ffplay -max_delay 500000 -rtsp_transport udp rtsp://server/video.mp4 -.Ve -.PP -To watch a stream tunneled over \s-1HTTP:\s0 -.PP -.Vb 1 -\& ffplay -rtsp_transport http rtsp://server/video.mp4 -.Ve -.PP -To send a stream in realtime to a \s-1RTSP\s0 server, for others to watch: -.PP -.Vb 1 -\& ffmpeg -re -i -f rtsp -muxdelay 0.1 rtsp://server/live.sdp -.Ve -.PP -To receive a stream in realtime: -.PP -.Vb 1 -\& ffmpeg -rtsp_flags listen -i rtsp://ownaddress/live.sdp -.Ve -.IP "\fBstimeout\fR" 4 -.IX Item "stimeout" -Socket \s-1IO\s0 timeout in micro seconds. -.Sh "sap" -.IX Subsection "sap" -Session Announcement Protocol (\s-1RFC\s0 2974). This is not technically a -protocol handler in libavformat, it is a muxer and demuxer. -It is used for signalling of \s-1RTP\s0 streams, by announcing the \s-1SDP\s0 for the -streams regularly on a separate port. -.PP -\fIMuxer\fR -.IX Subsection "Muxer" -.PP -The syntax for a \s-1SAP\s0 url given to the muxer is: -.PP -.Vb 1 -\& sap://[:][?] -.Ve -.PP -The \s-1RTP\s0 packets are sent to \fIdestination\fR on port \fIport\fR, -or to port 5004 if no port is specified. -\&\fIoptions\fR is a \f(CW\*(C`&\*(C'\fR\-separated list. The following options -are supported: -.IP "\fBannounce_addr=\fR\fIaddress\fR" 4 -.IX Item "announce_addr=address" -Specify the destination \s-1IP\s0 address for sending the announcements to. -If omitted, the announcements are sent to the commonly used \s-1SAP\s0 -announcement multicast address 224.2.127.254 (sap.mcast.net), or -ff0e::2:7ffe if \fIdestination\fR is an IPv6 address. -.IP "\fBannounce_port=\fR\fIport\fR" 4 -.IX Item "announce_port=port" -Specify the port to send the announcements on, defaults to -9875 if not specified. -.IP "\fBttl=\fR\fIttl\fR" 4 -.IX Item "ttl=ttl" -Specify the time to live value for the announcements and \s-1RTP\s0 packets, -defaults to 255. -.IP "\fBsame_port=\fR\fI0|1\fR" 4 -.IX Item "same_port=0|1" -If set to 1, send all \s-1RTP\s0 streams on the same port pair. If zero (the -default), all streams are sent on unique ports, with each stream on a -port 2 numbers higher than the previous. -VLC/Live555 requires this to be set to 1, to be able to receive the stream. -The \s-1RTP\s0 stack in libavformat for receiving requires all streams to be sent -on unique ports. -.PP -Example command lines follow. -.PP -To broadcast a stream on the local subnet, for watching in \s-1VLC:\s0 -.PP -.Vb 1 -\& ffmpeg -re -i -f sap sap://224.0.0.255?same_port=1 -.Ve -.PP -Similarly, for watching in \fBffplay\fR: -.PP -.Vb 1 -\& ffmpeg -re -i -f sap sap://224.0.0.255 -.Ve -.PP -And for watching in \fBffplay\fR, over IPv6: -.PP -.Vb 1 -\& ffmpeg -re -i -f sap sap://[ff0e::1:2:3:4] -.Ve -.PP -\fIDemuxer\fR -.IX Subsection "Demuxer" -.PP -The syntax for a \s-1SAP\s0 url given to the demuxer is: -.PP -.Vb 1 -\& sap://[
][:] -.Ve -.PP -\&\fIaddress\fR is the multicast address to listen for announcements on, -if omitted, the default 224.2.127.254 (sap.mcast.net) is used. \fIport\fR -is the port that is listened on, 9875 if omitted. -.PP -The demuxers listens for announcements on the given address and port. -Once an announcement is received, it tries to receive that particular stream. -.PP -Example command lines follow. -.PP -To play back the first stream announced on the normal \s-1SAP\s0 multicast address: -.PP -.Vb 1 -\& ffplay sap:// -.Ve -.PP -To play back the first stream announced on one the default IPv6 \s-1SAP\s0 multicast address: -.PP -.Vb 1 -\& ffplay sap://[ff0e::2:7ffe] -.Ve -.Sh "sctp" -.IX Subsection "sctp" -Stream Control Transmission Protocol. -.PP -The accepted \s-1URL\s0 syntax is: -.PP -.Vb 1 -\& sctp://:[?] -.Ve -.PP -The protocol accepts the following options: -.IP "\fBlisten\fR" 4 -.IX Item "listen" -If set to any value, listen for an incoming connection. Outgoing connection is done by default. -.IP "\fBmax_streams\fR" 4 -.IX Item "max_streams" -Set the maximum number of streams. By default no limit is set. -.Sh "srtp" -.IX Subsection "srtp" -Secure Real-time Transport Protocol. -.PP -The accepted options are: -.IP "\fBsrtp_in_suite\fR" 4 -.IX Item "srtp_in_suite" -.PD 0 -.IP "\fBsrtp_out_suite\fR" 4 -.IX Item "srtp_out_suite" -.PD -Select input and output encoding suites. -.Sp -Supported values: -.RS 4 -.IP "\fB\s-1AES_CM_128_HMAC_SHA1_80\s0\fR" 4 -.IX Item "AES_CM_128_HMAC_SHA1_80" -.PD 0 -.IP "\fB\s-1SRTP_AES128_CM_HMAC_SHA1_80\s0\fR" 4 -.IX Item "SRTP_AES128_CM_HMAC_SHA1_80" -.IP "\fB\s-1AES_CM_128_HMAC_SHA1_32\s0\fR" 4 -.IX Item "AES_CM_128_HMAC_SHA1_32" -.IP "\fB\s-1SRTP_AES128_CM_HMAC_SHA1_32\s0\fR" 4 -.IX Item "SRTP_AES128_CM_HMAC_SHA1_32" -.RE -.RS 4 -.RE -.IP "\fBsrtp_in_params\fR" 4 -.IX Item "srtp_in_params" -.IP "\fBsrtp_out_params\fR" 4 -.IX Item "srtp_out_params" -.PD -Set input and output encoding parameters, which are expressed by a -base64\-encoded representation of a binary block. The first 16 bytes of -this binary block are used as master key, the following 14 bytes are -used as master salt. -.Sh "tcp" -.IX Subsection "tcp" -Trasmission Control Protocol. -.PP -The required syntax for a \s-1TCP\s0 url is: -.PP -.Vb 1 -\& tcp://:[?] -.Ve -.IP "\fBlisten\fR" 4 -.IX Item "listen" -Listen for an incoming connection -.IP "\fBtimeout=\fR\fImicroseconds\fR" 4 -.IX Item "timeout=microseconds" -In read mode: if no data arrived in more than this time interval, raise error. -In write mode: if socket cannot be written in more than this time interval, raise error. -This also sets timeout on \s-1TCP\s0 connection establishing. -.Sp -.Vb 2 -\& ffmpeg -i -f tcp://:?listen -\& ffplay tcp://: -.Ve -.Sh "tls" -.IX Subsection "tls" -Transport Layer Security (\s-1TLS\s0) / Secure Sockets Layer (\s-1SSL\s0) -.PP -The required syntax for a \s-1TLS/SSL\s0 url is: -.PP -.Vb 1 -\& tls://:[?] -.Ve -.PP -The following parameters can be set via command line options -(or in code via \f(CW\*(C`AVOption\*(C'\fRs): -.IP "\fBca_file, cafile=\fR\fIfilename\fR" 4 -.IX Item "ca_file, cafile=filename" -A file containing certificate authority (\s-1CA\s0) root certificates to treat -as trusted. If the linked \s-1TLS\s0 library contains a default this might not -need to be specified for verification to work, but not all libraries and -setups have defaults built in. -The file must be in OpenSSL \s-1PEM\s0 format. -.IP "\fBtls_verify=\fR\fI1|0\fR" 4 -.IX Item "tls_verify=1|0" -If enabled, try to verify the peer that we are communicating with. -Note, if using OpenSSL, this currently only makes sure that the -peer certificate is signed by one of the root certificates in the \s-1CA\s0 -database, but it does not validate that the certificate actually -matches the host name we are trying to connect to. (With GnuTLS, -the host name is validated as well.) -.Sp -This is disabled by default since it requires a \s-1CA\s0 database to be -provided by the caller in many cases. -.IP "\fBcert_file, cert=\fR\fIfilename\fR" 4 -.IX Item "cert_file, cert=filename" -A file containing a certificate to use in the handshake with the peer. -(When operating as server, in listen mode, this is more often required -by the peer, while client certificates only are mandated in certain -setups.) -.IP "\fBkey_file, key=\fR\fIfilename\fR" 4 -.IX Item "key_file, key=filename" -A file containing the private key for the certificate. -.IP "\fBlisten=\fR\fI1|0\fR" 4 -.IX Item "listen=1|0" -If enabled, listen for connections on the provided port, and assume -the server role in the handshake instead of the client role. -.PP -Example command lines: -.PP -To create a \s-1TLS/SSL\s0 server that serves an input stream. -.PP -.Vb 1 -\& ffmpeg -i -f tls://:?listen&cert=&key= -.Ve -.PP -To play back a stream from the \s-1TLS/SSL\s0 server using \fBffplay\fR: -.PP -.Vb 1 -\& ffplay tls://: -.Ve -.Sh "udp" -.IX Subsection "udp" -User Datagram Protocol. -.PP -The required syntax for a \s-1UDP\s0 url is: -.PP -.Vb 1 -\& udp://:[?] -.Ve -.PP -\&\fIoptions\fR contains a list of &\-separated options of the form \fIkey\fR=\fIval\fR. -.PP -In case threading is enabled on the system, a circular buffer is used -to store the incoming data, which allows to reduce loss of data due to -\&\s-1UDP\s0 socket buffer overruns. The \fIfifo_size\fR and -\&\fIoverrun_nonfatal\fR options are related to this buffer. -.PP -The list of supported options follows. -.IP "\fBbuffer_size=\fR\fIsize\fR" 4 -.IX Item "buffer_size=size" -Set the \s-1UDP\s0 socket buffer size in bytes. This is used both for the -receiving and the sending buffer size. -.IP "\fBlocalport=\fR\fIport\fR" 4 -.IX Item "localport=port" -Override the local \s-1UDP\s0 port to bind with. -.IP "\fBlocaladdr=\fR\fIaddr\fR" 4 -.IX Item "localaddr=addr" -Choose the local \s-1IP\s0 address. This is useful e.g. if sending multicast -and the host has multiple interfaces, where the user can choose -which interface to send on by specifying the \s-1IP\s0 address of that interface. -.IP "\fBpkt_size=\fR\fIsize\fR" 4 -.IX Item "pkt_size=size" -Set the size in bytes of \s-1UDP\s0 packets. -.IP "\fBreuse=\fR\fI1|0\fR" 4 -.IX Item "reuse=1|0" -Explicitly allow or disallow reusing \s-1UDP\s0 sockets. -.IP "\fBttl=\fR\fIttl\fR" 4 -.IX Item "ttl=ttl" -Set the time to live value (for multicast only). -.IP "\fBconnect=\fR\fI1|0\fR" 4 -.IX Item "connect=1|0" -Initialize the \s-1UDP\s0 socket with \f(CW\*(C`connect()\*(C'\fR. In this case, the -destination address can't be changed with ff_udp_set_remote_url later. -If the destination address isn't known at the start, this option can -be specified in ff_udp_set_remote_url, too. -This allows finding out the source address for the packets with getsockname, -and makes writes return with \s-1AVERROR\s0(\s-1ECONNREFUSED\s0) if \*(L"destination -unreachable\*(R" is received. -For receiving, this gives the benefit of only receiving packets from -the specified peer address/port. -.IP "\fBsources=\fR\fIaddress\fR\fB[,\fR\fIaddress\fR\fB]\fR" 4 -.IX Item "sources=address[,address]" -Only receive packets sent to the multicast group from one of the -specified sender \s-1IP\s0 addresses. -.IP "\fBblock=\fR\fIaddress\fR\fB[,\fR\fIaddress\fR\fB]\fR" 4 -.IX Item "block=address[,address]" -Ignore packets sent to the multicast group from the specified -sender \s-1IP\s0 addresses. -.IP "\fBfifo_size=\fR\fIunits\fR" 4 -.IX Item "fifo_size=units" -Set the \s-1UDP\s0 receiving circular buffer size, expressed as a number of -packets with size of 188 bytes. If not specified defaults to 7*4096. -.IP "\fBoverrun_nonfatal=\fR\fI1|0\fR" 4 -.IX Item "overrun_nonfatal=1|0" -Survive in case of \s-1UDP\s0 receiving circular buffer overrun. Default -value is 0. -.IP "\fBtimeout=\fR\fImicroseconds\fR" 4 -.IX Item "timeout=microseconds" -In read mode: if no data arrived in more than this time interval, raise error. -.PP -Some usage examples of the \s-1UDP\s0 protocol with \fBffmpeg\fR follow. -.PP -To stream over \s-1UDP\s0 to a remote endpoint: -.PP -.Vb 1 -\& ffmpeg -i -f udp://: -.Ve -.PP -To stream in mpegts format over \s-1UDP\s0 using 188 sized \s-1UDP\s0 packets, using a large input buffer: -.PP -.Vb 1 -\& ffmpeg -i -f mpegts udp://:?pkt_size=188&buffer_size=65535 -.Ve -.PP -To receive over \s-1UDP\s0 from a remote endpoint: -.PP -.Vb 1 -\& ffmpeg -i udp://[]: -.Ve -.Sh "unix" -.IX Subsection "unix" -Unix local socket -.PP -The required syntax for a Unix socket \s-1URL\s0 is: -.PP -.Vb 1 -\& unix:// -.Ve -.PP -The following parameters can be set via command line options -(or in code via \f(CW\*(C`AVOption\*(C'\fRs): -.IP "\fBtimeout\fR" 4 -.IX Item "timeout" -Timeout in ms. -.IP "\fBlisten\fR" 4 -.IX Item "listen" -Create the Unix socket in listening mode. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavformat\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-resampler.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-resampler.1 deleted file mode 100644 index ff08066a4e..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-resampler.1 +++ /dev/null @@ -1,410 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-RESAMPLER 1" -.TH FFMPEG-RESAMPLER 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-resampler \- FFmpeg Resampler -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The FFmpeg resampler provides a high-level interface to the -libswresample library audio resampling utilities. In particular it -allows to perform audio resampling, audio channel layout rematrixing, -and convert audio format and packing layout. -.SH "RESAMPLER OPTIONS" -.IX Header "RESAMPLER OPTIONS" -The audio resampler supports the following named options. -.PP -Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the -FFmpeg tools, \fIoption\fR=\fIvalue\fR for the aresample filter, -by setting the value explicitly in the -\&\f(CW\*(C`SwrContext\*(C'\fR options or using the \fIlibavutil/opt.h\fR \s-1API\s0 for -programmatic use. -.IP "\fBich, in_channel_count\fR" 4 -.IX Item "ich, in_channel_count" -Set the number of input channels. Default value is 0. Setting this -value is not mandatory if the corresponding channel layout -\&\fBin_channel_layout\fR is set. -.IP "\fBoch, out_channel_count\fR" 4 -.IX Item "och, out_channel_count" -Set the number of output channels. Default value is 0. Setting this -value is not mandatory if the corresponding channel layout -\&\fBout_channel_layout\fR is set. -.IP "\fBuch, used_channel_count\fR" 4 -.IX Item "uch, used_channel_count" -Set the number of used input channels. Default value is 0. This option is -only used for special remapping. -.IP "\fBisr, in_sample_rate\fR" 4 -.IX Item "isr, in_sample_rate" -Set the input sample rate. Default value is 0. -.IP "\fBosr, out_sample_rate\fR" 4 -.IX Item "osr, out_sample_rate" -Set the output sample rate. Default value is 0. -.IP "\fBisf, in_sample_fmt\fR" 4 -.IX Item "isf, in_sample_fmt" -Specify the input sample format. It is set by default to \f(CW\*(C`none\*(C'\fR. -.IP "\fBosf, out_sample_fmt\fR" 4 -.IX Item "osf, out_sample_fmt" -Specify the output sample format. It is set by default to \f(CW\*(C`none\*(C'\fR. -.IP "\fBtsf, internal_sample_fmt\fR" 4 -.IX Item "tsf, internal_sample_fmt" -Set the internal sample format. Default value is \f(CW\*(C`none\*(C'\fR. -This will automatically be chosen when it is not explicitly set. -.IP "\fBicl, in_channel_layout\fR" 4 -.IX Item "icl, in_channel_layout" -.PD 0 -.IP "\fBocl, out_channel_layout\fR" 4 -.IX Item "ocl, out_channel_layout" -.PD -Set the input/output channel layout. -.Sp -See the Channel Layout section in the \fIffmpeg\-utils\fR\|(1) manual -for the required syntax. -.IP "\fBclev, center_mix_level\fR" 4 -.IX Item "clev, center_mix_level" -Set the center mix level. It is a value expressed in deciBel, and must be -in the interval [\-32,32]. -.IP "\fBslev, surround_mix_level\fR" 4 -.IX Item "slev, surround_mix_level" -Set the surround mix level. It is a value expressed in deciBel, and must -be in the interval [\-32,32]. -.IP "\fBlfe_mix_level\fR" 4 -.IX Item "lfe_mix_level" -Set \s-1LFE\s0 mix into non \s-1LFE\s0 level. It is used when there is a \s-1LFE\s0 input but no -\&\s-1LFE\s0 output. It is a value expressed in deciBel, and must -be in the interval [\-32,32]. -.IP "\fBrmvol, rematrix_volume\fR" 4 -.IX Item "rmvol, rematrix_volume" -Set rematrix volume. Default value is 1.0. -.IP "\fBrematrix_maxval\fR" 4 -.IX Item "rematrix_maxval" -Set maximum output value for rematrixing. -This can be used to prevent clipping vs. preventing volumn reduction -A value of 1.0 prevents cliping. -.IP "\fBflags, swr_flags\fR" 4 -.IX Item "flags, swr_flags" -Set flags used by the converter. Default value is 0. -.Sp -It supports the following individual flags: -.RS 4 -.IP "\fBres\fR" 4 -.IX Item "res" -force resampling, this flag forces resampling to be used even when the -input and output sample rates match. -.RE -.RS 4 -.RE -.IP "\fBdither_scale\fR" 4 -.IX Item "dither_scale" -Set the dither scale. Default value is 1. -.IP "\fBdither_method\fR" 4 -.IX Item "dither_method" -Set dither method. Default value is 0. -.Sp -Supported values: -.RS 4 -.IP "\fBrectangular\fR" 4 -.IX Item "rectangular" -select rectangular dither -.IP "\fBtriangular\fR" 4 -.IX Item "triangular" -select triangular dither -.IP "\fBtriangular_hp\fR" 4 -.IX Item "triangular_hp" -select triangular dither with high pass -.IP "\fBlipshitz\fR" 4 -.IX Item "lipshitz" -select lipshitz noise shaping dither -.IP "\fBshibata\fR" 4 -.IX Item "shibata" -select shibata noise shaping dither -.IP "\fBlow_shibata\fR" 4 -.IX Item "low_shibata" -select low shibata noise shaping dither -.IP "\fBhigh_shibata\fR" 4 -.IX Item "high_shibata" -select high shibata noise shaping dither -.IP "\fBf_weighted\fR" 4 -.IX Item "f_weighted" -select f\-weighted noise shaping dither -.IP "\fBmodified_e_weighted\fR" 4 -.IX Item "modified_e_weighted" -select modified-e-weighted noise shaping dither -.IP "\fBimproved_e_weighted\fR" 4 -.IX Item "improved_e_weighted" -select improved-e-weighted noise shaping dither -.RE -.RS 4 -.RE -.IP "\fBresampler\fR" 4 -.IX Item "resampler" -Set resampling engine. Default value is swr. -.Sp -Supported values: -.RS 4 -.IP "\fBswr\fR" 4 -.IX Item "swr" -select the native \s-1SW\s0 Resampler; filter options precision and cheby are not -applicable in this case. -.IP "\fBsoxr\fR" 4 -.IX Item "soxr" -select the SoX Resampler (where available); compensation, and filter options -filter_size, phase_shift, filter_type & kaiser_beta, are not applicable in this -case. -.RE -.RS 4 -.RE -.IP "\fBfilter_size\fR" 4 -.IX Item "filter_size" -For swr only, set resampling filter size, default value is 32. -.IP "\fBphase_shift\fR" 4 -.IX Item "phase_shift" -For swr only, set resampling phase shift, default value is 10, and must be in -the interval [0,30]. -.IP "\fBlinear_interp\fR" 4 -.IX Item "linear_interp" -Use Linear Interpolation if set to 1, default value is 0. -.IP "\fBcutoff\fR" 4 -.IX Item "cutoff" -Set cutoff frequency (swr: 6dB point; soxr: 0dB point) ratio; must be a float -value between 0 and 1. Default value is 0.97 with swr, and 0.91 with soxr -(which, with a sample-rate of 44100, preserves the entire audio band to 20kHz). -.IP "\fBprecision\fR" 4 -.IX Item "precision" -For soxr only, the precision in bits to which the resampled signal will be -calculated. The default value of 20 (which, with suitable dithering, is -appropriate for a destination bit-depth of 16) gives SoX's 'High Quality'; a -value of 28 gives SoX's 'Very High Quality'. -.IP "\fBcheby\fR" 4 -.IX Item "cheby" -For soxr only, selects passband rolloff none (Chebyshev) & higher-precision -approximation for 'irrational' ratios. Default value is 0. -.IP "\fBasync\fR" 4 -.IX Item "async" -For swr only, simple 1 parameter audio sync to timestamps using stretching, -squeezing, filling and trimming. Setting this to 1 will enable filling and -trimming, larger values represent the maximum amount in samples that the data -may be stretched or squeezed for each second. -Default value is 0, thus no compensation is applied to make the samples match -the audio timestamps. -.IP "\fBfirst_pts\fR" 4 -.IX Item "first_pts" -For swr only, assume the first pts should be this value. The time unit is 1 / sample rate. -This allows for padding/trimming at the start of stream. By default, no -assumption is made about the first frame's expected pts, so no padding or -trimming is done. For example, this could be set to 0 to pad the beginning with -silence if an audio stream starts after the video stream or to trim any samples -with a negative pts due to encoder delay. -.IP "\fBmin_comp\fR" 4 -.IX Item "min_comp" -For swr only, set the minimum difference between timestamps and audio data (in -seconds) to trigger stretching/squeezing/filling or trimming of the -data to make it match the timestamps. The default is that -stretching/squeezing/filling and trimming is disabled -(\fBmin_comp\fR = \f(CW\*(C`FLT_MAX\*(C'\fR). -.IP "\fBmin_hard_comp\fR" 4 -.IX Item "min_hard_comp" -For swr only, set the minimum difference between timestamps and audio data (in -seconds) to trigger adding/dropping samples to make it match the -timestamps. This option effectively is a threshold to select between -hard (trim/fill) and soft (squeeze/stretch) compensation. Note that -all compensation is by default disabled through \fBmin_comp\fR. -The default is 0.1. -.IP "\fBcomp_duration\fR" 4 -.IX Item "comp_duration" -For swr only, set duration (in seconds) over which data is stretched/squeezed -to make it match the timestamps. Must be a non-negative double float value, -default value is 1.0. -.IP "\fBmax_soft_comp\fR" 4 -.IX Item "max_soft_comp" -For swr only, set maximum factor by which data is stretched/squeezed to make it -match the timestamps. Must be a non-negative double float value, default value -is 0. -.IP "\fBmatrix_encoding\fR" 4 -.IX Item "matrix_encoding" -Select matrixed stereo encoding. -.Sp -It accepts the following values: -.RS 4 -.IP "\fBnone\fR" 4 -.IX Item "none" -select none -.IP "\fBdolby\fR" 4 -.IX Item "dolby" -select Dolby -.IP "\fBdplii\fR" 4 -.IX Item "dplii" -select Dolby Pro Logic \s-1II\s0 -.RE -.RS 4 -.Sp -Default value is \f(CW\*(C`none\*(C'\fR. -.RE -.IP "\fBfilter_type\fR" 4 -.IX Item "filter_type" -For swr only, select resampling filter type. This only affects resampling -operations. -.Sp -It accepts the following values: -.RS 4 -.IP "\fBcubic\fR" 4 -.IX Item "cubic" -select cubic -.IP "\fBblackman_nuttall\fR" 4 -.IX Item "blackman_nuttall" -select Blackman Nuttall Windowed Sinc -.IP "\fBkaiser\fR" 4 -.IX Item "kaiser" -select Kaiser Windowed Sinc -.RE -.RS 4 -.RE -.IP "\fBkaiser_beta\fR" 4 -.IX Item "kaiser_beta" -For swr only, set Kaiser Window Beta value. Must be an integer in the -interval [2,16], default value is 9. -.IP "\fBoutput_sample_bits\fR" 4 -.IX Item "output_sample_bits" -For swr only, set number of used output sample bits for dithering. Must be an integer in the -interval [0,64], default value is 0, which means it's not used. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibswresample\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-scaler.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-scaler.1 deleted file mode 100644 index cfc181dea1..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-scaler.1 +++ /dev/null @@ -1,268 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-SCALER 1" -.TH FFMPEG-SCALER 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-scaler \- FFmpeg video scaling and pixel format converter -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The FFmpeg rescaler provides a high-level interface to the libswscale -library image conversion utilities. In particular it allows to perform -image rescaling and pixel format conversion. -.SH "SCALER OPTIONS" -.IX Header "SCALER OPTIONS" -The video scaler supports the following named options. -.PP -Options may be set by specifying \-\fIoption\fR \fIvalue\fR in the -FFmpeg tools. For programmatic use, they can be set explicitly in the -\&\f(CW\*(C`SwsContext\*(C'\fR options or through the \fIlibavutil/opt.h\fR \s-1API\s0. -.IP "\fBsws_flags\fR" 4 -.IX Item "sws_flags" -Set the scaler flags. This is also used to set the scaling -algorithm. Only a single algorithm should be selected. -.Sp -It accepts the following values: -.RS 4 -.IP "\fBfast_bilinear\fR" 4 -.IX Item "fast_bilinear" -Select fast bilinear scaling algorithm. -.IP "\fBbilinear\fR" 4 -.IX Item "bilinear" -Select bilinear scaling algorithm. -.IP "\fBbicubic\fR" 4 -.IX Item "bicubic" -Select bicubic scaling algorithm. -.IP "\fBexperimental\fR" 4 -.IX Item "experimental" -Select experimental scaling algorithm. -.IP "\fBneighbor\fR" 4 -.IX Item "neighbor" -Select nearest neighbor rescaling algorithm. -.IP "\fBarea\fR" 4 -.IX Item "area" -Select averaging area rescaling algorithm. -.IP "\fBbicubiclin\fR" 4 -.IX Item "bicubiclin" -Select bicubic scaling algorithm for the luma component, bilinear for -chroma components. -.IP "\fBgauss\fR" 4 -.IX Item "gauss" -Select Gaussian rescaling algorithm. -.IP "\fBsinc\fR" 4 -.IX Item "sinc" -Select sinc rescaling algorithm. -.IP "\fBlanczos\fR" 4 -.IX Item "lanczos" -Select lanczos rescaling algorithm. -.IP "\fBspline\fR" 4 -.IX Item "spline" -Select natural bicubic spline rescaling algorithm. -.IP "\fBprint_info\fR" 4 -.IX Item "print_info" -Enable printing/debug logging. -.IP "\fBaccurate_rnd\fR" 4 -.IX Item "accurate_rnd" -Enable accurate rounding. -.IP "\fBfull_chroma_int\fR" 4 -.IX Item "full_chroma_int" -Enable full chroma interpolation. -.IP "\fBfull_chroma_inp\fR" 4 -.IX Item "full_chroma_inp" -Select full chroma input. -.IP "\fBbitexact\fR" 4 -.IX Item "bitexact" -Enable bitexact output. -.RE -.RS 4 -.RE -.IP "\fBsrcw\fR" 4 -.IX Item "srcw" -Set source width. -.IP "\fBsrch\fR" 4 -.IX Item "srch" -Set source height. -.IP "\fBdstw\fR" 4 -.IX Item "dstw" -Set destination width. -.IP "\fBdsth\fR" 4 -.IX Item "dsth" -Set destination height. -.IP "\fBsrc_format\fR" 4 -.IX Item "src_format" -Set source pixel format (must be expressed as an integer). -.IP "\fBdst_format\fR" 4 -.IX Item "dst_format" -Set destination pixel format (must be expressed as an integer). -.IP "\fBsrc_range\fR" 4 -.IX Item "src_range" -Select source range. -.IP "\fBdst_range\fR" 4 -.IX Item "dst_range" -Select destination range. -.IP "\fBparam0, param1\fR" 4 -.IX Item "param0, param1" -Set scaling algorithm parameters. The specified values are specific of -some scaling algorithms and ignored by others. The specified values -are floating point number values. -.IP "\fBsws_dither\fR" 4 -.IX Item "sws_dither" -Set the dithering algorithm. Accepts one of the following -values. Default value is \fBauto\fR. -.RS 4 -.IP "\fBauto\fR" 4 -.IX Item "auto" -automatic choice -.IP "\fBnone\fR" 4 -.IX Item "none" -no dithering -.IP "\fBbayer\fR" 4 -.IX Item "bayer" -bayer dither -.IP "\fBed\fR" 4 -.IX Item "ed" -error diffusion dither -.RE -.RS 4 -.RE -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibswscale\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-utils.1 b/contrib/sdk/sources/ffmpeg/doc/ffmpeg-utils.1 deleted file mode 100644 index a9e506b4eb..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/ffmpeg-utils.1 +++ /dev/null @@ -1,1445 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "FFMPEG-UTILS 1" -.TH FFMPEG-UTILS 1 "2013-12-14" " " " " -.SH "NAME" -ffmpeg\-utils \- FFmpeg utilities -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This document describes some generic features and utilities provided -by the libavutil library. -.SH "SYNTAX" -.IX Header "SYNTAX" -This section documents the syntax and formats employed by the FFmpeg -libraries and tools. -.Sh "Quoting and escaping" -.IX Subsection "Quoting and escaping" -FFmpeg adopts the following quoting and escaping mechanism, unless -explicitly specified. The following rules are applied: -.IP "\(bu" 4 -\&\f(CW\*(C`'\*(C'\fR and \f(CW\*(C`\e\*(C'\fR are special characters (respectively used for -quoting and escaping). In addition to them, there might be other -special characters depending on the specific syntax where the escaping -and quoting are employed. -.IP "\(bu" 4 -A special character is escaped by prefixing it with a '\e'. -.IP "\(bu" 4 -All characters enclosed between '' are included literally in the -parsed string. The quote character \f(CW\*(C`'\*(C'\fR itself cannot be quoted, -so you may need to close the quote and escape it. -.IP "\(bu" 4 -Leading and trailing whitespaces, unless escaped or quoted, are -removed from the parsed string. -.PP -Note that you may need to add a second level of escaping when using -the command line or a script, which depends on the syntax of the -adopted shell language. -.PP -The function \f(CW\*(C`av_get_token\*(C'\fR defined in -\&\fIlibavutil/avstring.h\fR can be used to parse a token quoted or -escaped according to the rules defined above. -.PP -The tool \fItools/ffescape\fR in the FFmpeg source tree can be used -to automatically quote or escape a string in a script. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.IP "\(bu" 4 -Escape the string \f(CW\*(C`Crime d'Amour\*(C'\fR containing the \f(CW\*(C`'\*(C'\fR special -character: -.Sp -.Vb 1 -\& Crime d\e'Amour -.Ve -.IP "\(bu" 4 -The string above contains a quote, so the \f(CW\*(C`'\*(C'\fR needs to be escaped -when quoting it: -.Sp -.Vb 1 -\& 'Crime d'\e''Amour' -.Ve -.IP "\(bu" 4 -Include leading or trailing whitespaces using quoting: -.Sp -.Vb 1 -\& ' this string starts and ends with whitespaces ' -.Ve -.IP "\(bu" 4 -Escaping and quoting can be mixed together: -.Sp -.Vb 1 -\& ' The string '\e'string\e'' is a string ' -.Ve -.IP "\(bu" 4 -To include a literal \f(CW\*(C`\e\*(C'\fR you can use either escaping or quoting: -.Sp -.Vb 1 -\& 'c:\efoo' can be written as c:\e\efoo -.Ve -.Sh "Date" -.IX Subsection "Date" -The accepted syntax is: -.PP -.Vb 2 -\& [(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z] -\& now -.Ve -.PP -If the value is \*(L"now\*(R" it takes the current time. -.PP -Time is local time unless Z is appended, in which case it is -interpreted as \s-1UTC\s0. -If the year-month-day part is not specified it takes the current -year\-month\-day. -.Sh "Time duration" -.IX Subsection "Time duration" -There are two accepted syntaxes for expressing time duration. -.PP -.Vb 1 -\& [-][:]:[....] -.Ve -.PP -\&\fI\s-1HH\s0\fR expresses the number of hours, \fI\s-1MM\s0\fR the number of minutes -for a maximum of 2 digits, and \fI\s-1SS\s0\fR the number of seconds for a -maximum of 2 digits. The \fIm\fR at the end expresses decimal value for -\&\fI\s-1SS\s0\fR. -.PP -\&\fIor\fR -.PP -.Vb 1 -\& [-]+[....] -.Ve -.PP -\&\fIS\fR expresses the number of seconds, with the optional decimal part -\&\fIm\fR. -.PP -In both expressions, the optional \fB\-\fR indicates negative duration. -.PP -\fIExamples\fR -.IX Subsection "Examples" -.PP -The following examples are all valid time duration: -.IP "\fB55\fR" 4 -.IX Item "55" -55 seconds -.IP "\fB12:03:45\fR" 4 -.IX Item "12:03:45" -12 hours, 03 minutes and 45 seconds -.IP "\fB23.189\fR" 4 -.IX Item "23.189" -23.189 seconds -.Sh "Video size" -.IX Subsection "Video size" -Specify the size of the sourced video, it may be a string of the form -\&\fIwidth\fRx\fIheight\fR, or the name of a size abbreviation. -.PP -The following abbreviations are recognized: -.IP "\fBntsc\fR" 4 -.IX Item "ntsc" -720x480 -.IP "\fBpal\fR" 4 -.IX Item "pal" -720x576 -.IP "\fBqntsc\fR" 4 -.IX Item "qntsc" -352x240 -.IP "\fBqpal\fR" 4 -.IX Item "qpal" -352x288 -.IP "\fBsntsc\fR" 4 -.IX Item "sntsc" -640x480 -.IP "\fBspal\fR" 4 -.IX Item "spal" -768x576 -.IP "\fBfilm\fR" 4 -.IX Item "film" -352x240 -.IP "\fBntsc-film\fR" 4 -.IX Item "ntsc-film" -352x240 -.IP "\fBsqcif\fR" 4 -.IX Item "sqcif" -128x96 -.IP "\fBqcif\fR" 4 -.IX Item "qcif" -176x144 -.IP "\fBcif\fR" 4 -.IX Item "cif" -352x288 -.IP "\fB4cif\fR" 4 -.IX Item "4cif" -704x576 -.IP "\fB16cif\fR" 4 -.IX Item "16cif" -1408x1152 -.IP "\fBqqvga\fR" 4 -.IX Item "qqvga" -160x120 -.IP "\fBqvga\fR" 4 -.IX Item "qvga" -320x240 -.IP "\fBvga\fR" 4 -.IX Item "vga" -640x480 -.IP "\fBsvga\fR" 4 -.IX Item "svga" -800x600 -.IP "\fBxga\fR" 4 -.IX Item "xga" -1024x768 -.IP "\fBuxga\fR" 4 -.IX Item "uxga" -1600x1200 -.IP "\fBqxga\fR" 4 -.IX Item "qxga" -2048x1536 -.IP "\fBsxga\fR" 4 -.IX Item "sxga" -1280x1024 -.IP "\fBqsxga\fR" 4 -.IX Item "qsxga" -2560x2048 -.IP "\fBhsxga\fR" 4 -.IX Item "hsxga" -5120x4096 -.IP "\fBwvga\fR" 4 -.IX Item "wvga" -852x480 -.IP "\fBwxga\fR" 4 -.IX Item "wxga" -1366x768 -.IP "\fBwsxga\fR" 4 -.IX Item "wsxga" -1600x1024 -.IP "\fBwuxga\fR" 4 -.IX Item "wuxga" -1920x1200 -.IP "\fBwoxga\fR" 4 -.IX Item "woxga" -2560x1600 -.IP "\fBwqsxga\fR" 4 -.IX Item "wqsxga" -3200x2048 -.IP "\fBwquxga\fR" 4 -.IX Item "wquxga" -3840x2400 -.IP "\fBwhsxga\fR" 4 -.IX Item "whsxga" -6400x4096 -.IP "\fBwhuxga\fR" 4 -.IX Item "whuxga" -7680x4800 -.IP "\fBcga\fR" 4 -.IX Item "cga" -320x200 -.IP "\fBega\fR" 4 -.IX Item "ega" -640x350 -.IP "\fBhd480\fR" 4 -.IX Item "hd480" -852x480 -.IP "\fBhd720\fR" 4 -.IX Item "hd720" -1280x720 -.IP "\fBhd1080\fR" 4 -.IX Item "hd1080" -1920x1080 -.IP "\fB2k\fR" 4 -.IX Item "2k" -2048x1080 -.IP "\fB2kflat\fR" 4 -.IX Item "2kflat" -1998x1080 -.IP "\fB2kscope\fR" 4 -.IX Item "2kscope" -2048x858 -.IP "\fB4k\fR" 4 -.IX Item "4k" -4096x2160 -.IP "\fB4kflat\fR" 4 -.IX Item "4kflat" -3996x2160 -.IP "\fB4kscope\fR" 4 -.IX Item "4kscope" -4096x1716 -.IP "\fBnhd\fR" 4 -.IX Item "nhd" -640x360 -.IP "\fBhqvga\fR" 4 -.IX Item "hqvga" -240x160 -.IP "\fBwqvga\fR" 4 -.IX Item "wqvga" -400x240 -.IP "\fBfwqvga\fR" 4 -.IX Item "fwqvga" -432x240 -.IP "\fBhvga\fR" 4 -.IX Item "hvga" -480x320 -.IP "\fBqhd\fR" 4 -.IX Item "qhd" -960x540 -.Sh "Video rate" -.IX Subsection "Video rate" -Specify the frame rate of a video, expressed as the number of frames -generated per second. It has to be a string in the format -\&\fIframe_rate_num\fR/\fIframe_rate_den\fR, an integer number, a float -number or a valid video frame rate abbreviation. -.PP -The following abbreviations are recognized: -.IP "\fBntsc\fR" 4 -.IX Item "ntsc" -30000/1001 -.IP "\fBpal\fR" 4 -.IX Item "pal" -25/1 -.IP "\fBqntsc\fR" 4 -.IX Item "qntsc" -30000/1001 -.IP "\fBqpal\fR" 4 -.IX Item "qpal" -25/1 -.IP "\fBsntsc\fR" 4 -.IX Item "sntsc" -30000/1001 -.IP "\fBspal\fR" 4 -.IX Item "spal" -25/1 -.IP "\fBfilm\fR" 4 -.IX Item "film" -24/1 -.IP "\fBntsc-film\fR" 4 -.IX Item "ntsc-film" -24000/1001 -.Sh "Ratio" -.IX Subsection "Ratio" -A ratio can be expressed as an expression, or in the form -\&\fInumerator\fR:\fIdenominator\fR. -.PP -Note that a ratio with infinite (1/0) or negative value is -considered valid, so you should check on the returned value if you -want to exclude those values. -.PP -The undefined value can be expressed using the \*(L"0:0\*(R" string. -.Sh "Color" -.IX Subsection "Color" -It can be the name of a color as defined below (case insensitive match) or a -\&\f(CW\*(C`[0x|#]RRGGBB[AA]\*(C'\fR sequence, possibly followed by @ and a string -representing the alpha component. -.PP -The alpha component may be a string composed by \*(L"0x\*(R" followed by an -hexadecimal number or a decimal number between 0.0 and 1.0, which -represents the opacity value (\fB0x00\fR or \fB0.0\fR means completely -transparent, \fB0xff\fR or \fB1.0\fR completely opaque). If the alpha -component is not specified then \fB0xff\fR is assumed. -.PP -The string \fBrandom\fR will result in a random color. -.PP -The following names of colors are recognized: -.IP "\fBAliceBlue\fR" 4 -.IX Item "AliceBlue" -0xF0F8FF -.IP "\fBAntiqueWhite\fR" 4 -.IX Item "AntiqueWhite" -0xFAEBD7 -.IP "\fBAqua\fR" 4 -.IX Item "Aqua" -0x00FFFF -.IP "\fBAquamarine\fR" 4 -.IX Item "Aquamarine" -0x7FFFD4 -.IP "\fBAzure\fR" 4 -.IX Item "Azure" -0xF0FFFF -.IP "\fBBeige\fR" 4 -.IX Item "Beige" -0xF5F5DC -.IP "\fBBisque\fR" 4 -.IX Item "Bisque" -0xFFE4C4 -.IP "\fBBlack\fR" 4 -.IX Item "Black" -0x000000 -.IP "\fBBlanchedAlmond\fR" 4 -.IX Item "BlanchedAlmond" -0xFFEBCD -.IP "\fBBlue\fR" 4 -.IX Item "Blue" -0x0000FF -.IP "\fBBlueViolet\fR" 4 -.IX Item "BlueViolet" -0x8A2BE2 -.IP "\fBBrown\fR" 4 -.IX Item "Brown" -0xA52A2A -.IP "\fBBurlyWood\fR" 4 -.IX Item "BurlyWood" -0xDEB887 -.IP "\fBCadetBlue\fR" 4 -.IX Item "CadetBlue" -0x5F9EA0 -.IP "\fBChartreuse\fR" 4 -.IX Item "Chartreuse" -0x7FFF00 -.IP "\fBChocolate\fR" 4 -.IX Item "Chocolate" -0xD2691E -.IP "\fBCoral\fR" 4 -.IX Item "Coral" -0xFF7F50 -.IP "\fBCornflowerBlue\fR" 4 -.IX Item "CornflowerBlue" -0x6495ED -.IP "\fBCornsilk\fR" 4 -.IX Item "Cornsilk" -0xFFF8DC -.IP "\fBCrimson\fR" 4 -.IX Item "Crimson" -0xDC143C -.IP "\fBCyan\fR" 4 -.IX Item "Cyan" -0x00FFFF -.IP "\fBDarkBlue\fR" 4 -.IX Item "DarkBlue" -0x00008B -.IP "\fBDarkCyan\fR" 4 -.IX Item "DarkCyan" -0x008B8B -.IP "\fBDarkGoldenRod\fR" 4 -.IX Item "DarkGoldenRod" -0xB8860B -.IP "\fBDarkGray\fR" 4 -.IX Item "DarkGray" -0xA9A9A9 -.IP "\fBDarkGreen\fR" 4 -.IX Item "DarkGreen" -0x006400 -.IP "\fBDarkKhaki\fR" 4 -.IX Item "DarkKhaki" -0xBDB76B -.IP "\fBDarkMagenta\fR" 4 -.IX Item "DarkMagenta" -0x8B008B -.IP "\fBDarkOliveGreen\fR" 4 -.IX Item "DarkOliveGreen" -0x556B2F -.IP "\fBDarkorange\fR" 4 -.IX Item "Darkorange" -0xFF8C00 -.IP "\fBDarkOrchid\fR" 4 -.IX Item "DarkOrchid" -0x9932CC -.IP "\fBDarkRed\fR" 4 -.IX Item "DarkRed" -0x8B0000 -.IP "\fBDarkSalmon\fR" 4 -.IX Item "DarkSalmon" -0xE9967A -.IP "\fBDarkSeaGreen\fR" 4 -.IX Item "DarkSeaGreen" -0x8FBC8F -.IP "\fBDarkSlateBlue\fR" 4 -.IX Item "DarkSlateBlue" -0x483D8B -.IP "\fBDarkSlateGray\fR" 4 -.IX Item "DarkSlateGray" -0x2F4F4F -.IP "\fBDarkTurquoise\fR" 4 -.IX Item "DarkTurquoise" -0x00CED1 -.IP "\fBDarkViolet\fR" 4 -.IX Item "DarkViolet" -0x9400D3 -.IP "\fBDeepPink\fR" 4 -.IX Item "DeepPink" -0xFF1493 -.IP "\fBDeepSkyBlue\fR" 4 -.IX Item "DeepSkyBlue" -0x00BFFF -.IP "\fBDimGray\fR" 4 -.IX Item "DimGray" -0x696969 -.IP "\fBDodgerBlue\fR" 4 -.IX Item "DodgerBlue" -0x1E90FF -.IP "\fBFireBrick\fR" 4 -.IX Item "FireBrick" -0xB22222 -.IP "\fBFloralWhite\fR" 4 -.IX Item "FloralWhite" -0xFFFAF0 -.IP "\fBForestGreen\fR" 4 -.IX Item "ForestGreen" -0x228B22 -.IP "\fBFuchsia\fR" 4 -.IX Item "Fuchsia" -0xFF00FF -.IP "\fBGainsboro\fR" 4 -.IX Item "Gainsboro" -0xDCDCDC -.IP "\fBGhostWhite\fR" 4 -.IX Item "GhostWhite" -0xF8F8FF -.IP "\fBGold\fR" 4 -.IX Item "Gold" -0xFFD700 -.IP "\fBGoldenRod\fR" 4 -.IX Item "GoldenRod" -0xDAA520 -.IP "\fBGray\fR" 4 -.IX Item "Gray" -0x808080 -.IP "\fBGreen\fR" 4 -.IX Item "Green" -0x008000 -.IP "\fBGreenYellow\fR" 4 -.IX Item "GreenYellow" -0xADFF2F -.IP "\fBHoneyDew\fR" 4 -.IX Item "HoneyDew" -0xF0FFF0 -.IP "\fBHotPink\fR" 4 -.IX Item "HotPink" -0xFF69B4 -.IP "\fBIndianRed\fR" 4 -.IX Item "IndianRed" -0xCD5C5C -.IP "\fBIndigo\fR" 4 -.IX Item "Indigo" -0x4B0082 -.IP "\fBIvory\fR" 4 -.IX Item "Ivory" -0xFFFFF0 -.IP "\fBKhaki\fR" 4 -.IX Item "Khaki" -0xF0E68C -.IP "\fBLavender\fR" 4 -.IX Item "Lavender" -0xE6E6FA -.IP "\fBLavenderBlush\fR" 4 -.IX Item "LavenderBlush" -0xFFF0F5 -.IP "\fBLawnGreen\fR" 4 -.IX Item "LawnGreen" -0x7CFC00 -.IP "\fBLemonChiffon\fR" 4 -.IX Item "LemonChiffon" -0xFFFACD -.IP "\fBLightBlue\fR" 4 -.IX Item "LightBlue" -0xADD8E6 -.IP "\fBLightCoral\fR" 4 -.IX Item "LightCoral" -0xF08080 -.IP "\fBLightCyan\fR" 4 -.IX Item "LightCyan" -0xE0FFFF -.IP "\fBLightGoldenRodYellow\fR" 4 -.IX Item "LightGoldenRodYellow" -0xFAFAD2 -.IP "\fBLightGreen\fR" 4 -.IX Item "LightGreen" -0x90EE90 -.IP "\fBLightGrey\fR" 4 -.IX Item "LightGrey" -0xD3D3D3 -.IP "\fBLightPink\fR" 4 -.IX Item "LightPink" -0xFFB6C1 -.IP "\fBLightSalmon\fR" 4 -.IX Item "LightSalmon" -0xFFA07A -.IP "\fBLightSeaGreen\fR" 4 -.IX Item "LightSeaGreen" -0x20B2AA -.IP "\fBLightSkyBlue\fR" 4 -.IX Item "LightSkyBlue" -0x87CEFA -.IP "\fBLightSlateGray\fR" 4 -.IX Item "LightSlateGray" -0x778899 -.IP "\fBLightSteelBlue\fR" 4 -.IX Item "LightSteelBlue" -0xB0C4DE -.IP "\fBLightYellow\fR" 4 -.IX Item "LightYellow" -0xFFFFE0 -.IP "\fBLime\fR" 4 -.IX Item "Lime" -0x00FF00 -.IP "\fBLimeGreen\fR" 4 -.IX Item "LimeGreen" -0x32CD32 -.IP "\fBLinen\fR" 4 -.IX Item "Linen" -0xFAF0E6 -.IP "\fBMagenta\fR" 4 -.IX Item "Magenta" -0xFF00FF -.IP "\fBMaroon\fR" 4 -.IX Item "Maroon" -0x800000 -.IP "\fBMediumAquaMarine\fR" 4 -.IX Item "MediumAquaMarine" -0x66CDAA -.IP "\fBMediumBlue\fR" 4 -.IX Item "MediumBlue" -0x0000CD -.IP "\fBMediumOrchid\fR" 4 -.IX Item "MediumOrchid" -0xBA55D3 -.IP "\fBMediumPurple\fR" 4 -.IX Item "MediumPurple" -0x9370D8 -.IP "\fBMediumSeaGreen\fR" 4 -.IX Item "MediumSeaGreen" -0x3CB371 -.IP "\fBMediumSlateBlue\fR" 4 -.IX Item "MediumSlateBlue" -0x7B68EE -.IP "\fBMediumSpringGreen\fR" 4 -.IX Item "MediumSpringGreen" -0x00FA9A -.IP "\fBMediumTurquoise\fR" 4 -.IX Item "MediumTurquoise" -0x48D1CC -.IP "\fBMediumVioletRed\fR" 4 -.IX Item "MediumVioletRed" -0xC71585 -.IP "\fBMidnightBlue\fR" 4 -.IX Item "MidnightBlue" -0x191970 -.IP "\fBMintCream\fR" 4 -.IX Item "MintCream" -0xF5FFFA -.IP "\fBMistyRose\fR" 4 -.IX Item "MistyRose" -0xFFE4E1 -.IP "\fBMoccasin\fR" 4 -.IX Item "Moccasin" -0xFFE4B5 -.IP "\fBNavajoWhite\fR" 4 -.IX Item "NavajoWhite" -0xFFDEAD -.IP "\fBNavy\fR" 4 -.IX Item "Navy" -0x000080 -.IP "\fBOldLace\fR" 4 -.IX Item "OldLace" -0xFDF5E6 -.IP "\fBOlive\fR" 4 -.IX Item "Olive" -0x808000 -.IP "\fBOliveDrab\fR" 4 -.IX Item "OliveDrab" -0x6B8E23 -.IP "\fBOrange\fR" 4 -.IX Item "Orange" -0xFFA500 -.IP "\fBOrangeRed\fR" 4 -.IX Item "OrangeRed" -0xFF4500 -.IP "\fBOrchid\fR" 4 -.IX Item "Orchid" -0xDA70D6 -.IP "\fBPaleGoldenRod\fR" 4 -.IX Item "PaleGoldenRod" -0xEEE8AA -.IP "\fBPaleGreen\fR" 4 -.IX Item "PaleGreen" -0x98FB98 -.IP "\fBPaleTurquoise\fR" 4 -.IX Item "PaleTurquoise" -0xAFEEEE -.IP "\fBPaleVioletRed\fR" 4 -.IX Item "PaleVioletRed" -0xD87093 -.IP "\fBPapayaWhip\fR" 4 -.IX Item "PapayaWhip" -0xFFEFD5 -.IP "\fBPeachPuff\fR" 4 -.IX Item "PeachPuff" -0xFFDAB9 -.IP "\fBPeru\fR" 4 -.IX Item "Peru" -0xCD853F -.IP "\fBPink\fR" 4 -.IX Item "Pink" -0xFFC0CB -.IP "\fBPlum\fR" 4 -.IX Item "Plum" -0xDDA0DD -.IP "\fBPowderBlue\fR" 4 -.IX Item "PowderBlue" -0xB0E0E6 -.IP "\fBPurple\fR" 4 -.IX Item "Purple" -0x800080 -.IP "\fBRed\fR" 4 -.IX Item "Red" -0xFF0000 -.IP "\fBRosyBrown\fR" 4 -.IX Item "RosyBrown" -0xBC8F8F -.IP "\fBRoyalBlue\fR" 4 -.IX Item "RoyalBlue" -0x4169E1 -.IP "\fBSaddleBrown\fR" 4 -.IX Item "SaddleBrown" -0x8B4513 -.IP "\fBSalmon\fR" 4 -.IX Item "Salmon" -0xFA8072 -.IP "\fBSandyBrown\fR" 4 -.IX Item "SandyBrown" -0xF4A460 -.IP "\fBSeaGreen\fR" 4 -.IX Item "SeaGreen" -0x2E8B57 -.IP "\fBSeaShell\fR" 4 -.IX Item "SeaShell" -0xFFF5EE -.IP "\fBSienna\fR" 4 -.IX Item "Sienna" -0xA0522D -.IP "\fBSilver\fR" 4 -.IX Item "Silver" -0xC0C0C0 -.IP "\fBSkyBlue\fR" 4 -.IX Item "SkyBlue" -0x87CEEB -.IP "\fBSlateBlue\fR" 4 -.IX Item "SlateBlue" -0x6A5ACD -.IP "\fBSlateGray\fR" 4 -.IX Item "SlateGray" -0x708090 -.IP "\fBSnow\fR" 4 -.IX Item "Snow" -0xFFFAFA -.IP "\fBSpringGreen\fR" 4 -.IX Item "SpringGreen" -0x00FF7F -.IP "\fBSteelBlue\fR" 4 -.IX Item "SteelBlue" -0x4682B4 -.IP "\fBTan\fR" 4 -.IX Item "Tan" -0xD2B48C -.IP "\fBTeal\fR" 4 -.IX Item "Teal" -0x008080 -.IP "\fBThistle\fR" 4 -.IX Item "Thistle" -0xD8BFD8 -.IP "\fBTomato\fR" 4 -.IX Item "Tomato" -0xFF6347 -.IP "\fBTurquoise\fR" 4 -.IX Item "Turquoise" -0x40E0D0 -.IP "\fBViolet\fR" 4 -.IX Item "Violet" -0xEE82EE -.IP "\fBWheat\fR" 4 -.IX Item "Wheat" -0xF5DEB3 -.IP "\fBWhite\fR" 4 -.IX Item "White" -0xFFFFFF -.IP "\fBWhiteSmoke\fR" 4 -.IX Item "WhiteSmoke" -0xF5F5F5 -.IP "\fBYellow\fR" 4 -.IX Item "Yellow" -0xFFFF00 -.IP "\fBYellowGreen\fR" 4 -.IX Item "YellowGreen" -0x9ACD32 -.Sh "Channel Layout" -.IX Subsection "Channel Layout" -A channel layout specifies the spatial disposition of the channels in -a multi-channel audio stream. To specify a channel layout, FFmpeg -makes use of a special syntax. -.PP -Individual channels are identified by an id, as given by the table -below: -.IP "\fB\s-1FL\s0\fR" 4 -.IX Item "FL" -front left -.IP "\fB\s-1FR\s0\fR" 4 -.IX Item "FR" -front right -.IP "\fB\s-1FC\s0\fR" 4 -.IX Item "FC" -front center -.IP "\fB\s-1LFE\s0\fR" 4 -.IX Item "LFE" -low frequency -.IP "\fB\s-1BL\s0\fR" 4 -.IX Item "BL" -back left -.IP "\fB\s-1BR\s0\fR" 4 -.IX Item "BR" -back right -.IP "\fB\s-1FLC\s0\fR" 4 -.IX Item "FLC" -front left-of-center -.IP "\fB\s-1FRC\s0\fR" 4 -.IX Item "FRC" -front right-of-center -.IP "\fB\s-1BC\s0\fR" 4 -.IX Item "BC" -back center -.IP "\fB\s-1SL\s0\fR" 4 -.IX Item "SL" -side left -.IP "\fB\s-1SR\s0\fR" 4 -.IX Item "SR" -side right -.IP "\fB\s-1TC\s0\fR" 4 -.IX Item "TC" -top center -.IP "\fB\s-1TFL\s0\fR" 4 -.IX Item "TFL" -top front left -.IP "\fB\s-1TFC\s0\fR" 4 -.IX Item "TFC" -top front center -.IP "\fB\s-1TFR\s0\fR" 4 -.IX Item "TFR" -top front right -.IP "\fB\s-1TBL\s0\fR" 4 -.IX Item "TBL" -top back left -.IP "\fB\s-1TBC\s0\fR" 4 -.IX Item "TBC" -top back center -.IP "\fB\s-1TBR\s0\fR" 4 -.IX Item "TBR" -top back right -.IP "\fB\s-1DL\s0\fR" 4 -.IX Item "DL" -downmix left -.IP "\fB\s-1DR\s0\fR" 4 -.IX Item "DR" -downmix right -.IP "\fB\s-1WL\s0\fR" 4 -.IX Item "WL" -wide left -.IP "\fB\s-1WR\s0\fR" 4 -.IX Item "WR" -wide right -.IP "\fB\s-1SDL\s0\fR" 4 -.IX Item "SDL" -surround direct left -.IP "\fB\s-1SDR\s0\fR" 4 -.IX Item "SDR" -surround direct right -.IP "\fB\s-1LFE2\s0\fR" 4 -.IX Item "LFE2" -low frequency 2 -.PP -Standard channel layout compositions can be specified by using the -following identifiers: -.IP "\fBmono\fR" 4 -.IX Item "mono" -\&\s-1FC\s0 -.IP "\fBstereo\fR" 4 -.IX Item "stereo" -\&\s-1FL+FR\s0 -.IP "\fB2.1\fR" 4 -.IX Item "2.1" -\&\s-1FL+FR+LFE\s0 -.IP "\fB3.0\fR" 4 -.IX Item "3.0" -\&\s-1FL+FR+FC\s0 -.IP "\fB3.0(back)\fR" 4 -.IX Item "3.0(back)" -\&\s-1FL+FR+BC\s0 -.IP "\fB4.0\fR" 4 -.IX Item "4.0" -\&\s-1FL+FR+FC+BC\s0 -.IP "\fBquad\fR" 4 -.IX Item "quad" -\&\s-1FL+FR+BL+BR\s0 -.IP "\fBquad(side)\fR" 4 -.IX Item "quad(side)" -\&\s-1FL+FR+SL+SR\s0 -.IP "\fB3.1\fR" 4 -.IX Item "3.1" -\&\s-1FL+FR+FC+LFE\s0 -.IP "\fB5.0\fR" 4 -.IX Item "5.0" -\&\s-1FL+FR+FC+BL+BR\s0 -.IP "\fB5.0(side)\fR" 4 -.IX Item "5.0(side)" -\&\s-1FL+FR+FC+SL+SR\s0 -.IP "\fB4.1\fR" 4 -.IX Item "4.1" -\&\s-1FL+FR+FC+LFE+BC\s0 -.IP "\fB5.1\fR" 4 -.IX Item "5.1" -\&\s-1FL+FR+FC+LFE+BL+BR\s0 -.IP "\fB5.1(side)\fR" 4 -.IX Item "5.1(side)" -\&\s-1FL+FR+FC+LFE+SL+SR\s0 -.IP "\fB6.0\fR" 4 -.IX Item "6.0" -\&\s-1FL+FR+FC+BC+SL+SR\s0 -.IP "\fB6.0(front)\fR" 4 -.IX Item "6.0(front)" -\&\s-1FL+FR+FLC+FRC+SL+SR\s0 -.IP "\fBhexagonal\fR" 4 -.IX Item "hexagonal" -\&\s-1FL+FR+FC+BL+BR+BC\s0 -.IP "\fB6.1\fR" 4 -.IX Item "6.1" -\&\s-1FL+FR+FC+LFE+BC+SL+SR\s0 -.IP "\fB6.1\fR" 4 -.IX Item "6.1" -\&\s-1FL+FR+FC+LFE+BL+BR+BC\s0 -.IP "\fB6.1(front)\fR" 4 -.IX Item "6.1(front)" -\&\s-1FL+FR+LFE+FLC+FRC+SL+SR\s0 -.IP "\fB7.0\fR" 4 -.IX Item "7.0" -\&\s-1FL+FR+FC+BL+BR+SL+SR\s0 -.IP "\fB7.0(front)\fR" 4 -.IX Item "7.0(front)" -\&\s-1FL+FR+FC+FLC+FRC+SL+SR\s0 -.IP "\fB7.1\fR" 4 -.IX Item "7.1" -\&\s-1FL+FR+FC+LFE+BL+BR+SL+SR\s0 -.IP "\fB7.1(wide)\fR" 4 -.IX Item "7.1(wide)" -\&\s-1FL+FR+FC+LFE+BL+BR+FLC+FRC\s0 -.IP "\fB7.1(wide\-side)\fR" 4 -.IX Item "7.1(wide-side)" -\&\s-1FL+FR+FC+LFE+FLC+FRC+SL+SR\s0 -.IP "\fBoctagonal\fR" 4 -.IX Item "octagonal" -\&\s-1FL+FR+FC+BL+BR+BC+SL+SR\s0 -.IP "\fBdownmix\fR" 4 -.IX Item "downmix" -\&\s-1DL+DR\s0 -.PP -A custom channel layout can be specified as a sequence of terms, separated by -\&'+' or '|'. Each term can be: -.IP "\(bu" 4 -the name of a standard channel layout (e.g. \fBmono\fR, -\&\fBstereo\fR, \fB4.0\fR, \fBquad\fR, \fB5.0\fR, etc.) -.IP "\(bu" 4 -the name of a single channel (e.g. \fB\s-1FL\s0\fR, \fB\s-1FR\s0\fR, \fB\s-1FC\s0\fR, \fB\s-1LFE\s0\fR, etc.) -.IP "\(bu" 4 -a number of channels, in decimal, optionally followed by 'c', yielding -the default channel layout for that number of channels (see the -function \f(CW\*(C`av_get_default_channel_layout\*(C'\fR) -.IP "\(bu" 4 -a channel layout mask, in hexadecimal starting with \*(L"0x\*(R" (see the -\&\f(CW\*(C`AV_CH_*\*(C'\fR macros in \fIlibavutil/channel_layout.h\fR. -.PP -Starting from libavutil version 53 the trailing character \*(L"c\*(R" to -specify a number of channels will be required, while a channel layout -mask could also be specified as a decimal number (if and only if not -followed by \*(L"c\*(R"). -.PP -See also the function \f(CW\*(C`av_get_channel_layout\*(C'\fR defined in -\&\fIlibavutil/channel_layout.h\fR. -.SH "EXPRESSION EVALUATION" -.IX Header "EXPRESSION EVALUATION" -When evaluating an arithmetic expression, FFmpeg uses an internal -formula evaluator, implemented through the \fIlibavutil/eval.h\fR -interface. -.PP -An expression may contain unary, binary operators, constants, and -functions. -.PP -Two expressions \fIexpr1\fR and \fIexpr2\fR can be combined to form -another expression "\fIexpr1\fR;\fIexpr2\fR". -\&\fIexpr1\fR and \fIexpr2\fR are evaluated in turn, and the new -expression evaluates to the value of \fIexpr2\fR. -.PP -The following binary operators are available: \f(CW\*(C`+\*(C'\fR, \f(CW\*(C`\-\*(C'\fR, -\&\f(CW\*(C`*\*(C'\fR, \f(CW\*(C`/\*(C'\fR, \f(CW\*(C`^\*(C'\fR. -.PP -The following unary operators are available: \f(CW\*(C`+\*(C'\fR, \f(CW\*(C`\-\*(C'\fR. -.PP -The following functions are available: -.IP "\fBabs(x)\fR" 4 -.IX Item "abs(x)" -Compute absolute value of \fIx\fR. -.IP "\fBacos(x)\fR" 4 -.IX Item "acos(x)" -Compute arccosine of \fIx\fR. -.IP "\fBasin(x)\fR" 4 -.IX Item "asin(x)" -Compute arcsine of \fIx\fR. -.IP "\fBatan(x)\fR" 4 -.IX Item "atan(x)" -Compute arctangent of \fIx\fR. -.IP "\fBbetween(x, min, max)\fR" 4 -.IX Item "between(x, min, max)" -Return 1 if \fIx\fR is greater than or equal to \fImin\fR and lesser than or -equal to \fImax\fR, 0 otherwise. -.IP "\fBbitand(x, y)\fR" 4 -.IX Item "bitand(x, y)" -.PD 0 -.IP "\fBbitor(x, y)\fR" 4 -.IX Item "bitor(x, y)" -.PD -Compute bitwise and/or operation on \fIx\fR and \fIy\fR. -.Sp -The results of the evaluation of \fIx\fR and \fIy\fR are converted to -integers before executing the bitwise operation. -.Sp -Note that both the conversion to integer and the conversion back to -floating point can lose precision. Beware of unexpected results for -large numbers (usually 2^53 and larger). -.IP "\fBceil(expr)\fR" 4 -.IX Item "ceil(expr)" -Round the value of expression \fIexpr\fR upwards to the nearest -integer. For example, \*(L"ceil(1.5)\*(R" is \*(L"2.0\*(R". -.IP "\fBcos(x)\fR" 4 -.IX Item "cos(x)" -Compute cosine of \fIx\fR. -.IP "\fBcosh(x)\fR" 4 -.IX Item "cosh(x)" -Compute hyperbolic cosine of \fIx\fR. -.IP "\fBeq(x, y)\fR" 4 -.IX Item "eq(x, y)" -Return 1 if \fIx\fR and \fIy\fR are equivalent, 0 otherwise. -.IP "\fBexp(x)\fR" 4 -.IX Item "exp(x)" -Compute exponential of \fIx\fR (with base \f(CW\*(C`e\*(C'\fR, the Euler's number). -.IP "\fBfloor(expr)\fR" 4 -.IX Item "floor(expr)" -Round the value of expression \fIexpr\fR downwards to the nearest -integer. For example, \*(L"floor(\-1.5)\*(R" is \*(L"\-2.0\*(R". -.IP "\fBgauss(x)\fR" 4 -.IX Item "gauss(x)" -Compute Gauss function of \fIx\fR, corresponding to -\&\f(CW\*(C`exp(\-x*x/2) / sqrt(2*PI)\*(C'\fR. -.IP "\fBgcd(x, y)\fR" 4 -.IX Item "gcd(x, y)" -Return the greatest common divisor of \fIx\fR and \fIy\fR. If both \fIx\fR and -\&\fIy\fR are 0 or either or both are less than zero then behavior is undefined. -.IP "\fBgt(x, y)\fR" 4 -.IX Item "gt(x, y)" -Return 1 if \fIx\fR is greater than \fIy\fR, 0 otherwise. -.IP "\fBgte(x, y)\fR" 4 -.IX Item "gte(x, y)" -Return 1 if \fIx\fR is greater than or equal to \fIy\fR, 0 otherwise. -.IP "\fBhypot(x, y)\fR" 4 -.IX Item "hypot(x, y)" -This function is similar to the C function with the same name; it returns -"sqrt(\fIx\fR*\fIx\fR + \fIy\fR*\fIy\fR)", the length of the hypotenuse of a -right triangle with sides of length \fIx\fR and \fIy\fR, or the distance of the -point (\fIx\fR, \fIy\fR) from the origin. -.IP "\fBif(x, y)\fR" 4 -.IX Item "if(x, y)" -Evaluate \fIx\fR, and if the result is non-zero return the result of -the evaluation of \fIy\fR, return 0 otherwise. -.IP "\fBif(x, y, z)\fR" 4 -.IX Item "if(x, y, z)" -Evaluate \fIx\fR, and if the result is non-zero return the evaluation -result of \fIy\fR, otherwise the evaluation result of \fIz\fR. -.IP "\fBifnot(x, y)\fR" 4 -.IX Item "ifnot(x, y)" -Evaluate \fIx\fR, and if the result is zero return the result of the -evaluation of \fIy\fR, return 0 otherwise. -.IP "\fBifnot(x, y, z)\fR" 4 -.IX Item "ifnot(x, y, z)" -Evaluate \fIx\fR, and if the result is zero return the evaluation -result of \fIy\fR, otherwise the evaluation result of \fIz\fR. -.IP "\fBisinf(x)\fR" 4 -.IX Item "isinf(x)" -Return 1.0 if \fIx\fR is +/\-INFINITY, 0.0 otherwise. -.IP "\fBisnan(x)\fR" 4 -.IX Item "isnan(x)" -Return 1.0 if \fIx\fR is \s-1NAN\s0, 0.0 otherwise. -.IP "\fBld(var)\fR" 4 -.IX Item "ld(var)" -Allow to load the value of the internal variable with number -\&\fIvar\fR, which was previously stored with st(\fIvar\fR, \fIexpr\fR). -The function returns the loaded value. -.IP "\fBlog(x)\fR" 4 -.IX Item "log(x)" -Compute natural logarithm of \fIx\fR. -.IP "\fBlt(x, y)\fR" 4 -.IX Item "lt(x, y)" -Return 1 if \fIx\fR is lesser than \fIy\fR, 0 otherwise. -.IP "\fBlte(x, y)\fR" 4 -.IX Item "lte(x, y)" -Return 1 if \fIx\fR is lesser than or equal to \fIy\fR, 0 otherwise. -.IP "\fBmax(x, y)\fR" 4 -.IX Item "max(x, y)" -Return the maximum between \fIx\fR and \fIy\fR. -.IP "\fBmin(x, y)\fR" 4 -.IX Item "min(x, y)" -Return the maximum between \fIx\fR and \fIy\fR. -.IP "\fBmod(x, y)\fR" 4 -.IX Item "mod(x, y)" -Compute the remainder of division of \fIx\fR by \fIy\fR. -.IP "\fBnot(expr)\fR" 4 -.IX Item "not(expr)" -Return 1.0 if \fIexpr\fR is zero, 0.0 otherwise. -.IP "\fBpow(x, y)\fR" 4 -.IX Item "pow(x, y)" -Compute the power of \fIx\fR elevated \fIy\fR, it is equivalent to -"(\fIx\fR)^(\fIy\fR)". -.IP "\fBprint(t)\fR" 4 -.IX Item "print(t)" -.PD 0 -.IP "\fBprint(t, l)\fR" 4 -.IX Item "print(t, l)" -.PD -Print the value of expression \fIt\fR with loglevel \fIl\fR. If -\&\fIl\fR is not specified then a default log level is used. -Returns the value of the expression printed. -.Sp -Prints t with loglevel l -.IP "\fBrandom(x)\fR" 4 -.IX Item "random(x)" -Return a pseudo random value between 0.0 and 1.0. \fIx\fR is the index of the -internal variable which will be used to save the seed/state. -.IP "\fBroot(expr, max)\fR" 4 -.IX Item "root(expr, max)" -Find an input value for which the function represented by \fIexpr\fR -with argument \fI\fIld\fI\|(0)\fR is 0 in the interval 0..\fImax\fR. -.Sp -The expression in \fIexpr\fR must denote a continuous function or the -result is undefined. -.Sp -\&\fI\fIld\fI\|(0)\fR is used to represent the function input value, which means -that the given expression will be evaluated multiple times with -various input values that the expression can access through -\&\f(CWld(0)\fR. When the expression evaluates to 0 then the -corresponding input value will be returned. -.IP "\fBsin(x)\fR" 4 -.IX Item "sin(x)" -Compute sine of \fIx\fR. -.IP "\fBsinh(x)\fR" 4 -.IX Item "sinh(x)" -Compute hyperbolic sine of \fIx\fR. -.IP "\fBsqrt(expr)\fR" 4 -.IX Item "sqrt(expr)" -Compute the square root of \fIexpr\fR. This is equivalent to -"(\fIexpr\fR)^.5". -.IP "\fBsquish(x)\fR" 4 -.IX Item "squish(x)" -Compute expression \f(CW\*(C`1/(1 + exp(4*x))\*(C'\fR. -.IP "\fBst(var, expr)\fR" 4 -.IX Item "st(var, expr)" -Allow to store the value of the expression \fIexpr\fR in an internal -variable. \fIvar\fR specifies the number of the variable where to -store the value, and it is a value ranging from 0 to 9. The function -returns the value stored in the internal variable. -Note, Variables are currently not shared between expressions. -.IP "\fBtan(x)\fR" 4 -.IX Item "tan(x)" -Compute tangent of \fIx\fR. -.IP "\fBtanh(x)\fR" 4 -.IX Item "tanh(x)" -Compute hyperbolic tangent of \fIx\fR. -.IP "\fBtaylor(expr, x)\fR" 4 -.IX Item "taylor(expr, x)" -.PD 0 -.IP "\fBtaylor(expr, x, id)\fR" 4 -.IX Item "taylor(expr, x, id)" -.PD -Evaluate a Taylor series at \fIx\fR, given an expression representing -the \f(CW\*(C`ld(id)\*(C'\fR\-th derivative of a function at 0. -.Sp -When the series does not converge the result is undefined. -.Sp -\&\fIld(id)\fR is used to represent the derivative order in \fIexpr\fR, -which means that the given expression will be evaluated multiple times -with various input values that the expression can access through -\&\f(CW\*(C`ld(id)\*(C'\fR. If \fIid\fR is not specified then 0 is assumed. -.Sp -Note, when you have the derivatives at y instead of 0, -\&\f(CW\*(C`taylor(expr, x\-y)\*(C'\fR can be used. -.IP "\fB\f(BItime\fB\|(0)\fR" 4 -.IX Item "time" -Return the current (wallclock) time in seconds. -.IP "\fBtrunc(expr)\fR" 4 -.IX Item "trunc(expr)" -Round the value of expression \fIexpr\fR towards zero to the nearest -integer. For example, \*(L"trunc(\-1.5)\*(R" is \*(L"\-1.0\*(R". -.IP "\fBwhile(cond, expr)\fR" 4 -.IX Item "while(cond, expr)" -Evaluate expression \fIexpr\fR while the expression \fIcond\fR is -non\-zero, and returns the value of the last \fIexpr\fR evaluation, or -\&\s-1NAN\s0 if \fIcond\fR was always false. -.PP -The following constants are available: -.IP "\fB\s-1PI\s0\fR" 4 -.IX Item "PI" -area of the unit disc, approximately 3.14 -.IP "\fBE\fR" 4 -.IX Item "E" -\&\fIexp\fR\|(1) (Euler's number), approximately 2.718 -.IP "\fB\s-1PHI\s0\fR" 4 -.IX Item "PHI" -golden ratio (1+\fIsqrt\fR\|(5))/2, approximately 1.618 -.PP -Assuming that an expression is considered \*(L"true\*(R" if it has a non-zero -value, note that: -.PP -\&\f(CW\*(C`*\*(C'\fR works like \s-1AND\s0 -.PP -\&\f(CW\*(C`+\*(C'\fR works like \s-1OR\s0 -.PP -For example the construct: -.PP -.Vb 1 -\& if (A AND B) then C -.Ve -.PP -is equivalent to: -.PP -.Vb 1 -\& if(A*B, C) -.Ve -.PP -In your C code, you can extend the list of unary and binary functions, -and define recognized constants, so that they are available for your -expressions. -.PP -The evaluator also recognizes the International System unit prefixes. -If 'i' is appended after the prefix, binary prefixes are used, which -are based on powers of 1024 instead of powers of 1000. -The 'B' postfix multiplies the value by 8, and can be appended after a -unit prefix or used alone. This allows using for example '\s-1KB\s0', 'MiB', -\&'G' and 'B' as number postfix. -.PP -The list of available International System prefixes follows, with -indication of the corresponding powers of 10 and of 2. -.IP "\fBy\fR" 4 -.IX Item "y" -10^\-24 / 2^\-80 -.IP "\fBz\fR" 4 -.IX Item "z" -10^\-21 / 2^\-70 -.IP "\fBa\fR" 4 -.IX Item "a" -10^\-18 / 2^\-60 -.IP "\fBf\fR" 4 -.IX Item "f" -10^\-15 / 2^\-50 -.IP "\fBp\fR" 4 -.IX Item "p" -10^\-12 / 2^\-40 -.IP "\fBn\fR" 4 -.IX Item "n" -10^\-9 / 2^\-30 -.IP "\fBu\fR" 4 -.IX Item "u" -10^\-6 / 2^\-20 -.IP "\fBm\fR" 4 -.IX Item "m" -10^\-3 / 2^\-10 -.IP "\fBc\fR" 4 -.IX Item "c" -10^\-2 -.IP "\fBd\fR" 4 -.IX Item "d" -10^\-1 -.IP "\fBh\fR" 4 -.IX Item "h" -10^2 -.IP "\fBk\fR" 4 -.IX Item "k" -10^3 / 2^10 -.IP "\fBK\fR" 4 -.IX Item "K" -10^3 / 2^10 -.IP "\fBM\fR" 4 -.IX Item "M" -10^6 / 2^20 -.IP "\fBG\fR" 4 -.IX Item "G" -10^9 / 2^30 -.IP "\fBT\fR" 4 -.IX Item "T" -10^12 / 2^40 -.IP "\fBP\fR" 4 -.IX Item "P" -10^15 / 2^40 -.IP "\fBE\fR" 4 -.IX Item "E" -10^18 / 2^50 -.IP "\fBZ\fR" 4 -.IX Item "Z" -10^21 / 2^60 -.IP "\fBY\fR" 4 -.IX Item "Y" -10^24 / 2^70 -.SH "OPENCL OPTIONS" -.IX Header "OPENCL OPTIONS" -When FFmpeg is configured with \f(CW\*(C`\-\-enable\-opencl\*(C'\fR, it is possible -to set the options for the global OpenCL context. -.PP -The list of supported options follows: -.IP "\fBbuild_options\fR" 4 -.IX Item "build_options" -Set build options used to compile the registered kernels. -.Sp -See reference \*(L"OpenCL Specification Version: 1.2 chapter 5.6.4\*(R". -.IP "\fBplatform_idx\fR" 4 -.IX Item "platform_idx" -Select the index of the platform to run OpenCL code. -.Sp -The specified index must be one of the indexes in the device list -which can be obtained with \f(CW\*(C`av_opencl_get_device_list()\*(C'\fR. -.IP "\fBdevice_idx\fR" 4 -.IX Item "device_idx" -Select the index of the device used to run OpenCL code. -.Sp -The specifed index must be one of the indexes in the device list which -can be obtained with \f(CW\*(C`av_opencl_get_device_list()\*(C'\fR. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), \fIlibavutil\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/libavcodec.3 b/contrib/sdk/sources/ffmpeg/doc/libavcodec.3 deleted file mode 100644 index fe7fb24e7d..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/libavcodec.3 +++ /dev/null @@ -1,159 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "doc::libavcodec 3" -.TH doc::libavcodec 3 "2013-12-14" " " " " -.SH "NAME" -libavcodec \- media streams decoding and encoding library -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The libavcodec library provides a generic encoding/decoding framework -and contains multiple decoders and encoders for audio, video and -subtitle streams, and several bitstream filters. -.PP -The shared architecture provides various services ranging from bit -stream I/O to \s-1DSP\s0 optimizations, and makes it suitable for -implementing robust and fast codecs as well as for experimentation. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), -\&\fIffmpeg\-codecs\fR\|(1), \fIffmpeg\-bitstream\-filters\fR\|(1), -\&\fIlibavutil\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/libavdevice.3 b/contrib/sdk/sources/ffmpeg/doc/libavdevice.3 deleted file mode 100644 index 20797a7c15..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/libavdevice.3 +++ /dev/null @@ -1,156 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "doc::libavdevice 3" -.TH doc::libavdevice 3 "2013-12-14" " " " " -.SH "NAME" -libavdevice \- multimedia device handling library -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The libavdevice library provides a generic framework for grabbing from -and rendering to many common multimedia input/output devices, and -supports several input and output devices, including Video4Linux2, -VfW, DShow, and \s-1ALSA\s0. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), -\&\fIffmpeg\-devices\fR\|(1), -\&\fIlibavutil\fR\|(3), \fIlibavcodec\fR\|(3), \fIlibavformat\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/libavformat.3 b/contrib/sdk/sources/ffmpeg/doc/libavformat.3 deleted file mode 100644 index 691d5b42ce..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/libavformat.3 +++ /dev/null @@ -1,159 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "doc::libavformat 3" -.TH doc::libavformat 3 "2013-12-14" " " " " -.SH "NAME" -libavformat \- multimedia muxing and demuxing library -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The libavformat library provides a generic framework for multiplexing -and demultiplexing (muxing and demuxing) audio, video and subtitle -streams. It encompasses multiple muxers and demuxers for multimedia -container formats. -.PP -It also supports several input and output protocols to access a media -resource. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), -\&\fIffmpeg\-formats\fR\|(1), \fIffmpeg\-protocols\fR\|(1), -\&\fIlibavutil\fR\|(3), \fIlibavcodec\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/libavutil.3 b/contrib/sdk/sources/ffmpeg/doc/libavutil.3 deleted file mode 100644 index e990fab5fe..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/libavutil.3 +++ /dev/null @@ -1,156 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "doc::libavutil 3" -.TH doc::libavutil 3 "2013-12-14" " " " " -.SH "NAME" -libavutil \- multimedia\-biased utility library -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The libavutil library is a utility library to aid portable -multimedia programming. It contains safe portable string functions, -random number generators, data structures, additional mathematics -functions, cryptography and multimedia related functionality (like -enumerations for pixel and sample formats). -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), -\&\fIffmpeg\-utils\fR\|(1) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/libswresample.3 b/contrib/sdk/sources/ffmpeg/doc/libswresample.3 deleted file mode 100644 index 58fb0288b0..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/libswresample.3 +++ /dev/null @@ -1,176 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "doc::libswresample 3" -.TH doc::libswresample 3 "2013-12-14" " " " " -.SH "NAME" -libswresample \- audio resampling library -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The libswresample library performs highly optimized audio resampling, -rematrixing and sample format conversion operations. -.PP -Specifically, this library performs the following conversions: -.IP "\(bu" 4 -\&\fIResampling\fR: is the process of changing the audio rate, for -example from a high sample rate of 44100Hz to 8000Hz. Audio -conversion from high to low sample rate is a lossy process. Several -resampling options and algorithms are available. -.IP "\(bu" 4 -\&\fIFormat conversion\fR: is the process of converting the type of -samples, for example from 16\-bit signed samples to unsigned 8\-bit or -float samples. It also handles packing conversion, when passing from -packed layout (all samples belonging to distinct channels interleaved -in the same buffer), to planar layout (all samples belonging to the -same channel stored in a dedicated buffer or \*(L"plane\*(R"). -.IP "\(bu" 4 -\&\fIRematrixing\fR: is the process of changing the channel layout, for -example from stereo to mono. When the input channels cannot be mapped -to the output streams, the process is lossy, since it involves -different gain factors and mixing. -.PP -Various other audio conversions (e.g. stretching and padding) are -enabled through dedicated options. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), -\&\fIffmpeg\-resampler\fR\|(1), -\&\fIlibavutil\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree. diff --git a/contrib/sdk/sources/ffmpeg/doc/libswscale.3 b/contrib/sdk/sources/ffmpeg/doc/libswscale.3 deleted file mode 100644 index c4b779ed0f..0000000000 --- a/contrib/sdk/sources/ffmpeg/doc/libswscale.3 +++ /dev/null @@ -1,170 +0,0 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 -.\" -.\" Standard preamble: -.\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.ft R -.fi -.. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" -. ds C` "" -. ds C' "" -'br\} -.el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index -.\" entries marked with X<> in POD. Of course, you'll have to process the -.\" output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C -.\" ======================================================================== -.\" -.IX Title "doc::libswscale 3" -.TH doc::libswscale 3 "2013-12-14" " " " " -.SH "NAME" -libswscale \- video scaling and pixel format conversion library -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -The libswscale library performs highly optimized image scaling and -colorspace and pixel format conversion operations. -.PP -Specifically, this library performs the following conversions: -.IP "\(bu" 4 -\&\fIRescaling\fR: is the process of changing the video size. Several -rescaling options and algorithms are available. This is usually a -lossy process. -.IP "\(bu" 4 -\&\fIPixel format conversion\fR: is the process of converting the image -format and colorspace of the image, for example from planar \s-1YUV420P\s0 to -\&\s-1RGB24\s0 packed. It also handles packing conversion, that is converts -from packed layout (all pixels belonging to distinct planes -interleaved in the same buffer), to planar layout (all samples -belonging to the same plane stored in a dedicated buffer or \*(L"plane\*(R"). -.Sp -This is usually a lossy process in case the source and destination -colorspaces differ. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIffmpeg\fR\|(1), \fIffplay\fR\|(1), \fIffprobe\fR\|(1), \fIffserver\fR\|(1), -\&\fIffmpeg\-scaler\fR\|(1), -\&\fIlibavutil\fR\|(3) -.SH "AUTHORS" -.IX Header "AUTHORS" -The FFmpeg developers. -.PP -For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -\&\fBgit log\fR in the FFmpeg source directory, or browsing the -online repository at <\fBhttp://source.ffmpeg.org\fR>. -.PP -Maintainers for the specific components are listed in the file -\&\fI\s-1MAINTAINERS\s0\fR in the source code tree.