GetCentralMoment

Retrieves image central moment computed by ippiMoments.

Syntax

IppStatus ippiGetCentralMoment_64f(const IppiMomentState_64f* pState, int mOrd, int nOrd, int nChannel, Ipp64f* pValue);

IppStatus ippiGetCentralMoment_64s(const IppiMomentState_64s* pState, int mOrd, int nOrd, int nChannel, Ipp64s* pValue, int scaleFactor);

Parameters

pState	The structure that stores image moments.
mOrd, nOrd	Integer power exponents defining the moment order. These arguments must satisfy the condition 0 ≤ mOrd + nOrd ≤ 3.
nChannel	The channel for which the moment is returned.
pValue	Pointer to the returned moment value.
scaleFactor	Scale factor (see Integer Result Scaling).

Description

The function ippiGetCentralMoment is declared in the ippi.h file. This function returns the pointer pValue to the central moment previously computed by the ippiMoments function. The moment order is specified by the integer exponents mOrd, nOrd.

Different functions are used to retrieve central moment in integer and floating-point formats, respectively. In case of integer data, the result may be scaled by the specified scaleFactor.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr	Indicates an error condition if pState or pValue pointer is `NULL`.
ippStsContextMatchErr	Indicates an error condition if a pointer to an invalid structure is passed.
ippStsSizeErr	Indicates an error condition if mOrd + nOrd is greater than 3, or nChannel has an illegal value.