2 * Interface to libfaac for aac encoding
3 * Copyright (c) 2002 Gildas Bazin <gbazin@netcourrier.com>
5 * This file is part of Libav.
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * Interface to libfaac for aac encoding.
29 #include "libavutil/channel_layout.h"
30 #include "libavutil/common.h"
32 #include "audio_frame_queue.h"
36 /* libfaac has an encoder delay of 1024 samples */
37 #define FAAC_DELAY_SAMPLES 1024
39 typedef struct FaacAudioContext {
40 faacEncHandle faac_handle;
45 static av_cold int Faac_encode_close(AVCodecContext *avctx)
47 FaacAudioContext *s = avctx->priv_data;
49 av_freep(&avctx->extradata);
50 ff_af_queue_close(&s->afq);
53 faacEncClose(s->faac_handle);
58 static const int channel_maps[][6] = {
59 { 2, 0, 1 }, //< C L R
60 { 2, 0, 1, 3 }, //< C L R Cs
61 { 2, 0, 1, 3, 4 }, //< C L R Ls Rs
62 { 2, 0, 1, 4, 5, 3 }, //< C L R Ls Rs LFE
65 static av_cold int Faac_encode_init(AVCodecContext *avctx)
67 FaacAudioContext *s = avctx->priv_data;
68 faacEncConfigurationPtr faac_cfg;
69 unsigned long samples_input, max_bytes_output;
72 /* number of channels */
73 if (avctx->channels < 1 || avctx->channels > 6) {
74 av_log(avctx, AV_LOG_ERROR, "encoding %d channel(s) is not allowed\n", avctx->channels);
75 ret = AVERROR(EINVAL);
79 s->faac_handle = faacEncOpen(avctx->sample_rate,
81 &samples_input, &max_bytes_output);
82 if (!s->faac_handle) {
83 av_log(avctx, AV_LOG_ERROR, "error in faacEncOpen()\n");
84 ret = AVERROR_UNKNOWN;
88 /* check faac version */
89 faac_cfg = faacEncGetCurrentConfiguration(s->faac_handle);
90 if (faac_cfg->version != FAAC_CFG_VERSION) {
91 av_log(avctx, AV_LOG_ERROR, "wrong libfaac version (compiled for: %d, using %d)\n", FAAC_CFG_VERSION, faac_cfg->version);
92 ret = AVERROR(EINVAL);
96 /* put the options in the configuration struct */
97 switch(avctx->profile) {
98 case FF_PROFILE_AAC_MAIN:
99 faac_cfg->aacObjectType = MAIN;
101 case FF_PROFILE_UNKNOWN:
102 case FF_PROFILE_AAC_LOW:
103 faac_cfg->aacObjectType = LOW;
105 case FF_PROFILE_AAC_SSR:
106 faac_cfg->aacObjectType = SSR;
108 case FF_PROFILE_AAC_LTP:
109 faac_cfg->aacObjectType = LTP;
112 av_log(avctx, AV_LOG_ERROR, "invalid AAC profile\n");
113 ret = AVERROR(EINVAL);
116 faac_cfg->mpegVersion = MPEG4;
117 faac_cfg->useTns = 0;
118 faac_cfg->allowMidside = 1;
119 faac_cfg->bitRate = avctx->bit_rate / avctx->channels;
120 faac_cfg->bandWidth = avctx->cutoff;
121 if(avctx->flags & CODEC_FLAG_QSCALE) {
122 faac_cfg->bitRate = 0;
123 faac_cfg->quantqual = avctx->global_quality / FF_QP2LAMBDA;
125 faac_cfg->outputFormat = 1;
126 faac_cfg->inputFormat = FAAC_INPUT_16BIT;
127 if (avctx->channels > 2)
128 memcpy(faac_cfg->channel_map, channel_maps[avctx->channels-3],
129 avctx->channels * sizeof(int));
131 avctx->frame_size = samples_input / avctx->channels;
133 /* Set decoder specific info */
134 avctx->extradata_size = 0;
135 if (avctx->flags & CODEC_FLAG_GLOBAL_HEADER) {
137 unsigned char *buffer = NULL;
138 unsigned long decoder_specific_info_size;
140 if (!faacEncGetDecoderSpecificInfo(s->faac_handle, &buffer,
141 &decoder_specific_info_size)) {
142 avctx->extradata = av_malloc(decoder_specific_info_size + FF_INPUT_BUFFER_PADDING_SIZE);
143 if (!avctx->extradata) {
144 ret = AVERROR(ENOMEM);
147 avctx->extradata_size = decoder_specific_info_size;
148 memcpy(avctx->extradata, buffer, avctx->extradata_size);
149 faac_cfg->outputFormat = 0;
154 if (!faacEncSetConfiguration(s->faac_handle, faac_cfg)) {
155 av_log(avctx, AV_LOG_ERROR, "libfaac doesn't support this output format!\n");
156 ret = AVERROR(EINVAL);
160 avctx->delay = FAAC_DELAY_SAMPLES;
161 ff_af_queue_init(avctx, &s->afq);
165 Faac_encode_close(avctx);
169 static int Faac_encode_frame(AVCodecContext *avctx, AVPacket *avpkt,
170 const AVFrame *frame, int *got_packet_ptr)
172 FaacAudioContext *s = avctx->priv_data;
173 int bytes_written, ret;
174 int num_samples = frame ? frame->nb_samples : 0;
175 void *samples = frame ? frame->data[0] : NULL;
177 if ((ret = ff_alloc_packet(avpkt, (7 + 768) * avctx->channels))) {
178 av_log(avctx, AV_LOG_ERROR, "Error getting output packet\n");
182 bytes_written = faacEncEncode(s->faac_handle, samples,
183 num_samples * avctx->channels,
184 avpkt->data, avpkt->size);
185 if (bytes_written < 0) {
186 av_log(avctx, AV_LOG_ERROR, "faacEncEncode() error\n");
187 return bytes_written;
190 /* add current frame to the queue */
192 if ((ret = ff_af_queue_add(&s->afq, frame)) < 0)
199 /* Get the next frame pts/duration */
200 ff_af_queue_remove(&s->afq, avctx->frame_size, &avpkt->pts,
203 avpkt->size = bytes_written;
208 static const AVProfile profiles[] = {
209 { FF_PROFILE_AAC_MAIN, "Main" },
210 { FF_PROFILE_AAC_LOW, "LC" },
211 { FF_PROFILE_AAC_SSR, "SSR" },
212 { FF_PROFILE_AAC_LTP, "LTP" },
213 { FF_PROFILE_UNKNOWN },
216 static const uint64_t faac_channel_layouts[] = {
219 AV_CH_LAYOUT_SURROUND,
220 AV_CH_LAYOUT_4POINT0,
221 AV_CH_LAYOUT_5POINT0_BACK,
222 AV_CH_LAYOUT_5POINT1_BACK,
226 AVCodec ff_libfaac_encoder = {
228 .type = AVMEDIA_TYPE_AUDIO,
229 .id = AV_CODEC_ID_AAC,
230 .priv_data_size = sizeof(FaacAudioContext),
231 .init = Faac_encode_init,
232 .encode2 = Faac_encode_frame,
233 .close = Faac_encode_close,
234 .capabilities = CODEC_CAP_SMALL_LAST_FRAME | CODEC_CAP_DELAY,
235 .sample_fmts = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_S16,
236 AV_SAMPLE_FMT_NONE },
237 .long_name = NULL_IF_CONFIG_SMALL("libfaac AAC (Advanced Audio Coding)"),
238 .profiles = NULL_IF_CONFIG_SMALL(profiles),
239 .channel_layouts = faac_channel_layouts,