git.sesse.net Git - ffmpeg/blob - libswresample/audioconvert.h

   1 /*
   2  * audio conversion
   3  * Copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
   4  * Copyright (c) 2008 Peter Ross
   5  *
   6  * This file is part of FFmpeg.
   7  *
   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.
  12  *
  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.
  17  *
  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
  21  */
  22
  23 #ifndef SWR_AUDIOCONVERT_H
  24 #define SWR_AUDIOCONVERT_H
  25
  26 /**
  27  * @file
  28  * Audio format conversion routines
  29  */
  30
  31
  32 #include "swresample_internal.h"
  33 #include "libavutil/cpu.h"
  34 #include "libavutil/audioconvert.h"
  35
  36 struct AudioConvert;
  37 typedef struct AudioConvert AudioConvert;
  38
  39 /**
  40  * Create an audio sample format converter context
  41  * @param out_fmt Output sample format
  42  * @param in_fmt Input sample format
  43  * @param channels Number of channels
  44  * @param flags See AV_CPU_FLAG_xx
  45  * @param ch_map list of the channels id to pick from the source stream, NULL
  46  *               if all channels must be selected
  47  * @return NULL on error
  48  */
  49 AudioConvert *swri_audio_convert_alloc(enum AVSampleFormat out_fmt,
  50                                        enum AVSampleFormat in_fmt,
  51                                        int channels, const int *ch_map,
  52                                        int flags);
  53
  54 /**
  55  * Free audio sample format converter context.
  56  * and set the pointer to NULL
  57  */
  58 void swri_audio_convert_free(AudioConvert **ctx);
  59
  60 /**
  61  * Convert between audio sample formats
  62  * @param[in] out array of output buffers for each channel. set to NULL to ignore processing of the given channel.
  63  * @param[in] in array of input buffers for each channel
  64  * @param len length of audio frame size (measured in samples)
  65  */
  66 int swri_audio_convert(AudioConvert *ctx, AudioData *out, AudioData *in, int len);
  67
  68 #endif /* AUDIOCONVERT_H */