TODO: bump minor It's inferior in quality to fdk-aac and has an arguably more problematic license. As early as 2012, a HydrogenAudio user reported: > It has however one huge advantage: much better quality at low bitrates than > faac and libaacplus. (https://hydrogenaud.io/index.php?PHPSESSID=ckiq394pdglka0kj2fin6ij8t7&topic=95989.msg804633#msg804633) I myself have made a few spectrograms for a comparison of the two encoders as well. The FDK output is consistently better than the libaacplus one, in all bitrates I tested. libaacplus license is 3GPP + LGPLv2. 3GPP copyright notice is completely proprietory, as follows: > No part may be reproduced except as authorized by written permission. > > The copyright and the foregoing restriction extend to reproduction in > all media. > > © 2008, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC). > > All rights reserved. (The latest 26410-d00 zip from 3GPP has the same notice, but the copyright year is changed to 2015) The copyright part of the FDK AAC license (section 2) is a copyleft license that permits redistribution under certain conditions (and therefore the LGPL + libfdk-aac combination is not prohibited by configure): > Redistribution and use in source and binary forms, with or without > modification, are permitted without payment of copyright license fees > provided that you satisfy the following conditions: > > You must retain the complete text of this software license in > redistributions of the FDK AAC Codec or your modifications thereto in > source code form. > > You must retain the complete text of this software license in the > documentation and/or other materials provided with redistributions of > the FDK AAC Codec or your modifications thereto in binary form. > > You must make available free of charge copies of the complete source > code of the FDK AAC Codec and your modifications thereto to recipients > of copies in binary form. > > The name of Fraunhofer may not be used to endorse or promote products > derived from this library without prior written permission. > > You may not charge copyright license fees for anyone to use, copy or > distribute the FDK AAC Codec software or your modifications thereto. > > Your modified versions of the FDK AAC Codec must carry prominent > notices stating that you changed the software and the date of any > change. For modified versions of the FDK AAC Codec, the term > "Fraunhofer FDK AAC Codec Library for Android" must be replaced by the > term "Third-Party Modified Version of the Fraunhofer FDK AAC Codec > Library for Android."tags/n3.0
| @@ -60,6 +60,7 @@ version <next>: | |||||
| - convolution filter | - convolution filter | ||||
| - libquvi support removed | - libquvi support removed | ||||
| - support for dvaudio in wav and avi | - support for dvaudio in wav and avi | ||||
| - libaacplus support removed | |||||
| version 2.8: | version 2.8: | ||||
| @@ -104,7 +104,7 @@ license version needs to be upgraded by passing `--enable-version3` to configure | |||||
| incompatible libraries | incompatible libraries | ||||
| ---------------------- | ---------------------- | ||||
| The Fraunhofer AAC library, FAAC and aacplus are under licenses which | |||||
| The Fraunhofer AAC library and FAAC are under licenses which | |||||
| are incompatible with the GPLv2 and v3. We do not know for certain if their | are incompatible with the GPLv2 and v3. We do not know for certain if their | ||||
| licenses are compatible with the LGPL. | licenses are compatible with the LGPL. | ||||
| If you wish to enable these libraries, pass `--enable-nonfree` to configure. | If you wish to enable these libraries, pass `--enable-nonfree` to configure. | ||||
| @@ -207,7 +207,6 @@ External library support: | |||||
| if openssl is not used [no] | if openssl is not used [no] | ||||
| --disable-iconv disable iconv [autodetect] | --disable-iconv disable iconv [autodetect] | ||||
| --enable-ladspa enable LADSPA audio filtering [no] | --enable-ladspa enable LADSPA audio filtering [no] | ||||
| --enable-libaacplus enable AAC+ encoding via libaacplus [no] | |||||
| --enable-libass enable libass subtitles rendering, | --enable-libass enable libass subtitles rendering, | ||||
| needed for subtitles and ass filter [no] | needed for subtitles and ass filter [no] | ||||
| --enable-libbluray enable BluRay reading using libbluray [no] | --enable-libbluray enable BluRay reading using libbluray [no] | ||||
| @@ -1435,7 +1434,6 @@ EXTERNAL_LIBRARY_LIST=" | |||||
| gnutls | gnutls | ||||
| iconv | iconv | ||||
| ladspa | ladspa | ||||
| libaacplus | |||||
| libass | libass | ||||
| libbluray | libbluray | ||||
| libbs2b | libbs2b | ||||
| @@ -2604,7 +2602,6 @@ mjpeg2jpeg_bsf_select="jpegtables" | |||||
| # external libraries | # external libraries | ||||
| chromaprint_muxer_deps="chromaprint" | chromaprint_muxer_deps="chromaprint" | ||||
| libaacplus_encoder_deps="libaacplus" | |||||
| libcelt_decoder_deps="libcelt" | libcelt_decoder_deps="libcelt" | ||||
| libdcadec_decoder_deps="libdcadec" | libdcadec_decoder_deps="libdcadec" | ||||
| libfaac_encoder_deps="libfaac" | libfaac_encoder_deps="libfaac" | ||||
| @@ -4888,7 +4885,6 @@ die_license_disabled gpl libxavs | |||||
| die_license_disabled gpl libxvid | die_license_disabled gpl libxvid | ||||
| die_license_disabled gpl x11grab | die_license_disabled gpl x11grab | ||||
| die_license_disabled nonfree libaacplus | |||||
| die_license_disabled nonfree libfaac | die_license_disabled nonfree libfaac | ||||
| die_license_disabled nonfree nvenc | die_license_disabled nonfree nvenc | ||||
| enabled gpl && die_license_disabled_gpl nonfree libfdk_aac | enabled gpl && die_license_disabled_gpl nonfree libfdk_aac | ||||
| @@ -5464,7 +5460,6 @@ enabled gmp && require2 gmp gmp.h mpz_export -lgmp | |||||
| enabled gnutls && require_pkg_config gnutls gnutls/gnutls.h gnutls_global_init | enabled gnutls && require_pkg_config gnutls gnutls/gnutls.h gnutls_global_init | ||||
| enabled ladspa && { check_header ladspa.h || die "ERROR: ladspa.h header not found"; } | enabled ladspa && { check_header ladspa.h || die "ERROR: ladspa.h header not found"; } | ||||
| enabled libiec61883 && require libiec61883 libiec61883/iec61883.h iec61883_cmp_connect -lraw1394 -lavc1394 -lrom1394 -liec61883 | enabled libiec61883 && require libiec61883 libiec61883/iec61883.h iec61883_cmp_connect -lraw1394 -lavc1394 -lrom1394 -liec61883 | ||||
| enabled libaacplus && require "libaacplus >= 2.0.0" aacplus.h aacplusEncOpen -laacplus | |||||
| enabled libass && require_pkg_config libass ass/ass.h ass_library_init | enabled libass && require_pkg_config libass ass/ass.h ass_library_init | ||||
| enabled libbluray && require_pkg_config libbluray libbluray/bluray.h bd_open | enabled libbluray && require_pkg_config libbluray libbluray/bluray.h bd_open | ||||
| enabled libbs2b && require_pkg_config libbs2b bs2b.h bs2b_open | enabled libbs2b && require_pkg_config libbs2b bs2b.h bs2b_open | ||||
| @@ -881,10 +881,10 @@ following image formats are supported: | |||||
| @item Name @tab Encoding @tab Decoding @tab Comments | @item Name @tab Encoding @tab Decoding @tab Comments | ||||
| @item 8SVX exponential @tab @tab X | @item 8SVX exponential @tab @tab X | ||||
| @item 8SVX fibonacci @tab @tab X | @item 8SVX fibonacci @tab @tab X | ||||
| @item AAC+ @tab E @tab IX | |||||
| @tab encoding supported through external library libaacplus | |||||
| @item AAC @tab E @tab X | @item AAC @tab E @tab X | ||||
| @tab encoding supported through external library libfaac and libvo-aacenc | |||||
| @tab encoding supported through external library libfaac, libfdk-aac and libvo-aacenc | |||||
| @item AAC+ @tab E @tab IX | |||||
| @tab encoding supported through external library libfdk-aac | |||||
| @item AC-3 @tab IX @tab IX | @item AC-3 @tab IX @tab IX | ||||
| @item ADPCM 4X Movie @tab @tab X | @item ADPCM 4X Movie @tab @tab X | ||||
| @item APDCM Yamaha AICA @tab @tab X | @item APDCM Yamaha AICA @tab @tab X | ||||
| @@ -314,7 +314,7 @@ These library packages are only available from | |||||
| @uref{http://sourceware.org/cygwinports/, Cygwin Ports}: | @uref{http://sourceware.org/cygwinports/, Cygwin Ports}: | ||||
| @example | @example | ||||
| yasm, libSDL-devel, libfaac-devel, libaacplus-devel, libgsm-devel, libmp3lame-devel, | |||||
| yasm, libSDL-devel, libfaac-devel, libgsm-devel, libmp3lame-devel, | |||||
| libschroedinger1.0-devel, speex-devel, libtheora-devel, libxvidcore-devel | libschroedinger1.0-devel, speex-devel, libtheora-devel, libxvidcore-devel | ||||
| @end example | @end example | ||||
| @@ -798,7 +798,6 @@ OBJS-$(CONFIG_WTV_DEMUXER) += mpeg4audio.o mpegaudiodata.o | |||||
| OBJS-$(CONFIG_ELBG_FILTER) += elbg.o | OBJS-$(CONFIG_ELBG_FILTER) += elbg.o | ||||
| # external codec libraries | # external codec libraries | ||||
| OBJS-$(CONFIG_LIBAACPLUS_ENCODER) += libaacplus.o | |||||
| OBJS-$(CONFIG_LIBCELT_DECODER) += libcelt_dec.o | OBJS-$(CONFIG_LIBCELT_DECODER) += libcelt_dec.o | ||||
| OBJS-$(CONFIG_LIBDCADEC_DECODER) += libdcadec.o dca.o | OBJS-$(CONFIG_LIBDCADEC_DECODER) += libdcadec.o dca.o | ||||
| OBJS-$(CONFIG_LIBFAAC_ENCODER) += libfaac.o | OBJS-$(CONFIG_LIBFAAC_ENCODER) += libfaac.o | ||||
| @@ -593,7 +593,6 @@ void avcodec_register_all(void) | |||||
| REGISTER_ENCODER(LIBXAVS, libxavs); | REGISTER_ENCODER(LIBXAVS, libxavs); | ||||
| REGISTER_ENCODER(LIBXVID, libxvid); | REGISTER_ENCODER(LIBXVID, libxvid); | ||||
| REGISTER_DECODER(LIBZVBI_TELETEXT, libzvbi_teletext); | REGISTER_DECODER(LIBZVBI_TELETEXT, libzvbi_teletext); | ||||
| REGISTER_ENCODER(LIBAACPLUS, libaacplus); | |||||
| /* text */ | /* text */ | ||||
| REGISTER_DECODER(BINTEXT, bintext); | REGISTER_DECODER(BINTEXT, bintext); | ||||
| @@ -1,150 +0,0 @@ | |||||
| /* | |||||
| * Interface to libaacplus for aac+ (sbr+ps) encoding | |||||
| * Copyright (c) 2010 tipok <piratfm@gmail.com> | |||||
| * | |||||
| * This file is part of FFmpeg. | |||||
| * | |||||
| * FFmpeg is free software; you can redistribute it and/or | |||||
| * modify it under the terms of the GNU Lesser General Public | |||||
| * License as published by the Free Software Foundation; either | |||||
| * version 2.1 of the License, or (at your option) any later version. | |||||
| * | |||||
| * FFmpeg is distributed in the hope that it will be useful, | |||||
| * but WITHOUT ANY WARRANTY; without even the implied warranty of | |||||
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |||||
| * Lesser General Public License for more details. | |||||
| * | |||||
| * You should have received a copy of the GNU Lesser General Public | |||||
| * License along with FFmpeg; if not, write to the Free Software | |||||
| * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | |||||
| */ | |||||
| /** | |||||
| * @file | |||||
| * Interface to libaacplus for aac+ (sbr+ps) encoding. | |||||
| */ | |||||
| #include <aacplus.h> | |||||
| #include "avcodec.h" | |||||
| #include "internal.h" | |||||
| typedef struct aacPlusAudioContext { | |||||
| aacplusEncHandle aacplus_handle; | |||||
| unsigned long max_output_bytes; | |||||
| unsigned long samples_input; | |||||
| } aacPlusAudioContext; | |||||
| static int aacPlus_encode_close(AVCodecContext *avctx); | |||||
| static av_cold int aacPlus_encode_init(AVCodecContext *avctx) | |||||
| { | |||||
| aacPlusAudioContext *s = avctx->priv_data; | |||||
| aacplusEncConfiguration *aacplus_cfg; | |||||
| /* number of channels */ | |||||
| if (avctx->channels < 1 || avctx->channels > 2) { | |||||
| av_log(avctx, AV_LOG_ERROR, "encoding %d channel(s) is not allowed\n", avctx->channels); | |||||
| return AVERROR(EINVAL); | |||||
| } | |||||
| if (avctx->profile != FF_PROFILE_AAC_LOW && avctx->profile != FF_PROFILE_UNKNOWN) { | |||||
| av_log(avctx, AV_LOG_ERROR, "invalid AAC profile: %d, only LC supported\n", avctx->profile); | |||||
| return AVERROR(EINVAL); | |||||
| } | |||||
| s->aacplus_handle = aacplusEncOpen(avctx->sample_rate, avctx->channels, | |||||
| &s->samples_input, &s->max_output_bytes); | |||||
| if (!s->aacplus_handle) { | |||||
| av_log(avctx, AV_LOG_ERROR, "can't open encoder\n"); | |||||
| return AVERROR(EINVAL); | |||||
| } | |||||
| /* check aacplus version */ | |||||
| aacplus_cfg = aacplusEncGetCurrentConfiguration(s->aacplus_handle); | |||||
| aacplus_cfg->bitRate = avctx->bit_rate; | |||||
| aacplus_cfg->bandWidth = avctx->cutoff; | |||||
| aacplus_cfg->outputFormat = !(avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER); | |||||
| aacplus_cfg->inputFormat = avctx->sample_fmt == AV_SAMPLE_FMT_FLT ? AACPLUS_INPUT_FLOAT : AACPLUS_INPUT_16BIT; | |||||
| if (!aacplusEncSetConfiguration(s->aacplus_handle, aacplus_cfg)) { | |||||
| av_log(avctx, AV_LOG_ERROR, "libaacplus doesn't support this output format!\n"); | |||||
| aacPlus_encode_close(avctx); | |||||
| return AVERROR(EINVAL); | |||||
| } | |||||
| avctx->frame_size = s->samples_input / avctx->channels; | |||||
| /* Set decoder specific info */ | |||||
| avctx->extradata_size = 0; | |||||
| if (avctx->flags & AV_CODEC_FLAG_GLOBAL_HEADER) { | |||||
| unsigned char *buffer = NULL; | |||||
| unsigned long decoder_specific_info_size; | |||||
| if (aacplusEncGetDecoderSpecificInfo(s->aacplus_handle, &buffer, | |||||
| &decoder_specific_info_size) == 1) { | |||||
| avctx->extradata = av_malloc(decoder_specific_info_size + AV_INPUT_BUFFER_PADDING_SIZE); | |||||
| if (!avctx->extradata) { | |||||
| free(buffer); | |||||
| aacPlus_encode_close(avctx); | |||||
| return AVERROR(ENOMEM); | |||||
| } | |||||
| avctx->extradata_size = decoder_specific_info_size; | |||||
| memcpy(avctx->extradata, buffer, avctx->extradata_size); | |||||
| } | |||||
| free(buffer); | |||||
| } | |||||
| return 0; | |||||
| } | |||||
| static int aacPlus_encode_frame(AVCodecContext *avctx, AVPacket *pkt, | |||||
| const AVFrame *frame, int *got_packet) | |||||
| { | |||||
| aacPlusAudioContext *s = avctx->priv_data; | |||||
| int32_t *input_buffer = (int32_t *)frame->data[0]; | |||||
| int ret; | |||||
| if ((ret = ff_alloc_packet2(avctx, pkt, s->max_output_bytes, 0)) < 0) | |||||
| return ret; | |||||
| pkt->size = aacplusEncEncode(s->aacplus_handle, input_buffer, | |||||
| s->samples_input, pkt->data, pkt->size); | |||||
| *got_packet = 1; | |||||
| pkt->pts = frame->pts; | |||||
| return 0; | |||||
| } | |||||
| static av_cold int aacPlus_encode_close(AVCodecContext *avctx) | |||||
| { | |||||
| aacPlusAudioContext *s = avctx->priv_data; | |||||
| av_freep(&avctx->extradata); | |||||
| aacplusEncClose(s->aacplus_handle); | |||||
| s->aacplus_handle = NULL; | |||||
| return 0; | |||||
| } | |||||
| static const AVProfile profiles[] = { | |||||
| { FF_PROFILE_AAC_LOW, "LC" }, | |||||
| { FF_PROFILE_UNKNOWN }, | |||||
| }; | |||||
| AVCodec ff_libaacplus_encoder = { | |||||
| .name = "libaacplus", | |||||
| .long_name = NULL_IF_CONFIG_SMALL("libaacplus AAC+ (Advanced Audio Codec with SBR+PS)"), | |||||
| .type = AVMEDIA_TYPE_AUDIO, | |||||
| .id = AV_CODEC_ID_AAC, | |||||
| .priv_data_size = sizeof(aacPlusAudioContext), | |||||
| .init = aacPlus_encode_init, | |||||
| .encode2 = aacPlus_encode_frame, | |||||
| .close = aacPlus_encode_close, | |||||
| .sample_fmts = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_S16, | |||||
| AV_SAMPLE_FMT_FLT, | |||||
| AV_SAMPLE_FMT_NONE }, | |||||
| .profiles = profiles, | |||||
| .channel_layouts = (const uint64_t[]) { AV_CH_LAYOUT_MONO, | |||||
| AV_CH_LAYOUT_STEREO, | |||||
| 0 }, | |||||
| }; | |||||