| synopsis || return value || arguments || prev || next |

kdu_kernels::get_energy_gain

double get_energy_gain( kdu_kernel_type which, int level_idx)

[Declared in "../coresys/common/kdu_kernels.h"]

Go to class description.


Synopsis

Computes the energy gain factor associated with the one dimensional synthesis basis vectors (sequences) for samples in the low- or high-pass subband at a particular DWT level.

The function does not explicitly compute the analysis or synthesis vectors for more than a certain number of DWT levels, beyond which point it relies upon the fact that the vectors converge to samplings of underlying continuous wavelet and scaling functions. This allows a large number of DWT levels to be specified without consuming inordinate amounts of memory calculating the kernels. For an explanation of these convergence properties, see Section 17.3 of the book by Taubman and Marcellin.

To determine the energy gain for 2D subbands, the 1D energy gains for each direction may be multiplied.


Return Value

The energy gain factor.

Arguments

which [kdu_kernel_type]

Must be one of KDU_SYNTHESIS_LOW or KDU_SYNTHESIS_HIGH.

level_idx [int]

A value of 0 refers to no transform at all, in which case the function returns 1.0 for low-pass and 0.0 for high-pass kernels. Otherwise, this argument identifies the level (or depth) of the subband within the DWT.


| top || synopsis || return value || arguments || prev || next |