GetNormalizedCentralMoment

Retrieves the normalized value of the image central moment computed by ippiMoments.

Syntax

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

IppStatus ippiGetNormalizedCentralMoment_64s(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 ippiGetNormalizedCentralMoment is declared in the ippi.h file. This function normalizes the central moment value that was previously computed by the ippiMoments function, and returns the pointer pValue to the normalized moment. The moment order (mOrd, nOrd) is specified by the integer power exponents. See Image Moments for details of moments normalization. Different functions are used to retrieve normalized 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.

ippStsMoment00ZeroErr

Indicates an error condition if M(0,0) value is close to zero.

Submit feedback on this help topic

Copyright © 2000 - 2011, Intel Corporation. All rights reserved.