source: multimedia/libdriv/faac.xml@ be9a1905

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since be9a1905 was be9a1905, checked in by Alexander E. Patrakov <alexander@…>, 14 years ago

Removed the disabled --obj-type option from faac documentation

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

  • Property mode set to 100644
File size: 7.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY faac-download-http "http://downloads.sourceforge.net/faac/faac-&faac-version;.tar.gz">
8 <!ENTITY faac-download-ftp " ">
9 <!ENTITY faac-md5sum "1d7c019bd2dbb4f3101b8937ebc59cf6">
10 <!ENTITY faac-size "392 KB">
11 <!ENTITY faac-buildsize "33 MB">
12 <!ENTITY faac-time "0.55 SBU">
13]>
14
15<sect1 id="faac" xreflabel="FAAC-&faac-version;">
16 <?dbhtml filename="faac.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy: ag $</othername>
20 <date>$Date: 2007-12-13 16:04:40 +0500 (Чтв, 13 Дек 2007) $</date>
21 </sect1info>
22
23 <title>FAAC-&faac-version;</title>
24
25 <indexterm zone="faac">
26 <primary sortas="a-faac">faac</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to FAAC</title>
31
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). Such 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>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&faac-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&faac-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &faac-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &faac-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &faac-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &faac-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">FAAC Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Optional</bridgehead>
63 <para>libmp4v2 from
64 <ulink url="http://mpeg4ip.sourceforge.net/">mpeg4ip</ulink> (untested,
65 an internal version of the library is used if the external one
66 is not found).</para>
67
68 <para condition="html" role="usernotes">User Notes:
69 <ulink url="&blfs-wiki;/faac"/></para>
70
71 </sect2>
72
73 <sect2 role="installation">
74 <title>Installation of FAAC</title>
75
76 <para>Install <application>FAAC</application> by running the
77 following commands:</para>
78
79<screen><userinput>./bootstrap &amp;&amp;
80sed -i -e '/obj-type/d' -e '/Long Term/d' frontend/main.c &amp;&amp;
81./configure --prefix=/usr &amp;&amp;
82make</userinput></screen>
83
84 <para>This package does not come with a test suite. However, one can test
85 its basic functionality with a sample WAV file. Encode the file:</para>
86
87<screen><userinput>./frontend/faac -o Front_Left.mp4 /usr/share/sounds/alsa/Front_Left.wav</userinput></screen>
88
89 <para>Then, decode the result with <xref linkend="faad2"/> and play back
90 the decoded file:</para>
91
92<screen><userinput>faad Front_Left.mp4
93aplay Front_Left.wav</userinput></screen>
94
95 <para><command>aplay</command> should identify the file as
96 "Signed 16 bit Little Endian, Rate 48000 Hz, Stereo", and you should hear
97 the words "front left".</para>
98
99 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
100
101<screen role="root"><userinput>make install</userinput></screen>
102
103 </sect2>
104
105 <sect2 role="commands">
106 <title>Command Explanations</title>
107
108 <para><command>./bootstrap</command>: This command runs GNU Autotools
109 and produces the <command>configure</command> script and some other files
110 that drive the further build.</para>
111
112<!-- Note to editors: remove this sed if the new release re-enables the
113 option (look for "#if 0" near "case OBJTYPE_FLAG:", this is line
114 697 in frontend/main.c as of FAAC-1.26) or fixes the documentation
115 so that it dosn't mention the disabled option. -->
116
117 <para><command>sed -i ...</command>: This command removes documentation
118 for the <option>--obj-type</option> parameter from the
119 <command>faad --long-help</command> command output. This parameter
120 is disabled in FAAC-&faac-version; anyway due to sound quality issues
121 with object types other than <quote>Low Complexity</quote>.</para>
122
123 <para><option>--enable-drm</option>: This option is supposed to enable
124 support for encoding files for
125 <ulink url="http://www.drm.org/">Digital Radio Mondiale</ulink>, but
126 actually breaks the base functionality of the package (e.g., the resulting
127 <command>faac</command> program produces files that cannot be decoded
128 by <xref linkend="faad2"/>, even if compiled with DRM support).
129 Don't use it.</para>
130 </sect2>
131
132 <sect2>
133 <title>Other AAC encoders</title>
134
135 <para>The quality of <application>FAAC</application> is not up
136 to par with the currently best AAC encoders available. Also, it supports
137 only AAC, but not High Efficiency AAC (also known as aacPlus), which provides
138 better quality at low bitrates by means of using the
139 <quote>spectral band replication</quote> technology. There are the
140 following alternative programs for producing AAC and HE-AAC streams:</para>
141
142 <itemizedlist>
143 <listitem>
144 <para><ulink url="http://www.nero.com/eng/nero-aac-codec.html">Nero AAC Codec</ulink>:
145 available only in the binary form, a command-line AAC and HE-AAC encoder
146 for Linux is in the same archive as the Windows application.</para>
147 </listitem>
148 <listitem>
149 <para><ulink url="http://www.3gpp.org/ftp/Specs/html-info/26410.htm">3GPP Enhanced aacPlus general audio codec</ulink>:
150 available in the source form, can encode only HE-AAC up to 48 kbps
151 out of the box, but the maximum bitrate can be changed by editing
152 the tuning table in the
153 <filename>FloatFR_sbrenclib/src/sbr_main.c</filename> file.</para>
154 </listitem>
155 </itemizedlist>
156
157 <para>Note, however, that iPod supports only Low Complexity AAC profile,
158 which is the default in FAAC, but may not be the default in Nero AAC Encoder
159 and is completely unavailable in the 3GPP encoder.</para>
160
161 </sect2>
162 <sect2 role="content">
163 <title>Contents</title>
164
165 <segmentedlist>
166 <segtitle>Installed Program</segtitle>
167 <segtitle>Installed Libraries</segtitle>
168
169 <seglistitem>
170 <seg>faac</seg>
171 <seg>libfaac.{so,a} and libmp4v2.{so,a}</seg>
172 </seglistitem>
173 </segmentedlist>
174
175 <variablelist>
176 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
177 <?dbfo list-presentation="list"?>
178 <?dbhtml list-presentation="table"?>
179
180 <varlistentry id="faac-prog">
181 <term><command>faac</command></term>
182 <listitem>
183 <para>is a command-line AAC encoder.</para>
184 <indexterm zone="faac faac-prog">
185 <primary sortas="b-faac">faac</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="libfaac">
191 <term><filename class='libraryfile'>libfaac.{so,a}</filename></term>
192 <listitem>
193 <para>this library contains functions for encoding AAC streams.</para>
194 <indexterm zone="faac libfaac">
195 <primary sortas="c-libfaac">libfaac.{so,a}</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="libmp4v2">
201 <term><filename class='libraryfile'>libmp4v2.{so,a}</filename></term>
202 <listitem>
203 <para>this library contains functions for creating and manipulating MP4 files.</para>
204 <indexterm zone="faac libmp4v2">
205 <primary sortas="c-libmp4v2">libmp4v2.{so,a}</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 </variablelist>
211
212 </sect2>
213
214</sect1>
Note: See TracBrowser for help on using the repository browser.