FFmpeg  4.0
ac3enc_float.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  * floating-point AC-3 encoder.
27  */
28 
29 #define CONFIG_AC3ENC_FLOAT 1
30 #include "internal.h"
31 #include "audiodsp.h"
32 #include "ac3enc.h"
33 #include "eac3enc.h"
34 #include "kbdwin.h"
35 
36 
37 #define AC3ENC_TYPE AC3ENC_TYPE_AC3
38 #include "ac3enc_opts_template.c"
39 static const AVClass ac3enc_class = {
40  .class_name = "AC-3 Encoder",
41  .item_name = av_default_item_name,
42  .option = ac3_options,
43  .version = LIBAVUTIL_VERSION_INT,
44 };
45 
46 
47 /*
48  * Scale MDCT coefficients from float to 24-bit fixed-point.
49  */
51 {
52  int chan_size = AC3_MAX_COEFS * s->num_blocks;
53  int cpl = s->cpl_on;
54  s->ac3dsp.float_to_fixed24(s->fixed_coef_buffer + (chan_size * !cpl),
55  s->mdct_coef_buffer + (chan_size * !cpl),
56  chan_size * (s->channels + cpl));
57 }
58 
59 
60 /*
61  * Clip MDCT coefficients to allowable range.
62  */
63 static void clip_coefficients(AudioDSPContext *adsp, float *coef,
64  unsigned int len)
65 {
66  adsp->vector_clipf(coef, coef, len, COEF_MIN, COEF_MAX);
67 }
68 
69 
70 /*
71  * Calculate a single coupling coordinate.
72  */
73 static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
74 {
75  float coord = 0.125;
76  if (energy_cpl > 0)
77  coord *= sqrtf(energy_ch / energy_cpl);
78  return FFMIN(coord, COEF_MAX);
79 }
80 
81 static void sum_square_butterfly(AC3EncodeContext *s, float sum[4],
82  const float *coef0, const float *coef1,
83  int len)
84 {
85  s->ac3dsp.sum_square_butterfly_float(sum, coef0, coef1, len);
86 }
87 
88 
89 #include "ac3enc_template.c"
90 
91 
92 /**
93  * Finalize MDCT and free allocated memory.
94  *
95  * @param s AC-3 encoder private context
96  */
98 {
99  ff_mdct_end(&s->mdct);
100  av_freep(&s->mdct_window);
101 }
102 
103 
104 /**
105  * Initialize MDCT tables.
106  *
107  * @param s AC-3 encoder private context
108  * @return 0 on success, negative error code on failure
109  */
111 {
112  float *window;
113  int i, n, n2;
114 
115  n = 1 << 9;
116  n2 = n >> 1;
117 
118  window = av_malloc_array(n, sizeof(*window));
119  if (!window) {
120  av_log(s->avctx, AV_LOG_ERROR, "Cannot allocate memory.\n");
121  return AVERROR(ENOMEM);
122  }
123  ff_kbd_window_init(window, 5.0, n2);
124  for (i = 0; i < n2; i++)
125  window[n-1-i] = window[i];
126  s->mdct_window = window;
127 
128  return ff_mdct_init(&s->mdct, 9, 0, -2.0 / n);
129 }
130 
131 
133 {
134  AC3EncodeContext *s = avctx->priv_data;
136  if (!s->fdsp)
137  return AVERROR(ENOMEM);
138  return ff_ac3_encode_init(avctx);
139 }
140 
142  .name = "ac3",
143  .long_name = NULL_IF_CONFIG_SMALL("ATSC A/52A (AC-3)"),
144  .type = AVMEDIA_TYPE_AUDIO,
145  .id = AV_CODEC_ID_AC3,
146  .priv_data_size = sizeof(AC3EncodeContext),
148  .encode2 = ff_ac3_float_encode_frame,
149  .close = ff_ac3_encode_close,
150  .sample_fmts = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_FLTP,
152  .priv_class = &ac3enc_class,
153  .channel_layouts = ff_ac3_channel_layouts,
154  .defaults = ac3_defaults,
155 };
float, planar
Definition: samplefmt.h:69
const char * s
Definition: avisynth_c.h:768
AVFloatDSPContext * fdsp
Definition: ac3enc.h:168
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
#define AC3_MAX_COEFS
Definition: ac3.h:35
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:191
#define COEF_MIN
Definition: ac3enc.h:67
static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
Definition: ac3enc_float.c:73
AVCodec.
Definition: avcodec.h:3408
int ff_ac3_float_encode_frame(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
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
static void sum_square_butterfly(AC3EncodeContext *s, float sum[4], const float *coef0, const float *coef1, int len)
Definition: ac3enc_float.c:81
#define av_cold
Definition: attributes.h:82
av_cold int ff_ac3_encode_close(AVCodecContext *avctx)
Finalize encoding and free any memory allocated by the encoder.
Definition: ac3enc.c:2017
void(* vector_clipf)(float *dst, const float *src, int len, float min, float max)
Definition: audiodsp.h:49
av_cold int ff_ac3_float_mdct_init(AC3EncodeContext *s)
Initialize MDCT tables.
Definition: ac3enc_float.c:110
AC3DSPContext ac3dsp
AC-3 optimized functions.
Definition: ac3enc.h:170
#define av_log(a,...)
av_cold int ff_ac3_float_encode_init(AVCodecContext *avctx)
Definition: ac3enc_float.c:132
int64_t CoefSumType
Definition: ac3enc.h:72
static const AVClass ac3enc_class
Definition: ac3enc_float.c:39
const uint64_t ff_ac3_channel_layouts[19]
List of supported channel layouts.
Definition: ac3enc.c:81
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
av_cold AVFloatDSPContext * avpriv_float_dsp_alloc(int bit_exact)
Allocate a float DSP context.
Definition: float_dsp.c:127
#define AVERROR(e)
Definition: error.h:43
int channels
total number of channels (nchans)
Definition: ac3enc.h:194
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:1598
int cpl_on
coupling turned on for this frame
Definition: ac3enc.h:214
const char * name
Name of the codec implementation.
Definition: avcodec.h:3415
#define ff_mdct_init
Definition: fft.h:169
AVCodec ff_ac3_encoder
Definition: ac3enc_float.c:141
static SDL_Window * window
Definition: ffplay.c:362
#define AV_CODEC_FLAG_BITEXACT
Use only bitexact stuff (except (I)DCT).
Definition: avcodec.h:886
#define FFMIN(a, b)
Definition: common.h:96
AudioDSPContext adsp
Definition: ac3enc.h:167
static void scale_coefficients(AC3EncodeContext *s)
Definition: ac3enc_float.c:50
int n
Definition: avisynth_c.h:684
FFTContext mdct
FFT context for MDCT calculation.
Definition: ac3enc.h:171
const SampleType * mdct_window
MDCT window function array.
Definition: ac3enc.h:172
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:58
main external API structure.
Definition: avcodec.h:1518
CoefType * mdct_coef_buffer
Definition: ac3enc.h:240
Describe the class of an AVClass context structure.
Definition: log.h:67
static const AVCodecDefault ac3_defaults[]
AC-3 encoder private context.
Definition: ac3enc.h:162
int num_blocks
number of blocks per frame
Definition: ac3enc.h:185
#define COEF_MAX
Definition: ac3enc.h:68
static void clip_coefficients(AudioDSPContext *adsp, float *coef, unsigned int len)
Definition: ac3enc_float.c:63
AC-3 encoder float/fixed template.
common internal api header.
#define ff_mdct_end
Definition: fft.h:170
static const AVOption ac3_options[]
AVCodecContext * avctx
parent AVCodecContext
Definition: ac3enc.h:165
void * priv_data
Definition: avcodec.h:1545
int len
AC-3 encoder & E-AC-3 encoder common header.
void(* sum_square_butterfly_float)(float sum[4], const float *coef0, const float *coef1, int len)
Definition: ac3dsp.h:132
static enum AVSampleFormat sample_fmts[]
Definition: adpcmenc.c:701
#define av_freep(p)
#define av_malloc_array(a, b)
int32_t CoefType
Definition: ac3enc.h:71
E-AC-3 encoder.
av_cold void ff_ac3_float_mdct_end(AC3EncodeContext *s)
Finalize MDCT and free allocated memory.
Definition: ac3enc_float.c:97
int32_t * fixed_coef_buffer
Definition: ac3enc.h:241
void(* float_to_fixed24)(int32_t *dst, const float *src, unsigned int len)
Convert an array of float in range [-1.0,1.0] to int32_t with range [-(1<<24),(1<<24)].
Definition: ac3dsp.h:89
av_cold int ff_ac3_encode_init(AVCodecContext *avctx)
Definition: ac3enc.c:2425