DFTFwd

Syntax

Parameters

pSrc	Pointer to the source image ROI.
srcStep	Distance in bytes between starts of consecutive lines in the source image.
pDst	Pointer to the destination image ROI.
dstStep	Distance in bytes between starts of consecutive lines in the destination image.
pSrcDst	Pointer to the source and destination image ROI for the in-place operation.
srcDstStep	Distance in bytes between starts of consecutive lines in the source and destination image for the in-place operation.
pDFTSpec	Pointer to the previously initialized DFT context structure.
scaleFactor	Scale factor (see Integer Result Scaling).
pBuffer	Pointer to the external work buffer, can be NULL.

Description

The function ippiDFTFwd is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP) of the size specified by the function ippiDFTInitAlloc.

This function performs a forward DFT on each channel of the source image ROI pSrc (pSrcDst for in-place flavors) and writes the Fourier coefficients into the corresponding channel of the destination buffer pDst (pSrcDst for in-place flavors).

The function flavor ippiDFTFwd_RToPack that operates on images with real data takes advantage of the symmetry property and stores the output data in RCPack2D format. It supports processing of the 1-, 3-, and 4-channel images. Note that the functions with AC4 descriptor do not process alpha channel.

The function flavor ippiDFTFwd_CToC that operates on images with complex data performs no packing of the transform results as no symmetry with respect to frequency domain data is observed in this case. Memory layout of images with complex data follows the same conventions as for real images provided that each pixel value consists of two numbers: imaginary and real part.

The forward DFT functions use the previously initialized pDFTSpec context structure to set the mode of calculations and retrieve support data.

The function may be used with the external work buffer pBuffer to avoid memory allocation within the functions. Once the work buffer is allocated, it can be used for all following calls to the functions computing DFT. As internal allocation of memory is too expensive operation and depends on operating system and/or runtime libraries used - the use of an external buffer improves performance significantly, especially for the small size transforms.

The size of the external buffer must be previously computed by the function ippiDFTGetBufSize. If the external buffer is not specified (pBuffer is set to NULL), the function itself allocates the memory needed for operation.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr	Indicates an error condition if pSrc, pDst, or pDFTSpec pointer is NULL.
ippStsStepErr	Indicates an error condition if srcStep or dstStep value is zero or negative.
ippStsContextMatchErr	Indicates an error condition if a pointer to an invalid pDFTSpec structure is passed.
ippStsMemAllocErr	Indicates an error condition if memory allocation fails.