OpticalFlowPyrLKInitAlloc

Allocates memory and initializes a structure for optical flow calculation.

Syntax

IppStatus ippiOpticalFlowPyrLKInitAlloc_<mod>(IppiOptFlowPyrLK_<mod>** ppState, IppiSize roiSize, int winSize, IppHintAlgorithm hint);

Supported values for mod:

8u_C1R

16u_C1R

32f_C1R

Parameters

ppState: Pointer to the pointer to the optical flow structure being initialized.
roiSize: Size of the source image (zero level of the pyramid) ROI in pixels.
winSize: Size of the search window of each pyramid level.
hint: Option to select the algorithmic implementation of the transform function.

Description

The function ippiOpticalFlowPyrLKInitAlloc is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP). This function allocates memory and initializes a structure pState for calculation the optical flow between two images using the pyramidal Lucas-Kanade algorithm in the centered window of size winSize * winSize. Computation algorithm is specified by the hint argument. This structure is used by the function ippiOpticalFlowPyrLK.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr	Indicates an error if ppState is NULL.
ippStsSizeErr	Indicates an error condition if roiSize has a field with zero or negative value or if winSize is equal to or less than 0.
ippStsMemAllocErr	Memory allocation error.