2 * Interface to libgsm for gsm encoding/decoding
3 * Copyright (c) 2005 Alban Bedel <albeu@free.fr>
4 * Copyright (c) 2006, 2007 Michel Bardiaux <mbardiaux@mediaxim.be>
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 * Interface to libgsm for gsm encoding/decoding
28 // The idiosyncrasies of GSM-in-WAV are explained at http://kbs.cs.tu-berlin.de/~jutta/toast.html
33 // gsm.h misses some essential constants
34 #define GSM_BLOCK_SIZE 33
35 #define GSM_MS_BLOCK_SIZE 65
36 #define GSM_FRAME_SIZE 160
38 static av_cold int libgsm_encode_init(AVCodecContext *avctx) {
39 if (avctx->channels > 1) {
40 av_log(avctx, AV_LOG_ERROR, "Mono required for GSM, got %d channels\n",
45 if (avctx->sample_rate != 8000) {
46 av_log(avctx, AV_LOG_ERROR, "Sample rate 8000Hz required for GSM, got %dHz\n",
48 if (avctx->strict_std_compliance > FF_COMPLIANCE_UNOFFICIAL)
51 if (avctx->bit_rate != 13000 /* Official */ &&
52 avctx->bit_rate != 13200 /* Very common */ &&
53 avctx->bit_rate != 0 /* Unknown; a.o. mov does not set bitrate when decoding */ ) {
54 av_log(avctx, AV_LOG_ERROR, "Bitrate 13000bps required for GSM, got %dbps\n",
56 if (avctx->strict_std_compliance > FF_COMPLIANCE_UNOFFICIAL)
60 avctx->priv_data = gsm_create();
62 switch(avctx->codec_id) {
64 avctx->frame_size = GSM_FRAME_SIZE;
65 avctx->block_align = GSM_BLOCK_SIZE;
67 case CODEC_ID_GSM_MS: {
69 gsm_option(avctx->priv_data, GSM_OPT_WAV49, &one);
70 avctx->frame_size = 2*GSM_FRAME_SIZE;
71 avctx->block_align = GSM_MS_BLOCK_SIZE;
75 avctx->coded_frame= avcodec_alloc_frame();
76 avctx->coded_frame->key_frame= 1;
81 static av_cold int libgsm_encode_close(AVCodecContext *avctx) {
82 av_freep(&avctx->coded_frame);
83 gsm_destroy(avctx->priv_data);
84 avctx->priv_data = NULL;
88 static int libgsm_encode_frame(AVCodecContext *avctx,
89 unsigned char *frame, int buf_size, void *data) {
90 // we need a full block
91 if(buf_size < avctx->block_align) return 0;
93 switch(avctx->codec_id) {
95 gsm_encode(avctx->priv_data,data,frame);
98 gsm_encode(avctx->priv_data,data,frame);
99 gsm_encode(avctx->priv_data,((short*)data)+GSM_FRAME_SIZE,frame+32);
101 return avctx->block_align;
105 AVCodec ff_libgsm_encoder = {
107 .type = AVMEDIA_TYPE_AUDIO,
109 .init = libgsm_encode_init,
110 .encode = libgsm_encode_frame,
111 .close = libgsm_encode_close,
112 .sample_fmts = (const enum AVSampleFormat[]){AV_SAMPLE_FMT_S16,AV_SAMPLE_FMT_NONE},
113 .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM"),
116 AVCodec ff_libgsm_ms_encoder = {
118 .type = AVMEDIA_TYPE_AUDIO,
119 .id = CODEC_ID_GSM_MS,
120 .init = libgsm_encode_init,
121 .encode = libgsm_encode_frame,
122 .close = libgsm_encode_close,
123 .sample_fmts = (const enum AVSampleFormat[]){AV_SAMPLE_FMT_S16,AV_SAMPLE_FMT_NONE},
124 .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM Microsoft variant"),
127 static av_cold int libgsm_decode_init(AVCodecContext *avctx) {
128 if (avctx->channels > 1) {
129 av_log(avctx, AV_LOG_ERROR, "Mono required for GSM, got %d channels\n",
134 if (!avctx->channels)
137 if (!avctx->sample_rate)
138 avctx->sample_rate = 8000;
140 avctx->sample_fmt = AV_SAMPLE_FMT_S16;
142 avctx->priv_data = gsm_create();
144 switch(avctx->codec_id) {
146 avctx->frame_size = GSM_FRAME_SIZE;
147 avctx->block_align = GSM_BLOCK_SIZE;
149 case CODEC_ID_GSM_MS: {
151 gsm_option(avctx->priv_data, GSM_OPT_WAV49, &one);
152 avctx->frame_size = 2 * GSM_FRAME_SIZE;
153 avctx->block_align = GSM_MS_BLOCK_SIZE;
160 static av_cold int libgsm_decode_close(AVCodecContext *avctx) {
161 gsm_destroy(avctx->priv_data);
162 avctx->priv_data = NULL;
166 static int libgsm_decode_frame(AVCodecContext *avctx,
167 void *data, int *data_size,
170 struct gsm_state *s = avctx->priv_data;
171 uint8_t *buf = avpkt->data;
172 int buf_size = avpkt->size;
173 int16_t *samples = data;
174 int out_size = avctx->frame_size * av_get_bytes_per_sample(avctx->sample_fmt);
176 if (*data_size < out_size) {
177 av_log(avctx, AV_LOG_ERROR, "Output buffer is too small\n");
178 return AVERROR(EINVAL);
181 if (buf_size < avctx->block_align) {
182 av_log(avctx, AV_LOG_ERROR, "Packet is too small\n");
183 return AVERROR_INVALIDDATA;
186 for (i = 0; i < avctx->frame_size / GSM_FRAME_SIZE; i++) {
187 if ((ret = gsm_decode(s, buf, samples)) < 0)
189 buf += GSM_BLOCK_SIZE;
190 samples += GSM_FRAME_SIZE;
193 *data_size = out_size;
194 return avctx->block_align;
197 static void libgsm_flush(AVCodecContext *avctx) {
198 gsm_destroy(avctx->priv_data);
199 avctx->priv_data = gsm_create();
202 AVCodec ff_libgsm_decoder = {
204 .type = AVMEDIA_TYPE_AUDIO,
206 .init = libgsm_decode_init,
207 .close = libgsm_decode_close,
208 .decode = libgsm_decode_frame,
209 .flush = libgsm_flush,
210 .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM"),
213 AVCodec ff_libgsm_ms_decoder = {
215 .type = AVMEDIA_TYPE_AUDIO,
216 .id = CODEC_ID_GSM_MS,
217 .init = libgsm_decode_init,
218 .close = libgsm_decode_close,
219 .decode = libgsm_decode_frame,
220 .flush = libgsm_flush,
221 .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM Microsoft variant"),