mirror of
https://github.com/nu774/fdkaac.git
synced 2025-06-05 23:29:14 +02:00
Compare commits
27 Commits
Author | SHA1 | Date | |
---|---|---|---|
a79a11ef99 | |||
70554c0791 | |||
a854b113ae | |||
f7a24bf87b | |||
5063c6dce1 | |||
57aa91419d | |||
b3dcf08647 | |||
a7c4895534 | |||
209130e887 | |||
b6ab92a9e7 | |||
e18fe91a40 | |||
472e82e42f | |||
ce0833f8e5 | |||
661f883dce | |||
b815f858d0 | |||
5d6ea58e92 | |||
71e4764062 | |||
a26e3cf3e8 | |||
c6e18ebec1 | |||
c1db26327a | |||
1c1d1931cb | |||
2ecae04c89 | |||
30c77dfb6f | |||
ed646ccf79 | |||
8009f87dca | |||
d09acb7283 | |||
8ac221b853 |
22
.gitignore
vendored
Normal file
22
.gitignore
vendored
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
*.o
|
||||||
|
*~
|
||||||
|
Makefile
|
||||||
|
Makefile.in
|
||||||
|
aclocal.m4
|
||||||
|
autom4te.cache
|
||||||
|
compile
|
||||||
|
config.guess
|
||||||
|
config.h
|
||||||
|
config.h.in
|
||||||
|
config.log
|
||||||
|
config.status
|
||||||
|
config.sub
|
||||||
|
configure
|
||||||
|
depcomp
|
||||||
|
install-sh
|
||||||
|
missing
|
||||||
|
missings/.deps/
|
||||||
|
src/.deps/
|
||||||
|
src/.dirstamp
|
||||||
|
stamp-h1
|
||||||
|
fdkaac
|
119
COPYING
119
COPYING
@ -1,17 +1,108 @@
|
|||||||
Copyright (C) 2013 nu774
|
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
|
||||||
|
Upstream-Name: fdkaac
|
||||||
|
Upstream-Contact: nu774 <honeycomb77@gmail.com>
|
||||||
|
Source: https://github.com/nu774/fdkaac
|
||||||
|
|
||||||
This software is provided 'as-is', without any express or implied
|
|
||||||
warranty. In no event will the authors be held liable for any damages
|
|
||||||
arising from the use of this software.
|
|
||||||
|
|
||||||
Permission is granted to anyone to use this software for any purpose,
|
Files: *
|
||||||
including commercial applications, and to alter it and redistribute it
|
Copyright: 2013-2014 nu774 <honeycomb77@gmail.com>
|
||||||
freely, subject to the following restrictions:
|
License: Zlib
|
||||||
|
|
||||||
1. The origin of this software must not be misrepresented; you must not
|
Files: missings/getopt.c
|
||||||
claim that you wrote the original software. If you use this software
|
Copyright: 2002 Todd C. Miller <Todd.Miller@courtesan.com>
|
||||||
in a product, an acknowledgment in the product documentation would be
|
2000 The NetBSD Foundation, Inc.
|
||||||
appreciated but is not required.
|
License: BSD-4-clause
|
||||||
2. Altered source versions must be plainly marked as such, and must not be
|
|
||||||
misrepresented as being the original software.
|
Files: missings/getopt.h
|
||||||
3. This notice may not be removed or altered from any source distribution.
|
Copyright: 2000 The NetBSD Foundation, Inc.
|
||||||
|
License: BSD-4-clause
|
||||||
|
|
||||||
|
Files: src/parson.*
|
||||||
|
Copyright: 2012 Krzysztof Gabis
|
||||||
|
License: MIT
|
||||||
|
|
||||||
|
Files: src/lpc.h
|
||||||
|
Copyright: 1994-2007 the Xiph.Org Foundation
|
||||||
|
License: BSD
|
||||||
|
|
||||||
|
Files: src/lpc.c
|
||||||
|
Copyright: 1994-2007 the Xiph.Org Foundation
|
||||||
|
1992, 1993, 1994 Jutta Degener and Carsten Bormann, Technische Universität Berlin
|
||||||
|
License: BSD-style
|
||||||
|
|
||||||
|
|
||||||
|
License: Zlib
|
||||||
|
This software is provided 'as-is', without any express or implied
|
||||||
|
warranty. In no event will the authors be held liable for any damages
|
||||||
|
arising from the use of this software.
|
||||||
|
.
|
||||||
|
Permission is granted to anyone to use this software for any purpose,
|
||||||
|
including commercial applications, and to alter it and redistribute it
|
||||||
|
freely, subject to the following restrictions:
|
||||||
|
.
|
||||||
|
1. The origin of this software must not be misrepresented; you must not
|
||||||
|
claim that you wrote the original software. If you use this software
|
||||||
|
in a product, an acknowledgment in the product documentation would be
|
||||||
|
appreciated but is not required.
|
||||||
|
2. Altered source versions must be plainly marked as such, and must not be
|
||||||
|
misrepresented as being the original software.
|
||||||
|
3. This notice may not be removed or altered from any source distribution.
|
||||||
|
|
||||||
|
|
||||||
|
License: MIT
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
.
|
||||||
|
The above copyright notice and this permission notice shall be included in
|
||||||
|
all copies or substantial portions of the Software.
|
||||||
|
.
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||||
|
THE SOFTWARE.
|
||||||
|
|
||||||
|
|
||||||
|
License: BSD-4-clause
|
||||||
|
Redistribution and use in source and binary forms, with or without
|
||||||
|
modification, are permitted provided that the following conditions
|
||||||
|
are met:
|
||||||
|
1. Redistributions of source code must retain the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer.
|
||||||
|
2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
notice, this list of conditions and the following disclaimer in the
|
||||||
|
documentation and/or other materials provided with the distribution.
|
||||||
|
3. All advertising materials mentioning features or use of this software
|
||||||
|
must display the following acknowledgement:
|
||||||
|
This product includes software developed by the NetBSD
|
||||||
|
Foundation, Inc. and its contributors.
|
||||||
|
4. Neither the name of The NetBSD Foundation nor the names of its
|
||||||
|
contributors may be used to endorse or promote products derived
|
||||||
|
from this software without specific prior written permission.
|
||||||
|
.
|
||||||
|
THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
||||||
|
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
||||||
|
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
||||||
|
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
|
||||||
|
|
||||||
|
License: BSD-style
|
||||||
|
Any use of this software is permitted provided that this notice is not
|
||||||
|
removed and that neither the authors nor the Technische Universita"t
|
||||||
|
Berlin are deemed to have made any representations as to the
|
||||||
|
suitability of this software for any purpose nor are held responsible
|
||||||
|
for any defects of this software. THERE IS ABSOLUTELY NO WARRANTY FOR
|
||||||
|
THIS SOFTWARE.
|
||||||
|
78
ChangeLog
78
ChangeLog
@ -1,7 +1,81 @@
|
|||||||
2013-10-30 nu774 <honeycomb77@gmail.com>
|
2014-02-17 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
* update ChangeLog [HEAD]
|
* update ChangeLog [HEAD]
|
||||||
|
|
||||||
|
* bump version [v0.5.3]
|
||||||
|
|
||||||
|
* fix: CAF chan chunk using channel bitmap was not correctly handled
|
||||||
|
|
||||||
|
2014-01-18 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* update ChangeLog [origin/master]
|
||||||
|
|
||||||
|
* bump version [v0.5.2]
|
||||||
|
|
||||||
|
* fix reading of caf file without chan chunk
|
||||||
|
|
||||||
|
2013-11-17 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* Merge pull request #9 from rbrito/fix-typo
|
||||||
|
|
||||||
|
2013-11-18 Rogério Brito <rbrito@ime.usp.br>
|
||||||
|
|
||||||
|
* man: Regen manpage with hyphens escaped.
|
||||||
|
|
||||||
|
* README: Remove trailing whitespaces that end up in the manpages.
|
||||||
|
|
||||||
|
* README: Fix typo in bandwidth to match CLI options.
|
||||||
|
|
||||||
|
2013-11-08 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* add genman.sh, update fdkaac.1
|
||||||
|
|
||||||
|
* update ChangeLog
|
||||||
|
|
||||||
|
* bump version [v0.5.1]
|
||||||
|
|
||||||
|
* fix to use libFDKAAC signaling mode 1
|
||||||
|
|
||||||
|
2013-11-05 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* fix README
|
||||||
|
|
||||||
|
2013-11-04 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* rename README.md -> README
|
||||||
|
|
||||||
|
* Update README -> README.md, generate groff manpage from README.md
|
||||||
|
|
||||||
|
* update ChangeLog
|
||||||
|
|
||||||
|
* update git2changelog to accept non-ascii output
|
||||||
|
|
||||||
|
* add manpage
|
||||||
|
|
||||||
|
2013-11-03 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* fix gcc warnings
|
||||||
|
|
||||||
|
* Merge pull request #7 from rbrito/misc-fixes
|
||||||
|
|
||||||
|
2013-11-03 Rogério Brito <rbrito@ime.usp.br>
|
||||||
|
|
||||||
|
* gitignore: Add list of files to ignore.
|
||||||
|
|
||||||
|
2013-11-03 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* update ChangeLog
|
||||||
|
|
||||||
|
* bump version [v0.5.0]
|
||||||
|
|
||||||
|
* add --sbr-ratio to support AACENC_SBR_RATIO appeared on libFDK 3.4.12
|
||||||
|
|
||||||
|
* support 7.1 channel mode added on FDK 3.4.12
|
||||||
|
|
||||||
|
2013-10-30 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
|
* update ChangeLog
|
||||||
|
|
||||||
* bump version [v0.4.2]
|
* bump version [v0.4.2]
|
||||||
|
|
||||||
* use tell() to obtain data chunk offset
|
* use tell() to obtain data chunk offset
|
||||||
@ -38,7 +112,7 @@
|
|||||||
|
|
||||||
2013-10-26 nu774 <honeycomb77@gmail.com>
|
2013-10-26 nu774 <honeycomb77@gmail.com>
|
||||||
|
|
||||||
* re-fix #ifdef cond for lrint()
|
* re-fix #ifdef cond for lrint() [old]
|
||||||
|
|
||||||
* tag mapping: add recorded date and tempo, remove performer->artist
|
* tag mapping: add recorded date and tempo, remove performer->artist
|
||||||
|
|
||||||
|
386
INSTALL
386
INSTALL
@ -1,370 +1,32 @@
|
|||||||
Installation Instructions
|
Prerequiste
|
||||||
*************************
|
-----------
|
||||||
|
|
||||||
Copyright (C) 1994-1996, 1999-2002, 2004-2011 Free Software Foundation,
|
To build fdkaac, you need the followings:
|
||||||
Inc.
|
- libfdk-aac (https://github.com/mstorsjo/fdk-aac)
|
||||||
|
- GNU autoconf, GNU automake
|
||||||
|
- GNU gettext (for iconv.m4)
|
||||||
|
|
||||||
Copying and distribution of this file, with or without modification,
|
libfdk-aac is always required, and probably you have to build it yourself.
|
||||||
are permitted in any medium without royalty provided the copyright
|
Others are required only when you build by configure and make on Unix-like
|
||||||
notice and this notice are preserved. This file is offered as-is,
|
enviromnent (including Cygwin or MinGW), and usually you can install them
|
||||||
without warranty of any kind.
|
through package manager of your system if they are not already present.
|
||||||
|
|
||||||
Basic Installation
|
Unix-like environment
|
||||||
==================
|
---------------------
|
||||||
|
|
||||||
Briefly, the shell commands `./configure; make; make install' should
|
You can build and install libfdkaac and fdkaac in the following step.
|
||||||
configure, build, and install this package. The following
|
|
||||||
more-detailed instructions are generic; see the `README' file for
|
|
||||||
instructions specific to this package. Some packages provide this
|
|
||||||
`INSTALL' file but do not implement all of the features documented
|
|
||||||
below. The lack of an optional feature in a given package is not
|
|
||||||
necessarily a bug. More recommendations for GNU packages can be found
|
|
||||||
in *note Makefile Conventions: (standards)Makefile Conventions.
|
|
||||||
|
|
||||||
The `configure' shell script attempts to guess correct values for
|
1) extract the source, and cd to the source directory
|
||||||
various system-dependent variables used during compilation. It uses
|
2) autoreconf -i
|
||||||
those values to create a `Makefile' in each directory of the package.
|
3) ./configure
|
||||||
It may also create one or more `.h' files containing system-dependent
|
4) make
|
||||||
definitions. Finally, it creates a shell script `config.status' that
|
5) sudo make install
|
||||||
you can run in the future to recreate the current configuration, and a
|
|
||||||
file `config.log' containing compiler output (useful mainly for
|
|
||||||
debugging `configure').
|
|
||||||
|
|
||||||
It can also use an optional file (typically called `config.cache'
|
Depending on your requirements, you might want to add some extra arguments to
|
||||||
and enabled with `--cache-file=config.cache' or simply `-C') that saves
|
configure script.
|
||||||
the results of its tests to speed up reconfiguring. Caching is
|
You have to install libfdk-aac first, and do the same for fdkaac.
|
||||||
disabled by default to prevent problems with accidental use of stale
|
|
||||||
cache files.
|
|
||||||
|
|
||||||
If you need to do unusual things to compile the package, please try
|
Windows, MSVC
|
||||||
to figure out how `configure' could check whether to do them, and mail
|
-------------
|
||||||
diffs or instructions to the address given in the `README' so they can
|
|
||||||
be considered for the next release. If you are using the cache, and at
|
|
||||||
some point `config.cache' contains results you don't want to keep, you
|
|
||||||
may remove or edit it.
|
|
||||||
|
|
||||||
The file `configure.ac' (or `configure.in') is used to create
|
|
||||||
`configure' by a program called `autoconf'. You need `configure.ac' if
|
|
||||||
you want to change it or regenerate `configure' using a newer version
|
|
||||||
of `autoconf'.
|
|
||||||
|
|
||||||
The simplest way to compile this package is:
|
|
||||||
|
|
||||||
1. `cd' to the directory containing the package's source code and type
|
|
||||||
`./configure' to configure the package for your system.
|
|
||||||
|
|
||||||
Running `configure' might take a while. While running, it prints
|
|
||||||
some messages telling which features it is checking for.
|
|
||||||
|
|
||||||
2. Type `make' to compile the package.
|
|
||||||
|
|
||||||
3. Optionally, type `make check' to run any self-tests that come with
|
|
||||||
the package, generally using the just-built uninstalled binaries.
|
|
||||||
|
|
||||||
4. Type `make install' to install the programs and any data files and
|
|
||||||
documentation. When installing into a prefix owned by root, it is
|
|
||||||
recommended that the package be configured and built as a regular
|
|
||||||
user, and only the `make install' phase executed with root
|
|
||||||
privileges.
|
|
||||||
|
|
||||||
5. Optionally, type `make installcheck' to repeat any self-tests, but
|
|
||||||
this time using the binaries in their final installed location.
|
|
||||||
This target does not install anything. Running this target as a
|
|
||||||
regular user, particularly if the prior `make install' required
|
|
||||||
root privileges, verifies that the installation completed
|
|
||||||
correctly.
|
|
||||||
|
|
||||||
6. You can remove the program binaries and object files from the
|
|
||||||
source code directory by typing `make clean'. To also remove the
|
|
||||||
files that `configure' created (so you can compile the package for
|
|
||||||
a different kind of computer), type `make distclean'. There is
|
|
||||||
also a `make maintainer-clean' target, but that is intended mainly
|
|
||||||
for the package's developers. If you use it, you may have to get
|
|
||||||
all sorts of other programs in order to regenerate files that came
|
|
||||||
with the distribution.
|
|
||||||
|
|
||||||
7. Often, you can also type `make uninstall' to remove the installed
|
|
||||||
files again. In practice, not all packages have tested that
|
|
||||||
uninstallation works correctly, even though it is required by the
|
|
||||||
GNU Coding Standards.
|
|
||||||
|
|
||||||
8. Some packages, particularly those that use Automake, provide `make
|
|
||||||
distcheck', which can by used by developers to test that all other
|
|
||||||
targets like `make install' and `make uninstall' work correctly.
|
|
||||||
This target is generally not run by end users.
|
|
||||||
|
|
||||||
Compilers and Options
|
|
||||||
=====================
|
|
||||||
|
|
||||||
Some systems require unusual options for compilation or linking that
|
|
||||||
the `configure' script does not know about. Run `./configure --help'
|
|
||||||
for details on some of the pertinent environment variables.
|
|
||||||
|
|
||||||
You can give `configure' initial values for configuration parameters
|
|
||||||
by setting variables in the command line or in the environment. Here
|
|
||||||
is an example:
|
|
||||||
|
|
||||||
./configure CC=c99 CFLAGS=-g LIBS=-lposix
|
|
||||||
|
|
||||||
*Note Defining Variables::, for more details.
|
|
||||||
|
|
||||||
Compiling For Multiple Architectures
|
|
||||||
====================================
|
|
||||||
|
|
||||||
You can compile the package for more than one kind of computer at the
|
|
||||||
same time, by placing the object files for each architecture in their
|
|
||||||
own directory. To do this, you can use GNU `make'. `cd' to the
|
|
||||||
directory where you want the object files and executables to go and run
|
|
||||||
the `configure' script. `configure' automatically checks for the
|
|
||||||
source code in the directory that `configure' is in and in `..'. This
|
|
||||||
is known as a "VPATH" build.
|
|
||||||
|
|
||||||
With a non-GNU `make', it is safer to compile the package for one
|
|
||||||
architecture at a time in the source code directory. After you have
|
|
||||||
installed the package for one architecture, use `make distclean' before
|
|
||||||
reconfiguring for another architecture.
|
|
||||||
|
|
||||||
On MacOS X 10.5 and later systems, you can create libraries and
|
|
||||||
executables that work on multiple system types--known as "fat" or
|
|
||||||
"universal" binaries--by specifying multiple `-arch' options to the
|
|
||||||
compiler but only a single `-arch' option to the preprocessor. Like
|
|
||||||
this:
|
|
||||||
|
|
||||||
./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
|
|
||||||
CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
|
|
||||||
CPP="gcc -E" CXXCPP="g++ -E"
|
|
||||||
|
|
||||||
This is not guaranteed to produce working output in all cases, you
|
|
||||||
may have to build one architecture at a time and combine the results
|
|
||||||
using the `lipo' tool if you have problems.
|
|
||||||
|
|
||||||
Installation Names
|
|
||||||
==================
|
|
||||||
|
|
||||||
By default, `make install' installs the package's commands under
|
|
||||||
`/usr/local/bin', include files under `/usr/local/include', etc. You
|
|
||||||
can specify an installation prefix other than `/usr/local' by giving
|
|
||||||
`configure' the option `--prefix=PREFIX', where PREFIX must be an
|
|
||||||
absolute file name.
|
|
||||||
|
|
||||||
You can specify separate installation prefixes for
|
|
||||||
architecture-specific files and architecture-independent files. If you
|
|
||||||
pass the option `--exec-prefix=PREFIX' to `configure', the package uses
|
|
||||||
PREFIX as the prefix for installing programs and libraries.
|
|
||||||
Documentation and other data files still use the regular prefix.
|
|
||||||
|
|
||||||
In addition, if you use an unusual directory layout you can give
|
|
||||||
options like `--bindir=DIR' to specify different values for particular
|
|
||||||
kinds of files. Run `configure --help' for a list of the directories
|
|
||||||
you can set and what kinds of files go in them. In general, the
|
|
||||||
default for these options is expressed in terms of `${prefix}', so that
|
|
||||||
specifying just `--prefix' will affect all of the other directory
|
|
||||||
specifications that were not explicitly provided.
|
|
||||||
|
|
||||||
The most portable way to affect installation locations is to pass the
|
|
||||||
correct locations to `configure'; however, many packages provide one or
|
|
||||||
both of the following shortcuts of passing variable assignments to the
|
|
||||||
`make install' command line to change installation locations without
|
|
||||||
having to reconfigure or recompile.
|
|
||||||
|
|
||||||
The first method involves providing an override variable for each
|
|
||||||
affected directory. For example, `make install
|
|
||||||
prefix=/alternate/directory' will choose an alternate location for all
|
|
||||||
directory configuration variables that were expressed in terms of
|
|
||||||
`${prefix}'. Any directories that were specified during `configure',
|
|
||||||
but not in terms of `${prefix}', must each be overridden at install
|
|
||||||
time for the entire installation to be relocated. The approach of
|
|
||||||
makefile variable overrides for each directory variable is required by
|
|
||||||
the GNU Coding Standards, and ideally causes no recompilation.
|
|
||||||
However, some platforms have known limitations with the semantics of
|
|
||||||
shared libraries that end up requiring recompilation when using this
|
|
||||||
method, particularly noticeable in packages that use GNU Libtool.
|
|
||||||
|
|
||||||
The second method involves providing the `DESTDIR' variable. For
|
|
||||||
example, `make install DESTDIR=/alternate/directory' will prepend
|
|
||||||
`/alternate/directory' before all installation names. The approach of
|
|
||||||
`DESTDIR' overrides is not required by the GNU Coding Standards, and
|
|
||||||
does not work on platforms that have drive letters. On the other hand,
|
|
||||||
it does better at avoiding recompilation issues, and works well even
|
|
||||||
when some directory options were not specified in terms of `${prefix}'
|
|
||||||
at `configure' time.
|
|
||||||
|
|
||||||
Optional Features
|
|
||||||
=================
|
|
||||||
|
|
||||||
If the package supports it, you can cause programs to be installed
|
|
||||||
with an extra prefix or suffix on their names by giving `configure' the
|
|
||||||
option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
|
|
||||||
|
|
||||||
Some packages pay attention to `--enable-FEATURE' options to
|
|
||||||
`configure', where FEATURE indicates an optional part of the package.
|
|
||||||
They may also pay attention to `--with-PACKAGE' options, where PACKAGE
|
|
||||||
is something like `gnu-as' or `x' (for the X Window System). The
|
|
||||||
`README' should mention any `--enable-' and `--with-' options that the
|
|
||||||
package recognizes.
|
|
||||||
|
|
||||||
For packages that use the X Window System, `configure' can usually
|
|
||||||
find the X include and library files automatically, but if it doesn't,
|
|
||||||
you can use the `configure' options `--x-includes=DIR' and
|
|
||||||
`--x-libraries=DIR' to specify their locations.
|
|
||||||
|
|
||||||
Some packages offer the ability to configure how verbose the
|
|
||||||
execution of `make' will be. For these packages, running `./configure
|
|
||||||
--enable-silent-rules' sets the default to minimal output, which can be
|
|
||||||
overridden with `make V=1'; while running `./configure
|
|
||||||
--disable-silent-rules' sets the default to verbose, which can be
|
|
||||||
overridden with `make V=0'.
|
|
||||||
|
|
||||||
Particular systems
|
|
||||||
==================
|
|
||||||
|
|
||||||
On HP-UX, the default C compiler is not ANSI C compatible. If GNU
|
|
||||||
CC is not installed, it is recommended to use the following options in
|
|
||||||
order to use an ANSI C compiler:
|
|
||||||
|
|
||||||
./configure CC="cc -Ae -D_XOPEN_SOURCE=500"
|
|
||||||
|
|
||||||
and if that doesn't work, install pre-built binaries of GCC for HP-UX.
|
|
||||||
|
|
||||||
HP-UX `make' updates targets which have the same time stamps as
|
|
||||||
their prerequisites, which makes it generally unusable when shipped
|
|
||||||
generated files such as `configure' are involved. Use GNU `make'
|
|
||||||
instead.
|
|
||||||
|
|
||||||
On OSF/1 a.k.a. Tru64, some versions of the default C compiler cannot
|
|
||||||
parse its `<wchar.h>' header file. The option `-nodtk' can be used as
|
|
||||||
a workaround. If GNU CC is not installed, it is therefore recommended
|
|
||||||
to try
|
|
||||||
|
|
||||||
./configure CC="cc"
|
|
||||||
|
|
||||||
and if that doesn't work, try
|
|
||||||
|
|
||||||
./configure CC="cc -nodtk"
|
|
||||||
|
|
||||||
On Solaris, don't put `/usr/ucb' early in your `PATH'. This
|
|
||||||
directory contains several dysfunctional programs; working variants of
|
|
||||||
these programs are available in `/usr/bin'. So, if you need `/usr/ucb'
|
|
||||||
in your `PATH', put it _after_ `/usr/bin'.
|
|
||||||
|
|
||||||
On Haiku, software installed for all users goes in `/boot/common',
|
|
||||||
not `/usr/local'. It is recommended to use the following options:
|
|
||||||
|
|
||||||
./configure --prefix=/boot/common
|
|
||||||
|
|
||||||
Specifying the System Type
|
|
||||||
==========================
|
|
||||||
|
|
||||||
There may be some features `configure' cannot figure out
|
|
||||||
automatically, but needs to determine by the type of machine the package
|
|
||||||
will run on. Usually, assuming the package is built to be run on the
|
|
||||||
_same_ architectures, `configure' can figure that out, but if it prints
|
|
||||||
a message saying it cannot guess the machine type, give it the
|
|
||||||
`--build=TYPE' option. TYPE can either be a short name for the system
|
|
||||||
type, such as `sun4', or a canonical name which has the form:
|
|
||||||
|
|
||||||
CPU-COMPANY-SYSTEM
|
|
||||||
|
|
||||||
where SYSTEM can have one of these forms:
|
|
||||||
|
|
||||||
OS
|
|
||||||
KERNEL-OS
|
|
||||||
|
|
||||||
See the file `config.sub' for the possible values of each field. If
|
|
||||||
`config.sub' isn't included in this package, then this package doesn't
|
|
||||||
need to know the machine type.
|
|
||||||
|
|
||||||
If you are _building_ compiler tools for cross-compiling, you should
|
|
||||||
use the option `--target=TYPE' to select the type of system they will
|
|
||||||
produce code for.
|
|
||||||
|
|
||||||
If you want to _use_ a cross compiler, that generates code for a
|
|
||||||
platform different from the build platform, you should specify the
|
|
||||||
"host" platform (i.e., that on which the generated programs will
|
|
||||||
eventually be run) with `--host=TYPE'.
|
|
||||||
|
|
||||||
Sharing Defaults
|
|
||||||
================
|
|
||||||
|
|
||||||
If you want to set default values for `configure' scripts to share,
|
|
||||||
you can create a site shell script called `config.site' that gives
|
|
||||||
default values for variables like `CC', `cache_file', and `prefix'.
|
|
||||||
`configure' looks for `PREFIX/share/config.site' if it exists, then
|
|
||||||
`PREFIX/etc/config.site' if it exists. Or, you can set the
|
|
||||||
`CONFIG_SITE' environment variable to the location of the site script.
|
|
||||||
A warning: not all `configure' scripts look for a site script.
|
|
||||||
|
|
||||||
Defining Variables
|
|
||||||
==================
|
|
||||||
|
|
||||||
Variables not defined in a site shell script can be set in the
|
|
||||||
environment passed to `configure'. However, some packages may run
|
|
||||||
configure again during the build, and the customized values of these
|
|
||||||
variables may be lost. In order to avoid this problem, you should set
|
|
||||||
them in the `configure' command line, using `VAR=value'. For example:
|
|
||||||
|
|
||||||
./configure CC=/usr/local2/bin/gcc
|
|
||||||
|
|
||||||
causes the specified `gcc' to be used as the C compiler (unless it is
|
|
||||||
overridden in the site shell script).
|
|
||||||
|
|
||||||
Unfortunately, this technique does not work for `CONFIG_SHELL' due to
|
|
||||||
an Autoconf bug. Until the bug is fixed you can use this workaround:
|
|
||||||
|
|
||||||
CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash
|
|
||||||
|
|
||||||
`configure' Invocation
|
|
||||||
======================
|
|
||||||
|
|
||||||
`configure' recognizes the following options to control how it
|
|
||||||
operates.
|
|
||||||
|
|
||||||
`--help'
|
|
||||||
`-h'
|
|
||||||
Print a summary of all of the options to `configure', and exit.
|
|
||||||
|
|
||||||
`--help=short'
|
|
||||||
`--help=recursive'
|
|
||||||
Print a summary of the options unique to this package's
|
|
||||||
`configure', and exit. The `short' variant lists options used
|
|
||||||
only in the top level, while the `recursive' variant lists options
|
|
||||||
also present in any nested packages.
|
|
||||||
|
|
||||||
`--version'
|
|
||||||
`-V'
|
|
||||||
Print the version of Autoconf used to generate the `configure'
|
|
||||||
script, and exit.
|
|
||||||
|
|
||||||
`--cache-file=FILE'
|
|
||||||
Enable the cache: use and save the results of the tests in FILE,
|
|
||||||
traditionally `config.cache'. FILE defaults to `/dev/null' to
|
|
||||||
disable caching.
|
|
||||||
|
|
||||||
`--config-cache'
|
|
||||||
`-C'
|
|
||||||
Alias for `--cache-file=config.cache'.
|
|
||||||
|
|
||||||
`--quiet'
|
|
||||||
`--silent'
|
|
||||||
`-q'
|
|
||||||
Do not print messages saying which checks are being made. To
|
|
||||||
suppress all normal output, redirect it to `/dev/null' (any error
|
|
||||||
messages will still be shown).
|
|
||||||
|
|
||||||
`--srcdir=DIR'
|
|
||||||
Look for the package's source code in directory DIR. Usually
|
|
||||||
`configure' can determine that directory automatically.
|
|
||||||
|
|
||||||
`--prefix=DIR'
|
|
||||||
Use DIR as the installation prefix. *note Installation Names::
|
|
||||||
for more details, including other options available for fine-tuning
|
|
||||||
the installation locations.
|
|
||||||
|
|
||||||
`--no-create'
|
|
||||||
`-n'
|
|
||||||
Run the configure checks, but stop before creating any output
|
|
||||||
files.
|
|
||||||
|
|
||||||
`configure' also accepts some other, not widely useful, options. Run
|
|
||||||
`configure --help' for more details.
|
|
||||||
|
|
||||||
|
Extract libfdk-aac under fdkaac directory, and open MSVC/fdkaac.sln.
|
||||||
|
@ -18,6 +18,8 @@ fdkaac_SOURCES = \
|
|||||||
src/progress.c \
|
src/progress.c \
|
||||||
src/wav_reader.c
|
src/wav_reader.c
|
||||||
|
|
||||||
|
dist_man_MANS = man/fdkaac.1
|
||||||
|
|
||||||
fdkaac_LDADD = \
|
fdkaac_LDADD = \
|
||||||
@LIBICONV@ -lfdk-aac -lm
|
@LIBICONV@ -lfdk-aac -lm
|
||||||
|
|
||||||
|
412
README
412
README
@ -1,122 +1,332 @@
|
|||||||
==========================================================================
|
% FDKAAC(1)
|
||||||
fdkaac - command line frontend encoder for libfdk-aac
|
% nu774 <honeycomb77@gmail.com>
|
||||||
==========================================================================
|
% November, 2013
|
||||||
|
|
||||||
Prerequisites
|
NAME
|
||||||
-------------
|
====
|
||||||
You need libfdk-aac.
|
|
||||||
On Posix environment, you will also need GNU gettext (for iconv.m4) and
|
|
||||||
GNU autoconf/automake.
|
|
||||||
|
|
||||||
How to build on Posix environment
|
fdkaac - command line frontend for libfdk-aac encoder
|
||||||
---------------------------------
|
|
||||||
First, you need to build libfdk-aac and install on your system.
|
|
||||||
Once you have done it, the following will do the task.
|
|
||||||
(MinGW build can be done the same way, and doesn't require gettext/iconv)
|
|
||||||
|
|
||||||
$ autoreconf -i
|
SYNOPSIS
|
||||||
$ ./configure && make && make install
|
========
|
||||||
|
|
||||||
How to build on MSVC
|
**fdkaac** [OPTIONS] [FILE]
|
||||||
--------------------
|
|
||||||
First you have to extract libfdk-aac source here, so that directory tree will
|
|
||||||
look like the following:
|
|
||||||
+- fdk-aac ---+-documentation
|
|
||||||
| +-libAACdec
|
|
||||||
| +-libAACenc
|
|
||||||
| :
|
|
||||||
+- m4
|
|
||||||
+- missings
|
|
||||||
+- MSVC
|
|
||||||
+- src
|
|
||||||
|
|
||||||
MSVC solution for Visual Studio 2010 is under MSVC directory.
|
DESCRIPTION
|
||||||
|
===========
|
||||||
|
|
||||||
Available input format
|
**fdkaac** reads linear PCM audio in either WAV, raw PCM, or CAF format,
|
||||||
----------------------
|
and encodes it into either M4A / AAC file.
|
||||||
WAV, RF64, CAF, RAW, upto 32bit int / 64bit float format is supported.
|
|
||||||
Metadata in CAF info chunk can be read and copied to the resulting m4a.
|
|
||||||
This is especially useful and works well when you pipe from ffmpeg via CAF.
|
|
||||||
For example, you can copy tag from original "foo.flac" to "foo.m4a"
|
|
||||||
through the following pipeline:
|
|
||||||
|
|
||||||
$ ffmpeg -i foo.flac -f caf - | fdkaac -m3 - -o foo.m4a
|
If the input file is "-", data is read from stdin. Likewise, if the
|
||||||
|
output file is "-", data is written to stdout if one of streamable AAC
|
||||||
|
transport formats are selected by **-f**.
|
||||||
|
|
||||||
Since FDK AAC encoder is implemented based on fixed point integer,
|
When CAF input and M4A output is used, tags in CAF file are copied into
|
||||||
encoder itself handles 16bit input only.
|
the resulting M4A.
|
||||||
Therefore, when feeding non-integer input, be careful so that input doesn't
|
|
||||||
exceed 0dBFS to avoid hard clips.
|
|
||||||
You might also want to apply dither/noise shape beforehand when your input
|
|
||||||
has higher resolution.
|
|
||||||
|
|
||||||
Note that fdkaac doesn't automatically resample for you
|
OPTIONS
|
||||||
when input samplerate is not supported by AAC spec.
|
=======
|
||||||
|
|
||||||
Tagging Options
|
-h, --help
|
||||||
---------------
|
: Show command help
|
||||||
Generic tagging options like --tag, --tag-from-file, --long-tag allows you
|
|
||||||
to set arbitrary tags.
|
|
||||||
Available tags and their fcc (four char code) for --tag and --tag-from-file
|
|
||||||
can be found at http://code.google.com/p/mp4v2/wiki/iTunesMetadata
|
|
||||||
|
|
||||||
For tags such as Artist where first char of fcc is copyright sign,
|
-o \<FILE\>
|
||||||
you can skip first char and just say like --tag="ART:Foo Bar" or
|
: Output filename.
|
||||||
--tag-from-file=lyr:/path/to/your/lyrics.txt
|
|
||||||
|
|
||||||
Currently, --tag-from-file just stores file contents into m4a without any
|
-p, --profile \<n\>
|
||||||
character encoding / line terminater conversion.
|
: Target profile (MPEG4 audio object type, AOT)
|
||||||
Therefore, only use UTF-8 (without BOM) when setting text tags by this option.
|
|
||||||
|
|
||||||
On the other hand, --tag / --long-tag (and other command line arguments) are
|
2
|
||||||
converted from locale character encoding to UTF-8 on Posix environment.
|
: MPEG-4 AAC LC (default)
|
||||||
On Windows, command line arguments are always treated as Unicode.
|
|
||||||
|
|
||||||
Tagging using JSON
|
5
|
||||||
------------------
|
: MPEG-4 HE-AAC (SBR)
|
||||||
With --tag-from-json, fdkaac can read JSON file and set tags from it.
|
|
||||||
By default, tags are assumed to be in the root object(dictionary) like this:
|
|
||||||
|
|
||||||
{
|
29
|
||||||
"title": "No Expectations",
|
: MPEG-4 HE-AAC v2 (SBR+PS)
|
||||||
"artist": "The Rolling Stones",
|
|
||||||
"album": "Beggars Banquet",
|
|
||||||
"track": 2
|
|
||||||
}
|
|
||||||
|
|
||||||
In this case, you can simply specify the filename like:
|
23
|
||||||
--tag-from-json=/path/to/json
|
: MPEG-4 AAC LD
|
||||||
|
|
||||||
If the object containing tags is placed somewhere else, you can optionally
|
39
|
||||||
specify the path of the object with dotted notation.
|
: MPEG-4 AAC ELD
|
||||||
|
|
||||||
{
|
129
|
||||||
"format" : {
|
: MPEG-2 AAC LC
|
||||||
"filename" : "Middle Curse.flac",
|
|
||||||
"nb_streams" : 1,
|
|
||||||
"format_name" : "flac",
|
|
||||||
"format_long_name" : "raw FLAC",
|
|
||||||
"start_time" : "N/A",
|
|
||||||
"duration" : "216.146667",
|
|
||||||
"size" : "11851007.000000",
|
|
||||||
"bit_rate" : "438628.000000",
|
|
||||||
"tags" : {
|
|
||||||
"ALBUM" : "Scary World Theory",
|
|
||||||
"ARTIST" : "Lali Puna",
|
|
||||||
"DATE" : "2001",
|
|
||||||
"DISCID" : "9208CC0A",
|
|
||||||
"TITLE" : "Middle Curse",
|
|
||||||
"TRACKTOTAL" : "10",
|
|
||||||
"track" : "2"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
In this example, tags are placed under the object "format.tags".
|
132
|
||||||
("format" is a child of the root, and "tags" is a child of the "format").
|
: MPEG-2 HE-AAC (SBR)
|
||||||
In this case, you can say:
|
|
||||||
--tag-from-json=/path/to/json?format.tags
|
|
||||||
|
|
||||||
For your information, ffprobe of ffmpeg project (or avprobe of libav) can
|
156
|
||||||
output media information/metadata in json format like this.
|
: MPEG-2 HE-AAC v2 (SBR+PS)
|
||||||
|
|
||||||
|
-b, --bitrate \<n\>
|
||||||
|
: Target bitrate (for CBR)
|
||||||
|
|
||||||
|
-m, --bitrate-mode \<n\>
|
||||||
|
: Bitrate configuration mode. Available VBR quality value depends on
|
||||||
|
other parameters such as profile, sample rate, or number of
|
||||||
|
channels.
|
||||||
|
|
||||||
|
0
|
||||||
|
: CBR (default)
|
||||||
|
|
||||||
|
1-5
|
||||||
|
: VBR (higher value -\> higher bitrate)
|
||||||
|
|
||||||
|
-w, --bandwidth \<n\>
|
||||||
|
: Frequency bandwidth (lowpass cut-off frequency) in Hz. Available on
|
||||||
|
AAC LC only.
|
||||||
|
|
||||||
|
-a, --afterburner \<n\>
|
||||||
|
: Configure afterburner mode. When enabled, quality is increased at
|
||||||
|
the expense of additional computational workload.
|
||||||
|
|
||||||
|
0
|
||||||
|
: Off
|
||||||
|
|
||||||
|
1
|
||||||
|
: On (default)
|
||||||
|
|
||||||
|
-L, --lowdelay-sbr \<n\>
|
||||||
|
: Configure SBR activity on AAC ELD.
|
||||||
|
|
||||||
|
-1
|
||||||
|
: Use ELD SBR auto configuration
|
||||||
|
|
||||||
|
0
|
||||||
|
: Disable SBR on ELD (default)
|
||||||
|
|
||||||
|
1
|
||||||
|
: Enable SBR on ELD
|
||||||
|
|
||||||
|
-s, --sbr-ratio \<n\>
|
||||||
|
: Controls activation of downsampled SBR.
|
||||||
|
|
||||||
|
0
|
||||||
|
: Use lib default (default)
|
||||||
|
|
||||||
|
1
|
||||||
|
: Use downsampled SBR (default for ELD+SBR)
|
||||||
|
|
||||||
|
2
|
||||||
|
: Use dual-rate SBR (default for HE-AAC)
|
||||||
|
|
||||||
|
Dual-rate SBR is what is normally used for HE-AAC, where AAC is
|
||||||
|
encoded at half the sample rate of SBR, hence "dual rate". On the
|
||||||
|
other hand, downsampled SBR uses same sample rate for both of AAC
|
||||||
|
and SBR (single rate), therefore downsampled SBR typically consumes
|
||||||
|
more bitrate.
|
||||||
|
|
||||||
|
Downsampled SBR is newly introduced feature in FDK encoder library
|
||||||
|
version 3.4.12. When libfdk-aac in the system doesn't support this,
|
||||||
|
dual-rate SBR will be used. When available, dual-rate SBR is the
|
||||||
|
default for HE-AAC and downsampled SBR is the default for ELD+SBR.
|
||||||
|
|
||||||
|
Note that downsampled HE-AAC is not so common as dual-rate one. When
|
||||||
|
downsampled HE-AAC is selected, **fdkaac** is forced to choose
|
||||||
|
explicit hierarchical SBR signaling, which (at least) iTunes doesn't
|
||||||
|
accept.
|
||||||
|
|
||||||
|
-f, --transport-format \<n\>
|
||||||
|
: Transport format. Tagging and gapless playback is only available on
|
||||||
|
M4A. Streaming to stdout is only available on others.
|
||||||
|
|
||||||
|
0
|
||||||
|
: M4A (default)
|
||||||
|
|
||||||
|
1
|
||||||
|
: ADIF
|
||||||
|
|
||||||
|
2
|
||||||
|
: ADTS
|
||||||
|
|
||||||
|
6
|
||||||
|
: LATM MCP=1
|
||||||
|
|
||||||
|
7
|
||||||
|
: LATM MCP=0
|
||||||
|
|
||||||
|
10
|
||||||
|
: LOAS/LATM (LATM within LOAS)
|
||||||
|
|
||||||
|
-C, --adts-crc-check
|
||||||
|
: Add CRC protection on ADTS header.
|
||||||
|
|
||||||
|
-h, --header-period \<n\>
|
||||||
|
: StreamMuxConfig/PCE repetition period in the transport layer.
|
||||||
|
|
||||||
|
-G, --gapless-mode \<n\>
|
||||||
|
: Method to declare amount of encoder delay (and padding) in M4A
|
||||||
|
container. These values are mandatory for proper gapless playback on
|
||||||
|
player side.
|
||||||
|
|
||||||
|
0
|
||||||
|
: iTunSMPB (default)
|
||||||
|
|
||||||
|
1
|
||||||
|
: ISO standard (edts and sgpd)
|
||||||
|
|
||||||
|
2
|
||||||
|
: Both
|
||||||
|
|
||||||
|
--include-sbr-delay
|
||||||
|
: When specified, count SBR decoder delay in encoder delay.
|
||||||
|
|
||||||
|
This is not iTunes compatible and will lead to gapless playback
|
||||||
|
issue on LC only decoder, but this is the default behavior of FDK
|
||||||
|
library.
|
||||||
|
|
||||||
|
Whether counting SBR decoder delay in encoder delay or not result in
|
||||||
|
incompatibility in gapless playback. You should pick which one will
|
||||||
|
work for your favorite player.
|
||||||
|
|
||||||
|
However, it's better not to choose SBR at all if you want gapless
|
||||||
|
playback. LC doesn't have such issues.
|
||||||
|
|
||||||
|
-I, --ignorelength
|
||||||
|
: Ignore length field of data chunk in input WAV file.
|
||||||
|
|
||||||
|
-S, --silent
|
||||||
|
: Don't print progress messages.
|
||||||
|
|
||||||
|
--moov-before-mdat
|
||||||
|
: Place moov box before mdat box in M4A container. This option might
|
||||||
|
be important for some hardware players, that are known to refuse
|
||||||
|
moov box placed after mdat box.
|
||||||
|
|
||||||
|
-R, --raw
|
||||||
|
: Regard input as raw PCM.
|
||||||
|
|
||||||
|
--raw-channels \<n\>
|
||||||
|
: Specify number of channels of raw input (default: 2)
|
||||||
|
|
||||||
|
--raw-rate \<n\>
|
||||||
|
: Specify sample rate of raw input (default: 44100)
|
||||||
|
|
||||||
|
--raw-format \<spec\>
|
||||||
|
: Specify sample format of raw input (default: "S16L"). **Spec** is as
|
||||||
|
the following (case insensitive):
|
||||||
|
|
||||||
|
1st char -- type of sample
|
||||||
|
: **S** (igned) | **U** (nsigned) | **F** (loat)
|
||||||
|
|
||||||
|
2nd part (in digits)
|
||||||
|
: bits per channel
|
||||||
|
|
||||||
|
Last char -- endianness (can be omitted)
|
||||||
|
: **L** (ittle, default) | **B** (ig)
|
||||||
|
|
||||||
|
--title \<string\>
|
||||||
|
: Set title tag.
|
||||||
|
|
||||||
|
--artist \<string\>
|
||||||
|
: Set artist tag.
|
||||||
|
|
||||||
|
--album \<string\>
|
||||||
|
: Set album tag.
|
||||||
|
|
||||||
|
--genre \<string\>
|
||||||
|
: Set genre tag.
|
||||||
|
|
||||||
|
--date \<string\>
|
||||||
|
: Set date tag.
|
||||||
|
|
||||||
|
--composer \<string\>
|
||||||
|
: Set composer tag.
|
||||||
|
|
||||||
|
--grouping \<string\>
|
||||||
|
: Set grouping tag.
|
||||||
|
|
||||||
|
--comment \<string\>
|
||||||
|
: Set comment tag.
|
||||||
|
|
||||||
|
--album-artist \<string\>
|
||||||
|
: Set album artist tag.
|
||||||
|
|
||||||
|
--track \<number[/total]\>
|
||||||
|
: Set track tag, with or without number of total tracks.
|
||||||
|
|
||||||
|
--disk \<number[/total]\>
|
||||||
|
: Set disk tag, with or without number of total discs.
|
||||||
|
|
||||||
|
--tempo \<n\>
|
||||||
|
: Set tempo (BPM) tag.
|
||||||
|
|
||||||
|
--tag \<fcc\>:\<value\>
|
||||||
|
: Set iTunes predefined tag with explicit fourcc key and value. See
|
||||||
|
[https://code.google.com/p/mp4v2/wiki/iTunesMetadata](https://code.google.com/p/mp4v2/wiki/iTunesMetadata)
|
||||||
|
for known predefined keys. You can omit first char of **fcc** when
|
||||||
|
it is the copyright sign.
|
||||||
|
|
||||||
|
--tag-from-file \<fcc\>:\<filename\>
|
||||||
|
: Same as --tag, but set content of file as tag value.
|
||||||
|
|
||||||
|
--long-tag \<name\>:\<value\>
|
||||||
|
: Set arbitrary tag as iTunes custom metadata. Stored in
|
||||||
|
com.apple.iTunes field.
|
||||||
|
|
||||||
|
--tag-from-json \<filename[?dot\_notation]\>
|
||||||
|
: Read tags from JSON. By default, tags are assumed to be direct
|
||||||
|
children of the root object in JSON. Optionally you can specify
|
||||||
|
arbitrary dot notation to locate the object containing tags.
|
||||||
|
|
||||||
|
|
||||||
|
EXAMPLES
|
||||||
|
========
|
||||||
|
|
||||||
|
Encode WAV file into a M4A file. MPEG4 AAC LC, VBR quality 3:
|
||||||
|
|
||||||
|
fdkaac -m3 foo.wav
|
||||||
|
|
||||||
|
Encode WAV file into a M4A file. MPEG4 HE-AAC, bitrate 64kbps:
|
||||||
|
|
||||||
|
fdkaac -p5 -b64 foo.wav
|
||||||
|
|
||||||
|
Piping from **ffmpeg** (you need version supporting CAF output):
|
||||||
|
|
||||||
|
ffmpeg -i foo.flac -f caf - | fdkaac -b128 - -o foo.m4a
|
||||||
|
|
||||||
|
Import tags via json:
|
||||||
|
|
||||||
|
ffprobe -v 0 -of json -show_format foo.flac >foo.json
|
||||||
|
|
||||||
|
flac -dc foo.flac | \
|
||||||
|
fdkaac - -ox.m4a -m2 --import-tag-from-json=foo.json?format.tags
|
||||||
|
|
||||||
|
NOTES
|
||||||
|
=====
|
||||||
|
|
||||||
|
Upto 32bit integer or 64bit floating point format is supported as input.
|
||||||
|
However, FDK library is implemented based on fixed point math and only
|
||||||
|
supports 16bit integer PCM. Therefore, be wary of clipping. You might
|
||||||
|
want to dither/noise shape beforehand when your input has higher
|
||||||
|
resolution.
|
||||||
|
|
||||||
|
Following channel layouts are supported by the encoder.
|
||||||
|
|
||||||
|
1ch
|
||||||
|
: C
|
||||||
|
|
||||||
|
2ch
|
||||||
|
: L R
|
||||||
|
|
||||||
|
3ch
|
||||||
|
: C L R
|
||||||
|
|
||||||
|
4ch
|
||||||
|
: C L R Cs
|
||||||
|
|
||||||
|
5ch
|
||||||
|
: C L R Ls Rs
|
||||||
|
|
||||||
|
5.1ch
|
||||||
|
: C L R Ls Rs LFE
|
||||||
|
|
||||||
|
7.1ch (front)
|
||||||
|
: C Lc Rc L R Ls Rs LFE
|
||||||
|
|
||||||
|
7.1ch (rear)
|
||||||
|
: C L R Ls Rs Rls Rrs LFE
|
||||||
|
|
||||||
Note that not all tags can be read/written this way.
|
|
||||||
|
2
genman.sh
Executable file
2
genman.sh
Executable file
@ -0,0 +1,2 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
pandoc -s -f markdown -t man README >fdkaac.1 && mv -f fdkaac.1 man/fdkaac.1
|
@ -39,6 +39,6 @@ with Popen(GITLOG_CMD, shell=False, stdout=PIPE).stdout as pipe:
|
|||||||
commits = parse_gitlog(pipe)
|
commits = parse_gitlog(pipe)
|
||||||
commits_by_date_author = groupby(commits, key=lambda x: (x.date, x.author))
|
commits_by_date_author = groupby(commits, key=lambda x: (x.date, x.author))
|
||||||
for (date, author), commits in commits_by_date_author:
|
for (date, author), commits in commits_by_date_author:
|
||||||
output('{0} {1}\n\n'.format(date, author))
|
output(u'{0} {1}\n\n'.format(date, author).encode('utf-8'))
|
||||||
for c in commits:
|
for c in commits:
|
||||||
output(' * {0}{1}\n\n'.format(c.subject, c.ref))
|
output(u' * {0}{1}\n\n'.format(c.subject, c.ref).encode('utf-8'))
|
||||||
|
493
man/fdkaac.1
Normal file
493
man/fdkaac.1
Normal file
@ -0,0 +1,493 @@
|
|||||||
|
.TH FDKAAC 1 "November, 2013"
|
||||||
|
.SH NAME
|
||||||
|
.PP
|
||||||
|
fdkaac \- command line frontend for libfdk\-aac encoder
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.PP
|
||||||
|
\f[B]fdkaac\f[] [OPTIONS][FILE]
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.PP
|
||||||
|
\f[B]fdkaac\f[] reads linear PCM audio in either WAV, raw PCM, or CAF
|
||||||
|
format, and encodes it into either M4A / AAC file.
|
||||||
|
.PP
|
||||||
|
If the input file is "\-", data is read from stdin.
|
||||||
|
Likewise, if the output file is "\-", data is written to stdout if one
|
||||||
|
of streamable AAC transport formats are selected by \f[B]\-f\f[].
|
||||||
|
.PP
|
||||||
|
When CAF input and M4A output is used, tags in CAF file are copied into
|
||||||
|
the resulting M4A.
|
||||||
|
.SH OPTIONS
|
||||||
|
.TP
|
||||||
|
.B \-h, \-\-help
|
||||||
|
Show command help
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-o <FILE>
|
||||||
|
Output filename.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-p, \-\-profile <n>
|
||||||
|
Target profile (MPEG4 audio object type, AOT)
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 2
|
||||||
|
MPEG\-4 AAC LC (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 5
|
||||||
|
MPEG\-4 HE\-AAC (SBR)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 29
|
||||||
|
MPEG\-4 HE\-AAC v2 (SBR+PS)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 23
|
||||||
|
MPEG\-4 AAC LD
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 39
|
||||||
|
MPEG\-4 AAC ELD
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 129
|
||||||
|
MPEG\-2 AAC LC
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 132
|
||||||
|
MPEG\-2 HE\-AAC (SBR)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 156
|
||||||
|
MPEG\-2 HE\-AAC v2 (SBR+PS)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-b, \-\-bitrate <n>
|
||||||
|
Target bitrate (for CBR)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-m, \-\-bitrate\-mode <n>
|
||||||
|
Bitrate configuration mode.
|
||||||
|
Available VBR quality value depends on other parameters such as profile,
|
||||||
|
sample rate, or number of channels.
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 0
|
||||||
|
CBR (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 1\-5
|
||||||
|
VBR (higher value \-> higher bitrate)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-w, \-\-bandwidth <n>
|
||||||
|
Frequency bandwidth (lowpass cut\-off frequency) in Hz.
|
||||||
|
Available on AAC LC only.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-a, \-\-afterburner <n>
|
||||||
|
Configure afterburner mode.
|
||||||
|
When enabled, quality is increased at the expense of additional
|
||||||
|
computational workload.
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 0
|
||||||
|
Off
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 1
|
||||||
|
On (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-L, \-\-lowdelay\-sbr <n>
|
||||||
|
Configure SBR activity on AAC ELD.
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B \-1
|
||||||
|
Use ELD SBR auto configuration
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 0
|
||||||
|
Disable SBR on ELD (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 1
|
||||||
|
Enable SBR on ELD
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-s, \-\-sbr\-ratio <n>
|
||||||
|
Controls activation of downsampled SBR.
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 0
|
||||||
|
Use lib default (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 1
|
||||||
|
Use downsampled SBR (default for ELD+SBR)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 2
|
||||||
|
Use dual\-rate SBR (default for HE\-AAC)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
Dual\-rate SBR is what is normally used for HE\-AAC, where AAC is
|
||||||
|
encoded at half the sample rate of SBR, hence "dual rate".
|
||||||
|
On the other hand, downsampled SBR uses same sample rate for both of AAC
|
||||||
|
and SBR (single rate), therefore downsampled SBR typically consumes more
|
||||||
|
bitrate.
|
||||||
|
.PP
|
||||||
|
Downsampled SBR is newly introduced feature in FDK encoder library
|
||||||
|
version 3.4.12.
|
||||||
|
When libfdk\-aac in the system doesn\[aq]t support this, dual\-rate SBR
|
||||||
|
will be used.
|
||||||
|
When available, dual\-rate SBR is the default for HE\-AAC and
|
||||||
|
downsampled SBR is the default for ELD+SBR.
|
||||||
|
.PP
|
||||||
|
Note that downsampled HE\-AAC is not so common as dual\-rate one.
|
||||||
|
When downsampled HE\-AAC is selected, \f[B]fdkaac\f[] is forced to
|
||||||
|
choose explicit hierarchical SBR signaling, which (at least) iTunes
|
||||||
|
doesn\[aq]t accept.
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-f, \-\-transport\-format <n>
|
||||||
|
Transport format.
|
||||||
|
Tagging and gapless playback is only available on M4A.
|
||||||
|
Streaming to stdout is only available on others.
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 0
|
||||||
|
M4A (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 1
|
||||||
|
ADIF
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 2
|
||||||
|
ADTS
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 6
|
||||||
|
LATM MCP=1
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 7
|
||||||
|
LATM MCP=0
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 10
|
||||||
|
LOAS/LATM (LATM within LOAS)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-C, \-\-adts\-crc\-check
|
||||||
|
Add CRC protection on ADTS header.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-h, \-\-header\-period <n>
|
||||||
|
StreamMuxConfig/PCE repetition period in the transport layer.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-G, \-\-gapless\-mode <n>
|
||||||
|
Method to declare amount of encoder delay (and padding) in M4A
|
||||||
|
container.
|
||||||
|
These values are mandatory for proper gapless playback on player side.
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 0
|
||||||
|
iTunSMPB (default)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 1
|
||||||
|
ISO standard (edts and sgpd)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 2
|
||||||
|
Both
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-include\-sbr\-delay
|
||||||
|
When specified, count SBR decoder delay in encoder delay.
|
||||||
|
.RS
|
||||||
|
.PP
|
||||||
|
This is not iTunes compatible and will lead to gapless playback issue on
|
||||||
|
LC only decoder, but this is the default behavior of FDK library.
|
||||||
|
.PP
|
||||||
|
Whether counting SBR decoder delay in encoder delay or not result in
|
||||||
|
incompatibility in gapless playback.
|
||||||
|
You should pick which one will work for your favorite player.
|
||||||
|
.PP
|
||||||
|
However, it\[aq]s better not to choose SBR at all if you want gapless
|
||||||
|
playback.
|
||||||
|
LC doesn\[aq]t have such issues.
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-I, \-\-ignorelength
|
||||||
|
Ignore length field of data chunk in input WAV file.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-S, \-\-silent
|
||||||
|
Don\[aq]t print progress messages.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-moov\-before\-mdat
|
||||||
|
Place moov box before mdat box in M4A container.
|
||||||
|
This option might be important for some hardware players, that are known
|
||||||
|
to refuse moov box placed after mdat box.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-R, \-\-raw
|
||||||
|
Regard input as raw PCM.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-raw\-channels <n>
|
||||||
|
Specify number of channels of raw input (default: 2)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-raw\-rate <n>
|
||||||
|
Specify sample rate of raw input (default: 44100)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-raw\-format <spec>
|
||||||
|
Specify sample format of raw input (default: "S16L").
|
||||||
|
\f[B]Spec\f[] is as the following (case insensitive):
|
||||||
|
.RS
|
||||||
|
.TP
|
||||||
|
.B 1st char \-\- type of sample
|
||||||
|
\f[B]S\f[] (igned) | \f[B]U\f[] (nsigned) | \f[B]F\f[] (loat)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 2nd part (in digits)
|
||||||
|
bits per channel
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B Last char \-\- endianness (can be omitted)
|
||||||
|
\f[B]L\f[] (ittle, default) | \f[B]B\f[] (ig)
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-title <string>
|
||||||
|
Set title tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-artist <string>
|
||||||
|
Set artist tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-album <string>
|
||||||
|
Set album tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-genre <string>
|
||||||
|
Set genre tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-date <string>
|
||||||
|
Set date tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-composer <string>
|
||||||
|
Set composer tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-grouping <string>
|
||||||
|
Set grouping tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-comment <string>
|
||||||
|
Set comment tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-album\-artist <string>
|
||||||
|
Set album artist tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-track <number[/total]>
|
||||||
|
Set track tag, with or without number of total tracks.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-disk <number[/total]>
|
||||||
|
Set disk tag, with or without number of total discs.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-tempo <n>
|
||||||
|
Set tempo (BPM) tag.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-tag <fcc>:<value>
|
||||||
|
Set iTunes predefined tag with explicit fourcc key and value.
|
||||||
|
See <https://code.google.com/p/mp4v2/wiki/iTunesMetadata> for known
|
||||||
|
predefined keys.
|
||||||
|
You can omit first char of \f[B]fcc\f[] when it is the copyright sign.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-tag\-from\-file <fcc>:<filename>
|
||||||
|
Same as \-\-tag, but set content of file as tag value.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-long\-tag <name>:<value>
|
||||||
|
Set arbitrary tag as iTunes custom metadata.
|
||||||
|
Stored in com.apple.iTunes field.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B \-\-tag\-from\-json <filename[?dot_notation]>
|
||||||
|
Read tags from JSON.
|
||||||
|
By default, tags are assumed to be direct children of the root object in
|
||||||
|
JSON.
|
||||||
|
Optionally you can specify arbitrary dot notation to locate the object
|
||||||
|
containing tags.
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.SH EXAMPLES
|
||||||
|
.PP
|
||||||
|
Encode WAV file into a M4A file.
|
||||||
|
MPEG4 AAC LC, VBR quality 3:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
fdkaac\ \-m3\ foo.wav
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
|
.PP
|
||||||
|
Encode WAV file into a M4A file.
|
||||||
|
MPEG4 HE\-AAC, bitrate 64kbps:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
fdkaac\ \-p5\ \-b64\ foo.wav
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
|
.PP
|
||||||
|
Piping from \f[B]ffmpeg\f[] (you need version supporting CAF output):
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
ffmpeg\ \-i\ foo.flac\ \-f\ caf\ \-\ |\ fdkaac\ \-b128\ \-\ \-o\ foo.m4a
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
|
.PP
|
||||||
|
Import tags via json:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
ffprobe\ \-v\ 0\ \-of\ json\ \-show_format\ foo.flac\ >foo.json
|
||||||
|
|
||||||
|
flac\ \-dc\ foo.flac\ |\ \\
|
||||||
|
fdkaac\ \-\ \-ox.m4a\ \-m2\ \-\-import\-tag\-from\-json=foo.json?format.tags
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
|
.SH NOTES
|
||||||
|
.PP
|
||||||
|
Upto 32bit integer or 64bit floating point format is supported as input.
|
||||||
|
However, FDK library is implemented based on fixed point math and only
|
||||||
|
supports 16bit integer PCM.
|
||||||
|
Therefore, be wary of clipping.
|
||||||
|
You might want to dither/noise shape beforehand when your input has
|
||||||
|
higher resolution.
|
||||||
|
.PP
|
||||||
|
Following channel layouts are supported by the encoder.
|
||||||
|
.TP
|
||||||
|
.B 1ch
|
||||||
|
C
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 2ch
|
||||||
|
L R
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 3ch
|
||||||
|
C L R
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 4ch
|
||||||
|
C L R Cs
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 5ch
|
||||||
|
C L R Ls Rs
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 5.1ch
|
||||||
|
C L R Ls Rs LFE
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 7.1ch (front)
|
||||||
|
C Lc Rc L R Ls Rs LFE
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
.B 7.1ch (rear)
|
||||||
|
C L R Ls Rs Rls Rrs LFE
|
||||||
|
.RS
|
||||||
|
.RE
|
||||||
|
.SH AUTHORS
|
||||||
|
nu774 <honeycomb77@gmail.com>.
|
64
src/aacenc.c
64
src/aacenc.c
@ -64,70 +64,6 @@ void aacenc_get_lib_info(LIB_INFO *info)
|
|||||||
free(lib_info);
|
free(lib_info);
|
||||||
}
|
}
|
||||||
|
|
||||||
static const unsigned aacenc_sampling_freq_tab[] = {
|
|
||||||
96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050,
|
|
||||||
16000, 12000, 11025, 8000, 7350, 0, 0, 0
|
|
||||||
};
|
|
||||||
|
|
||||||
static
|
|
||||||
unsigned sampling_freq_index(unsigned rate)
|
|
||||||
{
|
|
||||||
unsigned i;
|
|
||||||
for (i = 0; aacenc_sampling_freq_tab[i]; ++i)
|
|
||||||
if (aacenc_sampling_freq_tab[i] == rate)
|
|
||||||
return i;
|
|
||||||
return 0xf;
|
|
||||||
}
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Append backward compatible SBR/PS signaling to implicit signaling ASC,
|
|
||||||
* if SBR/PS is present.
|
|
||||||
*/
|
|
||||||
int aacenc_mp4asc(const aacenc_param_t *params,
|
|
||||||
const uint8_t *asc, uint32_t ascsize,
|
|
||||||
uint8_t *outasc, uint32_t *outsize)
|
|
||||||
{
|
|
||||||
unsigned asc_sfreq = aacenc_sampling_freq_tab[(asc[0]&0x7)<<1 |asc[1]>>7];
|
|
||||||
unsigned shift = aacenc_is_dual_rate_sbr(params);
|
|
||||||
|
|
||||||
switch (params->profile) {
|
|
||||||
case AOT_SBR:
|
|
||||||
case AOT_PS:
|
|
||||||
if (!shift)
|
|
||||||
break;
|
|
||||||
if (*outsize < ascsize + 3)
|
|
||||||
return -1;
|
|
||||||
memcpy(outasc, asc, ascsize);
|
|
||||||
/* syncExtensionType:11 (value:0x2b7) */
|
|
||||||
outasc[ascsize+0] = 0x2b << 1;
|
|
||||||
outasc[ascsize+1] = 0x7 << 5;
|
|
||||||
/* extensionAudioObjectType:5 (value:5)*/
|
|
||||||
outasc[ascsize+1] |= 5;
|
|
||||||
/* sbrPresentFlag:1 (value:1) */
|
|
||||||
outasc[ascsize+2] = 0x80;
|
|
||||||
/* extensionSamplingFrequencyIndex:4 */
|
|
||||||
outasc[ascsize+2] |= sampling_freq_index(asc_sfreq << shift) << 3;
|
|
||||||
if (params->profile == AOT_SBR) {
|
|
||||||
*outsize = ascsize + 3;
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
if (*outsize < ascsize + 5)
|
|
||||||
return -1;
|
|
||||||
/* syncExtensionType:11 (value:0x548) */
|
|
||||||
outasc[ascsize+2] |= 0x5;
|
|
||||||
outasc[ascsize+3] = 0x48;
|
|
||||||
/* psPresentFlag:1 (value:1) */
|
|
||||||
outasc[ascsize+4] = 0x80;
|
|
||||||
*outsize = ascsize + 5;
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
if (*outsize < ascsize)
|
|
||||||
return -1;
|
|
||||||
memcpy(outasc, asc, ascsize);
|
|
||||||
*outsize = ascsize;
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
static
|
static
|
||||||
int aacenc_channel_mode(const pcm_sample_description_t *format)
|
int aacenc_channel_mode(const pcm_sample_description_t *format)
|
||||||
{
|
{
|
||||||
|
@ -38,10 +38,6 @@ int aacenc_is_dual_rate_sbr(const aacenc_param_t *params);
|
|||||||
|
|
||||||
void aacenc_get_lib_info(LIB_INFO *info);
|
void aacenc_get_lib_info(LIB_INFO *info);
|
||||||
|
|
||||||
int aacenc_mp4asc(const aacenc_param_t *params,
|
|
||||||
const uint8_t *asc, uint32_t ascsize,
|
|
||||||
uint8_t *outasc, uint32_t *outsize);
|
|
||||||
|
|
||||||
int aacenc_init(HANDLE_AACENCODER *encoder, const aacenc_param_t *params,
|
int aacenc_init(HANDLE_AACENCODER *encoder, const aacenc_param_t *params,
|
||||||
const pcm_sample_description_t *format,
|
const pcm_sample_description_t *format,
|
||||||
AACENC_InfoStruct *info);
|
AACENC_InfoStruct *info);
|
||||||
|
@ -225,6 +225,7 @@ pcm_reader_t *caf_open(pcm_io_context_t *io,
|
|||||||
memcpy(&reader->io, io, sizeof(pcm_io_context_t));
|
memcpy(&reader->io, io, sizeof(pcm_io_context_t));
|
||||||
reader->tag_callback = tag_callback;
|
reader->tag_callback = tag_callback;
|
||||||
reader->tag_ctx = tag_ctx;
|
reader->tag_ctx = tag_ctx;
|
||||||
|
memcpy(reader->chanmap, "\000\001\002\003\004\005\006\007", 8);
|
||||||
|
|
||||||
if (caf_parse(reader, &data_length) < 0) {
|
if (caf_parse(reader, &data_length) < 0) {
|
||||||
free(reader);
|
free(reader);
|
||||||
|
@ -157,7 +157,7 @@ int aacenc_fprintf(FILE *fp, const char *fmt, ...)
|
|||||||
codepage_decode_wchar(CP_UTF8, s, &ws);
|
codepage_decode_wchar(CP_UTF8, s, &ws);
|
||||||
free(s);
|
free(s);
|
||||||
fflush(fp);
|
fflush(fp);
|
||||||
WriteConsoleW(fh, ws, cnt, &nw, 0);
|
WriteConsoleW(fh, ws, wcslen(ws), &nw, 0);
|
||||||
free(ws);
|
free(ws);
|
||||||
}
|
}
|
||||||
return cnt;
|
return cnt;
|
||||||
|
25
src/main.c
25
src/main.c
@ -54,7 +54,8 @@ static void handle_signals(void)
|
|||||||
{
|
{
|
||||||
int i, sigs[] = { SIGINT, SIGHUP, SIGTERM };
|
int i, sigs[] = { SIGINT, SIGHUP, SIGTERM };
|
||||||
for (i = 0; i < sizeof(sigs)/sizeof(sigs[0]); ++i) {
|
for (i = 0; i < sizeof(sigs)/sizeof(sigs[0]); ++i) {
|
||||||
struct sigaction sa = { 0 };
|
struct sigaction sa;
|
||||||
|
memset(&sa, 0, sizeof sa);
|
||||||
sa.sa_handler = signal_handler;
|
sa.sa_handler = signal_handler;
|
||||||
sa.sa_flags |= SA_RESTART;
|
sa.sa_flags |= SA_RESTART;
|
||||||
sigaction(sigs[i], &sa, 0);
|
sigaction(sigs[i], &sa, 0);
|
||||||
@ -767,10 +768,8 @@ int main(int argc, char **argv)
|
|||||||
pcm_reader_t *reader = 0;
|
pcm_reader_t *reader = 0;
|
||||||
HANDLE_AACENCODER encoder = 0;
|
HANDLE_AACENCODER encoder = 0;
|
||||||
AACENC_InfoStruct aacinfo = { 0 };
|
AACENC_InfoStruct aacinfo = { 0 };
|
||||||
LIB_INFO lib_info = { 0 };
|
|
||||||
m4af_ctx_t *m4af = 0;
|
m4af_ctx_t *m4af = 0;
|
||||||
const pcm_sample_description_t *sample_format;
|
const pcm_sample_description_t *sample_format;
|
||||||
int downsampled_timescale = 0;
|
|
||||||
int frame_count = 0;
|
int frame_count = 0;
|
||||||
int sbr_mode = 0;
|
int sbr_mode = 0;
|
||||||
unsigned scale_shift = 0;
|
unsigned scale_shift = 0;
|
||||||
@ -786,15 +785,6 @@ int main(int argc, char **argv)
|
|||||||
|
|
||||||
sample_format = pcm_get_format(reader);
|
sample_format = pcm_get_format(reader);
|
||||||
|
|
||||||
/*
|
|
||||||
* We use explicit/hierarchical signaling for LOAS.
|
|
||||||
* Other than that, we request implicit signaling to FDK library, then
|
|
||||||
* append explicit/backward-compatible signaling to ASC in case of MP4FF.
|
|
||||||
*
|
|
||||||
* Explicit/backward-compatible signaling of SBR is the most recommended
|
|
||||||
* way in MPEG4 part3 spec, and seems the only way supported by iTunes.
|
|
||||||
* Since FDK library does not support it, we have to do it on our side.
|
|
||||||
*/
|
|
||||||
sbr_mode = aacenc_is_sbr_active((aacenc_param_t*)¶ms);
|
sbr_mode = aacenc_is_sbr_active((aacenc_param_t*)¶ms);
|
||||||
if (sbr_mode && !aacenc_is_sbr_ratio_available()) {
|
if (sbr_mode && !aacenc_is_sbr_ratio_available()) {
|
||||||
fprintf(stderr, "WARNING: Only dual-rate SBR is available "
|
fprintf(stderr, "WARNING: Only dual-rate SBR is available "
|
||||||
@ -802,7 +792,9 @@ int main(int argc, char **argv)
|
|||||||
params.sbr_ratio = 2;
|
params.sbr_ratio = 2;
|
||||||
}
|
}
|
||||||
scale_shift = aacenc_is_dual_rate_sbr((aacenc_param_t*)¶ms);
|
scale_shift = aacenc_is_dual_rate_sbr((aacenc_param_t*)¶ms);
|
||||||
params.sbr_signaling = (params.transport_format == TT_MP4_LOAS) ? 2 : 0;
|
params.sbr_signaling =
|
||||||
|
(params.transport_format == TT_MP4_LOAS) ? 2 :
|
||||||
|
(params.transport_format == TT_MP4_RAW) ? 1 : 0;
|
||||||
if (sbr_mode && !scale_shift)
|
if (sbr_mode && !scale_shift)
|
||||||
params.sbr_signaling = 2;
|
params.sbr_signaling = 2;
|
||||||
|
|
||||||
@ -825,16 +817,13 @@ int main(int argc, char **argv)
|
|||||||
|
|
||||||
if (!params.transport_format) {
|
if (!params.transport_format) {
|
||||||
uint32_t scale;
|
uint32_t scale;
|
||||||
uint8_t mp4asc[32];
|
|
||||||
uint32_t ascsize = sizeof(mp4asc);
|
|
||||||
unsigned framelen = aacinfo.frameLength;
|
unsigned framelen = aacinfo.frameLength;
|
||||||
scale = sample_format->sample_rate >> scale_shift;
|
scale = sample_format->sample_rate >> scale_shift;
|
||||||
if ((m4af = m4af_create(M4AF_CODEC_MP4A, scale, &m4af_io,
|
if ((m4af = m4af_create(M4AF_CODEC_MP4A, scale, &m4af_io,
|
||||||
params.output_fp)) < 0)
|
params.output_fp)) < 0)
|
||||||
goto END;
|
goto END;
|
||||||
aacenc_mp4asc((aacenc_param_t*)¶ms, aacinfo.confBuf,
|
m4af_set_decoder_specific_info(m4af, 0,
|
||||||
aacinfo.confSize, mp4asc, &ascsize);
|
aacinfo.confBuf, aacinfo.confSize);
|
||||||
m4af_set_decoder_specific_info(m4af, 0, mp4asc, ascsize);
|
|
||||||
m4af_set_fixed_frame_duration(m4af, 0,
|
m4af_set_fixed_frame_duration(m4af, 0,
|
||||||
framelen >> scale_shift);
|
framelen >> scale_shift);
|
||||||
m4af_set_vbr_mode(m4af, 0, params.bitrate_mode);
|
m4af_set_vbr_mode(m4af, 0, params.bitrate_mode);
|
||||||
|
@ -204,7 +204,7 @@ int apple_chan_chunk(pcm_io_context_t *io, uint32_t chunk_size,
|
|||||||
|
|
||||||
switch (mChannelLayoutTag) {
|
switch (mChannelLayoutTag) {
|
||||||
case kAudioChannelLayoutTag_UseChannelBitmap:
|
case kAudioChannelLayoutTag_UseChannelBitmap:
|
||||||
ENSURE(bitcount(mask) == nchannels);
|
ENSURE(bitcount(mChannelBitmap) == nchannels);
|
||||||
TRY_IO(pcm_skip(io, chunk_size - 12));
|
TRY_IO(pcm_skip(io, chunk_size - 12));
|
||||||
fmt->channel_mask = mChannelBitmap;
|
fmt->channel_mask = mChannelBitmap;
|
||||||
for (i = 0; i < nchannels; ++i)
|
for (i = 0; i < nchannels; ++i)
|
||||||
|
Reference in New Issue
Block a user