[01062dd] | 1 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
|
---|
| 2 | "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 3 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 4 | %general-entities;
|
---|
[560e14cf] | 5 |
|
---|
[01062dd] | 6 | <!ENTITY ffmpeg-download-http "http://prdownloads.sourceforge.net/ffmpeg/ffmpeg-&ffmpeg-version;.tar.gz">
|
---|
| 7 | <!ENTITY ffmpeg-download-ftp " ">
|
---|
| 8 | <!ENTITY ffmpeg-size "1.3 MB">
|
---|
| 9 | <!ENTITY ffmpeg-buildsize "31 MB">
|
---|
| 10 | <!ENTITY ffmpeg-time "0.89 SBU">
|
---|
| 11 | ]>
|
---|
| 12 |
|
---|
[d374b41] | 13 | <sect1 id="ffmpeg" xreflabel="FFmpeg-&ffmpeg-version;">
|
---|
[a0f03b0] | 14 | <sect1info>
|
---|
[5cd0959d] | 15 | <othername>$LastChangedBy$</othername>
|
---|
| 16 | <date>$Date$</date>
|
---|
[a0f03b0] | 17 | </sect1info>
|
---|
[dd3f20f0] | 18 | <?dbhtml filename="ffmpeg.html"?>
|
---|
[d374b41] | 19 | <title>FFmpeg-&ffmpeg-version;</title>
|
---|
[49e5372] | 20 |
|
---|
[01062dd] | 21 | <sect2>
|
---|
| 22 | <title>Introduction to <application>FFmpeg</application></title>
|
---|
| 23 |
|
---|
[560e14cf] | 24 | <para><application>FFmpeg</application> is a solution to record, convert and
|
---|
| 25 | stream audio and video. Due to heavy development, not all of these functions
|
---|
| 26 | will work.</para>
|
---|
[01062dd] | 27 |
|
---|
| 28 | <sect3><title>Package information</title>
|
---|
| 29 | <itemizedlist spacing='compact'>
|
---|
| 30 | <listitem><para>Download (HTTP): <ulink url="&ffmpeg-download-http;"/></para></listitem>
|
---|
| 31 | <listitem><para>Download (FTP): <ulink url="&ffmpeg-download-ftp;"/></para></listitem>
|
---|
| 32 | <listitem><para>Download size: &ffmpeg-size;</para></listitem>
|
---|
| 33 | <listitem><para>Estimated Disk space required: &ffmpeg-buildsize;</para></listitem>
|
---|
| 34 | <listitem><para>Estimated build time: &ffmpeg-time;</para></listitem></itemizedlist>
|
---|
| 35 | </sect3>
|
---|
| 36 |
|
---|
[560e14cf] | 37 | <sect3><title>Additional downloads</title>
|
---|
| 38 | <itemizedlist spacing='compact'>
|
---|
| 39 | <listitem><para>Required Patch: <ulink
|
---|
| 40 | url="&patch-root;/ffmpeg-&ffmpeg-version;-gcc34-1.patch"/></para>
|
---|
| 41 | </listitem></itemizedlist>
|
---|
| 42 | </sect3>
|
---|
| 43 |
|
---|
[01062dd] | 44 | <sect3><title><application>FFmpeg</application> dependencies</title>
|
---|
| 45 | <sect4><title>Optional</title>
|
---|
[560e14cf] | 46 | <para><xref linkend="libvorbis"/>, <xref linkend="lame"/>,
|
---|
| 47 | <xref linkend="liba52"/>, <xref linkend="imlib2"/>,
|
---|
| 48 | X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
|
---|
| 49 | <xref linkend="SDL"/>, <xref linkend="freetype2"/>,
|
---|
| 50 | <ulink url="http://www.audiocoding.com/modules/mydownloads/">FAAC</ulink> and
|
---|
| 51 | <ulink url="http://www.audiocoding.com/modules/mydownloads/">FAAD</ulink></para>
|
---|
| 52 | </sect4>
|
---|
[01062dd] | 53 | </sect3>
|
---|
| 54 |
|
---|
| 55 | </sect2>
|
---|
| 56 |
|
---|
| 57 | <sect2>
|
---|
| 58 | <title>Installation of <application>FFmpeg</application></title>
|
---|
| 59 |
|
---|
| 60 | <para>Install <application>FFmpeg</application> by running the following
|
---|
| 61 | commands:</para>
|
---|
| 62 |
|
---|
| 63 | <note><para>The package maintainers recommend compiling without any
|
---|
| 64 | optimizations.</para></note>
|
---|
| 65 |
|
---|
[560e14cf] | 66 | <screen><userinput><command>patch -Np1 -i ../ffmpeg-&ffmpeg-version;-gcc34-1.patch &&
|
---|
| 67 | ./configure --prefix=/usr --enable-shared &&
|
---|
[01062dd] | 68 | make &&
|
---|
| 69 | make install</command></userinput></screen>
|
---|
| 70 |
|
---|
| 71 | </sect2>
|
---|
| 72 |
|
---|
| 73 | <sect2>
|
---|
| 74 | <title>Command explanations</title>
|
---|
| 75 |
|
---|
[560e14cf] | 76 | <para><parameter>--enable-shared</parameter>: This switch is needed to
|
---|
| 77 | build the <filename class="libraryfile">libavcodec</filename> and
|
---|
| 78 | <filename class="libraryfile">libavformat</filename> shared
|
---|
| 79 | libraries.</para>
|
---|
[01062dd] | 80 |
|
---|
| 81 | <para><option>--enable-mp3lame</option>: Link against
|
---|
| 82 | <filename class="libraryfile">libmp3lame</filename>.</para>
|
---|
| 83 |
|
---|
| 84 | <para><option>--enable-vorbis</option>: Link against
|
---|
| 85 | <filename class="libraryfile">libvorbis</filename>.</para>
|
---|
| 86 |
|
---|
| 87 | <para><option>--disable-ffplay</option>: Only installs the server part.
|
---|
[560e14cf] | 88 | <command>ffplay</command> requires <application>X</application> for
|
---|
| 89 | building.</para>
|
---|
| 90 |
|
---|
| 91 | <note><para>Linking the <application>liba52</application> library using the
|
---|
| 92 | <option>--enable-a52</option> parameter to <command>configure</command> is
|
---|
| 93 | known to break the build.</para></note>
|
---|
[01062dd] | 94 |
|
---|
| 95 | </sect2>
|
---|
| 96 |
|
---|
| 97 | <sect2>
|
---|
| 98 | <title>Configuring <application>FFmpeg</application></title>
|
---|
| 99 |
|
---|
| 100 | <sect3><title>Config files</title>
|
---|
| 101 |
|
---|
| 102 | <para><filename>~/.ffmpeg/ffserver-config</filename></para>
|
---|
| 103 |
|
---|
| 104 | <para>You'll find a sample ffserver configuration file at
|
---|
| 105 | <ulink url="http://ffmpeg.sourceforge.net/sample.html"/></para>
|
---|
| 106 |
|
---|
| 107 | </sect3>
|
---|
| 108 |
|
---|
| 109 | </sect2>
|
---|
| 110 |
|
---|
| 111 | <sect2>
|
---|
| 112 | <title>Contents</title>
|
---|
| 113 |
|
---|
[560e14cf] | 114 | <para>The <application>FFmpeg</application> package contains
|
---|
| 115 | <command>ffmpeg</command>, <command>ffserver</command>,
|
---|
| 116 | <command>ffplay</command>,
|
---|
[01062dd] | 117 | <filename class="libraryfile">libavcodec</filename> and
|
---|
| 118 | <filename class="libraryfile">libavformat</filename>.</para>
|
---|
| 119 |
|
---|
| 120 | </sect2>
|
---|
| 121 |
|
---|
| 122 | <sect2><title>Description</title>
|
---|
| 123 |
|
---|
| 124 | <sect3><title>ffmpeg</title>
|
---|
| 125 | <para><command>ffmpeg</command> is a command-line tool to convert video files,
|
---|
[560e14cf] | 126 | network streams and input from a TV card to several video formats.</para>
|
---|
| 127 | </sect3>
|
---|
[01062dd] | 128 |
|
---|
| 129 | <sect3><title>ffserver</title>
|
---|
| 130 | <para><command>ffserver</command> is a streaming server for everything
|
---|
| 131 | that <command>ffmpeg</command> could use as input (files, streams, TV card
|
---|
| 132 | input, webcam, etc.).</para></sect3>
|
---|
| 133 |
|
---|
| 134 | <sect3><title>ffplay</title>
|
---|
| 135 | <para><command>ffplay</command> is a very simple and portable media
|
---|
[560e14cf] | 136 | player using the <filename>ffmpeg</filename> libraries and the
|
---|
| 137 | <acronym>SDL</acronym> library.</para></sect3>
|
---|
[01062dd] | 138 |
|
---|
| 139 | <sect3><title>libavcodec/libavformat</title>
|
---|
[560e14cf] | 140 | <para><filename class="libraryfile">libavcodec</filename> and
|
---|
| 141 | <filename class="libraryfile">libavformats</filename> are libraries for
|
---|
| 142 | encoding/decoding video streams and putting them into files or network
|
---|
| 143 | packets. Since they're well documented, you can easily include them in your
|
---|
| 144 | software, like some other packages already do.</para></sect3>
|
---|
[01062dd] | 145 |
|
---|
| 146 | </sect2>
|
---|
[49e5372] | 147 |
|
---|
| 148 | </sect1>
|
---|
| 149 |
|
---|