Ignore:
Timestamp:
02/01/2016 12:21:29 AM (8 years ago)
Author:
DJ Lucas <dj@…>
Branches:
systemd-13485
Children:
d6e4445
Parents:
3144280
Message:

Completed Section VII Merge from trunk.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16891 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • multimedia/videoutils/ffmpeg.xml

    r3144280 r12fbef3  
    55  %general-entities;
    66
    7   <!ENTITY ffmpeg-download-http "http://ffmpeg.org/releases/ffmpeg-&ffmpeg-version;.tar.bz2">
     7  <!ENTITY ffmpeg-download-http "http://ffmpeg.org/releases/ffmpeg-&ffmpeg-version;.tar.xz">
    88  <!ENTITY ffmpeg-download-ftp  " ">
    9   <!ENTITY ffmpeg-md5sum        "f159c6d7eed8546b23e1a17325cbf1f8">
    10   <!ENTITY ffmpeg-size          "7.8 MB">
    11   <!ENTITY ffmpeg-buildsize     "135 MB (additional 1.0 GB to build and install Doxygen, PDF and Postscript documentation)">
    12   <!ENTITY ffmpeg-time          "3.7 SBU">
     9  <!ENTITY ffmpeg-md5sum        "b34164bd181f4f81c21da3dd131d919d">
     10  <!ENTITY ffmpeg-size          "6.9 MB">
     11  <!ENTITY ffmpeg-buildsize     "156 MB (additional 2450 MB for the FATE suite)">
     12  <!ENTITY ffmpeg-time          "1.2 SBU, with -j4 (additional 3.1 SBU, with THREADS=4,
     13    to run the FATE suite, after sample files are downloaded)">
    1314]>
    1415
    … …  
    4243    </para>
    4344
    44     &lfs77_checked;
     45    &lfs78_checked;
    4546
    4647    <bridgehead renderas="sect3">Package Information</bridgehead>
    … …  
    8283    <bridgehead renderas="sect4">Recommended</bridgehead>
    8384    <para role="recommended">
     85      <xref linkend="libass"/>,
    8486      <xref linkend="fdk-aac"/>,
    8587      <xref linkend="freetype2"/>,
    8688      <xref linkend="lame"/>,
    87       <xref linkend="libass"/>,
    8889      <xref linkend="libtheora"/>,
    8990      <xref linkend="libvorbis"/>,
    9091      <xref linkend="libvpx"/>,
    9192      <xref linkend="opus"/>,
    92       <xref linkend="x264"/>, and
     93      <xref linkend="x264"/>,
     94      <xref linkend="x265"/>, and
    9395      <xref linkend="yasm"/>
    9496    </para>
    … …  
    9799    <para>
    98100      <xref linkend="alsa-lib"/>,
    99       <xref linkend="libva"/> (with the corresponding driver package),
     101      <xref linkend="libva"/>,
    100102      <xref linkend="libvdpau"/> (with the corresponding driver package), and
    101103      <xref linkend="sdl"/>
    … …  
    105107    <para role="optional">
    106108      <xref linkend="faac"/>,
    107       <xref linkend="fribidi"/>,
    108109      <xref linkend="fontconfig"/>,
     110      <xref linkend="frei0r"/>,
    109111      <xref linkend="libcdio"/> (to identify and play CDs),
    110112      <xref linkend="libwebp"/>,
     113      <xref linkend="opencv"/>,
    111114      <xref linkend="openjpeg"/>,
    112115      <xref linkend="openssl"/> or
    113116      <xref linkend="gnutls"/>,
    114117      <xref linkend="pulseaudio"/>,
    115       <xref linkend="samba"/>,
    116118      <xref linkend="speex"/>,
    117       <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>) for PDF and PS documentation,
     119      <xref linkend="texlive"/>
     120         (or <xref linkend="tl-installer"/>) for PDF and PS documentation,
    118121      <xref linkend="v4l-utils"/>,
    119122      <xref linkend="xvid"/>,
    120123      <xref linkend="x-window-system"/>,
    121124      <ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
    122       <ulink url="https://files.dyne.org/frei0r/snapshots/">frei0r</ulink>,
    123125      <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
    124       <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
     126      <ulink url="http://xhevc.com/en/hevc/decoder/download.jsp">HEVC/H.265</ulink>,
     127      <!--<ulink url="http://www.ladspa.org/">LADSPA</ulink>,-->
    125128      <ulink url="http://tipok.org.ua/node/17">libaacplus</ulink>,
    126129      <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
    … …  
    135138      <ulink url="http://rtmpdump.mplayerhq.hu/">librtmp</ulink>,
    136139      <ulink url="http://www.libssh.org/">libssh</ulink>,
    137       <ulink url="http://xavs.sourceforge.net/">libxavs</ulink> (SVN checkout),
     140      <!--<ulink url="http://xavs.sourceforge.net/">libxavs</ulink> (SVN checkout),-->
    138141      <ulink url="http://kcat.strangesoft.net/openal-releases/">OpenAL</ulink>,
    139142      <ulink url="http://sourceforge.net/projects/opencore-amr">OpenCore AMR</ulink>,
    140       <ulink url="http://opencv.org/">OpenCV</ulink>,
    141       <ulink url="http://diracvideo.org/">Schroedinger</ulink>,
    142       <ulink url="http://www.nongnu.org/texi2html">texi2html</ulink> (to build HTML documentation),
     143      <!--<ulink url="http://diracvideo.org/">Schroedinger</ulink>,-->
     144      <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
    143145      <ulink url="http://www.twolame.org/">TwoLAME</ulink>,
    144       <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-aacenc">vo-aaenc</ulink>,
    145       <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-amrwbenc">vo-amrwbenc</ulink>,
    146       <ulink url="https://bitbucket.org/multicoreware/x265/">x265</ulink>, and
     146      <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-aacenc/">vo-aaenc</ulink>,
     147      <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-amrwbenc/">vo-amrwbenc</ulink>, and
     148      <!--<ulink url="http://www.videolan.org/developers/x265.html">x265 (H.265/MPEG-H HEVC)</ulink>, and-->
    147149      <ulink url="http://zapping.sourceforge.net/ZVBI/">ZVBI</ulink>
    148150    </para>
    … …  
    162164
    163165<screen><userinput>sed -i 's/-lflite"/-lflite -lasound"/' configure &amp;&amp;
     166
    164167./configure --prefix=/usr        \
    165168            --enable-gpl         \
    … …  
    178181            --enable-libvpx      \
    179182            --enable-libx264     \
     183            --enable-libx265     \
    180184            --enable-x11grab     \
    181185            --docdir=/usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
     186
    182187make &amp;&amp;
     188
    183189gcc tools/qt-faststart.c -o tools/qt-faststart</userinput></screen>
    184190
    185191    <para>
    186       If you have <xref linkend="texlive"/> installed and want to build
    187       PDF and Postscript documentation, issue the following commands:
    188     </para>
    189 
    190 <screen><userinput>pushd doc &amp;&amp;
    191 for DOCNAME in $(basename -s .html *.html)
     192      HTML documentation was built in the previous step. If  you have
     193      <xref linkend="texlive"/> installed and wish to build PDF and
     194      Postscript versions of the documentation, issue the following commands:
     195    </para>
     196
     197<screen><userinput>sed -i '$s/$/\n\n@bye/' doc/{git-howto,nut,fate}.texi             &amp;&amp;
     198sed -i '/machine:i386/ s/\\/@backslashchar{}/g' doc/platform.texi &amp;&amp;
     199
     200pushd doc &amp;&amp;
     201for DOCNAME in `basename -s .html *.html`
    192202do
    193203    texi2pdf -b $DOCNAME.texi &amp;&amp;
    194204    texi2dvi -b $DOCNAME.texi &amp;&amp;
    195     dvips -o    $DOCNAME.ps $DOCNAME.dvi
     205
     206    dvips    -o $DOCNAME.ps   \
     207                $DOCNAME.dvi
    196208done &amp;&amp;
    197209popd &amp;&amp;
    … …  
    199211
    200212    <para>
    201       If you have <xref linkend="doxygen"/> installed and want to build
    202       the API documentation, issue: <command>doxygen doc/Doxyfile</command>.
    203     </para>
    204 
    205     <para>
    206       To test the results, issue <command>make RUNNING_FATE= check</command>.
     213      If you have <xref linkend="doxygen"/> installed and wish to create the API
     214      documentation (takes about 350 MB of space), issue the command
     215      <command>doxygen doc/Doxyfile</command>.
     216    </para>
     217
     218    <para>
     219      The fate-suite tests include comparisons with installed files, and should
     220      not be run before the package is installed. Therefore, if you desire to
     221      run them, instructions are given further below.
    207222    </para>
    208223
    … …  
    212227
    213228<screen role="root"><userinput>make install &amp;&amp;
    214 install -v -m755 tools/qt-faststart /usr/bin &amp;&amp;
    215 install -v -m644 doc/*.txt /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
    216 
    217     <para>
    218       If the PDF and Postscript documentation was built, run the following
    219       commands as the <systemitem class="username">root</systemitem> user
    220       to install it:
    221     </para>
    222 
    223 <screen role="root"><userinput>install -v -m644 doc/*.pdf /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
    224 install -v -m644 doc/*.ps  /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
    225 
    226     <para>
    227       If you used <command>doxygen</command> to build the API documentation,
    228       you can install it by running the following commands
     229
     230install -v -m755    tools/qt-faststart /usr/bin &amp;&amp;
     231install -v -m644    doc/*.txt \
     232                    /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
     233
     234    <para>
     235      If PDF and Postscript documentations were built, issue the following
     236      commands, as the <systemitem class="username">root</systemitem> user, to
     237      install them:
     238    </para>
     239
     240<screen role="root"><userinput>install -v -m644 doc/*.pdf \
     241                 /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
     242install -v -m644 doc/*.ps  \
     243                 /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
     244
     245    <para>
     246      If you used <command>doxygen</command> to create the API documentation,
     247      install it (another 300 MB of space) by issuing the following commands
    229248      as the <systemitem class="username">root</systemitem> user:
    230249    </para>
    231250
    232 <screen role="root"><userinput>install -v -dm755 /usr/share/doc/ffmpeg-&ffmpeg-version;/api &amp;&amp;
    233 cp -rv doc/doxy/html/* /usr/share/doc/ffmpeg-&ffmpeg-version;/api</userinput></screen>
     251<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/ffmpeg-&ffmpeg-version;/api                     &amp;&amp;
     252cp -vr doc/doxy/html/* /usr/share/doc/ffmpeg-&ffmpeg-version;/api                  &amp;&amp;
     253find /usr/share/doc/ffmpeg-&ffmpeg-version;/api -type f -exec chmod -c 0644 \{} \; &amp;&amp;
     254find /usr/share/doc/ffmpeg-&ffmpeg-version;/api -type d -exec chmod -c 0755 \{} \;</userinput></screen>
     255
     256    <para>
     257      To properly test the installation you must have <xref linkend="rsync"/>
     258      installed and follow the instructions for the <ulink
     259      url="http://www.ffmpeg.org/fate.html"> FFmpeg Automated Testing
     260      Environment</ulink> (FATE). First, about 958 MB of sample files used to
     261      run FATE are downloaded with the command:
     262    </para>
     263
     264<screen><userinput>make fate-rsync SAMPLES=fate-suite/</userinput></screen>
     265
     266    <para>
     267      The <filename class="directory">fate-suite</filename> directory is
     268      created and the files are downloaded there. That command actually runs an
     269      rsync command, to obtain the sample files.  You may want to compress and
     270      keep this directory for testing again, in another system, or when a new
     271      version of ffmpeg is launched. Then, you unpack the sample files in the
     272      source directory, and run, again, the <command>make fate-rsync
     273      ...</command> command above, to sync with the repository. Now, the
     274      download size and time are drastically reduced.  Estimated values in
     275      "Package Information" do not include the download SBU. Some samples may
     276      have been removed, in the new version, so, in order to be sure local and
     277      server fate samples are identical, when you use previously saved samples,
     278      run the following command:
     279    </para>
     280
     281<screen><userinput><command>rsync -vrltLW  --delete --timeout=60 --contimeout=60 \
     282      rsync://fate-suite.ffmpeg.org/fate-suite/ fate-suite/</command></userinput></screen>
     283
     284    <para>
     285      Next, FATE is executed, with the commands (you obtain a number of tests
     286      larger than 2500):
     287    </para>
     288
     289<screen><userinput>make fate THREADS=<replaceable>N</replaceable> SAMPLES=fate-suite/ | tee ../fate.log &amp;&amp;
     290grep ^TEST ../fate.log | wc -l</userinput></screen>
     291
     292    <para>
     293      where <replaceable>N</replaceable> is an integer,
     294      <replaceable>N</replaceable> &le; number of threads in the system.
     295    </para>
    234296
    235297  </sect2>
    … …  
    246308
    247309    <para>
     310      <command>sed -i ... texi</command>: Fix some .texi files for
     311      documentation builds.
     312    </para>
     313
     314    <para>
     315      <command>find ... ;</command>: Fix permissions of documentation files
     316      and directories.
     317    </para>
     318
     319    <para>
    248320      <option>--enable-libfreetype</option>: Enables
    249321      <application>Freetype</application> support.
    … …  
    311383      H.264/MPEG-4 AVC encoding via <filename
    312384      class="libraryfile">libx264</filename>.
     385    </para>
     386
     387    <para>
     388      <parameter>--enable-libx265</parameter>: Enables high-quality
     389      H.265/HEVC encoding via <filename
     390      class="libraryfile">libx265</filename>.
    313391    </para>
    314392
    … …  
    382460      <seglistitem>
    383461        <seg>
    384           ffmpeg, ffplay, ffprobe, ffserver and
    385           qt-faststart
     462          ffmpeg, ffplay, ffprobe, ffserver, and qt-faststart
    386463        </seg>
    387464        <seg>
    388465          libavcodec.so, libavdevice.so, libavfilter.so,
    389466          libavformat.so, libavutil.so, libpostproc.so,
    390           libswresample and libswscale.so
     467          libswresample, and libswscale.so
    391468        </seg>
    392469        <seg>
    393           /usr/include/{libavcodec,libavdevice,libavfilter,libavformat},
    394           /usr/include/{libavutil,libpostproc,libswresample,libswscale},
    395           /usr/share/doc/ffmpeg-&ffmpeg-version; and
     470          /usr/include/lib{avcodec,avdevice,avfilter,avformat},
     471          /usr/include/lib{avutil,postproc,swresample,swscale},
     472          /usr/share/doc/ffmpeg-&ffmpeg-version;, and
    396473          /usr/share/ffmpeg
    397474        </seg>
Note: See TracChangeset for help on using the changeset viewer.