libavcodec/audioconvert.c

   1 /*
   2  * audio conversion
   3  * Copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
   4  *
   5  * This file is part of FFmpeg.
   6  *
   7  * FFmpeg is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * FFmpeg is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with FFmpeg; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 /**
  23  * @file libavcodec/audioconvert.c
  24  * audio conversion
  25  * @author Michael Niedermayer <michaelni@gmx.at>
  26  */
  27
  28 #include "libavutil/avstring.h"
  29 #include "avcodec.h"
  30 #include "audioconvert.h"
  31
  32 typedef struct SampleFmtInfo {
  33     const char *name;
  34     int bits;
  35 } SampleFmtInfo;
  36
  37 /** this table gives more information about formats */
  38 static const SampleFmtInfo sample_fmt_info[SAMPLE_FMT_NB] = {
  39     [SAMPLE_FMT_U8]  = { .name = "u8",  .bits = 8 },
  40     [SAMPLE_FMT_S16] = { .name = "s16", .bits = 16 },
  41     [SAMPLE_FMT_S32] = { .name = "s32", .bits = 32 },
  42     [SAMPLE_FMT_FLT] = { .name = "flt", .bits = 32 },
  43     [SAMPLE_FMT_DBL] = { .name = "dbl", .bits = 64 },
  44 };
  45
  46 const char *avcodec_get_sample_fmt_name(int sample_fmt)
  47 {
  48     if (sample_fmt < 0 || sample_fmt >= SAMPLE_FMT_NB)
  49         return NULL;
  50     return sample_fmt_info[sample_fmt].name;
  51 }
  52
  53 enum SampleFormat avcodec_get_sample_fmt(const char* name)
  54 {
  55     int i;
  56
  57     for (i=0; i < SAMPLE_FMT_NB; i++)
  58         if (!strcmp(sample_fmt_info[i].name, name))
  59             return i;
  60     return SAMPLE_FMT_NONE;
  61 }
  62
  63 void avcodec_sample_fmt_string (char *buf, int buf_size, int sample_fmt)
  64 {
  65     /* print header */
  66     if (sample_fmt < 0)
  67         snprintf (buf, buf_size, "name  " " depth");
  68     else if (sample_fmt < SAMPLE_FMT_NB) {
  69         SampleFmtInfo info= sample_fmt_info[sample_fmt];
  70         snprintf (buf, buf_size, "%-6s" "   %2d ", info.name, info.bits);
  71     }
  72 }
  73
  74 static const char* const channel_names[]={
  75     "FL", "FR", "FC", "LFE", "BL",  "BR",  "FLC", "FRC",
  76     "BC", "SL", "SR", "TC",  "TFL", "TFC", "TFR", "TBL",
  77     "TBC", "TBR",
  78     [29] = "DL",
  79     [30] = "DR",
  80 };
  81
  82 const char *get_channel_name(int channel_id)
  83 {
  84     if (channel_id<0 || channel_id>=FF_ARRAY_ELEMS(channel_names))
  85         return NULL;
  86     return channel_names[channel_id];
  87 }
  88
  89 int64_t avcodec_guess_channel_layout(int nb_channels, enum CodecID codec_id, const char *fmt_name)
  90 {
  91     switch(nb_channels) {
  92     case 1: return CH_LAYOUT_MONO;
  93     case 2: return CH_LAYOUT_STEREO;
  94     case 3: return CH_LAYOUT_SURROUND;
  95     case 4: return CH_LAYOUT_QUAD;
  96     case 5: return CH_LAYOUT_5POINT0;
  97     case 6: return CH_LAYOUT_5POINT1;
  98     case 8: return CH_LAYOUT_7POINT1;
  99     default: return 0;
 100     }
 101 }
 102
 103 static const struct {
 104     const char *name;
 105     int         nb_channels;
 106     int64_t     layout;
 107 } channel_layout_map[] = {
 108     { "mono",        1,  CH_LAYOUT_MONO },
 109     { "stereo",      2,  CH_LAYOUT_STEREO },
 110     { "4.0",         4,  CH_LAYOUT_4POINT0 },
 111     { "quad",        4,  CH_LAYOUT_QUAD },
 112     { "5.0",         5,  CH_LAYOUT_5POINT0 },
 113     { "5.0",         5,  CH_LAYOUT_5POINT0_BACK },
 114     { "5.1",         6,  CH_LAYOUT_5POINT1 },
 115     { "5.1",         6,  CH_LAYOUT_5POINT1_BACK },
 116     { "5.1+downmix", 8,  CH_LAYOUT_5POINT1|CH_LAYOUT_STEREO_DOWNMIX, },
 117     { "7.1",         8,  CH_LAYOUT_7POINT1 },
 118     { "7.1(wide)",   8,  CH_LAYOUT_7POINT1_WIDE },
 119     { "7.1+downmix", 10, CH_LAYOUT_7POINT1|CH_LAYOUT_STEREO_DOWNMIX, },
 120     { 0 }
 121 };
 122
 123 void avcodec_get_channel_layout_string(char *buf, int buf_size, int nb_channels, int64_t channel_layout)
 124 {
 125     int i;
 126
 127     if (channel_layout==0)
 128         channel_layout = avcodec_guess_channel_layout(nb_channels, CODEC_ID_NONE, NULL);
 129
 130     for (i=0; channel_layout_map[i].name; i++)
 131         if (nb_channels    == channel_layout_map[i].nb_channels &&
 132             channel_layout == channel_layout_map[i].layout) {
 133             av_strlcpy(buf, channel_layout_map[i].name, buf_size);
 134             return;
 135         }
 136
 137     snprintf(buf, buf_size, "%d channels", nb_channels);
 138     if (channel_layout) {
 139         int i,ch;
 140         av_strlcat(buf, " (", buf_size);
 141         for(i=0,ch=0; i<64; i++) {
 142             if ((channel_layout & (1L<<i))) {
 143                 const char *name = get_channel_name(i);
 144                 if (name) {
 145                     if (ch>0) av_strlcat(buf, "|", buf_size);
 146                     av_strlcat(buf, name, buf_size);
 147                 }
 148                 ch++;
 149             }
 150         }
 151         av_strlcat(buf, ")", buf_size);
 152     }
 153 }
 154
 155 int avcodec_channel_layout_num_channels(int64_t channel_layout)
 156 {
 157     int count;
 158     uint64_t x = channel_layout;
 159     for (count = 0; x; count++)
 160         x &= x-1; // unset lowest set bit
 161     return count;
 162 }
 163
 164 struct AVAudioConvert {
 165     int in_channels, out_channels;
 166     int fmt_pair;
 167 };
 168
 169 AVAudioConvert *av_audio_convert_alloc(enum SampleFormat out_fmt, int out_channels,
 170                                        enum SampleFormat in_fmt, int in_channels,
 171                                        const float *matrix, int flags)
 172 {
 173     AVAudioConvert *ctx;
 174     if (in_channels!=out_channels)
 175         return NULL;  /* FIXME: not supported */
 176     ctx = av_malloc(sizeof(AVAudioConvert));
 177     if (!ctx)
 178         return NULL;
 179     ctx->in_channels = in_channels;
 180     ctx->out_channels = out_channels;
 181     ctx->fmt_pair = out_fmt + SAMPLE_FMT_NB*in_fmt;
 182     return ctx;
 183 }
 184
 185 void av_audio_convert_free(AVAudioConvert *ctx)
 186 {
 187     av_free(ctx);
 188 }
 189
 190 int av_audio_convert(AVAudioConvert *ctx,
 191                            void * const out[6], const int out_stride[6],
 192                      const void * const  in[6], const int  in_stride[6], int len)
 193 {
 194     int ch;
 195
 196     //FIXME optimize common cases
 197
 198     for(ch=0; ch<ctx->out_channels; ch++){
 199         const int is=  in_stride[ch];
 200         const int os= out_stride[ch];
 201         const uint8_t *pi=  in[ch];
 202         uint8_t *po= out[ch];
 203         uint8_t *end= po + os*len;
 204         if(!out[ch])
 205             continue;
 206
 207 #define CONV(ofmt, otype, ifmt, expr)\
 208 if(ctx->fmt_pair == ofmt + SAMPLE_FMT_NB*ifmt){\
 209     do{\
 210         *(otype*)po = expr; pi += is; po += os;\
 211     }while(po < end);\
 212 }
 213
 214 //FIXME put things below under ifdefs so we do not waste space for cases no codec will need
 215 //FIXME rounding and clipping ?
 216
 217              CONV(SAMPLE_FMT_U8 , uint8_t, SAMPLE_FMT_U8 ,  *(const uint8_t*)pi)
 218         else CONV(SAMPLE_FMT_S16, int16_t, SAMPLE_FMT_U8 , (*(const uint8_t*)pi - 0x80)<<8)
 219         else CONV(SAMPLE_FMT_S32, int32_t, SAMPLE_FMT_U8 , (*(const uint8_t*)pi - 0x80)<<24)
 220         else CONV(SAMPLE_FMT_FLT, float  , SAMPLE_FMT_U8 , (*(const uint8_t*)pi - 0x80)*(1.0 / (1<<7)))
 221         else CONV(SAMPLE_FMT_DBL, double , SAMPLE_FMT_U8 , (*(const uint8_t*)pi - 0x80)*(1.0 / (1<<7)))
 222         else CONV(SAMPLE_FMT_U8 , uint8_t, SAMPLE_FMT_S16, (*(const int16_t*)pi>>8) + 0x80)
 223         else CONV(SAMPLE_FMT_S16, int16_t, SAMPLE_FMT_S16,  *(const int16_t*)pi)
 224         else CONV(SAMPLE_FMT_S32, int32_t, SAMPLE_FMT_S16,  *(const int16_t*)pi<<16)
 225         else CONV(SAMPLE_FMT_FLT, float  , SAMPLE_FMT_S16,  *(const int16_t*)pi*(1.0 / (1<<15)))
 226         else CONV(SAMPLE_FMT_DBL, double , SAMPLE_FMT_S16,  *(const int16_t*)pi*(1.0 / (1<<15)))
 227         else CONV(SAMPLE_FMT_U8 , uint8_t, SAMPLE_FMT_S32, (*(const int32_t*)pi>>24) + 0x80)
 228         else CONV(SAMPLE_FMT_S16, int16_t, SAMPLE_FMT_S32,  *(const int32_t*)pi>>16)
 229         else CONV(SAMPLE_FMT_S32, int32_t, SAMPLE_FMT_S32,  *(const int32_t*)pi)
 230         else CONV(SAMPLE_FMT_FLT, float  , SAMPLE_FMT_S32,  *(const int32_t*)pi*(1.0 / (1<<31)))
 231         else CONV(SAMPLE_FMT_DBL, double , SAMPLE_FMT_S32,  *(const int32_t*)pi*(1.0 / (1<<31)))
 232         else CONV(SAMPLE_FMT_U8 , uint8_t, SAMPLE_FMT_FLT, lrintf(*(const float*)pi * (1<<7)) + 0x80)
 233         else CONV(SAMPLE_FMT_S16, int16_t, SAMPLE_FMT_FLT, lrintf(*(const float*)pi * (1<<15)))
 234         else CONV(SAMPLE_FMT_S32, int32_t, SAMPLE_FMT_FLT, lrintf(*(const float*)pi * (1<<31)))
 235         else CONV(SAMPLE_FMT_FLT, float  , SAMPLE_FMT_FLT, *(const float*)pi)
 236         else CONV(SAMPLE_FMT_DBL, double , SAMPLE_FMT_FLT, *(const float*)pi)
 237         else CONV(SAMPLE_FMT_U8 , uint8_t, SAMPLE_FMT_DBL, lrint(*(const double*)pi * (1<<7)) + 0x80)
 238         else CONV(SAMPLE_FMT_S16, int16_t, SAMPLE_FMT_DBL, lrint(*(const double*)pi * (1<<15)))
 239         else CONV(SAMPLE_FMT_S32, int32_t, SAMPLE_FMT_DBL, lrint(*(const double*)pi * (1<<31)))
 240         else CONV(SAMPLE_FMT_FLT, float  , SAMPLE_FMT_DBL, *(const double*)pi)
 241         else CONV(SAMPLE_FMT_DBL, double , SAMPLE_FMT_DBL, *(const double*)pi)
 242         else return -1;
 243     }
 244     return 0;
 245 }