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 #define FFT_FIXED_32 1
32 #include "internal.h"
33 #include "audiodsp.h"
34 #include "ac3enc.h"
35 #include "eac3enc.h"
36 #include "kbdwin.h"
37 
38 #define AC3ENC_TYPE AC3ENC_TYPE_AC3_FIXED
39 #include "ac3enc_opts_template.c"
40 
41 static const AVClass ac3enc_class = {
42  .class_name = "Fixed-Point AC-3 Encoder",
43  .item_name = av_default_item_name,
44  .option = ac3_options,
45  .version = LIBAVUTIL_VERSION_INT,
46 };
47 
48 static void sum_square_butterfly(AC3EncodeContext *s, int64_t sum[4],
49  const int32_t *coef0, const int32_t *coef1,
50  int len)
51 {
52  s->ac3dsp.sum_square_butterfly_int32(sum, coef0, coef1, len);
53 }
54 
55 /*
56  * Clip MDCT coefficients to allowable range.
57  */
59  unsigned int len)
60 {
61  adsp->vector_clip_int32(coef, coef, COEF_MIN, COEF_MAX, len);
62 }
63 
64 
65 /*
66  * Calculate a single coupling coordinate.
67  */
68 static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
69 {
70  if (energy_cpl <= COEF_MAX) {
71  return 1048576;
72  } else {
73  uint64_t coord = energy_ch / (energy_cpl >> 24);
74  uint32_t coord32 = FFMIN(coord, 1073741824);
75  coord32 = ff_sqrt(coord32) << 9;
76  return FFMIN(coord32, COEF_MAX);
77  }
78 }
79 
80 
81 #include "ac3enc_template.c"
82 
83 
84 /**
85  * Finalize MDCT and free allocated memory.
86  *
87  * @param s AC-3 encoder private context
88  */
90 {
91  ff_mdct_end(&s->mdct);
92 }
93 
94 /**
95  * Initialize MDCT tables.
96  *
97  * @param s AC-3 encoder private context
98  * @return 0 on success, negative error code on failure
99  */
101 {
102  float fwin[AC3_BLOCK_SIZE];
103 
104  int32_t *iwin = av_malloc_array(AC3_BLOCK_SIZE, sizeof(*iwin));
105  if (!iwin)
106  return AVERROR(ENOMEM);
107 
109  for (int i = 0; i < AC3_BLOCK_SIZE; i++)
110  iwin[i] = lrintf(fwin[i] * (1 << 22));
111 
112  s->mdct_window = iwin;
113 
115  if (!s->fdsp)
116  return AVERROR(ENOMEM);
117 
118  return ff_mdct_init(&s->mdct, 9, 0, -1.0);
119 }
120 
121 
123 {
124  AC3EncodeContext *s = avctx->priv_data;
125  s->fixed_point = 1;
129  return ff_ac3_encode_init(avctx);
130 }
131 
132 
134  .name = "ac3_fixed",
135  .long_name = NULL_IF_CONFIG_SMALL("ATSC A/52A (AC-3)"),
136  .type = AVMEDIA_TYPE_AUDIO,
137  .id = AV_CODEC_ID_AC3,
138  .priv_data_size = sizeof(AC3EncodeContext),
140  .encode2 = ff_ac3_fixed_encode_frame,
141  .close = ff_ac3_encode_close,
142  .sample_fmts = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_S32P,
144  .priv_class = &ac3enc_class,
146  .supported_samplerates = ff_ac3_sample_rate_tab,
147  .channel_layouts = ff_ac3_channel_layouts,
148  .defaults = ac3_defaults,
149 };
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
Definition: internal.h:48
void(* mdct_end)(struct AC3EncodeContext *s)
Definition: ac3enc.h:264
av_cold void ff_kbd_window_init(float *window, float alpha, int n)
Generate a Kaiser-Bessel Derived Window.
Definition: kbdwin.c:26
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
static int allocate_sample_buffers(AC3EncodeContext *s)
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
static av_cold int ac3_fixed_encode_init(AVCodecContext *avctx)
Definition: ac3enc_fixed.c:122
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:235
#define COEF_MIN
Definition: ac3enc.h:67
int(* mdct_init)(struct AC3EncodeContext *s)
Definition: ac3enc.h:265
AVCodec.
Definition: codec.h:190
static av_cold int ac3_fixed_mdct_init(AC3EncodeContext *s)
Initialize MDCT tables.
Definition: ac3enc_fixed.c:100
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
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
#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: internal.h:40
#define av_cold
Definition: attributes.h:88
av_cold int ff_ac3_encode_close(AVCodecContext *avctx)
Finalize encoding and free any memory allocated by the encoder.
Definition: ac3enc.c:2045
AVFixedDSPContext * fdsp
Definition: ac3enc.h:170
#define lrintf(x)
Definition: libm_mips.h:70
AC3DSPContext ac3dsp
AC-3 optimized functions.
Definition: ac3enc.h:173
#define ff_sqrt
Definition: mathops.h:206
int64_t CoefSumType
Definition: ac3enc.h:72
const uint64_t ff_ac3_channel_layouts[19]
List of supported channel layouts.
Definition: ac3enc.c:83
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:115
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:611
const char * name
Name of the codec implementation.
Definition: codec.h:197
int fixed_point
indicates if fixed-point encoder is being used
Definition: ac3enc.h:179
#define ff_mdct_init
Definition: fft.h:161
#define AC3_BLOCK_SIZE
Definition: ac3.h:36
static av_cold void ac3_fixed_mdct_end(AC3EncodeContext *s)
Finalize MDCT and free allocated memory.
Definition: ac3enc_fixed.c:89
#define AV_CODEC_FLAG_BITEXACT
Use only bitexact stuff (except (I)DCT).
Definition: avcodec.h:333
#define FFMIN(a, b)
Definition: common.h:96
AudioDSPContext adsp
Definition: ac3enc.h:166
signed 32 bits, planar
Definition: samplefmt.h:68
int32_t
#define s(width, name)
Definition: cbs_vp9.c:257
FFTContext mdct
FFT context for MDCT calculation.
Definition: ac3enc.h:174
const SampleType * mdct_window
MDCT window function array.
Definition: ac3enc.h:175
void(* sum_square_butterfly_int32)(int64_t sum[4], const int32_t *coef0, const int32_t *coef1, int len)
Definition: ac3dsp.h:96
static void clip_coefficients(AudioDSPContext *adsp, int32_t *coef, unsigned int len)
Definition: ac3enc_fixed.c:58
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:58
static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
Definition: ac3enc_fixed.c:68
main external API structure.
Definition: avcodec.h:531
int(* allocate_sample_buffers)(struct AC3EncodeContext *s)
Definition: ac3enc.h:268
Describe the class of an AVClass context structure.
Definition: log.h:67
int ff_ac3_fixed_encode_frame(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
static const AVCodecDefault ac3_defaults[]
AC-3 encoder private context.
Definition: ac3enc.h:161
AVFixedDSPContext * avpriv_alloc_fixed_dsp(int bit_exact)
Allocate and initialize a fixed DSP context.
Definition: fixed_dsp.c:149
#define COEF_MAX
Definition: ac3enc.h:68
AC-3 encoder float/fixed template.
common internal api header.
AVCodec ff_ac3_fixed_encoder
Definition: ac3enc_fixed.c:133
#define ff_mdct_end
Definition: fft.h:162
static const AVClass ac3enc_class
Definition: ac3enc_fixed.c:41
static const AVOption ac3_options[]
AVCodecContext * avctx
parent AVCodecContext
Definition: ac3enc.h:164
void * priv_data
Definition: avcodec.h:558
int len
AC-3 encoder & E-AC-3 encoder common header.
static enum AVSampleFormat sample_fmts[]
Definition: adpcmenc.c:940
const int ff_ac3_sample_rate_tab[]
Definition: ac3tab.c:129
#define av_malloc_array(a, b)
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:48
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
int32_t CoefType
Definition: ac3enc.h:71
E-AC-3 encoder.
int i
Definition: input.c:407
av_cold int ff_ac3_encode_init(AVCodecContext *avctx)
Definition: ac3enc.c:2438