GetNormalizedSpatialMoment

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

Syntax

IppStatus ippiGetNormalizedSpatialMoment_64f(IppiMomentState_64f* pState, int mOrd, int nOrd, int nChannel, IppiPoint roiOffset, Ipp64f* pValue);

IppStatus ippiGetNormalizedSpatialMoment_64s(IppiMomentState_64s* pState, int mOrd, int nOrd, int nChannel, IppiPoint roiOffset, 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.
roiOffset	Offset in pixels of the ROI origin (top left corner) from the image origin.
pValue	Pointer to the returned normalized moment value.
scaleFactor	Scale factor (see Integer Result Scaling).

Description

The function ippiGetNormalizedSpatialMoment is declared in the ippi.h file. This function normalizes the spatial moment value that was previously computed by the ippiMoments function, and returns the pointer pValue to the normalized moment. See Image Moments for details of moments normalization. The moment order (mOrd, nOrd) is specified by integer power exponents. All spatial moment values are computed by ippiMoments relative to the image ROI origin.You may also obtain normalized spatial moment values relative to different point in the image, using the appropriate roiOffset settings.

Different functions are used to retrieve normalized spatial 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.
ippStsSizeErr	Indicates an error condition if mOrd + nOrd is greater than 3, or nChannel has an illegal value.