Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of Contents

FGMMInit

Initializes the state structure for the Gaussian mixture model foreground/background subtraction.

Syntax

IppStatus ippiFGMMInit_8u_C3R(IppiSize roi, int maxNGauss, IppFGMModel* pModel, IppFGMMState_8u_C3R* pState);

Include Files

ippcv.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h, ippi.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib

Parameters

roi
Size of the source image ROI, in pixels.
maxNGauss
Maximal size of the Gaussian mixture components.
pModel
Pointer to the IppFGMModel structure containing parameters for the model. If pModel is NULL, the default parameters are applied.
pState
Pointer to the IppFGMMState_8u_C3R state structure.

Description

This function operates with ROI.

This function initializes the IppFGMMState_8u_C3R state structure for the FGMMForeground and FGMMBackground functions.

Before using this function, you need to compute the size of the state structure using the FGMMGetBufferSize function.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when pModel or pState is NULL.

ippStsSizeErr

Indicates an error when roi is less than, or equal to zero.

ippStsBadArgErr

Indicates an error when maxNGauss is less than, or equal to zero.

See Also