libavcodec/libgsm.c

   1 /*
   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>
   5  *
   6  * This file is part of Libav.
   7  *
   8  * Libav 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.
  12  *
  13  * Libav 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.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with Libav; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  21  */
  22
  23 /**
  24  * @file
  25  * Interface to libgsm for gsm encoding/decoding
  26  */
  27
  28 // The idiosyncrasies of GSM-in-WAV are explained at http://kbs.cs.tu-berlin.de/~jutta/toast.html
  29
  30 #include "avcodec.h"
  31 #include <gsm/gsm.h>
  32
  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
  37
  38 static av_cold int libgsm_init(AVCodecContext *avctx) {
  39     if (avctx->channels > 1) {
  40         av_log(avctx, AV_LOG_ERROR, "Mono required for GSM, got %d channels\n",
  41                avctx->channels);
  42         return -1;
  43     }
  44
  45     if(avctx->codec->decode){
  46         if(!avctx->channels)
  47             avctx->channels= 1;
  48
  49         if(!avctx->sample_rate)
  50             avctx->sample_rate= 8000;
  51
  52         avctx->sample_fmt = AV_SAMPLE_FMT_S16;
  53     }else{
  54         if (avctx->sample_rate != 8000) {
  55             av_log(avctx, AV_LOG_ERROR, "Sample rate 8000Hz required for GSM, got %dHz\n",
  56                 avctx->sample_rate);
  57             if(avctx->strict_std_compliance > FF_COMPLIANCE_UNOFFICIAL)
  58                 return -1;
  59         }
  60         if (avctx->bit_rate != 13000 /* Official */ &&
  61             avctx->bit_rate != 13200 /* Very common */ &&
  62             avctx->bit_rate != 0 /* Unknown; a.o. mov does not set bitrate when decoding */ ) {
  63             av_log(avctx, AV_LOG_ERROR, "Bitrate 13000bps required for GSM, got %dbps\n",
  64                 avctx->bit_rate);
  65             if(avctx->strict_std_compliance > FF_COMPLIANCE_UNOFFICIAL)
  66                 return -1;
  67         }
  68     }
  69
  70     avctx->priv_data = gsm_create();
  71
  72     switch(avctx->codec_id) {
  73     case CODEC_ID_GSM:
  74         avctx->frame_size = GSM_FRAME_SIZE;
  75         avctx->block_align = GSM_BLOCK_SIZE;
  76         break;
  77     case CODEC_ID_GSM_MS: {
  78         int one = 1;
  79         gsm_option(avctx->priv_data, GSM_OPT_WAV49, &one);
  80         avctx->frame_size = 2*GSM_FRAME_SIZE;
  81         avctx->block_align = GSM_MS_BLOCK_SIZE;
  82         }
  83     }
  84
  85     avctx->coded_frame= avcodec_alloc_frame();
  86     avctx->coded_frame->key_frame= 1;
  87
  88     return 0;
  89 }
  90
  91 static av_cold int libgsm_close(AVCodecContext *avctx) {
  92     av_freep(&avctx->coded_frame);
  93     gsm_destroy(avctx->priv_data);
  94     avctx->priv_data = NULL;
  95     return 0;
  96 }
  97
  98 static int libgsm_encode_frame(AVCodecContext *avctx,
  99                                unsigned char *frame, int buf_size, void *data) {
 100     // we need a full block
 101     if(buf_size < avctx->block_align) return 0;
 102
 103     switch(avctx->codec_id) {
 104     case CODEC_ID_GSM:
 105         gsm_encode(avctx->priv_data,data,frame);
 106         break;
 107     case CODEC_ID_GSM_MS:
 108         gsm_encode(avctx->priv_data,data,frame);
 109         gsm_encode(avctx->priv_data,((short*)data)+GSM_FRAME_SIZE,frame+32);
 110     }
 111     return avctx->block_align;
 112 }
 113
 114
 115 AVCodec ff_libgsm_encoder = {
 116     .name           = "libgsm",
 117     .type           = AVMEDIA_TYPE_AUDIO,
 118     .id             = CODEC_ID_GSM,
 119     .init           = libgsm_init,
 120     .encode         = libgsm_encode_frame,
 121     .close          = libgsm_close,
 122     .sample_fmts = (const enum AVSampleFormat[]){AV_SAMPLE_FMT_S16,AV_SAMPLE_FMT_NONE},
 123     .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM"),
 124 };
 125
 126 AVCodec ff_libgsm_ms_encoder = {
 127     .name           = "libgsm_ms",
 128     .type           = AVMEDIA_TYPE_AUDIO,
 129     .id             = CODEC_ID_GSM_MS,
 130     .init           = libgsm_init,
 131     .encode         = libgsm_encode_frame,
 132     .close          = libgsm_close,
 133     .sample_fmts = (const enum AVSampleFormat[]){AV_SAMPLE_FMT_S16,AV_SAMPLE_FMT_NONE},
 134     .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM Microsoft variant"),
 135 };
 136
 137 static int libgsm_decode_frame(AVCodecContext *avctx,
 138                                void *data, int *data_size,
 139                                AVPacket *avpkt) {
 140     uint8_t *buf = avpkt->data;
 141     int buf_size = avpkt->size;
 142     *data_size = 0; /* In case of error */
 143     if(buf_size < avctx->block_align) return -1;
 144     switch(avctx->codec_id) {
 145     case CODEC_ID_GSM:
 146         if(gsm_decode(avctx->priv_data,buf,data)) return -1;
 147         *data_size = GSM_FRAME_SIZE*sizeof(int16_t);
 148         break;
 149     case CODEC_ID_GSM_MS:
 150         if(gsm_decode(avctx->priv_data,buf,data) ||
 151            gsm_decode(avctx->priv_data,buf+33,((int16_t*)data)+GSM_FRAME_SIZE)) return -1;
 152         *data_size = GSM_FRAME_SIZE*sizeof(int16_t)*2;
 153     }
 154     return avctx->block_align;
 155 }
 156
 157 AVCodec ff_libgsm_decoder = {
 158     .name           = "libgsm",
 159     .type           = AVMEDIA_TYPE_AUDIO,
 160     .id             = CODEC_ID_GSM,
 161     .init           = libgsm_init,
 162     .close          = libgsm_close,
 163     .decode         = libgsm_decode_frame,
 164     .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM"),
 165 };
 166
 167 AVCodec ff_libgsm_ms_decoder = {
 168     .name           = "libgsm_ms",
 169     .type           = AVMEDIA_TYPE_AUDIO,
 170     .id             = CODEC_ID_GSM_MS,
 171     .init           = libgsm_init,
 172     .close          = libgsm_close,
 173     .decode         = libgsm_decode_frame,
 174     .long_name = NULL_IF_CONFIG_SMALL("libgsm GSM Microsoft variant"),
 175 };