qccwavtce3dlosslessencode.3

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

.TH QCCWAVTCE3DLOSSLESSENCODE 1 "QCCPACK" ""
.SH NAME
QccWAVtce3DLosslessEncode, QccWAVtce3DLosslessDecode \-
encode/decode an image cube using the lossless 3D-TCE algorithm
.SH SYNOPSIS
.B #include "libQccPack.h"
.sp
.BI "int QccWAVtce3DLosslessEncode(const QccIMGImageCube *" image ", QccBitBuffer *" buffer ", int " transform_type ", int " temporal_num_levels ", int " spatial_num_levels ", double " alpha ", const QccWAVWavelet *" wavelet );
.sp
.BI "int QccWAVtce3DLosslessDecodeHeader(QccBitBuffer *" buffer ", int *" transform_type ", int *" temporal_num_levels ", int *" spatial_num_levels ", int *" num_frames ", int *" num_rows ", int *" num_cols ", int *" image_mean ", int *" max_coefficient_bits ", double *" alpha );
.sp
.BI "int QccWAVtce3DLosslessDecode(QccBitBuffer *" buffer ", QccIMGImageCube *" image ", int " transform_type ", int " temporal_num_levels ", int " spatial_num_levels ", double " alpha ", const QccWAVWavelet *" wavelet ", int " image_mean ", int " max_coefficient_bits ", int " target_bit_bit );
.SH DESCRIPTION
.SS Encoding
.LP
.B QccWAVtce3DLosslessEncode()
encodes an image cube,
.IR image ,
using a 3D generalization of the TCE algorithm.
The original TCE algorithm was developed for lossy coding of 2D images by
Tian and Hemami;
it was latter extended to 3D
and made lossless via the incorporation reversible transforms
by Zhang
.IR "et al" .
.LP
.I image
is the image cube to be coded and
.I buffer
is the output bitstream.
.I buffer
must be of
.B QCCBITBUFFER_OUTPUT
type and opened via a prior call to
.BR QccBitBufferStart (3).
.LP
.BR QccWAVtce3DLosslessEncode ()
supports the use of both wavelet-packet and dyadic wavelet-transform
decompositions.
If
.IR transform_type
is
.BR QCCWAVSUBBANDPYRAMID3D_DYADIC ,
a dyadic DWT is used; if
.IR transform_type
is
.BR QCCWAVSUBBANDPYRAMID3D_PACKET ,
a wavelet-packet DWT is used.
.IR temporal_num_levels 
and
.IR spatial_num_levels
give the number of levels of wavelet decomposition to perform
for both transform types; for a dyadic transform,
.IR temporal_num_levels 
should equal
.IR spatial_num_levels .
.I wavelet
is the integer-to-integer wavelet to use for decomposition.
.LP
The 3D-TCE algorithm performance is in part through
the parameter
.IR alpha ,
a value that gives the learning rate of the density-estimation
process implemented by the tarp filter used in one of
the coding passes of the TCE algorithm.
.LP
The bitstream output from the 3D-TCE encoder is embedded, meaning that
any prefix of the bitstream can be decoded to give a valid, albeit lossy,
representation of the image.
.LP
.SS Decoding
.LP
.B QccWAVtce3DLosslessDecodeHeader()
decodes the header information 
in a bitstream previously produced by
.BR QccWAVtce3DLosslessEncode() .
The input bitstream is
.I buffer
which must be of
.B QCCBITBUFFER_INPUT
type and opened via a prior call to
.BR QccBitBufferStart (3).
.LP
The header information is returned in
.I transform_type
(either
.BR QCCWAVSUBBANDPYRAMID3D_DYADIC 
or
.BR QCCWAVSUBBANDPYRAMID3D_PACKET 
to indicate a dyadic or wavelet-packet transform decomposition, respectively),
.I temporal_num_levels
(number of levels of wavelet decomposition in the temporal direction),
.I spatial_num_levels
(number of levels of wavelet decomposition in the spatial directions),
.I num_frames
(size of the image cube in the temporal direction),
.I num_rows
(vertical size of image cube),
.I num_cols
(horizontal size of image cube),
.I image_mean
(the mean value of the original image cube),
.I max_coefficient_bits
(indicates the precision, in number of bits, of the wavelet coefficient
with the largest magnitude),
and
.I alpha
(the value of the learning rate).
.LP
.B QccWAVtce3DLosslessDecode()
decodes the bitstream
.IR buffer ,
producing the reconstructed image cube,
.IR image .
The bitstream must already have had its header read by a prior call
to
.B QccWAVtce3DLosslessDecodeHeader()
(i.e., you call
.B QccWAVtce3DLosslessDecodeHeader() 
first and then
.BR QccWAVtce3DLosslessDecode() ).
If
.I target_bit_cnt
is
.BR QCCENT_ANYNUMBITS ,
then decoding stops when the end of the input bitstream is reached;
i.e.,
.IR image
will be a lossless reconstruction of the original image.
Otherwise, decoding stops when
.I target_num_bits
from the input bitstream have been decoded which
will produce a lossy representation that differs from the
originally encoded image.
.SH "SEE ALSO"
.BR tceencode3d_lossless (1),
.BR tcedecode3d_lossless (1),
.BR QccBitBuffer (3),
.BR QccWAVSubbandPyramid3DInt (3),
.BR QccWAVSubbandPyramid3DIntDWT (3),
.BR QccWAVtce3DEncode (3),
.BR QccPackWAV (3),
.BR QccPackIMG (3),
.BR QccPack (3)

.LP
J. Zhang, J. E. Fowler, and G. Liu,
"Lossy-to-Lossless Compression of Hyperspectral Imagery Using
3D-TCE and an Integer KLT," 
.IR "IEEE Geoscience and Remote Sensing Letters" ,
vol. 5, pp. 814-818, October 2008.

C. Tian and S. S. Hemami, "An Embedded Image Coding System
Based on Tarp Filter with Classification," in
.IR "Proceedings of the International Conference on Acoustics, Speech, and Signal Processing" ,
Montreal, Quebec, Canada, May 2004, vol. 3, pp. 49-52.

.SH AUTHOR
Copyright (C) 1997-2009  James E. Fowler
.\"  The programs herein are free software; you can redistribute them and/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.