FFmpeg
ac3enc_fixed.c
Go to the documentation of this file.
1 /*
2  * The simplest AC-3 encoder
3  * Copyright (c) 2000 Fabrice Bellard
4  * Copyright (c) 2006-2010 Justin Ruggles <justin.ruggles@gmail.com>
5  * Copyright (c) 2006-2010 Prakash Punnoor <prakash@punnoor.de>
6  *
7  * This file is part of FFmpeg.
8  *
9  * FFmpeg is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * FFmpeg is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with FFmpeg; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  */
23 
24 /**
25  * @file
26  * fixed-point AC-3 encoder.
27  */
28 
29 #define AC3ENC_FLOAT 0
30 #define FFT_FLOAT 0
31 #include "audiodsp.h"
32 #include "ac3enc.h"
33 #include "codec_internal.h"
34 #include "eac3enc.h"
35 #include "kbdwin.h"
36 
37 static void sum_square_butterfly(AC3EncodeContext *s, int64_t sum[4],
38  const int32_t *coef0, const int32_t *coef1,
39  int len)
40 {
41  s->ac3dsp.sum_square_butterfly_int32(sum, coef0, coef1, len);
42 }
43 
44 /*
45  * Clip MDCT coefficients to allowable range.
46  */
48  unsigned int len)
49 {
50  adsp->vector_clip_int32(coef, coef, COEF_MIN, COEF_MAX, len);
51 }
52 
53 
54 /*
55  * Calculate a single coupling coordinate.
56  */
57 static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
58 {
59  if (energy_cpl <= COEF_MAX) {
60  return 1048576;
61  } else {
62  uint64_t coord = energy_ch / (energy_cpl >> 24);
63  uint32_t coord32 = FFMIN(coord, 1073741824);
64  coord32 = ff_sqrt(coord32) << 9;
65  return FFMIN(coord32, COEF_MAX);
66  }
67 }
68 
69 
70 #include "ac3enc_template.c"
71 
72 
73 /**
74  * Finalize MDCT and free allocated memory.
75  *
76  * @param s AC-3 encoder private context
77  */
79 {
80  ff_mdct_end(&s->mdct);
81 }
82 
83 /**
84  * Initialize MDCT tables.
85  *
86  * @param s AC-3 encoder private context
87  * @return 0 on success, negative error code on failure
88  */
90 {
91  float fwin[AC3_BLOCK_SIZE];
92 
93  int32_t *iwin = av_malloc_array(AC3_BLOCK_SIZE, sizeof(*iwin));
94  if (!iwin)
95  return AVERROR(ENOMEM);
96 
98  for (int i = 0; i < AC3_BLOCK_SIZE; i++)
99  iwin[i] = lrintf(fwin[i] * (1 << 22));
100 
101  s->mdct_window = iwin;
102 
103  s->fdsp = avpriv_alloc_fixed_dsp(s->avctx->flags & AV_CODEC_FLAG_BITEXACT);
104  if (!s->fdsp)
105  return AVERROR(ENOMEM);
106 
107  return ff_mdct_init(&s->mdct, 9, 0, -1.0);
108 }
109 
110 
112 {
114  s->fixed_point = 1;
115  s->mdct_end = ac3_fixed_mdct_end;
116  s->mdct_init = ac3_fixed_mdct_init;
117  s->allocate_sample_buffers = allocate_sample_buffers;
118  return ff_ac3_encode_init(avctx);
119 }
120 
121 
124  .p.name = "ac3_fixed",
125  .p.long_name = NULL_IF_CONFIG_SMALL("ATSC A/52A (AC-3)"),
126  .p.type = AVMEDIA_TYPE_AUDIO,
127  .p.id = AV_CODEC_ID_AC3,
128  .p.capabilities = AV_CODEC_CAP_DR1,
129  .priv_data_size = sizeof(AC3EncodeContext),
132  .close = ff_ac3_encode_close,
133  .p.sample_fmts = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_S32P,
135  .p.priv_class = &ff_ac3enc_class,
137  .p.supported_samplerates = ff_ac3_sample_rate_tab,
138 #if FF_API_OLD_CHANNEL_LAYOUT
139  .p.channel_layouts = ff_ac3_channel_layouts,
140 #endif
141  .p.ch_layouts = ff_ac3_ch_layouts,
142  .defaults = ff_ac3_enc_defaults,
143 };
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:83
AV_CODEC_ID_AC3
@ AV_CODEC_ID_AC3
Definition: codec_id.h:430
FF_CODEC_CAP_INIT_CLEANUP
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
Definition: codec_internal.h:39
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
COEF_MAX
#define COEF_MAX
Definition: ac3enc.h:64
AV_SAMPLE_FMT_S32P
@ AV_SAMPLE_FMT_S32P
signed 32 bits, planar
Definition: samplefmt.h:65
ff_mdct_init
#define ff_mdct_init
Definition: fft.h:153
FFCodec
Definition: codec_internal.h:112
ac3_fixed_mdct_init
static av_cold int ac3_fixed_mdct_init(AC3EncodeContext *s)
Initialize MDCT tables.
Definition: ac3enc_fixed.c:89
allocate_sample_buffers
static int allocate_sample_buffers(AC3EncodeContext *s)
Definition: ac3enc_template.c:42
ff_ac3_fixed_encoder
const FF_DISABLE_DEPRECATION_WARNINGS FFCodec ff_ac3_fixed_encoder
Definition: ac3enc_fixed.c:123
init
static int init
Definition: av_tx.c:47
AudioDSPContext::vector_clip_int32
void(* vector_clip_int32)(int32_t *dst, const int32_t *src, int32_t min, int32_t max, unsigned int len)
Clip each element in an array of int32_t to a given minimum and maximum value.
Definition: audiodsp.h:46
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:116
avpriv_alloc_fixed_dsp
AVFixedDSPContext * avpriv_alloc_fixed_dsp(int bit_exact)
Allocate and initialize a fixed DSP context.
Definition: fixed_dsp.c:150
FF_CODEC_ENCODE_CB
#define FF_CODEC_ENCODE_CB(func)
Definition: codec_internal.h:263
ff_sqrt
#define ff_sqrt
Definition: mathops.h:208
ac3_fixed_encode_init
static av_cold int ac3_fixed_encode_init(AVCodecContext *avctx)
Definition: ac3enc_fixed.c:111
ff_ac3_ch_layouts
const AVChannelLayout ff_ac3_ch_layouts[19]
List of supported channel layouts.
Definition: ac3enc.c:178
av_cold
#define av_cold
Definition: attributes.h:90
s
#define s(width, name)
Definition: cbs_vp9.c:256
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
kbdwin.h
ac3enc.h
CoefSumType
int64_t CoefSumType
Definition: ac3enc.h:68
COEF_MIN
#define COEF_MIN
Definition: ac3enc.h:63
ac3_fixed_mdct_end
static av_cold void ac3_fixed_mdct_end(AC3EncodeContext *s)
Finalize MDCT and free allocated memory.
Definition: ac3enc_fixed.c:78
AC3EncodeContext
AC-3 encoder private context.
Definition: ac3enc.h:157
AC3EncodeContext::adsp
AudioDSPContext adsp
Definition: ac3enc.h:162
ac3enc_template.c
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
clip_coefficients
static void clip_coefficients(AudioDSPContext *adsp, int32_t *coef, unsigned int len)
Definition: ac3enc_fixed.c:47
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
codec_internal.h
AC3_BLOCK_SIZE
#define AC3_BLOCK_SIZE
Definition: ac3defs.h:30
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:56
ff_mdct_end
#define ff_mdct_end
Definition: fft.h:154
calc_cpl_coord
static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
Definition: ac3enc_fixed.c:57
eac3enc.h
ff_ac3_sample_rate_tab
const int ff_ac3_sample_rate_tab[]
Definition: ac3tab.c:95
lrintf
#define lrintf(x)
Definition: libm_mips.h:72
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
ff_ac3_fixed_encode_frame
int ff_ac3_fixed_encode_frame(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
av_malloc_array
#define av_malloc_array(a, b)
Definition: tableprint_vlc.h:31
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:55
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
FF_CODEC_CAP_INIT_THREADSAFE
#define FF_CODEC_CAP_INIT_THREADSAFE
The codec does not modify any global variables in the init function, allowing to call the init functi...
Definition: codec_internal.h:31
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:203
len
int len
Definition: vorbis_enc_data.h:426
sum_square_butterfly
static void sum_square_butterfly(AC3EncodeContext *s, int64_t sum[4], const int32_t *coef0, const int32_t *coef1, int len)
Definition: ac3enc_fixed.c:37
AVCodecContext
main external API structure.
Definition: avcodec.h:389
ff_kbd_window_init
av_cold void ff_kbd_window_init(float *window, float alpha, int n)
Generate a Kaiser-Bessel Derived Window.
Definition: kbdwin.c:26
CoefType
int32_t CoefType
Definition: ac3enc.h:67
ff_ac3enc_class
const AVClass ff_ac3enc_class
Definition: ac3enc.c:132
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:82
ff_ac3_enc_defaults
const FFCodecDefault ff_ac3_enc_defaults[]
Definition: ac3enc.c:139
ff_ac3_encode_init
av_cold int ff_ac3_encode_init(AVCodecContext *avctx)
Definition: ac3enc.c:2564
audiodsp.h
AV_CODEC_FLAG_BITEXACT
#define AV_CODEC_FLAG_BITEXACT
Use only bitexact stuff (except (I)DCT).
Definition: avcodec.h:278
AudioDSPContext
Definition: audiodsp.h:24
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:416
AC3EncodeContext::avctx
AVCodecContext * avctx
parent AVCodecContext
Definition: ac3enc.h:160
ff_ac3_encode_close
av_cold int ff_ac3_encode_close(AVCodecContext *avctx)
Finalize encoding and free any memory allocated by the encoder.
Definition: ac3enc.c:2169
int32_t
int32_t
Definition: audioconvert.c:56