FFmpeg
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 AC3ENC_FLOAT 1
30 #include "audiodsp.h"
31 #include "ac3enc.h"
32 #include "codec_internal.h"
33 #include "eac3enc.h"
34 #include "kbdwin.h"
35 
36 
37 /*
38  * Scale MDCT coefficients from float to 24-bit fixed-point.
39  */
41 {
42  int chan_size = AC3_MAX_COEFS * s->num_blocks;
43  int cpl = s->cpl_on;
44  s->ac3dsp.float_to_fixed24(s->fixed_coef_buffer + (chan_size * !cpl),
45  s->mdct_coef_buffer + (chan_size * !cpl),
46  chan_size * (s->channels + cpl));
47 }
48 
49 
50 /*
51  * Clip MDCT coefficients to allowable range.
52  */
53 static void clip_coefficients(AudioDSPContext *adsp, float *coef,
54  unsigned int len)
55 {
56  adsp->vector_clipf(coef, coef, len, COEF_MIN, COEF_MAX);
57 }
58 
59 
60 /*
61  * Calculate a single coupling coordinate.
62  */
63 static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
64 {
65  float coord = 0.125;
66  if (energy_cpl > 0)
67  coord *= sqrtf(energy_ch / energy_cpl);
68  return FFMIN(coord, COEF_MAX);
69 }
70 
71 static void sum_square_butterfly(AC3EncodeContext *s, float sum[4],
72  const float *coef0, const float *coef1,
73  int len)
74 {
75  s->ac3dsp.sum_square_butterfly_float(sum, coef0, coef1, len);
76 }
77 
78 #include "ac3enc_template.c"
79 
80 /**
81  * Initialize MDCT tables.
82  *
83  * @param s AC-3 encoder private context
84  * @return 0 on success, negative error code on failure
85  */
87 {
88  const float scale = -2.0 / AC3_WINDOW_SIZE;
89  float *window = av_malloc_array(AC3_BLOCK_SIZE, sizeof(*window));
90  if (!window) {
91  av_log(s->avctx, AV_LOG_ERROR, "Cannot allocate memory.\n");
92  return AVERROR(ENOMEM);
93  }
94 
96  s->mdct_window = window;
97 
98  return av_tx_init(&s->tx, &s->tx_fn, AV_TX_FLOAT_MDCT, 0,
99  AC3_BLOCK_SIZE, &scale, 0);
100 }
101 
102 
104 {
106  s->mdct_init = ac3_float_mdct_init;
107  s->allocate_sample_buffers = allocate_sample_buffers;
109  if (!s->fdsp)
110  return AVERROR(ENOMEM);
111  return ff_ac3_encode_init(avctx);
112 }
113 
115  .p.name = "ac3",
116  CODEC_LONG_NAME("ATSC A/52A (AC-3)"),
117  .p.type = AVMEDIA_TYPE_AUDIO,
118  .p.id = AV_CODEC_ID_AC3,
120  .priv_data_size = sizeof(AC3EncodeContext),
123  .close = ff_ac3_encode_close,
124  .p.sample_fmts = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_FLTP,
126  .p.priv_class = &ff_ac3enc_class,
127  .p.supported_samplerates = ff_ac3_sample_rate_tab,
128  CODEC_OLD_CHANNEL_LAYOUTS_ARRAY(ff_ac3_channel_layouts)
129  .p.ch_layouts = ff_ac3_ch_layouts,
130  .defaults = ff_ac3_enc_defaults,
131  .caps_internal = FF_CODEC_CAP_INIT_CLEANUP,
132 };
avpriv_kbd_window_init
av_cold int avpriv_kbd_window_init(float *window, float alpha, int n)
Generate a Kaiser-Bessel Derived Window.
Definition: kbdwin.c:61
AV_SAMPLE_FMT_FLTP
@ AV_SAMPLE_FMT_FLTP
float, planar
Definition: samplefmt.h:66
AudioDSPContext::vector_clipf
void(* vector_clipf)(float *dst, const float *src, int len, float min, float max)
Definition: audiodsp.h:49
AV_CODEC_ID_AC3
@ AV_CODEC_ID_AC3
Definition: codec_id.h:445
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:42
ff_ac3_encoder
const FFCodec ff_ac3_encoder
Definition: ac3enc_float.c:114
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:65
FFCodec
Definition: codec_internal.h:127
sum_square_butterfly
static void sum_square_butterfly(AC3EncodeContext *s, float sum[4], const float *coef0, const float *coef1, int len)
Definition: ac3enc_float.c:71
allocate_sample_buffers
static int allocate_sample_buffers(AC3EncodeContext *s)
Definition: ac3enc_template.c:42
ff_ac3_float_encode_frame
int ff_ac3_float_encode_frame(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
av_tx_init
av_cold int av_tx_init(AVTXContext **ctx, av_tx_fn *tx, enum AVTXType type, int inv, int len, const void *scale, uint64_t flags)
Initialize a transform context with the given configuration (i)MDCTs with an odd length are currently...
Definition: tx.c:901
window
static SDL_Window * window
Definition: ffplay.c:360
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:131
AVCodecContext::flags
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:521
scale
static av_always_inline float scale(float x, float s)
Definition: vf_v360.c:1389
FF_CODEC_ENCODE_CB
#define FF_CODEC_ENCODE_CB(func)
Definition: codec_internal.h:315
ff_ac3_ch_layouts
const AVChannelLayout ff_ac3_ch_layouts[19]
List of supported channel layouts.
Definition: ac3enc.c:177
AC3_WINDOW_SIZE
#define AC3_WINDOW_SIZE
Definition: ac3defs.h:33
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
av_cold
#define av_cold
Definition: attributes.h:90
AV_TX_FLOAT_MDCT
@ AV_TX_FLOAT_MDCT
Standard MDCT with a sample data type of float, double or int32_t, respecively.
Definition: tx.h:68
s
#define s(width, name)
Definition: cbs_vp9.c:198
AC3_MAX_COEFS
#define AC3_MAX_COEFS
Definition: ac3defs.h:29
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
init
int(* init)(AVBSFContext *ctx)
Definition: dts2pts_bsf.c:365
AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE
#define AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE
This encoder can reorder user opaque values from input AVFrames and return them with corresponding ou...
Definition: codec.h:159
kbdwin.h
CODEC_LONG_NAME
#define CODEC_LONG_NAME(str)
Definition: codec_internal.h:272
ac3enc.h
CoefSumType
int64_t CoefSumType
Definition: ac3enc.h:69
COEF_MIN
#define COEF_MIN
Definition: ac3enc.h:64
sqrtf
static __device__ float sqrtf(float a)
Definition: cuda_runtime.h:184
AC3EncodeContext
AC-3 encoder private context.
Definition: ac3enc.h:158
ff_ac3_float_encode_init
av_cold int ff_ac3_float_encode_init(AVCodecContext *avctx)
Definition: ac3enc_float.c:103
scale_coefficients
static void scale_coefficients(AC3EncodeContext *s)
Definition: ac3enc_float.c:40
AC3EncodeContext::adsp
AudioDSPContext adsp
Definition: ac3enc.h:163
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
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
eac3enc.h
CODEC_OLD_CHANNEL_LAYOUTS_ARRAY
#define CODEC_OLD_CHANNEL_LAYOUTS_ARRAY(array)
Definition: codec_internal.h:303
ff_ac3_sample_rate_tab
const int ff_ac3_sample_rate_tab[]
Definition: ac3tab.c:95
av_malloc_array
#define av_malloc_array(a, b)
Definition: tableprint_vlc.h:31
ac3_float_mdct_init
static av_cold int ac3_float_mdct_init(AC3EncodeContext *s)
Initialize MDCT tables.
Definition: ac3enc_float.c:86
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:55
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:194
len
int len
Definition: vorbis_enc_data.h:426
clip_coefficients
static void clip_coefficients(AudioDSPContext *adsp, float *coef, unsigned int len)
Definition: ac3enc_float.c:53
AVCodecContext
main external API structure.
Definition: avcodec.h:441
CoefType
int32_t CoefType
Definition: ac3enc.h:68
ff_ac3enc_class
const AVClass ff_ac3enc_class
Definition: ac3enc.c:131
ff_ac3_enc_defaults
const FFCodecDefault ff_ac3_enc_defaults[]
Definition: ac3enc.c:138
ff_ac3_encode_init
av_cold int ff_ac3_encode_init(AVCodecContext *avctx)
Definition: ac3enc.c:2563
audiodsp.h
AV_CODEC_FLAG_BITEXACT
#define AV_CODEC_FLAG_BITEXACT
Use only bitexact stuff (except (I)DCT).
Definition: avcodec.h:338
AudioDSPContext
Definition: audiodsp.h:24
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:468
AC3EncodeContext::avctx
AVCodecContext * avctx
parent AVCodecContext
Definition: ac3enc.h:161
avpriv_float_dsp_alloc
av_cold AVFloatDSPContext * avpriv_float_dsp_alloc(int bit_exact)
Allocate a float DSP context.
Definition: float_dsp.c:135
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:2168
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
calc_cpl_coord
static CoefType calc_cpl_coord(CoefSumType energy_ch, CoefSumType energy_cpl)
Definition: ac3enc_float.c:63