EncodeGetDist

Returns estimated distortion of the image for the specified coding pass.

Syntax

IppStatus ippiEncodeGetDist_JPEG2K(IppiEncodeState_JPEG2K* pState, int passNumber, Ipp64f* pDist);

Parameters

pState	Pointer to the allocated and initialized encoder state structure.
passNumber	Number of the specified coding pass.
pDist	Pointer to the variable that returns the value of the estimated distortion.

Description

The function ippiEncodeGetDist_JPEG2K is declared in the ippj.h file. This function returns the cumulative weighted mean square error (MSE) distortion pDist of the reconstructed image for the coding pass of a given number passNumber. The distortions are computed in accordance with [ISO15444], Annex J, section J.14, Rate Control during the encoding procedure and then stored in the pState structure.Therefore, it is available only after completing both encoding procedures.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when any of the specified pointers is `NULL`.
ippStsContextMatchErr	Indicates an error condition if a pointer to an invalid state structure is passed.
ippStsJPEG2KBadPassNumber	Indicates an error condition if passNumber exceeds the allowed boundaries.