Decodes the compressed code block data.
Syntax
IppStatus ippiDecodeCodeBlock_JPEG2K_1u32s_C1R(const Ipp8u* pSrc, Ipp32s* pDst, int dstStep, IppiSize codeBlockSize, IppiWTSubband subband, int sfBits, int nOfPasses, const int* pTermPassLen, int nOfTermPasses, int codeStyleFlags, int* pErrorBitPlane, Ipp8u* pBuffer);
Parameters
pSrc |
Pointer to the source compressed code block. |
pDst |
Pointer to the destination for decoded data. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination buffer. |
codeBlockSize |
Size of the code block. |
subband |
Wavelet transform subband contained the given code block. Possible values are listed in the Table “Subband Parameter for the JPEG2000 Entropy Coder Functions”. |
sfBits |
Number of significant bit planes. |
nOfPasses |
Number of coding passes. |
pTermPassLen |
Pointer to the array that contains the length of each terminated coding pass. |
nOfTermPasses |
Number of terminated coding passes. |
codeStyleFlags |
Options for the decoding procedure. Possible values are listed in the Table “CodeStyleFlag Argument for the JPEG2000 Entropy Coder Functions”. |
pErrorBitPlane |
Pointer to the bit plane that contains the first error returned when the damaged code block occurs. |
pBuffer |
Pointer to the work buffer. |
Description
The function ippiDecodeCodeBlock_JPEG2K is declared in the ippj.h file. This function decodes the compressed code block pSrc of data using adaptive arithmetic decoding procedure and stores the decoded data in the pDst buffer. Negative integers in the code block should be presented in the direct code with the sign in the most significant bit (31st in the zero-based numeration, when the least significant bit has a zero index). This code may be effectively obtained using the specially designed function ippiComplement.
Note
errorBitPlane should be set to NULL if the corresponding information is not required.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when any of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition if the width or height of the code block has zero or negative value. |
ippStsJPEG2KDamagedCodeBlock |
Indicates an error condition if a code block contains damaged data. |
ippStsStepErr |
Indicates an error condition if dstStep has zero or negative value. |