Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 6/24/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

WTInvInit

Initializes the inverse wavelet transform specification structure.

Syntax

IppStatus ippiWTInvInit_32f_C1R (IppiWTInvSpec_32f_C1R* pSpec,const Ipp32f* pTapsLow, int lenLow, int anchorLow,const Ipp32f* pTapsHigh, int lenHigh, int anchorHigh);

IppStatus ippiWTInvInit_32f_C3R (IppiWTInvSpec_32f_C3R* pSpec,const Ipp32f* pTapsLow, int lenLow, int anchorLow,const Ipp32f* pTapsHigh, int lenHigh, int anchorHigh);

Include Files

ippi.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

pSpec
Double pointer to a new allocated and initialized inverse DWT context structure.
pTapsLow
Pointer to lowpass filter taps.
lenLow
Length of the lowpass filter.
anchorLow
Anchor position of the lowpass filter.
pTapsHigh
Pointer to highpass filter taps.
lenHigh
Length of the highpass filter.
anchorHigh
Anchor position of the highpass filter.

Description

This function initializes the specification structure pSpec for a one-level wavelet reconstruction.

The inverse wavelet transform specification structure contains parameters of a wavelet filter bank used for image reconstruction. The filter bank consists of two synthesis filters and includes the lowpass reconstruction filter (or coarse filter) and the highpass reconstruction filter (or detail filter).

The parameters pTapsLow and pTapsHigh specify coefficients, and anchorLow and anchorHigh - anchor positions for two synthesis filters. The anchor value sets the initial leftmost filter position relative to image row or column as shown in the figure below:

Anchor Value and Initial Filter Position for Wavelet Reconstruction

Here a stands for anchor value, N is filter length, x0 is the starting pixel of the processed row or column, and x-1, x-2 ,... are the additional border pixels that are needed for calculations. As seen from this figure, anchor position is specified relative to upsampled source data. The anchor value and filter length completely determine right, left, top, and bottom border sizes for source images used in reconstruction. The corresponding C-language expressions to calculate border sizes are given in the description of the ippWTInv function.

For an example on how to use this function, refer to the example provided with the ippiWTInv function description.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or a warning.

ippStsNullPtrErr

Indicates an error when any of the specified pointers is NULL.

ippStsNumChannelsErr

Indicates an error when numChannels has an illegal value.

ippStsSizeErr

Indicates an error when filter length lenLow or lenHigh is less than 2.

ippStsAnchorErr

Indicates an error when anchor position anchorLow or anchorHigh is less than zero.

See Also