593 lines
25 KiB
C
593 lines
25 KiB
C
/******************************************************************************
|
|
* @file transform_functions.h
|
|
* @brief Public header file for CMSIS DSP Library
|
|
* @version V1.9.0
|
|
* @date 23 April 2021
|
|
* Target Processor: Cortex-M and Cortex-A cores
|
|
******************************************************************************/
|
|
/*
|
|
* Copyright (c) 2010-2020 Arm Limited or its affiliates. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the License); you may
|
|
* not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
|
|
#ifndef _TRANSFORM_FUNCTIONS_H_
|
|
#define _TRANSFORM_FUNCTIONS_H_
|
|
|
|
#include "arm_math_types.h"
|
|
#include "arm_math_memory.h"
|
|
|
|
#include "dsp/none.h"
|
|
#include "dsp/utils.h"
|
|
|
|
#include "dsp/basic_math_functions.h"
|
|
#include "dsp/complex_math_functions.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
|
|
/**
|
|
* @defgroup groupTransforms Transform Functions
|
|
*/
|
|
|
|
|
|
/**
|
|
* @brief Instance structure for the Q15 CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */
|
|
uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */
|
|
const q15_t *pTwiddle; /**< points to the Sin twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */
|
|
} arm_cfft_radix2_instance_q15;
|
|
|
|
/* Deprecated */
|
|
arm_status arm_cfft_radix2_init_q15(
|
|
arm_cfft_radix2_instance_q15 * S,
|
|
uint16_t fftLen,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/* Deprecated */
|
|
void arm_cfft_radix2_q15(
|
|
const arm_cfft_radix2_instance_q15 * S,
|
|
q15_t * pSrc);
|
|
|
|
|
|
/**
|
|
* @brief Instance structure for the Q15 CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */
|
|
uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */
|
|
const q15_t *pTwiddle; /**< points to the twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */
|
|
} arm_cfft_radix4_instance_q15;
|
|
|
|
/* Deprecated */
|
|
arm_status arm_cfft_radix4_init_q15(
|
|
arm_cfft_radix4_instance_q15 * S,
|
|
uint16_t fftLen,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/* Deprecated */
|
|
void arm_cfft_radix4_q15(
|
|
const arm_cfft_radix4_instance_q15 * S,
|
|
q15_t * pSrc);
|
|
|
|
/**
|
|
* @brief Instance structure for the Radix-2 Q31 CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */
|
|
uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */
|
|
const q31_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */
|
|
} arm_cfft_radix2_instance_q31;
|
|
|
|
/* Deprecated */
|
|
arm_status arm_cfft_radix2_init_q31(
|
|
arm_cfft_radix2_instance_q31 * S,
|
|
uint16_t fftLen,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/* Deprecated */
|
|
void arm_cfft_radix2_q31(
|
|
const arm_cfft_radix2_instance_q31 * S,
|
|
q31_t * pSrc);
|
|
|
|
/**
|
|
* @brief Instance structure for the Q31 CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */
|
|
uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */
|
|
const q31_t *pTwiddle; /**< points to the twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */
|
|
} arm_cfft_radix4_instance_q31;
|
|
|
|
/* Deprecated */
|
|
void arm_cfft_radix4_q31(
|
|
const arm_cfft_radix4_instance_q31 * S,
|
|
q31_t * pSrc);
|
|
|
|
/* Deprecated */
|
|
arm_status arm_cfft_radix4_init_q31(
|
|
arm_cfft_radix4_instance_q31 * S,
|
|
uint16_t fftLen,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/**
|
|
* @brief Instance structure for the floating-point CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */
|
|
uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */
|
|
const float32_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */
|
|
float32_t onebyfftLen; /**< value of 1/fftLen. */
|
|
} arm_cfft_radix2_instance_f32;
|
|
|
|
|
|
/* Deprecated */
|
|
arm_status arm_cfft_radix2_init_f32(
|
|
arm_cfft_radix2_instance_f32 * S,
|
|
uint16_t fftLen,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/* Deprecated */
|
|
void arm_cfft_radix2_f32(
|
|
const arm_cfft_radix2_instance_f32 * S,
|
|
float32_t * pSrc);
|
|
|
|
/**
|
|
* @brief Instance structure for the floating-point CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */
|
|
uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */
|
|
const float32_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */
|
|
float32_t onebyfftLen; /**< value of 1/fftLen. */
|
|
} arm_cfft_radix4_instance_f32;
|
|
|
|
|
|
|
|
/* Deprecated */
|
|
arm_status arm_cfft_radix4_init_f32(
|
|
arm_cfft_radix4_instance_f32 * S,
|
|
uint16_t fftLen,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/* Deprecated */
|
|
void arm_cfft_radix4_f32(
|
|
const arm_cfft_radix4_instance_f32 * S,
|
|
float32_t * pSrc);
|
|
|
|
/**
|
|
* @brief Instance structure for the fixed-point CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
const q15_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t bitRevLength; /**< bit reversal table length. */
|
|
#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE)
|
|
const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \
|
|
const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \
|
|
const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \
|
|
const q15_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \
|
|
const q15_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \
|
|
const q15_t *rearranged_twiddle_stride3;
|
|
#endif
|
|
} arm_cfft_instance_q15;
|
|
|
|
arm_status arm_cfft_init_q15(
|
|
arm_cfft_instance_q15 * S,
|
|
uint16_t fftLen);
|
|
|
|
void arm_cfft_q15(
|
|
const arm_cfft_instance_q15 * S,
|
|
q15_t * p1,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/**
|
|
* @brief Instance structure for the fixed-point CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
const q31_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t bitRevLength; /**< bit reversal table length. */
|
|
#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE)
|
|
const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \
|
|
const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \
|
|
const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \
|
|
const q31_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \
|
|
const q31_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \
|
|
const q31_t *rearranged_twiddle_stride3;
|
|
#endif
|
|
} arm_cfft_instance_q31;
|
|
|
|
arm_status arm_cfft_init_q31(
|
|
arm_cfft_instance_q31 * S,
|
|
uint16_t fftLen);
|
|
|
|
void arm_cfft_q31(
|
|
const arm_cfft_instance_q31 * S,
|
|
q31_t * p1,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/**
|
|
* @brief Instance structure for the floating-point CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
const float32_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t bitRevLength; /**< bit reversal table length. */
|
|
#if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE)
|
|
const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \
|
|
const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \
|
|
const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \
|
|
const float32_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \
|
|
const float32_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \
|
|
const float32_t *rearranged_twiddle_stride3;
|
|
#endif
|
|
} arm_cfft_instance_f32;
|
|
|
|
|
|
|
|
arm_status arm_cfft_init_f32(
|
|
arm_cfft_instance_f32 * S,
|
|
uint16_t fftLen);
|
|
|
|
void arm_cfft_f32(
|
|
const arm_cfft_instance_f32 * S,
|
|
float32_t * p1,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
|
|
/**
|
|
* @brief Instance structure for the Double Precision Floating-point CFFT/CIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t fftLen; /**< length of the FFT. */
|
|
const float64_t *pTwiddle; /**< points to the Twiddle factor table. */
|
|
const uint16_t *pBitRevTable; /**< points to the bit reversal table. */
|
|
uint16_t bitRevLength; /**< bit reversal table length. */
|
|
} arm_cfft_instance_f64;
|
|
|
|
arm_status arm_cfft_init_f64(
|
|
arm_cfft_instance_f64 * S,
|
|
uint16_t fftLen);
|
|
|
|
void arm_cfft_f64(
|
|
const arm_cfft_instance_f64 * S,
|
|
float64_t * p1,
|
|
uint8_t ifftFlag,
|
|
uint8_t bitReverseFlag);
|
|
|
|
/**
|
|
* @brief Instance structure for the Q15 RFFT/RIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t fftLenReal; /**< length of the real FFT. */
|
|
uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */
|
|
uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */
|
|
uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
const q15_t *pTwiddleAReal; /**< points to the real twiddle factor table. */
|
|
const q15_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */
|
|
#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE)
|
|
arm_cfft_instance_q15 cfftInst;
|
|
#else
|
|
const arm_cfft_instance_q15 *pCfft; /**< points to the complex FFT instance. */
|
|
#endif
|
|
} arm_rfft_instance_q15;
|
|
|
|
arm_status arm_rfft_init_q15(
|
|
arm_rfft_instance_q15 * S,
|
|
uint32_t fftLenReal,
|
|
uint32_t ifftFlagR,
|
|
uint32_t bitReverseFlag);
|
|
|
|
void arm_rfft_q15(
|
|
const arm_rfft_instance_q15 * S,
|
|
q15_t * pSrc,
|
|
q15_t * pDst);
|
|
|
|
/**
|
|
* @brief Instance structure for the Q31 RFFT/RIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t fftLenReal; /**< length of the real FFT. */
|
|
uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */
|
|
uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */
|
|
uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
const q31_t *pTwiddleAReal; /**< points to the real twiddle factor table. */
|
|
const q31_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */
|
|
#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE)
|
|
arm_cfft_instance_q31 cfftInst;
|
|
#else
|
|
const arm_cfft_instance_q31 *pCfft; /**< points to the complex FFT instance. */
|
|
#endif
|
|
} arm_rfft_instance_q31;
|
|
|
|
arm_status arm_rfft_init_q31(
|
|
arm_rfft_instance_q31 * S,
|
|
uint32_t fftLenReal,
|
|
uint32_t ifftFlagR,
|
|
uint32_t bitReverseFlag);
|
|
|
|
void arm_rfft_q31(
|
|
const arm_rfft_instance_q31 * S,
|
|
q31_t * pSrc,
|
|
q31_t * pDst);
|
|
|
|
/**
|
|
* @brief Instance structure for the floating-point RFFT/RIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t fftLenReal; /**< length of the real FFT. */
|
|
uint16_t fftLenBy2; /**< length of the complex FFT. */
|
|
uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */
|
|
uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */
|
|
uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */
|
|
const float32_t *pTwiddleAReal; /**< points to the real twiddle factor table. */
|
|
const float32_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */
|
|
arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */
|
|
} arm_rfft_instance_f32;
|
|
|
|
arm_status arm_rfft_init_f32(
|
|
arm_rfft_instance_f32 * S,
|
|
arm_cfft_radix4_instance_f32 * S_CFFT,
|
|
uint32_t fftLenReal,
|
|
uint32_t ifftFlagR,
|
|
uint32_t bitReverseFlag);
|
|
|
|
void arm_rfft_f32(
|
|
const arm_rfft_instance_f32 * S,
|
|
float32_t * pSrc,
|
|
float32_t * pDst);
|
|
|
|
/**
|
|
* @brief Instance structure for the Double Precision Floating-point RFFT/RIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
arm_cfft_instance_f64 Sint; /**< Internal CFFT structure. */
|
|
uint16_t fftLenRFFT; /**< length of the real sequence */
|
|
const float64_t * pTwiddleRFFT; /**< Twiddle factors real stage */
|
|
} arm_rfft_fast_instance_f64 ;
|
|
|
|
arm_status arm_rfft_fast_init_f64 (
|
|
arm_rfft_fast_instance_f64 * S,
|
|
uint16_t fftLen);
|
|
|
|
|
|
void arm_rfft_fast_f64(
|
|
arm_rfft_fast_instance_f64 * S,
|
|
float64_t * p, float64_t * pOut,
|
|
uint8_t ifftFlag);
|
|
|
|
|
|
/**
|
|
* @brief Instance structure for the floating-point RFFT/RIFFT function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
arm_cfft_instance_f32 Sint; /**< Internal CFFT structure. */
|
|
uint16_t fftLenRFFT; /**< length of the real sequence */
|
|
const float32_t * pTwiddleRFFT; /**< Twiddle factors real stage */
|
|
} arm_rfft_fast_instance_f32 ;
|
|
|
|
arm_status arm_rfft_fast_init_f32 (
|
|
arm_rfft_fast_instance_f32 * S,
|
|
uint16_t fftLen);
|
|
|
|
|
|
void arm_rfft_fast_f32(
|
|
const arm_rfft_fast_instance_f32 * S,
|
|
float32_t * p, float32_t * pOut,
|
|
uint8_t ifftFlag);
|
|
|
|
/**
|
|
* @brief Instance structure for the floating-point DCT4/IDCT4 function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t N; /**< length of the DCT4. */
|
|
uint16_t Nby2; /**< half of the length of the DCT4. */
|
|
float32_t normalize; /**< normalizing factor. */
|
|
const float32_t *pTwiddle; /**< points to the twiddle factor table. */
|
|
const float32_t *pCosFactor; /**< points to the cosFactor table. */
|
|
arm_rfft_instance_f32 *pRfft; /**< points to the real FFT instance. */
|
|
arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */
|
|
} arm_dct4_instance_f32;
|
|
|
|
|
|
/**
|
|
* @brief Initialization function for the floating-point DCT4/IDCT4.
|
|
* @param[in,out] S points to an instance of floating-point DCT4/IDCT4 structure.
|
|
* @param[in] S_RFFT points to an instance of floating-point RFFT/RIFFT structure.
|
|
* @param[in] S_CFFT points to an instance of floating-point CFFT/CIFFT structure.
|
|
* @param[in] N length of the DCT4.
|
|
* @param[in] Nby2 half of the length of the DCT4.
|
|
* @param[in] normalize normalizing factor.
|
|
* @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if <code>fftLenReal</code> is not a supported transform length.
|
|
*/
|
|
arm_status arm_dct4_init_f32(
|
|
arm_dct4_instance_f32 * S,
|
|
arm_rfft_instance_f32 * S_RFFT,
|
|
arm_cfft_radix4_instance_f32 * S_CFFT,
|
|
uint16_t N,
|
|
uint16_t Nby2,
|
|
float32_t normalize);
|
|
|
|
|
|
/**
|
|
* @brief Processing function for the floating-point DCT4/IDCT4.
|
|
* @param[in] S points to an instance of the floating-point DCT4/IDCT4 structure.
|
|
* @param[in] pState points to state buffer.
|
|
* @param[in,out] pInlineBuffer points to the in-place input and output buffer.
|
|
*/
|
|
void arm_dct4_f32(
|
|
const arm_dct4_instance_f32 * S,
|
|
float32_t * pState,
|
|
float32_t * pInlineBuffer);
|
|
|
|
|
|
/**
|
|
* @brief Instance structure for the Q31 DCT4/IDCT4 function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t N; /**< length of the DCT4. */
|
|
uint16_t Nby2; /**< half of the length of the DCT4. */
|
|
q31_t normalize; /**< normalizing factor. */
|
|
const q31_t *pTwiddle; /**< points to the twiddle factor table. */
|
|
const q31_t *pCosFactor; /**< points to the cosFactor table. */
|
|
arm_rfft_instance_q31 *pRfft; /**< points to the real FFT instance. */
|
|
arm_cfft_radix4_instance_q31 *pCfft; /**< points to the complex FFT instance. */
|
|
} arm_dct4_instance_q31;
|
|
|
|
|
|
/**
|
|
* @brief Initialization function for the Q31 DCT4/IDCT4.
|
|
* @param[in,out] S points to an instance of Q31 DCT4/IDCT4 structure.
|
|
* @param[in] S_RFFT points to an instance of Q31 RFFT/RIFFT structure
|
|
* @param[in] S_CFFT points to an instance of Q31 CFFT/CIFFT structure
|
|
* @param[in] N length of the DCT4.
|
|
* @param[in] Nby2 half of the length of the DCT4.
|
|
* @param[in] normalize normalizing factor.
|
|
* @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if <code>N</code> is not a supported transform length.
|
|
*/
|
|
arm_status arm_dct4_init_q31(
|
|
arm_dct4_instance_q31 * S,
|
|
arm_rfft_instance_q31 * S_RFFT,
|
|
arm_cfft_radix4_instance_q31 * S_CFFT,
|
|
uint16_t N,
|
|
uint16_t Nby2,
|
|
q31_t normalize);
|
|
|
|
|
|
/**
|
|
* @brief Processing function for the Q31 DCT4/IDCT4.
|
|
* @param[in] S points to an instance of the Q31 DCT4 structure.
|
|
* @param[in] pState points to state buffer.
|
|
* @param[in,out] pInlineBuffer points to the in-place input and output buffer.
|
|
*/
|
|
void arm_dct4_q31(
|
|
const arm_dct4_instance_q31 * S,
|
|
q31_t * pState,
|
|
q31_t * pInlineBuffer);
|
|
|
|
|
|
/**
|
|
* @brief Instance structure for the Q15 DCT4/IDCT4 function.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint16_t N; /**< length of the DCT4. */
|
|
uint16_t Nby2; /**< half of the length of the DCT4. */
|
|
q15_t normalize; /**< normalizing factor. */
|
|
const q15_t *pTwiddle; /**< points to the twiddle factor table. */
|
|
const q15_t *pCosFactor; /**< points to the cosFactor table. */
|
|
arm_rfft_instance_q15 *pRfft; /**< points to the real FFT instance. */
|
|
arm_cfft_radix4_instance_q15 *pCfft; /**< points to the complex FFT instance. */
|
|
} arm_dct4_instance_q15;
|
|
|
|
|
|
/**
|
|
* @brief Initialization function for the Q15 DCT4/IDCT4.
|
|
* @param[in,out] S points to an instance of Q15 DCT4/IDCT4 structure.
|
|
* @param[in] S_RFFT points to an instance of Q15 RFFT/RIFFT structure.
|
|
* @param[in] S_CFFT points to an instance of Q15 CFFT/CIFFT structure.
|
|
* @param[in] N length of the DCT4.
|
|
* @param[in] Nby2 half of the length of the DCT4.
|
|
* @param[in] normalize normalizing factor.
|
|
* @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if <code>N</code> is not a supported transform length.
|
|
*/
|
|
arm_status arm_dct4_init_q15(
|
|
arm_dct4_instance_q15 * S,
|
|
arm_rfft_instance_q15 * S_RFFT,
|
|
arm_cfft_radix4_instance_q15 * S_CFFT,
|
|
uint16_t N,
|
|
uint16_t Nby2,
|
|
q15_t normalize);
|
|
|
|
|
|
/**
|
|
* @brief Processing function for the Q15 DCT4/IDCT4.
|
|
* @param[in] S points to an instance of the Q15 DCT4 structure.
|
|
* @param[in] pState points to state buffer.
|
|
* @param[in,out] pInlineBuffer points to the in-place input and output buffer.
|
|
*/
|
|
void arm_dct4_q15(
|
|
const arm_dct4_instance_q15 * S,
|
|
q15_t * pState,
|
|
q15_t * pInlineBuffer);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* ifndef _TRANSFORM_FUNCTIONS_H_ */
|