dwt.h revision ee451cb395940862dad63c85adfe8f2fd55e864c
1/* 2 * The copyright in this software is being made available under the 2-clauses 3 * BSD License, included below. This software may be subject to other third 4 * party and contributor rights, including patent rights, and no such rights 5 * are granted under this license. 6 * 7 * Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium 8 * Copyright (c) 2002-2014, Professor Benoit Macq 9 * Copyright (c) 2001-2003, David Janssens 10 * Copyright (c) 2002-2003, Yannick Verschueren 11 * Copyright (c) 2003-2007, Francois-Olivier Devaux 12 * Copyright (c) 2003-2014, Antonin Descampe 13 * Copyright (c) 2005, Herve Drolon, FreeImage Team 14 * All rights reserved. 15 * 16 * Redistribution and use in source and binary forms, with or without 17 * modification, are permitted provided that the following conditions 18 * are met: 19 * 1. Redistributions of source code must retain the above copyright 20 * notice, this list of conditions and the following disclaimer. 21 * 2. Redistributions in binary form must reproduce the above copyright 22 * notice, this list of conditions and the following disclaimer in the 23 * documentation and/or other materials provided with the distribution. 24 * 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS' 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 28 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 29 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35 * POSSIBILITY OF SUCH DAMAGE. 36 */ 37 38#ifndef __DWT_H 39#define __DWT_H 40/** 41@file dwt.h 42@brief Implementation of a discrete wavelet transform (DWT) 43 44The functions in DWT.C have for goal to realize forward and inverse discret wavelet 45transform with filter 5-3 (reversible) and filter 9-7 (irreversible). The functions in 46DWT.C are used by some function in TCD.C. 47*/ 48 49/** @defgroup DWT DWT - Implementation of a discrete wavelet transform */ 50/*@{*/ 51 52 53/** @name Exported functions */ 54/*@{*/ 55/* ----------------------------------------------------------------------- */ 56/** 57Forward 5-3 wavelet tranform in 2-D. 58Apply a reversible DWT transform to a component of an image. 59@param tilec Tile component information (current tile) 60*/ 61OPJ_BOOL opj_dwt_encode(opj_tcd_tilecomp_t * tilec); 62 63/** 64Inverse 5-3 wavelet tranform in 2-D. 65Apply a reversible inverse DWT transform to a component of an image. 66@param tilec Tile component information (current tile) 67@param numres Number of resolution levels to decode 68*/ 69OPJ_BOOL opj_dwt_decode(opj_tcd_tilecomp_t* tilec, OPJ_UINT32 numres); 70 71/** 72Get the gain of a subband for the reversible 5-3 DWT. 73@param orient Number that identifies the subband (0->LL, 1->HL, 2->LH, 3->HH) 74@return Returns 0 if orient = 0, returns 1 if orient = 1 or 2, returns 2 otherwise 75*/ 76OPJ_UINT32 opj_dwt_getgain(OPJ_UINT32 orient) ; 77/** 78Get the norm of a wavelet function of a subband at a specified level for the reversible 5-3 DWT. 79@param level Level of the wavelet function 80@param orient Band of the wavelet function 81@return Returns the norm of the wavelet function 82*/ 83OPJ_FLOAT64 opj_dwt_getnorm(OPJ_UINT32 level, OPJ_UINT32 orient); 84/** 85Forward 9-7 wavelet transform in 2-D. 86Apply an irreversible DWT transform to a component of an image. 87@param tilec Tile component information (current tile) 88*/ 89OPJ_BOOL opj_dwt_encode_real(opj_tcd_tilecomp_t * tilec); 90/** 91Inverse 9-7 wavelet transform in 2-D. 92Apply an irreversible inverse DWT transform to a component of an image. 93@param tilec Tile component information (current tile) 94@param numres Number of resolution levels to decode 95*/ 96OPJ_BOOL opj_dwt_decode_real(opj_tcd_tilecomp_t* restrict tilec, OPJ_UINT32 numres); 97 98/** 99Get the gain of a subband for the irreversible 9-7 DWT. 100@param orient Number that identifies the subband (0->LL, 1->HL, 2->LH, 3->HH) 101@return Returns the gain of the 9-7 wavelet transform 102*/ 103OPJ_UINT32 opj_dwt_getgain_real(OPJ_UINT32 orient); 104/** 105Get the norm of a wavelet function of a subband at a specified level for the irreversible 9-7 DWT 106@param level Level of the wavelet function 107@param orient Band of the wavelet function 108@return Returns the norm of the 9-7 wavelet 109*/ 110OPJ_FLOAT64 opj_dwt_getnorm_real(OPJ_UINT32 level, OPJ_UINT32 orient); 111/** 112Explicit calculation of the Quantization Stepsizes 113@param tccp Tile-component coding parameters 114@param prec Precint analyzed 115*/ 116void opj_dwt_calc_explicit_stepsizes(opj_tccp_t * tccp, OPJ_UINT32 prec); 117/* ----------------------------------------------------------------------- */ 118/*@}*/ 119 120/*@}*/ 121 122#endif /* __DWT_H */ 123