Performs a tile-oriented forward wavelet transform with reversible filter.
Syntax
IppStatus ippiWTFwd_B53_JPEG2K_16s_C1R(const Ipp16s* pSrc, int srcStep, const IppiRect* pTileRect, Ipp16s* pDst[4], int dstStep[4], Ipp8u* pBuffer);
IppStatus ippiWTFwd_B53_JPEG2K_32s_C1R(const Ipp32s* pSrc, int srcStep, const IppiRect* pTileRect, Ipp32s* pDst[4], int dstStep[4], Ipp8u* pBuffer);
IppStatus ippiWTFwd_B53_JPEG2K_16s_C1IR(Ipp16s* pSrcDstTile, int srcDstStep, const IppiRect* pTileRect, Ipp8u* pBuffer);
IppStatus ippiWTFwd_B53_JPEG2K_32s_C1IR(Ipp32s* pSrcDstTile, int srcDstStep, const IppiRect* pTileRect, Ipp8u* pBuffer);
Parameters
pSrc |
Pointer to the source image. |
srcStep |
Distance in bytes between starts of consecutive lines in the source image. |
pTileRect |
Pointer to the tile rectangle structure. |
pDst |
Array of pointers to the subbands of the destination image (in the order LxLy, LxHy, HxLy, HxHy). |
dstStep |
Array of distances in bytes between starts of consecutive lines in the the subbands of the destination image. |
pSrcDstTile |
Pointer to the source and destination image for in-place operation. |
srcDstStep |
Distance in bytes between starts of consecutive lines in the source and destination image for in-place operation. |
pBuffer |
Pointer to the work buffer. |
Description
The function ippiWTFwd_B53_JPEG2K is declared in the ippj.h file. This function performs a forward discrete wavelet transformation of the tile-component using a subband decomposition in accordance with [ISO15444], Annex F, Discrete Wavelet Transformation of Tile-Components . The function performs one-level decomposition by downsampling each tile of the source image pSrc (pSrcDstTile for in-place flavors) into a set of four two-dimensional subbands labelled as LxLy, LxHy, HxLy, HxHy. The subband LxLy is a downsampled version of source tile that is low-pass filtered horizontally and low-pass filtered vertically. The subband LxHy is a downsampled version of source tile that is low-pass filtered horizontally and high-pass filtered vertically. The subband HxLy is a downsampled version of source tile that is high-pass filtered horizontally and low-pass filtered vertically. The subband HxHy is a downsampled version of source tile that is high-pass filtered horizontally and high-pass filtered vertically. The function uses the 5-3 reversible filter.
For not-in-place flavors, the subbands are stored separately in the array pDst. For in-place flavors, the subbands are stored in the pSrcDstTile (see Figure “Subband Positions for in-place Operations”).
The size of the required external buffer should be determined by calling the ippiWTGetBufSize_B53_JPEG2K function prior to using the wavelet transform function.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error condition if any of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition if the width or height of ROI has zero or negative value. |
ippStsStepErr |
Indicates an error condition if any of the specified step values is zero or negative. |