mirror of
https://github.com/mstorsjo/fdk-aac.git
synced 2025-02-18 04:00:36 +01:00
* AAC-Encoder - AAC-ELD core encoder audio quality tuning. Update tuning tables, configure bitreservoir size and adapt afterburner iteration value. Modified file(s): libAACenc/src/aacenc.h libAACenc/src/aacenc_lib.cpp libAACenc/src/adj_thr.cpp libAACenc/src/adj_thr.h libAACenc/src/adj_thr_data.h libAACenc/src/bandwidth.cpp libAACenc/src/pnsparam.cpp libAACenc/src/qc_main.cpp - Introduze dead zone quantizer for ELD to improve audio quality at certain configurations. Modified file(s): libAACenc/src/aacenc_lib.cpp libAACenc/src/adj_thr.cpp libAACenc/src/adj_thr.h libAACenc/src/qc_data.h libAACenc/src/qc_main.cpp libAACenc/src/quantize.cpp libAACenc/src/quantize.h libAACenc/src/sf_estim.cpp libAACenc/src/sf_estim.h - Revise TNS module to improve ELD audio quality. - Use new window function and separate prediction gain according TNS filters. - Add missing memory initilization to TNS configuration. Modified file(s): libAACenc/src/aacenc_lib.cpp libAACenc/src/aacenc_tns.cpp libAACenc/src/aacenc_tns.h libAACenc/src/psy_main.cpp libAACenc/src/tns_func.h * SBR-Encoder - Revise frequency resolution calculation and handle differently depending on number of envelopes and split frames decision. - Add and adjust ELD SBR tuning tables. Modified file(s): libSBRenc/include/sbr_encoder.h libSBRenc/src/bit_sbr.h libSBRenc/src/env_est.cpp libSBRenc/src/fram_gen.cpp libSBRenc/src/fram_gen.h libSBRenc/src/mh_det.cpp libSBRenc/src/sbr_def.h libSBRenc/src/sbr_encoder.cpp libSBRenc/src/sbr_rom.cpp libSBRenc/src/tran_det.cpp - Replace ELD transient detector with fast implementation. Modified file(s): libSBRenc/src/env_est.cpp libSBRenc/src/env_est.h libSBRenc/src/fram_gen.cpp libSBRenc/src/sbr_def.h libSBRenc/src/sbr_encoder.cpp libSBRenc/src/tran_det.cpp libSBRenc/src/tran_det.h * FDK-Library - Introduce generic compare function in tools library. Modified file(s): libFDK/include/fixpoint_math.h libFDK/src/FDK_core.cpp * SBR-Encoder - Revise ELD frame splitter to improve bit distribution. Modified file(s): libSBRenc/include/sbr_encoder.h libSBRenc/src/bit_sbr.h libSBRenc/src/env_est.cpp libSBRenc/src/fram_gen.cpp libSBRenc/src/fram_gen.h libSBRenc/src/sbr_encoder.cpp libSBRenc/src/tran_det.cpp libSBRenc/src/tran_det.h - Configure amplitude resolution according the tonality of the audio signal. Modified file(s): libSBRenc/include/sbr_encoder.h libSBRenc/src/bit_sbr.h libSBRenc/src/env_est.cpp libSBRenc/src/nf_est.cpp libSBRenc/src/nf_est.h libSBRenc/src/sbr_def.h libSBRenc/src/sbr_encoder.cpp libSBRenc/src/ton_corr.cpp libSBRenc/src/ton_corr.h libSBRenc/src/tran_det.cpp libSBRenc/src/tran_det.h Change-Id: Ie0672b989a06ee63b50240616b8d1d4b790b6cb2
204 lines
8.8 KiB
C
204 lines
8.8 KiB
C
|
|
/* -----------------------------------------------------------------------------------------------------------
|
|
Software License for The Fraunhofer FDK AAC Codec Library for Android
|
|
|
|
© Copyright 1995 - 2015 Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V.
|
|
All rights reserved.
|
|
|
|
1. INTRODUCTION
|
|
The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements
|
|
the MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio.
|
|
This FDK AAC Codec software is intended to be used on a wide variety of Android devices.
|
|
|
|
AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual
|
|
audio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by
|
|
independent studies and is widely deployed. AAC has been standardized by ISO and IEC as part
|
|
of the MPEG specifications.
|
|
|
|
Patent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer)
|
|
may be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners
|
|
individually for the purpose of encoding or decoding bit streams in products that are compliant with
|
|
the ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license
|
|
these patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec
|
|
software may already be covered under those patent licenses when it is used for those licensed purposes only.
|
|
|
|
Commercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality,
|
|
are also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional
|
|
applications information and documentation.
|
|
|
|
2. COPYRIGHT LICENSE
|
|
|
|
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."
|
|
|
|
3. NO PATENT LICENSE
|
|
|
|
NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer,
|
|
ARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with
|
|
respect to this software.
|
|
|
|
You may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized
|
|
by appropriate patent licenses.
|
|
|
|
4. DISCLAIMER
|
|
|
|
This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors
|
|
"AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties
|
|
of merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER 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), arising in any way out of the use of this software, even if
|
|
advised of the possibility of such damage.
|
|
|
|
5. CONTACT INFORMATION
|
|
|
|
Fraunhofer Institute for Integrated Circuits IIS
|
|
Attention: Audio and Multimedia Departments - FDK AAC LL
|
|
Am Wolfsmantel 33
|
|
91058 Erlangen, Germany
|
|
|
|
www.iis.fraunhofer.de/amm
|
|
amm-info@iis.fraunhofer.de
|
|
----------------------------------------------------------------------------------------------------------- */
|
|
|
|
/*!
|
|
\file
|
|
\brief Transient detector prototypes
|
|
*/
|
|
#ifndef __TRAN_DET_H
|
|
#define __TRAN_DET_H
|
|
|
|
#include "sbr_encoder.h"
|
|
#include "sbr_def.h"
|
|
|
|
typedef struct
|
|
{
|
|
FIXP_DBL transients[QMF_MAX_TIME_SLOTS+(QMF_MAX_TIME_SLOTS/2)];
|
|
FIXP_DBL thresholds[QMF_CHANNELS];
|
|
FIXP_DBL tran_thr; /* Master threshold for transient signals */
|
|
FIXP_DBL split_thr_m; /* Threshold for splitting FIXFIX-frames into 2 env */
|
|
INT split_thr_e; /* Scale for splitting threshold */
|
|
FIXP_DBL prevLowBandEnergy; /* Energy of low band */
|
|
FIXP_DBL prevHighBandEnergy; /* Energy of high band */
|
|
INT tran_fc; /* Number of lowband subbands to discard */
|
|
INT no_cols;
|
|
INT no_rows;
|
|
INT mode;
|
|
|
|
int frameShift;
|
|
int tran_off; /* Offset for reading energy values. */
|
|
}
|
|
SBR_TRANSIENT_DETECTOR;
|
|
|
|
|
|
typedef SBR_TRANSIENT_DETECTOR *HANDLE_SBR_TRANSIENT_DETECTOR;
|
|
|
|
#define TRAN_DET_LOOKAHEAD 2
|
|
#define TRAN_DET_START_FREQ 4500 /*start frequency for transient detection*/
|
|
#define TRAN_DET_STOP_FREQ 13500 /*stop frequency for transient detection*/
|
|
#define TRAN_DET_MIN_QMFBANDS 4 /* minimum qmf bands for transient detection */
|
|
#define QMF_HP_dBd_SLOPE_FIX FL2FXCONST_DBL(0.00075275f) /* 0.002266f/10 * log2(10) */
|
|
#define TRAN_DET_THRSHLD FL2FXCONST_DBL(3.2f/4.f)
|
|
#define TRAN_DET_THRSHLD_SCALE (2)
|
|
|
|
typedef struct
|
|
{
|
|
INT transientCandidates[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
INT nTimeSlots;
|
|
INT lookahead;
|
|
INT startBand;
|
|
INT stopBand;
|
|
|
|
FIXP_DBL dBf_m[QMF_CHANNELS];
|
|
INT dBf_e[QMF_CHANNELS];
|
|
|
|
FIXP_DBL energy_timeSlots[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
INT energy_timeSlots_scale[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
|
|
FIXP_DBL delta_energy[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
INT delta_energy_scale[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
|
|
FIXP_DBL lowpass_energy[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
INT lowpass_energy_scale[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
|
|
#if defined (FTD_LOG)
|
|
FDKFILE *ftd_log;
|
|
#endif
|
|
}
|
|
FAST_TRAN_DETECTOR;
|
|
typedef FAST_TRAN_DETECTOR *HANDLE_FAST_TRAN_DET;
|
|
|
|
|
|
INT FDKsbrEnc_InitSbrFastTransientDetector(
|
|
HANDLE_FAST_TRAN_DET h_sbrFastTransientDetector,
|
|
const INT time_slots_per_frame,
|
|
const INT bandwidth_qmf_slot,
|
|
const INT no_qmf_channels,
|
|
const INT sbr_qmf_1st_band
|
|
);
|
|
|
|
void FDKsbrEnc_fastTransientDetect(
|
|
const HANDLE_FAST_TRAN_DET h_sbrFastTransientDetector,
|
|
const FIXP_DBL *const *Energies,
|
|
const int *const scaleEnergies,
|
|
const INT YBufferWriteOffset,
|
|
UCHAR *const tran_vector
|
|
);
|
|
|
|
void
|
|
FDKsbrEnc_transientDetect(HANDLE_SBR_TRANSIENT_DETECTOR h_sbrTransientDetector,
|
|
FIXP_DBL **Energies,
|
|
INT *scaleEnergies,
|
|
UCHAR *tran_vector,
|
|
int YBufferWriteOffset,
|
|
int YBufferSzShift,
|
|
int timeStep,
|
|
int frameMiddleBorder);
|
|
|
|
int
|
|
FDKsbrEnc_InitSbrTransientDetector (HANDLE_SBR_TRANSIENT_DETECTOR h_sbrTransientDetector,
|
|
UINT sbrSyntaxFlags, /* SBR syntax flags derived from AOT. */
|
|
INT frameSize,
|
|
INT sampleFreq,
|
|
sbrConfigurationPtr params,
|
|
int tran_fc,
|
|
int no_cols,
|
|
int no_rows,
|
|
int YBufferWriteOffset,
|
|
int YBufferSzShift,
|
|
int frameShift,
|
|
int tran_off);
|
|
|
|
void
|
|
FDKsbrEnc_frameSplitter(FIXP_DBL **Energies,
|
|
INT *scaleEnergies,
|
|
HANDLE_SBR_TRANSIENT_DETECTOR h_sbrTransientDetector,
|
|
UCHAR *freqBandTable,
|
|
UCHAR *tran_vector,
|
|
int YBufferWriteOffset,
|
|
int YBufferSzShift,
|
|
int nSfb,
|
|
int timeStep,
|
|
int no_cols,
|
|
FIXP_DBL* tonality);
|
|
#endif
|