WTFwd_D97_JPEG2K

Performs a tile-oriented forward wavelet transform with irreversible filter.

Syntax

IppStatus ippiWTFwd_D97_JPEG2K_16s_C1R(const Ipp16s* pSrc, int srcStep, const IppiRect* pTileRect, Ipp16s* pDst[4], int dstStep[4], Ipp8u* pBuffer);

IppStatus ippiWTFwd_D97_JPEG2K_32s_C1R(const Ipp32s* pSrc, int srcStep, const IppiRect* pTileRect, Ipp32s* pDst[4], int dstStep[4], Ipp32s* pBuffer);

IppStatus ippiWTFwd_D97_JPEG2K_16s_C1IR(Ipp16s* pSrcDstTile, int srcDstStep, const IppiRect* pTileRect, Ipp8u* pBuffer);

IppStatus ippiWTFwd_D97_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 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 buffer.

Description

The function ippiWTFwd_D97_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 into a set of four two-dimensional subbands pDst labelled as LxLy, LxHy, HxLy, HxHy. The subband LxLy is a downsampled version of the source tile to which the horizontal and vertical low-pass filters were applied. The subband LxHy is a downsampled version of the source tile to which a horizontal low-pass and vertical and high-pass filters were applied. The subband HxLy is a downsampled version of the source tile to which the horizontal and vertical high-pass filters were applied. The subband HxHy is a downsampled version of the source tile to which horizontal high-pass and vertical high-pass filters were applied. The function uses the 9-7 irreversible 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_D97_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.