qccwavwaveletpacketdwt3dint.3

spiht for linux this is used to decod and encode vedio i wich all enjoy

.TH QCCWAVWAVELETPACKETDWT3DINT 3 "QCCPACK" ""
.SH NAME
QccWAVWaveletPacketDWT3DInt, QccWAVWaveletInversePacketDWT3DInt \- 
integer-valued separable wavelet-packet 3D discrete wavelet transform and
inverse transform for a 3D signal
.SH SYNOPSIS
.B #include "libQccPack.h"
.sp
.BI "int QccWAVWaveletPacketDWT3DInt(QccVolumeInt " volume ", int " num_frames ", int " num_rows ", int " num_cols ", int " origin_frame ", int " origin_row ", int " origin_col ", int " subsample_pattern_frame ", int " subsample_pattern_row ", int " subsample_pattern_col ", int " temporal_num_scales ", int " spatial_num_scales ", const QccWAVWavelet *" wavelet );
.sp
.BI "int QccWAVWaveletInversePacketDWT3DInt(QccVolumeInt " volume ", int " num_frames ", int " num_rows ", int " num_cols ", int " origin_frame ", int " origin_row ", int " origin_col ", int " subsample_pattern_frame ", int " subsample_pattern_row ", int " subsample_pattern_col ", int " temporal_num_scales ", int " spatial_num_scales ", const QccWAVWavelet *" wavelet );
.SH DESCRIPTION
.B QccWAVWaveletPacketDWT3DInt()
performs an integer-valued separable wavelet-packet 3D
discrete wavelet transform (DWT) of a three-dimensional signal,
.IR volume ,
which is represented as a volume of
.IR num_frames
frames,
.IR num_rows 
rows, and
.I num_cols
columns.
.IR origin_frame ,
.IR origin_row ,
and
.I origin_col
indicates the frame, row, and column indices, respectively, of the upper
corner of the image cube.
Usually, one assumes that the upper corner of the image cube is
indexed as (0, 0, 0) - in this case, 
.IR origin_frame ,
.IR origin_row ,
and
.I origin_col
would all be zero.
.I wavelet
must indicate an integer-valued lifting scheme (see
.BR QccWAVLiftingSchemeInteger (3)).
.LP
.I temporal_num_scales
and
.I spatial_num_scales
give the number of scales, or levels, of the decomposition.
.BR QccWAVWaveletPacketDWT3DInt()
implements a wavelet-packet decomposition of
.IR volume ;
that is, 
each temporal vector is decomposed with
.I temporal_num_scales
temporal decompositions (via a call to
.BR QccWAVWaveletDWT1DInt (3)
on each temporal vector),
and then each frame of the volume is decomposed with
.I spatial_num_scales
spatial decompositions (via a call to
.BR QccWAVWaveletDWT2DInt (3)
on each frame).
.LP
.B QccWAVWaveletInversePacketDWT3DInt()
performs the corresponding separable wavelet-packet 3D inverse DWT of
.IR volume
which is assumed to have been produced
by
.BR QccWAVWaveletPacketDWT3DInt() .
.I temporal_num_scales
and
.I spatial_num_scales
give the number of levels of decomposition that exist in
.IR volume .
.LP
.IR subsample_pattern_frame ,
.IR subsample_pattern_row ,
and
.I subsample_pattern_col
indicate the even- or odd-phase subsampling to be used at each level
of frame, row, and column decomposition.
In most applications, even subsampling at all
levels is desired, in which case 
.IR subsample_pattern_frame ,
.IR subsample_pattern_row ,
and
.I subsample_pattern_col
should all be set to zero.
In more general settings, when some mixture of even- and odd-phase subsampling
is desired, 
.IR subsample_pattern_frame ,
.IR subsample_pattern_row ,
and
.I subsample_pattern_col
can be integers between 0 and
.IR "(2 ^ num_levels) - 1" .
In these integers, the 
.IR j th
bit (where
.I j
= 1 is the least-significant bit) indicates whether the
.IR j th
level of decomposition employs
even or odd subsampling (0 = even, 1 = odd).
For example, if
.I subsample_pattern_row
is 5, then the first and third row decompositions use odd-phase
subsampling, while all others use even subsampling.
.LP
Use
.BR QccWAVSubbandPyramid3DIntDWT (3)
and
.BR QccWAVSubbandPyramid3DIntInverseDWT (3)
to perform a separable wavelet-packet 3D DWT or inverse DWT on a
.B QccWAVSubbandPyramid3DInt
data structure (which is the recommended way to do it, since the
.B QccWAVSubbandPyramid3DInt
structure stores the number of levels of decomposition along with
the transform coefficients).
.SH "RETURN VALUES"
These routines
return 0 on success and 1 on error.
.SH "SEE ALSO"
.BR QccWAVWaveletDWT1DInt (3),
.BR QccWAVWaveletInverseDWT1DInt (3),
.BR QccWAVWaveletDWT2DInt (3),
.BR QccWAVWaveletInverseDWT2DInt (3),
.BR QccWAVSubbandPyramid3DIntDWT (3),
.BR QccWAVSubbandPyramid3DIntInverseDWT (3),
.BR QccWAVWaveletDyadicDWT3DInt (3),
.BR QccWAVWaveletInverseDyadicDWT3DInt (3),
.BR QccWAVWavelet (3),
.BR QccPackWAV (3),
.BR QccPack (3)
.LP
A. R. Calderbank, I. Daubechies, W. Sweldens, B.-L. Yeo, "Lossless
Image Compression Using Integer to Integer Wavelet Transforms", in
.IR "Proceedings of the International Conference on Image Processing" ,
Lausanne, Switzerland, pp. 596-599, September 1997.

Z. Xiong, X. Wu, S. Cheng, J. Hua, "Lossy-to-Lossless Compression of
Medical Volumetric Data Using Three-Dimensional Integer Wavelet Transforms,"
.IR "IEEE Transactions on Medical Imaging" ,
vol. 22, pp. 459-470, March 2003.

I. Daubechies and W. Sweldens,
"Factoring Wavelet Transforms Into Lifting Steps,"
.IR "J. Fourier Anal. Appl." ,
vol. 4, no. 3, pp. 245-267, 1998.

B.-J. Kim, Z. Xiong, and W. A. Pearlman,
"Low Bit-Rate Scalable Video Coding with 3-D Set Partitioning
in Hierarchical Trees (3-D SPIHT),"
.IR "IEEE Transactions on Circuits and Systems for Video Technology" ,
vol. 10, no. 8, pp. 1374-1387, December 2000.
.SH AUTHOR
Copyright (C) 1997-2009  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.