.TH QCCWAVLIFTINGSCHEME 3 "QCCPACK" "".SH NAMEQccWAVLiftingScheme \- data structure .B QccWAVLiftingSchemeand corresponding.B LFTfile format for wavelet-based analysis/synthesis using alifting implementation.SH SYNOPSIS.B #include "libQccPack.h".sp.BI "int QccWAVLiftingSchemeInitialize(QccWAVLiftingScheme *" lifting_scheme );.br.BI "int QccWAVLiftingSchemePrint(const QccWAVLiftingScheme *" lifting_scheme );.br.BI "int QccWAVLiftingSchemeBiorthogonal(const QccWAVLiftingScheme *" lifting_scheme );.SH DESCRIPTIONQccPack provides data structure.B QccWAVLiftingSchemefor representing a lifting scheme for a two-band wavelet-basedanalysis and synthesis using lifting (as opposed to filtering; see.BR QccWAVFilterBank (3) ).This lifting-scheme structure can be read from and written to .BR LFT -formatfiles, or a.B QccWAVLiftingSchemestructure can be used without file input or output..LPThe only component of the lifting-scheme structure is an integercode indicating which lifting scheme to employ.This is due to the fact that the lifting implementations ofwavelet analysis and synthesis are "hard-coded" into the QccPack libraryfor purposes of execution speed and ease of implementation(this is opposed to the situation for filter-based analysis and synthesiswhich employ generic filter routines and read coefficients from files).As a consequence, only a limited number (see below) of waveletsare current supported, and this list cannot be extended by the user(without modifying the QccPack source code, or course)..SH "DATA STRUCTURE"The.B QccWAVLiftingSchemedata structure is defined as:.RS.nftypedef struct{  QccString filename;  QccString magic_num;  int major_version;  int minor_version;  int scheme;} QccWAVLiftingScheme;.fi.RE.LPThe fields of.B QccWAVLiftingSchemeare as follows:.TP.I filenameThe name of the file..TP.IR magic_num ", " major_version ", " minor_versionThe magic number and version of the file..TP.IR schemeThe integer code denoting which lifting scheme to employ.The current possibilities are limited to.BR QCCWAVLIFTINGSCHEME_LWT(Lazy Wavelet transform),.BR QCCWAVLIFTINGSCHEME_Daubechies4(Daubechies length-4 orthonormal wavelet),.BR QCCWAVLIFTINGSCHEME_CohenDaubechiesFeauveau9_7(Cohen-Daubechies-Feauveau length 9-7 biorothogonal wavelet),and.BR QCCWAVLIFTINGSCHEME_CohenDaubechiesFeauveau5_3(Cohen-Daubechies-Feauveau length 5-3 biorthogonal wavelet,which is also known as "linear lifting")..SH "FILE FORMAT"For reading and writing structuresof type.BR QccWAVLiftingScheme ,QccPack provides the.B LFTfile format.This file format starts with an ASCII header followed bybinary data.The ASCII header consists of magic-number/revisioninformationfollowed by any amount of white space(space, `\\t' (tab), `\\n' (newline), `\\r' (return)) and/orcomments lines (lines starting with `#').  The ASCII integer corresponding to.I scheme is given following the header..LPThe.B LFTfile format consists of the following information:.RS.sp.BI LFT X.X.br.I "<white space>".br.I scheme.br.sp.REwhere.B LFTis the magic number,.I X.Xis the version number,.I "<white space>"is white space and/or comment lines, and.I schemeis the lifting scheme..SH "ROUTINES".B QccWAVLiftingSchemeInitialize()should be called before any use of a.B QccWAVLiftingSchemestructure..B QccWAVLiftingSchemeInitialize()initializes the fields of.I lifting_schemeto the following values:.RS.IR filename :.B NULLstring.br.IR magic_num :.B QCCLIFTINGSCHEME_MAGICNUM.br.IR major_version ", " minor_version :initialized to output of .BR QccGetQccPackVersion (3).br.IR scheme :-1 (undefined).RE.LP.B QccWAVLiftingSchemePrint()prints the contents of.I lifting_schemeto stdout..LP.BR QccWAVLiftingSchemeBiorthogonal()returns 1 if.I lifting_scheme is biorthogonal, 0 otherwise..SH "FILES"QccPack comes with the following.BR LFT-format files for specifying certain lifting wavelets.The.BR LFTfiles and their corresponding wavelets are.RSLWT.lft - Lazy Wavelet transform.brCohenDaubechiesFeauveau.5-3.lft - length 9/5 biorthogonal wavelet.brCohenDaubechiesFeauveau.9-7.lft - length 9/7 biorthogonal wavelet.brDaubechies.4.lft - length 4 orthogonal wavelet.RE.SH "RETURN VALUE"These routines return 0 on success, and 1 on failure..SH "SEE ALSO".BR QccPackWAV (3),.BR QccPack (3).SH AUTHORCopyright (C) 1997-2005  James E. Fowler.\"  The programs herein are free software; you can redistribute them an.or.\"  modify them under the terms of the GNU General Public License.\"  as published by the Free Software Foundation; either version 2.\"  of the License, or (at your option) any later version..\"  .\"  These programs are distributed in the hope that they will be useful,.\"  but WITHOUT ANY WARRANTY; without even the implied warranty of.\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the.\"  GNU General Public License for more details..\"  .\"  You should have received a copy of the GNU General Public License.\"  along with these programs; if not, write to the Free Software.\"  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.