Ignore:
Timestamp:
03/09/2020 03:02:12 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
2aff70f
Parents:
22618785
Message:

Format multimedia chapter

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22821 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • multimedia/libdriv/faac.xml

    r22618785 r2eeb8695  
    3030    <title>Introduction to FAAC</title>
    3131
    32     <para><application>FAAC</application> is an encoder for a lossy sound
    33     compression scheme specified in MPEG-2 Part 7 and MPEG-4 Part 3 standards
    34     and known as Advanced Audio Coding (AAC). This encoder is useful for
    35     producing files that can be played back on iPod. Moreover, iPod does not
    36     understand other sound compression schemes in video files.</para>
     32    <para>
     33      <application>FAAC</application> is an encoder for a lossy sound
     34      compression scheme specified in MPEG-2 Part 7 and MPEG-4 Part 3 standards
     35      and known as Advanced Audio Coding (AAC). This encoder is useful for
     36      producing files that can be played back on iPod. Moreover, iPod does not
     37      understand other sound compression schemes in video files.
     38    </para>
    3739
    3840    &lfs91_checked;
    … …  
    4143    <itemizedlist spacing="compact">
    4244      <listitem>
    43         <para>Download (HTTP): <ulink url="&faac-download-http;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download (FTP): <ulink url="&faac-download-ftp;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download MD5 sum: &faac-md5sum;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Download size: &faac-size;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated disk space required: &faac-buildsize;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated build time: &faac-time;</para>
     45        <para>
     46          Download (HTTP): <ulink url="&faac-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&faac-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &faac-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &faac-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &faac-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &faac-time;
     72        </para>
    5973      </listitem>
    6074    </itemizedlist>
    … …  
    6882    <title>Installation of FAAC</title>
    6983
    70     <para>Install <application>FAAC</application> by running the
    71     following commands:</para>
     84    <para>
     85      Install <application>FAAC</application> by running the
     86      following commands:
     87    </para>
    7288
    7389<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
    7490make</userinput></screen>
    7591
    76     <para>This package does not come with a test suite. However, basic
    77     functionality can be tested by encoding a sample WAV file (the sample
    78     file is installed by the <xref linkend="alsa-utils"/> package:</para>
     92    <para>
     93      This package does not come with a test suite. However, basic
     94      functionality can be tested by encoding a sample WAV file (the sample
     95      file is installed by the <xref linkend="alsa-utils"/> package:
     96    </para>
    7997
    8098<screen remap="test"><userinput>./frontend/faac -o Front_Left.mp4 /usr/share/sounds/alsa/Front_Left.wav</userinput></screen>
    8199
    82     <para>Then, decode the result using the <command>faad</command> program
    83     from the <xref linkend="faad2"/> package and play back the decoded file
    84     (requires the <command>aplay</command> program from the
    85     <xref linkend="alsa-utils"/> package:</para>
     100    <para>
     101      Then, decode the result using the <command>faad</command> program
     102      from the <xref linkend="faad2"/> package and play back the decoded file
     103      (requires the <command>aplay</command> program from the
     104      <xref linkend="alsa-utils"/> package:
     105    </para>
    86106
    87107<screen remap="test"><userinput>faad Front_Left.mp4
    88108aplay Front_Left.wav</userinput></screen>
    89109
    90     <para><command>aplay</command> should identify the file as
    91     <quote>Signed 16 bit Little Endian, Rate 48000 Hz, Stereo</quote>, and you
    92     should hear the words <quote>front left</quote>.</para>
    93 
    94     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     110    <para>
     111      <command>aplay</command> should identify the file as
     112      <quote>Signed 16 bit Little Endian, Rate 48000 Hz, Stereo</quote>, and
     113      you should hear the words <quote>front left</quote>.
     114    </para>
     115
     116    <para>
     117      Now, as the <systemitem class="username">root</systemitem> user:
     118    </para>
    95119
    96120<screen role="root"><userinput>make install</userinput></screen>
    … …  
    106130    <!-- 1.28: This is still broken, it causes a segfault. -->
    107131    <!--
    108     <para><option>- -enable-drm</option>: This option is supposed to enable
    109     support for encoding files for
    110     <ulink url="http://www.drm.org/">Digital Radio Mondiale</ulink>, but
    111     actually breaks the base functionality of the package (e.g., the resulting
    112     <command>faac</command> program produces files that cannot be decoded
    113     by <xref linkend="faad2"/>, even if compiled with DRM support).
    114     Don't use it.</para>
     132    <para>
     133      <option>- -enable-drm</option>: This option is supposed to enable
     134      support for encoding files for
     135      <ulink url="http://www.drm.org/">Digital Radio Mondiale</ulink>, but
     136      actually breaks the base functionality of the package (e.g., the resulting
     137      <command>faac</command> program produces files that cannot be decoded
     138      by <xref linkend="faad2"/>, even if compiled with DRM support).
     139      Don't use it.
     140    </para>
    115141    -->
    116142    <!-- Since we say "Don't use it", let's not even list it. That would open up
    … …  
    121147    <title>Other AAC encoders</title>
    122148
    123     <para>The quality of <application>FAAC</application> is not up
    124     to par with the best AAC encoders currently available. Also, it only
    125     supports AAC and not High Efficiency AAC (also known as aacPlus), which
    126     provides better quality at low bitrates by means of using the
    127     <quote>spectral band replication</quote> technology. There are the
    128     following alternative programs for producing AAC and HE-AAC streams:</para>
     149    <para>
     150      The quality of <application>FAAC</application> is not up
     151      to par with the best AAC encoders currently available. Also, it only
     152      supports AAC and not High Efficiency AAC (also known as aacPlus), which
     153      provides better quality at low bitrates by means of using the
     154      <quote>spectral band replication</quote> technology. There are the
     155      following alternative programs for producing AAC and HE-AAC streams:
     156    </para>
    129157
    130158    <itemizedlist>
    131159      <listitem>
    132         <para><ulink url="http://www.nero.com/eng/nero-aac-codec.html">Nero AAC Codec</ulink>:
    133         available only in the binary form, the command-line AAC and HE-AAC encoders
    134         for Linux are in the same archive as the Windows application.</para>
    135       </listitem>
    136       <listitem>
    137         <para><ulink url="http://www.3gpp.org/ftp/Specs/html-info/26410.htm">3GPP
    138         Enhanced aacPlus general audio codec</ulink>:
    139         available in the source form, can encode only HE-AAC up to 48 kbps
    140         out of the box, but the maximum bitrate can be changed by editing
    141         the tuning table in the
    142         <filename>FloatFR_sbrenclib/src/sbr_main.c</filename> file.</para>
     160        <para>
     161          <ulink url="http://www.nero.com/eng/nero-aac-codec.html">Nero AAC
     162          Codec</ulink>:
     163          available only in the binary form, the command-line AAC and HE-AAC
     164          encoders for Linux are in the same archive as the Windows
     165          application.
     166        </para>
     167      </listitem>
     168      <listitem>
     169        <para>
     170          <ulink url="http://www.3gpp.org/ftp/Specs/html-info/26410.htm">3GPP
     171          Enhanced aacPlus general audio codec</ulink>:
     172          available in the source form, can encode only HE-AAC up to 48 kbps
     173          out of the box, but the maximum bitrate can be changed by editing
     174          the tuning table in the
     175          <filename>FloatFR_sbrenclib/src/sbr_main.c</filename> file.
     176        </para>
    143177      </listitem>
    144178    </itemizedlist>
    145179
    146     <para>Note, however, that iPod supports only Low Complexity AAC profile,
    147     which is the default in FAAC, but may not be the default in Nero AAC Encoder
    148     and is completely unavailable in the 3GPP encoder.</para>
     180    <para>
     181      Note, however, that iPod supports only Low Complexity AAC profile, which
     182      is the default in FAAC, but may not be the default in Nero AAC Encoder
     183      and is completely unavailable in the 3GPP encoder.
     184    </para>
    149185
    150186  </sect2>
    … …  
    172208        <term><command>faac</command></term>
    173209        <listitem>
    174           <para>is a command-line AAC encoder.</para>
     210          <para>
     211            is a command-line AAC encoder.
     212          </para>
    175213          <indexterm zone="faac faac-prog">
    176214            <primary sortas="b-faac">faac</primary>
    … …  
    182220        <term><filename class='libraryfile'>libfaac.so</filename></term>
    183221        <listitem>
    184           <para>contains functions for encoding AAC streams.</para>
     222          <para>
     223            contains functions for encoding AAC streams.
     224          </para>
    185225          <indexterm zone="faac libfaac">
    186226            <primary sortas="c-libfaac">libfaac.so</primary>
    … …  
    192232        <term><filename class='libraryfile'>libmp4v2.so</filename></term>
    193233        <listitem>
    194           <para>contains functions for creating and manipulating MP4 files.</para>
     234          <para>
     235            contains functions for creating and manipulating MP4 files.
     236          </para>
    195237          <indexterm zone="faac libmp4v2">
    196238            <primary sortas="c-libmp4v2">libmp4v2.so</primary>
Note: See TracChangeset for help on using the changeset viewer.