DCTFwdInitAlloc

Allocates memory and fills in context data needed for the forward DCT function to operate.

Syntax

IppStatus ippiDCTFwdInitAlloc_32f (IppiDCTFwdSpec_32f** ppDCTSpec, IppiSize roiSize, IppHintAlgorithm hint);

Parameters

ppDFTSpec	Pointer to the forward DCT context structure being initialized.
roiSize	Size of the source and destination ROI in pixels.
hint	Option to select the algorithmic implementation of the transform function.

Description

The function ippiDCTFwdInitAlloc is declared in the ippi.h file. This function allocates memory and initializes the context structure pDCTSpec needed to compute the forward DCT of a two-dimensional image data. The ippiDCTFwd function called with the pointer to the initialized pDCTSpec structure as an argument will compute the forward discrete cosine transform for points in the ROI of size roiSize using computation algorithm indicated by hint parameter (see Table “Hint Arguments for Linear Transform Functions”).

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr	Indicates an error condition if pDCTSpec pointer is `NULL`.
ippStsSizeErr	Indicates an error condition if roiSize has a field with zero or negative value.
ippStsMemAllocErr	Indicates an error condition if memory allocation fails.