DCTFwdInit

Initializes the forward discrete cosine transform structure.

Syntax

IppStatus ippsDCTFwdInit_16s(IppsDCTFwdSpec_16s** ppDCTSpec, int len, IppHintAlgorithm hint, Ipp8u* pSpec, Ipp8u* pSpecBuffer);

IppStatus ippsDCTFwdInit_32f(IppsDCTFwdSpec_32f** ppDCTSpec, int len, IppHintAlgorithm hint, Ipp8u* pSpec, Ipp8u* pSpecBuffer);

IppStatus ippsDCTFwdInit_64f(IppsDCTFwdSpec_64f** ppDCTSpec, int len, IppHintAlgorithm hint, Ipp8u* pSpec, Ipp8u* pSpecBuffer);

Parameters

ppDCTSpec	Double pointer to the forward DCT specification structure to be created.
len	Number of samples in the DCT.
hint	Suggests using specific code for calculation. The values for the hint argument are described in the section Flag and Hint Arguments.
pSpec	Pointer to the area for the DCT specification structure.
pSpecBuffer	Pointer to the additional work buffer, can be NULL.

Description

The function ippsDCTFWDInit is declared in the ipps.h file. This function initializes the forward DCT specification structure ppDCTSpec with the following parameters: the transform len, and the specific code hint.

Before calling this function the memory must be allocated for the DCT specification structure and the work buffer (if it is required). The size of the DCT specification structure and the work buffer must be computed by the function ippsDCTFwdGetBufSize beforehand.

If the work buffer is not used, the parameter pSpecBuffer can be NULL. If the working buffer is used, the parameter pSpecBuffer must not be NULL.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when one of the specified pointers with exception of pSpecBuffer is NULL.
ippStsSizeErr	Indicates an error when len is less than or equal to 0.