FFmpeg
Data Structures | Typedefs | Enumerations | Functions
tx.h File Reference
#include <stdint.h>
#include <stddef.h>

Go to the source code of this file.

Data Structures

struct  AVComplexFloat
 
struct  AVComplexDouble
 
struct  AVComplexInt32
 

Typedefs

typedef void(* av_tx_fn) (AVTXContext *s, void *out, void *in, ptrdiff_t stride)
 Function pointer to a function to perform the transform. More...
 

Enumerations

enum  AVTXType {
  AV_TX_FLOAT_FFT = 0, AV_TX_FLOAT_MDCT = 1, AV_TX_DOUBLE_FFT = 2, AV_TX_DOUBLE_MDCT = 3,
  AV_TX_INT32_FFT = 4, AV_TX_INT32_MDCT = 5
}
 

Functions

int av_tx_init (AVTXContext **ctx, av_tx_fn *tx, enum AVTXType type, int inv, int len, const void *scale, uint64_t flags)
 Initialize a transform context with the given configuration Currently power of two lengths from 2 to 131072 are supported, along with any length decomposable to a power of two and either 3, 5 or 15. More...
 
void av_tx_uninit (AVTXContext **ctx)
 Frees a context and sets ctx to NULL, does nothing when ctx == NULL. More...
 

Typedef Documentation

◆ av_tx_fn

typedef void(* av_tx_fn) (AVTXContext *s, void *out, void *in, ptrdiff_t stride)

Function pointer to a function to perform the transform.

Note
Using a different context than the one allocated during av_tx_init() is not allowed.
Parameters
sthe transform context
outthe output array
inthe input array
stridethe input or output stride in bytes

The out and in arrays must be aligned to the maximum required by the CPU architecture. The stride must follow the constraints the transform type has specified.

Definition at line 92 of file tx.h.

Enumeration Type Documentation

◆ AVTXType

enum AVTXType
Enumerator
AV_TX_FLOAT_FFT 

Standard complex to complex FFT with sample data type AVComplexFloat.

Output is not 1/len normalized. Scaling currently unsupported. The stride parameter is ignored.

AV_TX_FLOAT_MDCT 

Standard MDCT with sample data type of float and a scale type of float.

Length is the frame size, not the window size (which is 2x frame) For forward transforms, the stride specifies the spacing between each sample in the output array in bytes. The input must be a flat array. For inverse transforms, the stride specifies the spacing between each sample in the input array in bytes. The output will be a flat array. Stride must be a non-zero multiple of sizeof(float).

AV_TX_DOUBLE_FFT 

Same as AV_TX_FLOAT_FFT with a data type of AVComplexDouble.

AV_TX_DOUBLE_MDCT 

Same as AV_TX_FLOAT_MDCT with data and scale type of double.

Stride must be a non-zero multiple of sizeof(double).

AV_TX_INT32_FFT 

Same as AV_TX_FLOAT_FFT with a data type of AVComplexInt32.

AV_TX_INT32_MDCT 

Same as AV_TX_FLOAT_MDCT with data type of int32_t and scale type of float.

Only scale values less than or equal to 1.0 are supported. Stride must be a non-zero multiple of sizeof(int32_t).

Definition at line 39 of file tx.h.

Function Documentation

◆ av_tx_init()

int av_tx_init ( AVTXContext **  ctx,
av_tx_fn tx,
enum AVTXType  type,
int  inv,
int  len,
const void *  scale,
uint64_t  flags 
)

Initialize a transform context with the given configuration Currently power of two lengths from 2 to 131072 are supported, along with any length decomposable to a power of two and either 3, 5 or 15.

Parameters
ctxthe context to allocate, will be NULL on error
txpointer to the transform function pointer to set
typetype the type of transform
invwhether to do an inverse or a forward transform
lenthe size of the transform in samples
scalepointer to the value to scale the output if supported by type
flagscurrently unused
Returns
0 on success, negative error code on failure

Definition at line 123 of file tx.c.

Referenced by config_input(), config_output(), decode_init(), and siren_init().

◆ av_tx_uninit()

void av_tx_uninit ( AVTXContext **  ctx)

Frees a context and sets ctx to NULL, does nothing when ctx == NULL.

Definition at line 110 of file tx.c.

Referenced by av_tx_init(), decode_close(), siren_close(), and uninit().