World of Might and Magic
0.2.0
Open reimplementation of Might and Magic 6 7 8 game engine
|
Audio resampling, sample format conversion and mixing library. Подробнее...
Файлы | |
файл | swresample.h |
Определения типов | |
typedef struct SwrContext | SwrContext |
Функции | |
const AVClass * | swr_get_class (void) |
Option constants | |
These constants are used for the AVOptions interface for lswr. | |
enum | SwrDitherType { SWR_DITHER_NONE = 0, SWR_DITHER_RECTANGULAR, SWR_DITHER_TRIANGULAR, SWR_DITHER_TRIANGULAR_HIGHPASS, SWR_DITHER_NS = 64, SWR_DITHER_NS_LIPSHITZ, SWR_DITHER_NS_F_WEIGHTED, SWR_DITHER_NS_MODIFIED_E_WEIGHTED, SWR_DITHER_NS_IMPROVED_E_WEIGHTED, SWR_DITHER_NS_SHIBATA, SWR_DITHER_NS_LOW_SHIBATA, SWR_DITHER_NS_HIGH_SHIBATA, SWR_DITHER_NB } |
enum | SwrEngine { SWR_ENGINE_SWR, SWR_ENGINE_SOXR, SWR_ENGINE_NB } |
enum | SwrFilterType { SWR_FILTER_TYPE_CUBIC, SWR_FILTER_TYPE_BLACKMAN_NUTTALL, SWR_FILTER_TYPE_KAISER } |
SwrContext constructor functions | |
struct SwrContext * | swr_alloc (void) |
int | swr_init (struct SwrContext *s) |
int | swr_is_initialized (struct SwrContext *s) |
struct SwrContext * | swr_alloc_set_opts (struct SwrContext *s, int64_t out_ch_layout, enum AVSampleFormat out_sample_fmt, int out_sample_rate, int64_t in_ch_layout, enum AVSampleFormat in_sample_fmt, int in_sample_rate, int log_offset, void *log_ctx) |
SwrContext destructor functions | |
void | swr_free (struct SwrContext **s) |
void | swr_close (struct SwrContext *s) |
Core conversion functions | |
int | swr_convert (struct SwrContext *s, uint8_t **out, int out_count, const uint8_t **in, int in_count) |
int64_t | swr_next_pts (struct SwrContext *s, int64_t pts) |
Low-level option setting functions | |
These functons provide a means to set low-level options that is not possible with the AVOption API. | |
int | swr_set_compensation (struct SwrContext *s, int sample_delta, int compensation_distance) |
int | swr_set_channel_mapping (struct SwrContext *s, const int *channel_map) |
int | swr_build_matrix (uint64_t in_layout, uint64_t out_layout, double center_mix_level, double surround_mix_level, double lfe_mix_level, double rematrix_maxval, double rematrix_volume, double *matrix, int stride, enum AVMatrixEncoding matrix_encoding, void *log_ctx) |
int | swr_set_matrix (struct SwrContext *s, const double *matrix, int stride) |
Sample handling functions | |
int | swr_drop_output (struct SwrContext *s, int count) |
int | swr_inject_silence (struct SwrContext *s, int count) |
int64_t | swr_get_delay (struct SwrContext *s, int64_t base) |
int | swr_get_out_samples (struct SwrContext *s, int in_samples) |
Configuration accessors | |
unsigned | swresample_version (void) |
const char * | swresample_configuration (void) |
const char * | swresample_license (void) |
AVFrame based API | |
int | swr_convert_frame (SwrContext *swr, AVFrame *output, const AVFrame *input) |
int | swr_config_frame (SwrContext *swr, const AVFrame *out, const AVFrame *in) |
Audio resampling, sample format conversion and mixing library.
Interaction with lswr is done through SwrContext, which is allocated with swr_alloc() or swr_alloc_set_opts(). It is opaque, so all parameters must be set with the AVOptions API.
The first thing you will need to do in order to use lswr is to allocate SwrContext. This can be done with swr_alloc() or swr_alloc_set_opts(). If you are using the former, you must set options through the AVOptions API. The latter function provides the same feature, but it allows you to set some common options in the same statement.
For example the following code will setup conversion from planar float sample format to interleaved signed 16-bit integer, downsampling from 48kHz to 44.1kHz and downmixing from 5.1 channels to stereo (using the default mixing matrix). This is using the swr_alloc() function.
The same job can be done using swr_alloc_set_opts() as well:
Once all values have been set, it must be initialized with swr_init(). If you need to change the conversion parameters, you can change the parameters using AVOptions, as described above in the first example; or by using swr_alloc_set_opts(), but with the first argument the allocated context. You must then call swr_init() again.
The conversion itself is done by repeatedly calling swr_convert(). Note that the samples may get buffered in swr if you provide insufficient output space or if sample rate conversion is done, which requires "future" samples. Samples that do not require future input can be retrieved at any time by using swr_convert() (in_count can be set to 0). At the end of conversion the resampling buffer can be flushed by calling swr_convert() with NULL in and 0 in_count.
The samples used in the conversion process can be managed with the libavutil samples manipulation API, including av_samples_alloc() function used in the following example.
The delay between input and output, can at any time be found by using swr_get_delay().
The following code demonstrates the conversion loop assuming the parameters from above and caller-defined functions get_input() and handle_output():
When the conversion is finished, the conversion context and everything associated with it must be freed with swr_free(). A swr_close() function is also available, but it exists mainly for compatibility with libavresample, and is not required to be called.
There will be no memory leak if the data is not completely flushed before swr_free().
typedef struct SwrContext SwrContext |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
The libswresample context. Unlike libavcodec and libavformat, this structure is opaque. This means that if you would like to set options, you must use the AVOptions API and cannot directly set values to members of the structure.
См. определение в файле swresample.h строка 182
enum SwrDitherType |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Dithering algorithms
См. определение в файле swresample.h строка 141
enum SwrEngine |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Resampling Engines
Элементы перечислений | |
---|---|
SWR_ENGINE_SWR | SW Resampler |
SWR_ENGINE_SOXR | SoX Resampler |
SWR_ENGINE_NB | not part of API/ABI |
См. определение в файле swresample.h строка 159
enum SwrFilterType |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Resampling Filter Types
Элементы перечислений | |
---|---|
SWR_FILTER_TYPE_CUBIC | Cubic |
SWR_FILTER_TYPE_BLACKMAN_NUTTALL | Blackman Nuttall windowed sinc |
SWR_FILTER_TYPE_KAISER | Kaiser windowed sinc |
См. определение в файле swresample.h строка 166
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Get the AVClass for SwrContext. It can be used in combination with AV_OPT_SEARCH_FAKE_OBJ for examining options.
struct SwrContext* swr_alloc | ( | void | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Allocate SwrContext.
If you use this function you will need to set the parameters (manually or with swr_alloc_set_opts()) before calling swr_init().
int swr_init | ( | struct SwrContext * | s | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Initialize context after user parameters have been set.
[in,out] | s | Swr context to initialize |
Используется в AVAudioStream::open() и AudioBaseDataSource::Open().
int swr_is_initialized | ( | struct SwrContext * | s | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Check whether an swr context has been initialized or not.
[in] | s | Swr context to check |
struct SwrContext* swr_alloc_set_opts | ( | struct SwrContext * | s, |
int64_t | out_ch_layout, | ||
enum AVSampleFormat | out_sample_fmt, | ||
int | out_sample_rate, | ||
int64_t | in_ch_layout, | ||
enum AVSampleFormat | in_sample_fmt, | ||
int | in_sample_rate, | ||
int | log_offset, | ||
void * | log_ctx | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Allocate SwrContext if needed and set/reset common parameters.
This function does not require s to be allocated with swr_alloc(). On the other hand, swr_alloc() can use swr_alloc_set_opts() to set the parameters on the allocated context.
s | existing Swr context if available, or NULL if not |
out_ch_layout | output channel layout (AV_CH_LAYOUT_*) |
out_sample_fmt | output sample format (AV_SAMPLE_FMT_*). |
out_sample_rate | output sample rate (frequency in Hz) |
in_ch_layout | input channel layout (AV_CH_LAYOUT_*) |
in_sample_fmt | input sample format (AV_SAMPLE_FMT_*). |
in_sample_rate | input sample rate (frequency in Hz) |
log_offset | logging level offset |
log_ctx | parent logging context, can be NULL |
Используется в AVAudioStream::open() и AudioBaseDataSource::Open().
void swr_free | ( | struct SwrContext ** | s | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Free the given SwrContext and set the pointer to NULL.
[in] | s | a pointer to a pointer to Swr context |
Используется в AudioBaseDataSource::Close() и AVAudioStream::open().
void swr_close | ( | struct SwrContext * | s | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Closes the context so that swr_is_initialized() returns 0.
The context can be brought back to life by running swr_init(), swr_init() can also be used without swr_close(). This function is mainly provided for simplifying the usecase where one tries to support libavresample and libswresample.
[in,out] | s | Swr context to be closed |
int swr_convert | ( | struct SwrContext * | s, |
uint8_t ** | out, | ||
int | out_count, | ||
const uint8_t ** | in, | ||
int | in_count | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Convert audio.
in and in_count can be set to 0 to flush the last few samples out at the end.
If more input is provided than output space, then the input will be buffered. You can avoid this buffering by using swr_get_out_samples() to retrieve an upper bound on the required number of output samples for the given number of input samples. Conversion will run directly without copying whenever possible.
s | allocated Swr context, with parameters set |
out | output buffers, only the first one need be set in case of packed audio |
out_count | amount of space available for output in samples per channel |
in | input buffers, only the first one need to be set in case of packed audio |
in_count | number of input samples available in one channel |
Используется в AVAudioStream::decode_frame() и AudioBaseDataSource::GetNextBuffer().
int64_t swr_next_pts | ( | struct SwrContext * | s, |
int64_t | pts | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Convert the next timestamp from input to output timestamps are in 1/(in_sample_rate * out_sample_rate) units.
s[in] | initialized Swr context |
pts[in] | timestamp for the next input sample, INT64_MIN if unknown |
int swr_set_compensation | ( | struct SwrContext * | s, |
int | sample_delta, | ||
int | compensation_distance | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Activate resampling compensation ("soft" compensation). This function is internally called when needed in swr_next_pts().
[in,out] | s | allocated Swr context. If it is not initialized, or SWR_FLAG_RESAMPLE is not set, swr_init() is called with the flag set. |
[in] | sample_delta | delta in PTS per sample |
[in] | compensation_distance | number of samples to compensate for |
s
is NULL, compensation_distance
is less than 0, compensation_distance
is 0 but sample_delta is not, int swr_set_channel_mapping | ( | struct SwrContext * | s, |
const int * | channel_map | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Set a customized input channel mapping.
[in,out] | s | allocated Swr context, not yet initialized |
[in] | channel_map | customized input channel mapping (array of channel indexes, -1 for a muted channel) |
int swr_build_matrix | ( | uint64_t | in_layout, |
uint64_t | out_layout, | ||
double | center_mix_level, | ||
double | surround_mix_level, | ||
double | lfe_mix_level, | ||
double | rematrix_maxval, | ||
double | rematrix_volume, | ||
double * | matrix, | ||
int | stride, | ||
enum AVMatrixEncoding | matrix_encoding, | ||
void * | log_ctx | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Generate a channel mixing matrix.
This function is the one used internally by libswresample for building the default mixing matrix. It is made public just as a utility function for building custom matrices.
in_layout | input channel layout | |
out_layout | output channel layout | |
center_mix_level | mix level for the center channel | |
surround_mix_level | mix level for the surround channel(s) | |
lfe_mix_level | mix level for the low-frequency effects channel | |
rematrix_maxval | if 1.0, coefficients will be normalized to prevent overflow. if INT_MAX, coefficients will not be normalized. | |
[out] | matrix | mixing coefficients; matrix[i + stride * o] is the weight of input channel i in output channel o. |
stride | distance between adjacent input channels in the matrix array | |
matrix_encoding | matrixed stereo downmix mode (e.g. dplii) | |
log_ctx | parent logging context, can be NULL |
int swr_set_matrix | ( | struct SwrContext * | s, |
const double * | matrix, | ||
int | stride | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Set a customized remix matrix.
s | allocated Swr context, not yet initialized |
matrix | remix coefficients; matrix[i + stride * o] is the weight of input channel i in output channel o |
stride | offset between lines of the matrix |
int swr_drop_output | ( | struct SwrContext * | s, |
int | count | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Drops the specified number of output samples.
This function, along with swr_inject_silence(), is called by swr_next_pts() if needed for "hard" compensation.
s | allocated Swr context |
count | number of samples to be dropped |
int swr_inject_silence | ( | struct SwrContext * | s, |
int | count | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Injects the specified number of silence samples.
This function, along with swr_drop_output(), is called by swr_next_pts() if needed for "hard" compensation.
s | allocated Swr context |
count | number of samples to be dropped |
int64_t swr_get_delay | ( | struct SwrContext * | s, |
int64_t | base | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Gets the delay the next input sample will experience relative to the next output sample.
Swresample can buffer data if more input has been provided than available output space, also converting between sample rates needs a delay. This function returns the sum of all such delays. The exact delay is not necessarily an integer value in either input or output sample rate. Especially when downsampling by a large value, the output sample rate may be a poor choice to represent the delay, similarly for upsampling and the input sample rate.
s | swr context |
base | timebase in which the returned delay will be:
|
base
units. int swr_get_out_samples | ( | struct SwrContext * | s, |
int | in_samples | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Find an upper bound on the number of samples that the next swr_convert call will output, if called with in_samples of input samples. This depends on the internal state, and anything changing the internal state (like further swr_convert() calls) will may change the number of samples swr_get_out_samples() returns for the same number of input samples.
in_samples | number of input samples. |
unsigned swresample_version | ( | void | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Return the LIBSWRESAMPLE_VERSION_INT constant.
This is useful to check if the build-time libswresample has the same version as the run-time one.
const char* swresample_configuration | ( | void | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Return the swr build-time configuration.
./configure flags const char* swresample_license | ( | void | ) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Return the swr license.
int swr_convert_frame | ( | SwrContext * | swr, |
AVFrame * | output, | ||
const AVFrame * | input | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Convert the samples in the input AVFrame and write them to the output AVFrame.
Input and output AVFrames must have channel_layout, sample_rate and format set.
If the output AVFrame does not have the data pointers allocated the nb_samples field will be set using av_frame_get_buffer() is called to allocate the frame.
The output AVFrame can be NULL or have fewer allocated samples than required. In this case, any remaining samples not written to the output will be added to an internal FIFO buffer, to be returned at the next call to this function or to swr_convert().
If converting sample rate, there may be data remaining in the internal resampling delay buffer. swr_get_delay() tells the number of remaining samples. To get this data as output, call this function or swr_convert() with NULL input.
If the SwrContext configuration does not match the output and input AVFrame settings the conversion does not take place and depending on which AVFrame is not matching AVERROR_OUTPUT_CHANGED, AVERROR_INPUT_CHANGED or the result of a bitwise-OR of them is returned.
int swr_config_frame | ( | SwrContext * | swr, |
const AVFrame * | out, | ||
const AVFrame * | in | ||
) |
#include <C:/git/world-of-might-and-magic/lib/win32/x86/ffmpeg-4.2.2/include/libswresample/swresample.h>
Configure or reconfigure the SwrContext using the information provided by the AVFrames.
The original resampling context is reset even on failure. The function calls swr_close() internally if the context is open.