g722dec.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) CMU 1993 Computer Science, Speech Group
3  * Chengxiang Lu and Alex Hauptmann
4  * Copyright (c) 2005 Steve Underwood <steveu at coppice.org>
5  * Copyright (c) 2009 Kenan Gillet
6  * Copyright (c) 2010 Martin Storsjo
7  *
8  * This file is part of FFmpeg.
9  *
10  * FFmpeg is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Lesser General Public
12  * License as published by the Free Software Foundation; either
13  * version 2.1 of the License, or (at your option) any later version.
14  *
15  * FFmpeg is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18  * Lesser General Public License for more details.
19  *
20  * You should have received a copy of the GNU Lesser General Public
21  * License along with FFmpeg; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23  */
24 
25 /**
26  * @file
27  * G.722 ADPCM audio decoder
28  *
29  * This G.722 decoder is a bit-exact implementation of the ITU G.722
30  * specification for all three specified bitrates - 64000bps, 56000bps
31  * and 48000bps. It passes the ITU tests.
32  *
33  * @note For the 56000bps and 48000bps bitrates, the lowest 1 or 2 bits
34  * respectively of each byte are ignored.
35  */
36 
38 #include "libavutil/opt.h"
39 #include "avcodec.h"
40 #include "get_bits.h"
41 #include "g722.h"
42 #include "internal.h"
43 
44 #define OFFSET(x) offsetof(G722Context, x)
45 #define AD AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_DECODING_PARAM
46 static const AVOption options[] = {
47  { "bits_per_codeword", "Bits per G722 codeword", OFFSET(bits_per_codeword), AV_OPT_TYPE_FLAGS, { .i64 = 8 }, 6, 8, AD },
48  { NULL }
49 };
50 
51 static const AVClass g722_decoder_class = {
52  .class_name = "g722 decoder",
53  .item_name = av_default_item_name,
54  .option = options,
55  .version = LIBAVUTIL_VERSION_INT,
56 };
57 
59 {
60  G722Context *c = avctx->priv_data;
61 
62  avctx->channels = 1;
65 
66  c->band[0].scale_factor = 8;
67  c->band[1].scale_factor = 2;
68  c->prev_samples_pos = 22;
69 
70  return 0;
71 }
72 
73 static const int16_t low_inv_quant5[32] = {
74  -35, -35, -2919, -2195, -1765, -1458, -1219, -1023,
75  -858, -714, -587, -473, -370, -276, -190, -110,
76  2919, 2195, 1765, 1458, 1219, 1023, 858, 714,
77  587, 473, 370, 276, 190, 110, 35, -35
78 };
79 
80 static const int16_t *low_inv_quants[3] = { ff_g722_low_inv_quant6,
83 
84 static int g722_decode_frame(AVCodecContext *avctx, void *data,
85  int *got_frame_ptr, AVPacket *avpkt)
86 {
87  G722Context *c = avctx->priv_data;
88  AVFrame *frame = data;
89  int16_t *out_buf;
90  int j, ret;
91  const int skip = 8 - c->bits_per_codeword;
92  const int16_t *quantizer_table = low_inv_quants[skip];
93  GetBitContext gb;
94 
95  /* get output buffer */
96  frame->nb_samples = avpkt->size * 2;
97  if ((ret = ff_get_buffer(avctx, frame, 0)) < 0)
98  return ret;
99  out_buf = (int16_t *)frame->data[0];
100 
101  init_get_bits(&gb, avpkt->data, avpkt->size * 8);
102 
103  for (j = 0; j < avpkt->size; j++) {
104  int ilow, ihigh, rlow, rhigh, dhigh;
105  int xout1, xout2;
106 
107  ihigh = get_bits(&gb, 2);
108  ilow = get_bits(&gb, 6 - skip);
109  skip_bits(&gb, skip);
110 
111  rlow = av_clip((c->band[0].scale_factor * quantizer_table[ilow] >> 10)
112  + c->band[0].s_predictor, -16384, 16383);
113 
114  ff_g722_update_low_predictor(&c->band[0], ilow >> (2 - skip));
115 
116  dhigh = c->band[1].scale_factor * ff_g722_high_inv_quant[ihigh] >> 10;
117  rhigh = av_clip(dhigh + c->band[1].s_predictor, -16384, 16383);
118 
119  ff_g722_update_high_predictor(&c->band[1], dhigh, ihigh);
120 
121  c->prev_samples[c->prev_samples_pos++] = rlow + rhigh;
122  c->prev_samples[c->prev_samples_pos++] = rlow - rhigh;
124  &xout1, &xout2);
125  *out_buf++ = av_clip_int16(xout1 >> 11);
126  *out_buf++ = av_clip_int16(xout2 >> 11);
128  memmove(c->prev_samples, c->prev_samples + c->prev_samples_pos - 22,
129  22 * sizeof(c->prev_samples[0]));
130  c->prev_samples_pos = 22;
131  }
132  }
133 
134  *got_frame_ptr = 1;
135 
136  return avpkt->size;
137 }
138 
140  .name = "g722",
141  .type = AVMEDIA_TYPE_AUDIO,
143  .priv_data_size = sizeof(G722Context),
146  .capabilities = CODEC_CAP_DR1,
147  .long_name = NULL_IF_CONFIG_SMALL("G.722 ADPCM"),
148  .priv_class = &g722_decoder_class,
149 };
#define OFFSET(x)
Definition: g722dec.c:44
const int16_t ff_g722_low_inv_quant4[16]
This structure describes decoded (raw) audio or video data.
Definition: frame.h:76
AVOption.
Definition: opt.h:251
av_default_item_name
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:240
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
AVCodec ff_adpcm_g722_decoder
Definition: g722dec.c:139
static av_cold int g722_decode_init(AVCodecContext *avctx)
Definition: g722dec.c:58
signed 16 bits
Definition: samplefmt.h:52
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:55
enum AVSampleFormat sample_fmt
audio sample format
#define av_cold
Definition: attributes.h:78
AVOptions.
#define PREV_SAMPLES_BUF_SIZE
Definition: g722.h:31
#define CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
uint8_t * data
bitstream reader API header.
frame
Definition: stft.m:14
static const AVClass g722_decoder_class
Definition: g722dec.c:51
int bits_per_codeword
Definition: g722.h:35
const int16_t ff_g722_low_inv_quant6[64]
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Spectrum Plot time data
void ff_g722_apply_qmf(const int16_t *prev_samples, int *xout1, int *xout2)
int16_t prev_samples[PREV_SAMPLES_BUF_SIZE]
memory of past decoded samples
Definition: g722.h:36
const char * name
Name of the codec implementation.
external API header
uint64_t channel_layout
Audio channel layout.
struct G722Context::G722Band band[2]
audio channel layout utility functions
static const AVOption options[]
Definition: g722dec.c:46
ret
Definition: avfilter.c:821
void ff_g722_update_low_predictor(struct G722Band *band, const int ilow)
LIBAVUTIL_VERSION_INT
Definition: eval.c:55
static const int16_t low_inv_quant5[32]
Definition: g722dec.c:73
NULL
Definition: eval.c:55
#define AD
Definition: g722dec.c:45
main external API structure.
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
Describe the class of an AVClass context structure.
Definition: log.h:50
static void skip_bits(GetBitContext *s, int n)
Definition: get_bits.h:265
static int init_get_bits(GetBitContext *s, const uint8_t *buffer, int bit_size)
Initialize GetBitContext.
Definition: get_bits.h:379
struct G722Context G722Context
static const int16_t * low_inv_quants[3]
Definition: g722dec.c:80
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:87
common internal api header.
static double c[64]
int prev_samples_pos
the number of values in prev_samples
Definition: g722.h:37
static int g722_decode_frame(AVCodecContext *avctx, void *data, int *got_frame_ptr, AVPacket *avpkt)
Definition: g722dec.c:84
const int16_t ff_g722_high_inv_quant[4]
int channels
number of audio channels
int16_t s_predictor
predictor output value
Definition: g722.h:43
static int decode(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: crystalhd.c:868
void ff_g722_update_high_predictor(struct G722Band *band, const int dhigh, const int ihigh)
#define AV_CH_LAYOUT_MONO
This structure stores compressed data.
int16_t scale_factor
delayed quantizer scale factor
Definition: g722.h:51
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:127