-
-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
274 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,118 @@ | ||
/* | ||
* audio conversion | ||
* Copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at> | ||
* Copyright (c) 2008 Peter Ross | ||
* | ||
* This file is part of FFmpeg. | ||
* | ||
* FFmpeg is free software; you can redistribute it and/or | ||
* modify it under the terms of the GNU Lesser General Public | ||
* License as published by the Free Software Foundation; either | ||
* version 2.1 of the License, or (at your option) any later version. | ||
* | ||
* FFmpeg is distributed in the hope that it will be useful, | ||
* but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
* Lesser General Public License for more details. | ||
* | ||
* You should have received a copy of the GNU Lesser General Public | ||
* License along with FFmpeg; if not, write to the Free Software | ||
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | ||
*/ | ||
|
||
#ifndef AVCODEC_AUDIOCONVERT_H | ||
#define AVCODEC_AUDIOCONVERT_H | ||
|
||
/** | ||
* @file | ||
* Audio format conversion routines | ||
*/ | ||
|
||
|
||
#include "libavcodec/avcodec.h" | ||
#include "samplefmt.h" | ||
|
||
#if FF_API_OLD_SAMPLE_FMT | ||
/** | ||
* @deprecated Use av_get_sample_fmt_string() instead. | ||
*/ | ||
attribute_deprecated | ||
void avcodec_sample_fmt_string(char *buf, int buf_size, int sample_fmt); | ||
|
||
/** | ||
* @deprecated Use av_get_sample_fmt_name() instead. | ||
*/ | ||
attribute_deprecated | ||
const char *avcodec_get_sample_fmt_name(int sample_fmt); | ||
|
||
/** | ||
* @deprecated Use av_get_sample_fmt() instead. | ||
*/ | ||
attribute_deprecated | ||
enum AVSampleFormat avcodec_get_sample_fmt(const char* name); | ||
#endif | ||
|
||
#if FF_API_OLD_AUDIOCONVERT | ||
/** | ||
* @deprecated Use av_get_channel_layout() instead. | ||
*/ | ||
attribute_deprecated | ||
int64_t avcodec_get_channel_layout(const char *name); | ||
|
||
/** | ||
* @deprecated Use av_get_channel_layout_string() instead. | ||
*/ | ||
attribute_deprecated | ||
void avcodec_get_channel_layout_string(char *buf, int buf_size, int nb_channels, int64_t channel_layout); | ||
|
||
/** | ||
* @deprecated Use av_get_channel_layout_nb_channels() instead. | ||
*/ | ||
attribute_deprecated | ||
int avcodec_channel_layout_num_channels(int64_t channel_layout); | ||
#endif | ||
|
||
/** | ||
* Guess the channel layout | ||
* @param nb_channels | ||
* @param codec_id Codec identifier, or CODEC_ID_NONE if unknown | ||
* @param fmt_name Format name, or NULL if unknown | ||
* @return Channel layout mask | ||
*/ | ||
uint64_t avcodec_guess_channel_layout(int nb_channels, enum CodecID codec_id, const char *fmt_name); | ||
|
||
struct AVAudioConvert; | ||
typedef struct AVAudioConvert AVAudioConvert; | ||
|
||
/** | ||
* Create an audio sample format converter context | ||
* @param out_fmt Output sample format | ||
* @param out_channels Number of output channels | ||
* @param in_fmt Input sample format | ||
* @param in_channels Number of input channels | ||
* @param[in] matrix Channel mixing matrix (of dimension in_channel*out_channels). Set to NULL to ignore. | ||
* @param flags See AV_CPU_FLAG_xx | ||
* @return NULL on error | ||
*/ | ||
AVAudioConvert *av_audio_convert_alloc(enum AVSampleFormat out_fmt, int out_channels, | ||
enum AVSampleFormat in_fmt, int in_channels, | ||
const float *matrix, int flags); | ||
|
||
/** | ||
* Free audio sample format converter context | ||
*/ | ||
void av_audio_convert_free(AVAudioConvert *ctx); | ||
|
||
/** | ||
* Convert between audio sample formats | ||
* @param[in] out array of output buffers for each channel. set to NULL to ignore processing of the given channel. | ||
* @param[in] out_stride distance between consecutive output samples (measured in bytes) | ||
* @param[in] in array of input buffers for each channel | ||
* @param[in] in_stride distance between consecutive input samples (measured in bytes) | ||
* @param len length of audio frame size (measured in samples) | ||
*/ | ||
int av_audio_convert(AVAudioConvert *ctx, | ||
void * const out[6], const int out_stride[6], | ||
const void * const in[6], const int in_stride[6], int len); | ||
|
||
#endif /* AVCODEC_AUDIOCONVERT_H */ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,156 @@ | ||
/* | ||
* This file is part of FFmpeg. | ||
* | ||
* FFmpeg is free software; you can redistribute it and/or | ||
* modify it under the terms of the GNU Lesser General Public | ||
* License as published by the Free Software Foundation; either | ||
* version 2.1 of the License, or (at your option) any later version. | ||
* | ||
* FFmpeg is distributed in the hope that it will be useful, | ||
* but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
* Lesser General Public License for more details. | ||
* | ||
* You should have received a copy of the GNU Lesser General Public | ||
* License along with FFmpeg; if not, write to the Free Software | ||
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | ||
*/ | ||
|
||
#ifndef AVUTIL_SAMPLEFMT_H | ||
#define AVUTIL_SAMPLEFMT_H | ||
|
||
#include "libavutil/avutil.h" | ||
|
||
/** | ||
* all in native-endian format | ||
*/ | ||
enum AVSampleFormat { | ||
AV_SAMPLE_FMT_NONE = -1, | ||
AV_SAMPLE_FMT_U8, ///< unsigned 8 bits | ||
AV_SAMPLE_FMT_S16, ///< signed 16 bits | ||
AV_SAMPLE_FMT_S32, ///< signed 32 bits | ||
AV_SAMPLE_FMT_FLT, ///< float | ||
AV_SAMPLE_FMT_DBL, ///< double | ||
|
||
AV_SAMPLE_FMT_U8P, ///< unsigned 8 bits, planar | ||
AV_SAMPLE_FMT_S16P, ///< signed 16 bits, planar | ||
AV_SAMPLE_FMT_S32P, ///< signed 32 bits, planar | ||
AV_SAMPLE_FMT_FLTP, ///< float, planar | ||
AV_SAMPLE_FMT_DBLP, ///< double, planar | ||
|
||
AV_SAMPLE_FMT_NB ///< Number of sample formats. DO NOT USE if linking dynamically | ||
}; | ||
|
||
/** | ||
* Return the name of sample_fmt, or NULL if sample_fmt is not | ||
* recognized. | ||
*/ | ||
const char *av_get_sample_fmt_name(enum AVSampleFormat sample_fmt); | ||
|
||
/** | ||
* Return a sample format corresponding to name, or AV_SAMPLE_FMT_NONE | ||
* on error. | ||
*/ | ||
enum AVSampleFormat av_get_sample_fmt(const char *name); | ||
|
||
/** | ||
* Return the planar<->packed alternative form of the given sample format, or | ||
* AV_SAMPLE_FMT_NONE on error. If the passed sample_fmt is already in the | ||
* requested planar/packed format, the format returned is the same as the | ||
* input. | ||
*/ | ||
enum AVSampleFormat av_get_alt_sample_fmt(enum AVSampleFormat sample_fmt, int planar); | ||
|
||
/** | ||
* Generate a string corresponding to the sample format with | ||
* sample_fmt, or a header if sample_fmt is negative. | ||
* | ||
* @param buf the buffer where to write the string | ||
* @param buf_size the size of buf | ||
* @param sample_fmt the number of the sample format to print the | ||
* corresponding info string, or a negative value to print the | ||
* corresponding header. | ||
* @return the pointer to the filled buffer or NULL if sample_fmt is | ||
* unknown or in case of other errors | ||
*/ | ||
char *av_get_sample_fmt_string(char *buf, int buf_size, enum AVSampleFormat sample_fmt); | ||
|
||
#if FF_API_GET_BITS_PER_SAMPLE_FMT | ||
/** | ||
* @deprecated Use av_get_bytes_per_sample() instead. | ||
*/ | ||
attribute_deprecated | ||
int av_get_bits_per_sample_fmt(enum AVSampleFormat sample_fmt); | ||
#endif | ||
|
||
/** | ||
* Return number of bytes per sample. | ||
* | ||
* @param sample_fmt the sample format | ||
* @return number of bytes per sample or zero if unknown for the given | ||
* sample format | ||
*/ | ||
int av_get_bytes_per_sample(enum AVSampleFormat sample_fmt); | ||
|
||
/** | ||
* Check if the sample format is planar. | ||
* | ||
* @param sample_fmt the sample format to inspect | ||
* @return 1 if the sample format is planar, 0 if it is interleaved | ||
*/ | ||
int av_sample_fmt_is_planar(enum AVSampleFormat sample_fmt); | ||
|
||
/** | ||
* Get the required buffer size for the given audio parameters. | ||
* | ||
* @param[out] linesize calculated linesize, may be NULL | ||
* @param nb_channels the number of channels | ||
* @param nb_samples the number of samples in a single channel | ||
* @param sample_fmt the sample format | ||
* @return required buffer size, or negative error code on failure | ||
*/ | ||
int av_samples_get_buffer_size(int *linesize, int nb_channels, int nb_samples, | ||
enum AVSampleFormat sample_fmt, int align); | ||
|
||
/** | ||
* Fill channel data pointers and linesize for samples with sample | ||
* format sample_fmt. | ||
* | ||
* The pointers array is filled with the pointers to the samples data: | ||
* for planar, set the start point of each channel's data within the buffer, | ||
* for packed, set the start point of the entire buffer only. | ||
* | ||
* The linesize array is filled with the aligned size of each channel's data | ||
* buffer for planar layout, or the aligned size of the buffer for all channels | ||
* for packed layout. | ||
* | ||
* @param[out] audio_data array to be filled with the pointer for each channel | ||
* @param[out] linesize calculated linesize | ||
* @param buf the pointer to a buffer containing the samples | ||
* @param nb_channels the number of channels | ||
* @param nb_samples the number of samples in a single channel | ||
* @param sample_fmt the sample format | ||
* @param align buffer size alignment (1 = no alignment required) | ||
* @return 0 on success or a negative error code on failure | ||
*/ | ||
int av_samples_fill_arrays(uint8_t **audio_data, int *linesize, uint8_t *buf, | ||
int nb_channels, int nb_samples, | ||
enum AVSampleFormat sample_fmt, int align); | ||
|
||
/** | ||
* Allocate a samples buffer for nb_samples samples, and fill data pointers and | ||
* linesize accordingly. | ||
* The allocated samples buffer can be freed by using av_freep(&audio_data[0]) | ||
* | ||
* @param[out] audio_data array to be filled with the pointer for each channel | ||
* @param[out] linesize aligned size for audio buffer(s) | ||
* @param nb_channels number of audio channels | ||
* @param nb_samples number of samples per channel | ||
* @param align buffer size alignment (1 = no alignment required) | ||
* @return 0 on success or a negative error code on failure | ||
* @see av_samples_fill_arrays() | ||
*/ | ||
int av_samples_alloc(uint8_t **audio_data, int *linesize, int nb_channels, | ||
int nb_samples, enum AVSampleFormat sample_fmt, int align); | ||
|
||
#endif /* AVUTIL_SAMPLEFMT_H */ |